Crie um espaço de trabalho de dados denso com Blueprint: tokens verificados de tipografia e intenção, uma tabela de conjuntos de dados selecionáveis, um painel de revisão e o código-fonte completo de React.
Guia OpenDesign8 capítulos60 itens de referênciaGuia de aplicação original
01
Prévia da interface do sistema de design Palantir Blueprint
Filtre por nome ou tipo, selecione um conjunto de dados, altere a densidade das linhas, mude a aparência e valide uma nota de revisão antes de atualizar o status local.
Blueprint nativo 6.21.0 com React 18.3.1. Composição original e responsiva de área de trabalho; sem servidor ou revisão salva. · Referência de implementação
02
Referência de design do sistema de design Palantir Blueprint
Blueprint core 6.21.0, publicado CSS, e componentes nativos React. Estes são valores selecionados dos tokens do tema claro; use o tema escuro da biblioteca em vez de invertê-los manualmente. As escolhas de layout do aplicativo estão identificadas no exemplo CSS.
Área de trabalho com foco em dados do sistema de design Palantir Blueprint
Controles compactos com uma ordem de leitura explícita
O Blueprint é útil quando uma tela combina uma coleção, filtros, status e ações contextuais. O exemplo mantém a tabela do conjunto de dados à esquerda e o registro selecionado à direita. Assim, é possível comparar registros sem abrir uma nova página para cada um. O painel de inspeção contém a nota de revisão editável; a tabela permanece como uma superfície de consulta rápida.
Use o contrato do pacote v6
O exemplo é compilado com @blueprintjs/core 6.21.0. O namespace CSS é bp6 e seus tokens semânticos publicados começam com --bp-. Uma folha de estilos bp5 mais antiga não substitui os componentes CSS da v6. Importe a folha de estilos do pacote uma única vez na entrada do aplicativo e, em seguida, restrinja as regras de layout do aplicativo a uma classe separada.
Intenção e funções das cores do sistema de design Palantir Blueprint
Mantenha o status do registro separado da seleção
Uma Tag warning indica que o conjunto de dados precisa de revisão; a linha com tonalidade primária indica que ele está selecionado. Esses significados são independentes. Marcar uma linha como revisada altera seu rótulo e sua intenção para success, enquanto a seleção permanece no mesmo conjunto de dados. A tabela mantém o texto de cada status para que a cor não seja o único meio de transmitir o significado.
Mantenha o modo escuro no limite do componente
O exemplo adiciona bp6-dark ao elemento contêiner, permitindo que os componentes nativos apliquem seus estilos escuros. Os valores do tema claro acima são uma referência, não uma instrução para sobrescrever todos os componentes. Ao introduzir um portal, como Dialog, garanta que o conteúdo renderizado receba o mesmo contexto de tema; um contêiner que não englobe o portal não é suficiente.
Tipografia do sistema de design Palantir Blueprint para registros e metadados
Leia a escala do texto de corpo antes de escolher os títulos
Os tamanhos publicados para o texto de corpo incluem 10, 12, 14 e 16px; o tamanho médio é 14px. Os nomes dos conjuntos de dados permanecem no nível principal de leitura. IDs e tipos de registro usam texto auxiliar, enquanto as contagens numéricas usam algarismos tabulares, facilitando a comparação de valores que mudam. O guia não recomenda 10px para o conteúdo principal.
Crie uma hierarquia compacta no painel de inspeção
O painel de inspeção usa um título de 20px e uma lista de definições para ID, responsável, tipo e contagem. Rótulos e valores compartilham um alinhamento estável em duas colunas. A nota de revisão vem depois desses dados, separada por uma linha, para que a ação não seja confundida com um filtro da tabela.
Tabela, filtros e painel de inspeção do sistema de design Palantir Blueprint
Preserve a semântica da tabela
HTMLTable fornece uma tabela nativa com o estilo do Blueprint. Os botões na primeira célula selecionam registros e continuam acessíveis pelo teclado; o exemplo não depende de um manipulador de linha acionado apenas pelo ponteiro como único meio de seleção. A propriedade interactive aplica estilo de realce ao passar o cursor sobre as linhas, e condensed alterna a densidade independentemente da filtragem.
Deixe visível o fluxo controlado de dados
Encontre um conjunto de dados pelo nome exibido.
Restrinja a mesma coleção com o seletor de tipo.
Selecione o botão do nome para carregar o painel de inspeção.
Digite uma nota de revisão e envie a revisão local.
Espaçamento, superfícies e densidade do sistema de design Palantir Blueprint
Use uma unidade menor sem reduzir demais todos os espaços
O token publicado de espaçamento entre superfícies é 4px. A bancada usa múltiplos definidos pela aplicação: 12px entre os controles de filtro, 20px entre a coleção e o inspetor e 24px ao redor do exemplo para desktop. Essas são decisões de composição mostradas em CSS. O token de raio de borda de 4px mantém a geometria dos controles e das superfícies discreta.
Ajuste o layout antes de sacrificar os rótulos
No ponto de quebra de 800px definido para a aplicação de exemplo, o inspetor passa para baixo da coleção. Os filtros passam para a linha seguinte, o preenchimento principal muda para 16px e, quando necessário, a tabela recebe seu próprio contêiner com rolagem horizontal. Esse ponto de quebra pertence a esta bancada; ele não é apresentado como um ponto de quebra oficial e universal do Blueprint.
Revisão e estados vazios do Sistema de Design Palantir Blueprint
A validação faz parte da operação de revisão
Ao enviar uma nota vazia, o InputGroup e o FormGroup recebem a intenção de erro, é exibido um texto auxiliar explicativo e o foco vai para o campo. Ao inserir texto, o erro é removido. Um envio válido altera apenas o registro local selecionado, limpa a nota e exibe um Callout de sucesso que informa explicitamente que nenhum dado foi enviado.
Mantenha a recuperação próxima da coleção vazia
O Callout de nenhum resultado oferece a opção Limpar filtros. Ela redefine tanto a consulta de pesquisa quanto o seletor de tipo, restaurando a coleção completa. Não exclui linhas nem altera o inspetor. Os seguintes limites entre estados são intencionais:
A seleção altera o registro inspecionado, não seu status de revisão.
O modo compacto altera a densidade, não a ordem dos registros.
O tema altera a aparência visual, não os filtros atuais.
Uma revisão local bem-sucedida altera um registro e anuncia o resultado.
Foco e uso acessível de componentes do Sistema de Design Palantir Blueprint
Rotule cada controle nativo
O InputGroup recebe um nome acessível para a pesquisa e um id para o campo de revisão rotulado. O HTMLSelect tem seu próprio nome, o Switch exibe rótulos visíveis e cada registro é aberto por um botão real. Use essas APIs da biblioteca em vez de substituir os controles por divs estilizadas.
Mantenha o indicador de foco visível
A referência do pacote especifica uma largura de foco de 2px e um deslocamento de 2px. Mantenha o indicador de foco visível sobre Cards e linhas selecionadas. Usuários de teclado devem conseguir acessar os filtros, os botões das linhas e o formulário de revisão na ordem do documento. O parágrafo de status e o Callout de sucesso do exemplo comunicam os resultados sem levar a pessoa para outra tela.
Instalação e limites da aplicação do Sistema de Design Palantir Blueprint
Execute o mesmo código-fonte do exemplo
O código-fonte completo de App e o CSS da aplicação são fornecidos abaixo. App é montado no elemento raiz gerado pelo modelo do Vite React. A instalação do pacote principal fixado fornece os componentes nativos e o pacote CSS; o exemplo baseado em texto não requer nenhum recurso de design oculto.
Amplie a revisão com um contrato real de persistência
Exemplos de componentes do Sistema de Design Palantir Blueprint
main.jsx — aplicação completa para revisão de conjuntos de dados
Uma composição totalmente nativa com filtragem, seleção, densidade, tema, validação de campo e resultado de revisão local.
Salve este arquivo como src/main.jsx e o próximo exemplo como src/blueprint.css.
A chamada createRoot usa o elemento raiz de index.html do Vite React.
blueprint.css — layout responsivo da bancada
As regras de layout da aplicação complementam o CSS nativo importado. O ponto de quebra de 800px e o inspetor de 260px são escolhas explícitas deste exemplo.
A classe bp6-dark ativa o tema da biblioteca; o fundo da tela do exemplo é definido pela aplicação CSS.
04
Configuração do agente de IA para o Sistema de Design Palantir Blueprint
Ponto de partida para implementação
A prévia nativa foi empacotada e executada com React 18.3.1 e Blueprint 6.21.0. Use uma versão do Node.js compatível com a versão do Vite escolhida. Os dois arquivos da aplicação são fornecidos acima.
sh
npm create vite@latest blueprint-review -- --template react
cd blueprint-review
npm install
npm install [email protected][email protected] @blueprintjs/[email protected]
# Replace src/main.jsx and add src/blueprint.css using the complete examples.
npm run dev
Um prompt para seu projeto
Prompt para agente de IA
Use Blueprint 6.21.0 para criar um espaço de trabalho de revisão de conjuntos de dados. Consulte os tokens fornecidos e o exemplo completo em React/CSS. Preserve HTMLTable nativo, InputGroup/FormGroup rotulados, Tags de status e seleção de linhas acessível por teclado. Mantenha independentes os estados de filtro, seleção, densidade, aparência e revisão. Adicione o serviço real de salvamento somente quando seu API for fornecido; mostre respostas pendentes e com falha sem perder a nota. Mantenha o inspetor responsivo e os estados de foco visíveis.
05
Fontes e escopo do Sistema de Design Palantir Blueprint
OpenDesign: guia de aplicação para Blueprint 6.21.0, com um exemplo original de revisão de conjuntos de dados que executa o pacote React real. Os nomes dos conjuntos de dados e os resultados das revisões são dados de exemplo locais. O layout da bancada é código da aplicação; os valores de referência vêm do pacote publicado com versão definida.