Data Grid
Uma planilha para seu aplicativo. Edite células, selecione intervalos, filtre registros e trabalhe com milhares de linhas, com a primeira coluna fixa e resumos em tempo real.
Renewals
Instalação
Adicione o Data Grid gratuito com nossa CLI. Ele inclui os controles do BoardUI e os utilitários internos de dados que utiliza:
Modo escuro pronto - este componente segue tokens semânticos BoardUI automaticamente. Configurar a mudança de tema.
O CLI copia a fonte do componente (com suas dependências internas) em seu projeto e instala quaisquer pacotes npm necessários.
npx boardui@latest add data-gridUsando um pacote de UI compartilhado ou aliases de importação personalizados? Configure seus caminhos de instalação antes de executar o CLI. Exemplos de copy-paste usam as importações padrão.
Colunas e edição
Passe definições tipadas de columns, seu data, e um identificador único e estável getRowId. Forneça onDataChange para habilitar a edição. Os editores de texto, número e seleção reutilizam os inputs e selects do BoardUI. Defina limites com min e max, ou rejeite valores com validate.
Utilização format para exibir células e formatSummary para rodapés de soma, média ou contagem. Defina editable= em colunas individuais. A formatação altera a apresentação; edição, cópia e exportação usam os valores originais.
const columns: DataGridColumn<Account>[] = [ { key: "account", header: "Account", width: 220, validate: (value) => String(value).trim() ? undefined : "Account cannot be empty." }, { key: "stage", header: "Stage", type: "select", options: ["Discovery", "Proposal", "Closed won"] }, { key: "seats", header: "Seats", type: "number", min: 0, summary: "sum" }, { key: "arr", header: "ARR", type: "number", min: 0, editable: false, summary: "sum", formatSummary: (value) => `$${value.toLocaleString("en-US")}` },];
// Omit onDataChange to make every cell read-only.<DataGrid aria-label="Accounts" data={data} columns={columns} getRowId={getRowId} />Busca, filtros e exportação
Busque em todas as colunas, clique em um cabeçalho para alternar entre ordem crescente, decrescente e original, ou filtre por valores exatos. Colunas de seleção aparecem automaticamente no menu de filtros; adicione filterable às outras colunas. Oculte colunas, redimensione suas divisórias e alterne entre linhas confortáveis e compactas.
A primeira coluna visível fica fixa ao lado dos números das linhas. Em telas estreitas, ela rola com as outras colunas para que todas as células continuem acessíveis. As caixas de seleção das linhas selecionam registros independentemente dos intervalos de células; a caixa do cabeçalho alterna todas as linhas filtradas. Selecionar linhas mostra a contagem e as ações Excluir, Copiar e Exportar na barra. A cópia usa valores separados por tabulação; a exportação baixa um CSV, ambos com as colunas visíveis e os registros visíveis selecionados. Excluir exige onDataChange e pode ser desfeito. Limpe a seleção para voltar aos controles de busca e visualização. Os resumos sempre refletem os registros filtrados.
Teclado e área de transferência
Entre no grid com Tab e use as setas para navegar entre células. Segure Shift para ampliar um intervalo ou arraste o mouse pelas células. Home e End percorrem uma linha; adicione ⌘ ou Ctrl para ir ao primeiro ou último registro. Page Up e Page Down avançam uma área de visualização. ⌘/Ctrl+A seleciona todas as células.
Selecione uma célula com opções para revelar o menu e clique na seta para escolher um valor. Clique duplo, Enter ou F2 abre o editor da célula. Enter salva e move para baixo; Shift+Enter move para cima. Tab salva e vai para a próxima célula. Escape cancela. Copie um intervalo e cole dados de planilha separados por tabulação com os atalhos habituais. Valores inválidos rejeitam toda a colagem. Desfazer e refazer se aplicam a edições de células, colagens e exclusões de linhas, mantendo até 100 operações enquanto o grid estiver montado.
Forneça a cada grid um aria-label. Envolva as regiões da direita para a esquerda em DirectionProvider; colunas fixas, menus e teclas de seta horizontais seguem a direção de leitura.
10.000 linhas em uma área de visualização pequena
A prévia acima contém 10.000 registros reais. A virtualização de altura fixa monta apenas as linhas na área de visualização e ao redor dela. O cabeçalho e o resumo ficam fora da região de rolagem; um desfoque progressivo suaviza a borda superior ao rolar. Defina height para alterar a altura da área de visualização.
Busca, ordenação, filtros e resumos são executados no navegador sobre os dados fornecidos. A seleção e a edição das células seguem IDs de linha estáveis quando os registros mudam de posição. Persista as alterações no seu onDataChange como manipulador. Monte novamente o grid com uma nova key ao trocar para outro conjunto de dados, para redefinir o estado da visualização e o histórico de edição.
Da direita para a esquerda e somente leitura
Utilização DirectionProvider para definir a direção de leitura. Este exemplo somente leitura fixa a primeira coluna à direita e espelha a navegação horizontal pelo teclado. Os rótulos das colunas e valores dos registros podem usar qualquer idioma.