Guía de actualización

    En el Ignite UI for React versiones, el primer número siempre coincide con la versión principal de React admite el código y el segundo está dedicado a las versiones principales. Es posible que se introduzcan cambios importantes entre las versiones principales. Puede encontrar una lista completa de cambios para cada versión de Ignite UI for React en el REGISTRO DE CAMBIOS del producto.

    Del 18.9.0 al 19.0.0

    Esta versión incluye una revisión importante de algunos de nuestros componentes internos de React que conduce a los siguientes cambios en los paquetes igniteui-react e igniteui-react-grids:

    General

    Breaking changes

    • Ignite UI for React componentes ahora usan React Componentes de Función, por lo que las referencias obtenidas de useRef serán ahora un forwarding del elemento nativo en lugar de una instancia de componente de clase. Muchos de los casos de uso podrían permanecer sin cambios, pero se requieren cambios posibles, como no necesitar una propiedad adicional para acceder al propio elemento DOM.
    • Los componentes ya no aceptan la unión alternativa de cadenas en todos los tipos de propiedades (por ejemplo, booleano | cadena o número | cadena). Además, los tipos de unión de cuerdas ya no son insensibles a mayúsculas y mayúsculas.
    <IgrColumn dataType="String" sortable="true"></IgrColumn>
    

    Becomes:

    <IgrColumn dataType="string" sortable={true}></IgrColumn>
    
    • Los eventos de los componentes ahora tienen un prefijo, es decir:
    <IgrGrid columnPin={handlePinning}></IgrGrid>
    

    Becomes

    <IgrGrid onColumnPin={handlePinning}></IgrGrid>
    
    • Component events emit a single standard CustomEvent argument instead of the sender as first argument. Therefore, custom properties like sender.nativeElement are no longer available, but native event properties all are. Also, types for event arguments are available as aliases for the specific custom event, so usage accessing detail will remain the same. With the new handler signature event.detail is the same and event.target is the DOM element equivalent to the sender:
        const handlePinning = (sender: IgrGridBaseDirective, event: IgrPinColumnCancellableEventArgs) => {};
    

    Becomes:

        const handlePinning = (event: IgrPinColumnCancellableEventArgs) => {}
        // equivalent to
        const handlePinning = (event: CustomEvent<IgrPinColumnCancellableEventArgsDetail>) => {}
    
    • Components no longer have the non-functional name property by default. The name property only remains in igniteui-react components, mostly form inputs such as IgrInput and IgrCombo, where it has native functionality.
    • Ignite UI for React components no longer require a key property, unless it is necessary according to React`s documentation
    • IgrDataGrid ya no forma parte del paquete igniteui-react-grids. Se ha movido a igniteui-react-data-grids, lo que hace que igniteui-react-grids sea más liviano.
    • Hubo varios tipos que se expusieron como clases en la versión 18.9.0, lo cual ya no es el caso. Ahora se exportan como tipos y se pueden usar de la siguiente manera:
    const pivotConfiguration = new IgrPivotConfiguration();
    

    Becomes:

    const pivotConfiguration: IgrPivotConfiguration = {
      rows: [],
      columns: [],
      values: []
    }
    
    • IgrButton
      • Cambios importantes
      • clicked event is removed. Use native onClick instead.
    • IgrInput
      • Cambios importantes
      • inputOccurred event is renamed to onInput