Guia de atualização

No Ignite UI for React controle de versão, o primeiro número sempre corresponde à versão principal do React o código dá suporte e o segundo é dedicado para versões principais. Alterações significativas podem ser introduzidas entre as versões principais. Uma lista abrangente de alterações para cada versão do Ignite UI for React pode ser encontrada no CHANGELOG do produto.

From 18.9.0 to 19.0.0

Esta versão inclui um grande retrabalho de alguns de nossos componentes internos React, levando às seguintes alterações nos pacotes igniteui-react e igniteui-react-grids:

Geral

Breaking changes

• Ignite UI for React componentes agora estão usando React Componentes de Função, portanto, as referências obtidas de useRef agora serão um encaminhamento do elemento nativo em vez de uma instância de componente de classe. Muitos dos casos de uso podem permanecer inalterados, mas há possíveis alterações necessárias, como não precisar de uma propriedade extra para acessar o próprio elemento DOM.
• Os componentes não aceitam mais união de cadeia de caracteres alternativa em todos os tipos de propriedades (por exemplo, booleano | cadeia de caracteres ou número | cadeia de caracteres). Além disso, os tipos de união de cadeia de caracteres não diferenciam mais maiúsculas de minúsculas.

<IgrColumn dataType="String" sortable="true"></IgrColumn>

Becomes:

<IgrColumn dataType="string" sortable={true}></IgrColumn>

• Os eventos de componente agora são prefixados, ou seja:

<IgrGrid columnPin={handlePinning}></IgrGrid>

Becomes

<IgrGrid onColumnPin={handlePinning}></IgrGrid>

• Os eventos de componente emitem um único argumento CustomEvent padrão em vez do remetente como primeiro argumento. Portanto, propriedades personalizadas como sender.nativeElement não estão mais disponíveis, mas todas as propriedades de eventos nativos estão. Além disso, os tipos de argumentos de evento estão disponíveis como aliases para o evento personalizado específico, portanto, o uso de detalhes de acesso permanecerá o mesmo. Com a nova assinatura do manipulador, event.detail é o mesmo e event.target é o elemento DOM equivalente ao remetente:

    const handlePinning = (sender: IgrGridBaseDirective, event: IgrPinColumnCancellableEventArgs) => {};

Becomes:

    const handlePinning = (event: IgrPinColumnCancellableEventArgs) => {}
    // equivalent to
    const handlePinning = (event: CustomEvent<IgrPinColumnCancellableEventArgsDetail>) => {}

• Os componentes não têm mais a propriedade name não funcional por padrão. A propriedade name permanece apenas em componentes igniteui-react, principalmente entradas de formulário, como IgrInput e IgrCombo, onde possui funcionalidade nativa.
• Ignite UI for React componentes não exigem mais uma propriedade de chave, a menos que seja necessário de acordo com a documentação do React
• O IgrDataGrid não faz mais parte do pacote igniteui-react-grids. Ele foi movido para igniteui-react-data-grids, tornando igniteui-react-grids mais leves.
• Havia vários tipos que foram expostos como classes na versão 18.9.0, o que não é mais o caso. Eles agora são exportados como tipos e podem ser usados assim:

const pivotConfiguration = new IgrPivotConfiguration();

Becomes:

const pivotConfiguration: IgrPivotConfiguration = {
  rows: [],
  columns: [],
  values: []
}

• IgrButton
  • Alterações significativas
    • evento clicado é removido. Em vez disso, use o onClick nativo.
• IgrInput
  • Alterações significativas
    • inputOccurred event is renamed to onInput.