React Visão geral da seleção de coluna de grade

    O recurso React Grid Column Selection no Ignite UI for React oferece uma maneira simplificada e semelhante ao Excel de selecionar e destacar uma coluna inteira com um único clique. Ele pode ser habilitado por meio da columnSelection entrada. Graças à API avançada, o recurso permite fácil manipulação do estado de seleção, extração de dados das frações selecionadas, operações de análise de dados e visualizações.

    React Grid Column Selection Example

    O exemplo abaixo demonstra os três tipos de IgrGrid 's Seleção de colunas comportamento. Use o menu suspenso de seleção de coluna abaixo para ativar cada um dos modos de seleção disponíveis.

    * As colunas Título do contato, Cidade e Endereço estão com a seleção de coluna desabilitada.

    Basic Usage

    O recurso de seleção de coluna pode ser habilitado por meio da columnSelection entrada, que recebe GridSelectionMode valores.

    Interações

    O modo de seleção padrão é None. Se definido como Single ou Multiple, todas as colunas apresentadas serão selectable. Com isso dito, para selecionar uma coluna, basta clicar em uma, que a marcará como selected. Se a coluna não for selecionável, nenhum estilo de seleção será aplicado no cabeçalho, enquanto estiver passando o mouse.

    [!Note] The Multi Column Headers feature does not reflect on the selectable input. The ColumnGroupComponent is selectable, if at least one of its children has the selection behavior enabled. In addition, the component is marked as selected if all of its selectable descendants are selected.

    *No Grupo de Colunas de Informações do País, somente as colunas Cidade e Código Postal são selecionáveis.

    Keyboard Combinations

    [!Note] The keyboard combinations are available only when the grid columnSelection input is set to multiple.

    Há dois cenários para navegação pelo teclado do recurso Seleção de Coluna:

    • Seleção de várias colunas - segure ctrl + clique em cada célula de cabeçalho selecionável.
    • Seleção de coluna de intervalo - segurar shift + clicar seleciona todas as colunas selecionáveis entre elas.

    API Manipulations

    A API fornece alguns recursos adicionais quando se trata de colunas não visíveis, de modo que cada coluna oculta pode ser marcada como selected definindo o setter correspondente.

    [!Note] The above statement also applies to the ColumnGroupComponent, except that when the selected property is changed it changes the state of its descendants.

    Mais informações sobre as manipulações da API podem ser encontradas na seção Referências da API.

    Styling

    Além dos temas predefinidos, a grade pode ser ainda mais personalizada definindo algumas das propriedades CSS disponíveis. Caso você queira alterar algumas das cores, precisa definir uma class para a grade primeiro:

    <IgrGrid className="grid"></IgrGrid>

    Em seguida, defina as propriedades CSS relacionadas a esta classe:

    .grid {
    --ig-grid-row-selected-background: #0062A3;
    --ig-grid-row-selected-text-color: #ecaa53;
    --ig-grid-row-selected-hover-background: #0062A3;
    --ig-grid-header-selected-text-color: #ecaa53;
    --ig-grid-header-selected-background: #0062A3;
    --ig-grid-row-selected-hover-text-color: #ecaa53;
    --ig-grid-row-selected-hover-background: #0062A3;
}

    Demo

    API References

    A interface de seleção de colunas tem mais algumas APIs para explorar, listadas abaixo.

    IgrGrid properties:

    IgrColumn properties:

    columnGroup properties:

    IgrGrid events:

    • OnColumnsSelectionChange

    Additional Resources

    Nossa comunidade é ativa e sempre acolhedora para novas ideias.