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.
Da versão 18.9.0 para a 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 usam React Componentes de Função, portanto referências obtidas do useRef passarão a ser um forward 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 mudanças 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 alternativa de cadeias em todos os tipos de propriedades (por exemplo, booleano | string ou number | string). Além disso, os tipos de união de cordas não são mais indiferentes a maiúsculas e maiú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>
- Eventos componentes emitem um único argumento padrão CustomEvent em vez do
senderargumento como primeiro. Portanto, propriedades personalizadas como sender.nativeElement não estão mais disponíveis, mas todas as propriedades nativas de eventos estão. Além disso, tipos para argumentos de evento estão disponíveis como aliases para o evento personalizado específico, então o acessodetailpor uso permanecerá o mesmo. Com a nova assinaturaevent.detaildo handler é a mesma eevent.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 possuem mais a propriedade não
namefuncional por padrão. Anamepropriedade permanece apenas nos componentes igniteui-react, principalmente em entradas de forma comoIgrInputandIgrCombo, onde possui funcionalidade nativa. - Ignite UI for React componentes não precisam mais de uma
keypropriedade, a menos que seja necessário segundo a documentação da 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: []
}