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

Total Results10,000 rows

Use arrow keys to navigate, Shift and arrows to select cells, and Enter or F2 to edit. Copy and paste cells with your keyboard. Column headings sort; column separators resize with arrow keys.

Northwind Freight
Owen Park
Latin America
Closed won
40
$9,600
49%
Lumen Freight
Tyler Hayes
Europe
Closed won
105
$37,800
90%
Cedar Freight
Tyler Hayes
Latin America
Proposal
230
$96,600
64%
Brightline Freight
Marcus Johnson
Asia Pacific
Proposal
115
$41,400
78%
Harbor Freight
Daniel Kim
Latin America
Committed
10
$4,200
72%
Pinecrest Freight
Marcus Johnson
Europe
Closed won
470
$169,200
72%
Atlas Freight
Sarah Bennett
Latin America
Discovery
45
$16,200
95%
Summit Freight
Owen Park
Asia Pacific
Negotiation
255
$107,100
93%
Fieldstone Freight
Marcus Johnson
Europe
Discovery
660
$237,600
82%
Evergreen Freight
Marcus Johnson
Latin America
Negotiation
46
$13,800
56%
Meridian Freight
Owen Park
Asia Pacific
Discovery
119
$42,840
73%
Redwood Freight
Daniel Kim
Europe
Committed
192
$80,640
90%
Westbridge Freight
Tyler Hayes
North America
Proposal
265
$63,600
41%
Sum3.3M
Sum$1.1B
Avg67.5%
A1Count 1

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-grid

Usando 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.

Total Results2 rows

Use arrow keys to navigate, Shift and arrows to select cells, and Enter or F2 to edit. Copy and paste cells with your keyboard. Column headings sort; column separators resize with arrow keys.

نورث ويند
أوروبا
40
لومن
آسيا
105
Sum145
A1Count 1Read-only