Создайте насыщенную данными рабочую среду с Blueprint: проверенные токены типографики и намерений, таблица с выбором набора данных, панель проверки и полный исходный код React.
Фильтруйте по названию или типу, выбирайте набор данных, меняйте плотность строк и оформление, проверяйте заметку к проверке перед обновлением локального статуса.
Нативная Blueprint 6.21.0 с React 18.3.1. Оригинальная адаптивная компоновка рабочей области; сервера и сохранённой проверки нет. · Справочник по реализации
02
Palantir Blueprint Справочник по дизайн-системе
Ядро Blueprint 6.21.0, опубликованное CSS, и нативные компоненты React. Здесь приведены отдельные значения токенов светлой темы; для тёмного оформления используйте тёмную тему библиотеки, а не инвертируйте значения вручную. В примере CSS отдельно отмечены решения по компоновке приложения.
Дизайн-система Palantir Blueprint: рабочая область для работы с данными
Плотные элементы управления с чёткой последовательностью чтения
Blueprint полезна для экранов, объединяющих коллекцию, фильтры, статусы и контекстные действия. В примере таблица наборов данных расположена слева, а выбранная запись — справа. Так можно сравнивать записи, не открывая отдельную страницу для каждой. В панели сведений находится редактируемая заметка к проверке, а таблица служит для беглого просмотра.
Используйте контракт пакета v6
Пример собран с @blueprintjs/core 6.21.0. Пространство имён CSS — bp6, а опубликованные семантические токены начинаются с --bp-. Таблица стилей bp5 не заменяет компоненты CSS версии v6. Импортируйте таблицу стилей пакета один раз в точке входа приложения, а правила компоновки приложения задавайте для отдельного класса.
Дизайн-система Palantir Blueprint: назначение цветов и роли
Отделяйте статус записи от её выбора
Тег warning означает, что набор данных требует проверки; строка с основным оттенком показывает, что он выбран. Это независимые значения. При отметке записи как проверенной её метка и намерение меняются на success, а выбранным остаётся тот же набор данных. Для каждого статуса в таблице есть текст, поэтому смысл не зависит только от цвета.
Ограничивайте тёмный режим уровнем компонентов
В примере к обёртке добавлен класс bp6-dark, чтобы нативные компоненты применяли тёмные стили. Приведённые выше значения светлой темы — справочный снимок, а не указание переопределять стили каждого компонента. При добавлении портала, например Dialog, убедитесь, что его содержимое получает тот же контекст темы: обёртки, которая не содержит портал, недостаточно.
Palantir Blueprint — типографика дизайн-системы для записей и метаданных
Сначала изучите шкалу основного текста, затем выбирайте заголовки
Опубликованные размеры основного текста: 10, 12, 14 и 16px; средний размер — 14px. Названия наборов данных набраны основным кеглем. Для идентификаторов и типов записей используется вспомогательный текст, а числовые количества записей набраны табличными цифрами, чтобы их было проще сравнивать при изменении значений. Руководство не рекомендует использовать 10px для основного содержимого.
Создайте компактную иерархию в панели сведений
В панели сведений используется заголовок размером 20px и список определений с идентификатором, владельцем, типом и количеством. Подписи и значения выровнены по стабильной двухколоночной сетке. Примечание к проверке отделено от этих сведений линией, чтобы действие не приняли за фильтр таблицы.
Palantir Blueprint — таблица, фильтры и панель сведений дизайн-системы
Сохраняйте семантику таблицы
HTMLTable предоставляет нативную таблицу со стилями Blueprint. Кнопки в первой ячейке позволяют выбирать записи и доступны с клавиатуры; в примере обработчик строки, работающий только при нажатии указателем, не является единственным способом выбора. Свойство interactive включает подсветку строки при наведении, а condensed независимо от фильтрации переключает плотность.
Сделайте поток управляемых данных наглядным
Найдите набор данных по отображаемому названию.
Сузьте ту же коллекцию с помощью выбора типа.
Нажмите кнопку с названием, чтобы загрузить запись в панель сведений.
Введите заметку к проверке и отправьте её для локальной проверки.
Palantir Blueprint — интервалы, поверхности и плотность дизайн-системы
Используйте меньшую единицу, не превращая каждый отступ в крошечный
Опубликованный токен интервала для поверхностей — 4px. В рабочей области используются кратные значения: 12px между элементами фильтра, 20px между коллекцией и панелью сведений, 24px вокруг настольного примера. Это композиционные решения, показанные в CSS. Токен радиуса скругления 4px помогает сохранить сдержанную геометрию элементов управления и поверхностей.
Сначала измените компоновку, а не убирайте подписи
При контрольной точке приложения 800px из примера панель сведений перемещается под коллекцию. Фильтры переносятся на следующую строку, внутренний отступ основной области уменьшается до 16px, а для таблицы при необходимости появляется отдельная горизонтальная прокрутка. Эта контрольная точка относится к данной рабочей области и не представлена как официальная универсальная контрольная точка Blueprint.
Palantir Blueprint — проверка и пустые состояния дизайн-системы
Проверка данных — часть операции проверки записи
При отправке пустой заметки для InputGroup и FormGroup задаётся намерение danger, отображается поясняющий вспомогательный текст, а фокус перемещается в поле. После ввода текста ошибка очищается. При успешной отправке изменяется только выбранная локальная запись, заметка очищается, а в Callout об успехе явно указано, что данные не отправлялись.
Разместите способ восстановления рядом с пустой коллекцией
Callout для состояния «Ничего не найдено» предлагает очистить фильтры. Он сбрасывает поисковый запрос и выбор типа, возвращая всю коллекцию. Строки не удаляются, панель сведений не изменяется. Следующие границы состояний заданы намеренно:
Выбор меняет отображаемую запись, а не статус её проверки.
Компактный режим меняет плотность, но не порядок записей.
Смена темы меняет внешний вид, но не текущие фильтры.
После успешной локальной проверки изменяется одна запись и отображается сообщение о результате.
Palantir Blueprint — фокус и доступное использование компонентов дизайн-системы
Добавьте подпись к каждому нативному элементу управления
Для поиска InputGroup получает доступное имя, а для поля проверки — id, связанный с подписью. У HTMLSelect есть собственное имя, Switch отображает видимые подписи, а каждую запись можно открыть настоящей кнопкой. Используйте API этих библиотечных компонентов, а не заменяйте элементы управления стилизованными div.
Сохраняйте видимую индикацию фокуса
В справочнике пакета указаны ширина обводки фокуса 2px и смещение 2px. Индикация фокуса должна оставаться заметной на Card и выбранных строках. Пользователи клавиатуры должны иметь возможность последовательно перейти к фильтрам, кнопкам строк и форме проверки. Абзац состояния и Callout об успехе в примере сообщают о результатах, не перемещая читателя на другой экран.
Palantir Blueprint — установка и границы приложения дизайн-системы
Запустите тот же исходный код, что и в примере
Ниже приведены полный исходный код App и приложение CSS. App монтируется в корневой элемент, созданный шаблоном Vite React. Установка закреплённой версии основного пакета предоставляет нативные компоненты и пакет CSS; для текстового примера не нужны скрытые ресурсы дизайн-системы.
Дополните процесс проверки реальным механизмом сохранения
Сохраните этот код как src/main.jsx, а следующий пример — как src/blueprint.css.
Вызов createRoot использует корневой элемент из index.html шаблона Vite React.
blueprint.css — адаптивная компоновка рабочей области
Правила компоновки приложения дополняют импортированные нативные компоненты CSS. Контрольная точка 800px и панель сведений шириной 260px — явно заданные решения для этого примера.
Нативный пример был собран и запущен с помощью React 18.3.1 и Blueprint 6.21.0. Используйте версию Node.js, совместимую с выбранной вами версией Vite. Оба файла приложения приведены выше.
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
Запрос для вашего проекта
Промпт для AI-агента
Создайте рабочую область для проверки наборов данных с помощью Blueprint 6.21.0. Изучите предоставленные токены и полный пример React/CSS. Сохраните нативные HTMLTable, InputGroup/FormGroup с подписями, Tags состояния и доступный с клавиатуры выбор строк. Не связывайте состояния фильтра, выбора, плотности, оформления и проверки. Добавляйте реальный сервис сохранения только после предоставления его API; отображайте состояния ожидания и ошибки, не теряя заметку. Сохраните адаптивную панель сведений и видимую индикацию фокуса.
05
Palantir Blueprint — источники и область применения дизайн-системы
OpenDesign — руководство по приложению для Blueprint 6.21.0 с оригинальным примером проверки наборов данных, использующим настоящий пакет React. Названия наборов данных и результаты проверки — локальные примеры данных. Компоновка рабочей области реализована в коде приложения; справочные значения взяты из опубликованного пакета соответствующей версии.