Руководство по Lightning для работы с большим количеством записей: реальные отступы, типографика и семантические цвета, редактируемая рабочая область дела, проверка полей и история действий, отражающая локальные изменения.
Руководство OpenDesign8 глав40 справочных записейАвторское руководство по приложению
01
Предварительный просмотр интерфейса дизайн-системы Salesforce Lightning
Измените приоритет или статус, проверьте примечание к изменению, сохраните запись в локальной истории действий, а затем отмените последующий черновик, не изменяя сохранённую запись.
Нативные ресурсы SLDS 2.264.1 CSS и пакета; исходные доступные HTML и JavaScript. Без Salesforce API и среды выполнения Lightning. · Справочник по реализации
02
Справочник по дизайн-системе Salesforce Lightning
Опубликованный нативный пакет @salesforce-ux/design-system 2.264.1 CSS и экспорт токенов ui-force. Это справочник по закреплённой классической спецификации, а не заявление о совместимости с более новым языком дизайна SLDS 2 или средой выполнения Lightning Web Components. Исторический исходный репозиторий находится в архиве.
Структура и контекст записи в дизайн-системе Salesforce Lightning
Размещайте идентификатор записи над локальными задачами
В заголовке страницы указываются номер обращения, тема, учётная запись и владелец. Эти значения идентифицируют объект до того, как пользователь изменит какое-либо поле. Значок статуса отражает сводку сохранённой локальной записи, поэтому он меняется при нажатии кнопки сохранения, а не вслед за несохранённым значением в раскрывающемся списке.
Отделяйте сведения от истории действий
В более широкой области объединены контекст клиента и форма редактирования. Во вторичной области представлена упорядоченная история. Благодаря такому разделению пользователь может сопоставить запрошенную работу с уже зарегистрированными изменениями, не переходя на другой экран. В мобильной версии эти области располагаются вертикально в том же семантическом порядке.
Семантические цвета и состояния в дизайн-системе Salesforce Lightning
Рассматривайте названия токенов как обозначения ролей
Экспорт ui-force различает основной текст, приглушённый текст, границы выделения и фоны кнопок фирменного цвета. В примере основной текст тёмный, метаданные оформлены сдержанно, а основная кнопка синяя. Красный цвет используется для недопустимого значения поля и поясняющего сообщения о том, как исправить ошибку, а не для всех несохранённых значений.
Передавайте состояние не только цветом
Приоритет и статус отображаются словами в сводке и новой записи истории действий. Состояние ошибки обозначено нативным модификатором slds-has-error, атрибутом aria-invalid и сообщением, связанным с текстовой областью. Подтверждение локального сохранения выводится в области статуса; одного зелёного акцента недостаточно, чтобы сообщить пользователю, что именно сохранено.
Типографическая шкала и плотность записей в дизайн-системе Salesforce Lightning
Выстраивайте иерархию без чрезмерно крупных заголовков
Опубликованная нумерованная типографическая шкала начинается с 0.625rem и доходит до 2.625rem. Рабочему пространству обращения не требуется самый крупный размер заголовка во всех областях. Заголовок страницы по нативной спецификации идентифицирует запись, заголовки карточек разделяют области, а обычный текст содержит запрос клиента и примечание.
Не обрезайте длинные темы записей
В пользовательской компоновке заголовок страницы переносится на следующую строку, а не обрезается при узкой ширине. Метаданные также могут переноситься на дополнительные строки. Не уменьшайте весь текст из-за длинного названия учётной записи; прежде чем решать, где допустимо обрезание, проверьте макет на реалистичной длине тем и имён владельцев и убедитесь, что для обрезанного текста доступен полный вариант.
Отступы и структура спецификации в дизайн-системе Salesforce Lightning
Не смешивайте классические и переменные экспорты отступов
В этом руководстве перечислены SPACING_* из ui-force. Отдельный экспорт var-spacing содержит другие, более компактные значения; VAR_SPACING_MEDIUM и SPACING_MEDIUM — не один и тот же параметр. Смешивание значений только из-за похожих названий может привести к неравномерному оформлению формы. Выберите нужную систему плотности и придерживайтесь её источника.
Единообразно используйте обёртку поля
Поведение черновика и сохранённой записи в дизайн-системе Salesforce Lightning
Храните сохранённую запись отдельно от элементов управления
Скрипт хранит последние сохранённые значения приоритета и статуса в объекте record. Изменение элементов выбора влияет только на черновик. При нажатии кнопки сохранения значения копируются в этот объект, обновляется сводка и добавляется запись в историю действий. Благодаря этому действие «Отменить черновик» остаётся осмысленным и после нескольких успешных изменений.
Не имитируйте успешное обращение к серверу
В примере нет поиска по ID записи, модели разрешений, API или базы данных. Текст на кнопке и подтверждение явно указывают, что изменения локальные. Для интеграции с Salesforce в рабочей среде потребуются соответствующие API данных и ответы сервера, прежде чем можно будет обновить окончательный статус записи. Классы CSS не обеспечивают таких гарантий.
Проверка полей и история действий в дизайн-системе Salesforce Lightning
В примечании должно быть объяснение изменения
Заданное правило требует не менее десяти символов после удаления пробелов по краям и ограничивает текстовую область 300 символами. Пустое или слишком короткое примечание блокирует любые изменения записи, отображает ошибку поля и переводит фокус на примечание. При редактировании прежняя ошибка сбрасывается, а при следующем нажатии кнопки сохранения текущее значение проверяется заново.
Отправьте форму без примечания и убедитесь, что значения в сохранённой сводке не изменились.
Введите полезное примечание, сохраните его и проверьте самую новую запись в истории действий.
Снова измените поля, отмените черновик и убедитесь, что восстановлены последние сохранённые значения.
Добавляйте понятную запись об изменении
После успешного локального обновления создаётся запись истории действий: сначала заголовок на основе сохранённых статуса и приоритета, затем точное примечание в виде текстового содержимого. Новая запись добавляется в начало, поэтому самое последнее изменение отображается первым. Примечание не интерпретируется как HTML, а статическая начальная запись истории располагается после локальных записей пользователя.
Доступные формы и восстановление состояния в дизайн-системе Salesforce Lightning
Используйте настоящие подписи и явные описания
Для элементов select и textarea предусмотрены видимые подписи, связанные с ними через атрибуты for и id. Примечание связано с текстами подсказки и ошибки, а у маркера обязательного поля есть читаемое название. Основное действие и отмена оформлены кнопками с подходящими типами submit и button, что исключает случайную отправку формы при отмене черновика.
После отмены возвращайте пользователя в предсказуемое место
При отмене восстанавливаются сохранённые значения приоритета и статуса, очищаются примечание и ошибка поля, а фокус переводится на элемент управления приоритетом. История действий не удаляется, а запись не сбрасывается в исходное состояние. Это различие важно, если пользователь сначала сохраняет изменения, затем пробует внести другие и отменяет второй черновик.
Интеграция CSS и область применения версии дизайн-системы Salesforce Lightning
Установите опубликованный пакет стилей
Полный исходный код импортирует закреплённый дистрибутив CSS и небольшую таблицу стилей приложения. Vite обрабатывает URL шрифтов и изображений из пакета. Далее за поведение записи отвечают HTML и JavaScript; это реализация спецификации CSS, а не обёртка над lightning-record-edit-form.
Нативный пакет CSS задаёт оформление полей, кнопок и карточек.
Исходный HTML задаёт структуру записи и подписи.
Исходный JavaScript отвечает за состояние черновика, проверку и локальную историю действий.
Используйте архивный исходный код как справочник с указанной версией
Пример нативного CSS с закреплённой версией, не развёртывание в организации Salesforce. При распространении включённых в пакет ресурсов сохраняйте уведомления о пакетах и ресурсах.
sh
npm create vite@latest slds-case -- --template vanilla
cd slds-case
npm install
npm install @salesforce-ux/[email protected]
# Replace index.html; add src/main.js and src/slds.css from the complete examples.
npm run dev
Запрос для вашего проекта
Промпт для AI-агента
Создайте специализированное рабочее пространство обращения, используя закреплённые шаблоны SLDS CSS. Разделяйте идентификационные данные записи, контекст клиента, сохранённое состояние и черновик изменений. Используйте точную структуру полей, реальные ссылки на токены и полный исходный код, приведённый здесь. Проверяйте примечание до изменения сводки, сохраняйте локальную активность после отмены и не создавайте впечатление, что установлено соединение с серверной частью Salesforce.
05
Источники и область применения дизайн-системы Salesforce Lightning
Руководство OpenDesign по закреплённому пакету SLDS CSS. В предварительном просмотре используются нативная разметка CSS, оригинальные HTML и JavaScript, вымышленные данные обращений и локальное состояние. Lightning Web Components не загружаются, соединение с Salesforce не устанавливается. Исходный репозиторий находится в архиве; для рабочих проектов изучите актуальные рекомендации платформы Salesforce.