Блоки карточки разделяет проп
dividerу CdsCard — он рисует ту же линию, не добавляя разметки. Если части экрана нужно не разделить, а разнести по разным поверхностям, возьмите CdsSurface.
Вариации
Внешний вид
Свойство variant задаёт стиль линии: solid по умолчанию, а dashed, dotted и double помечают границу как временную или служебную.
Толщина и длина
Свойство thickness задаёт толщину линии в пикселях, length — её длину. Без length разделитель занимает всю ширину родителя (или всю его высоту, если разделитель вертикальный).
Цвет и прозрачность
Свойство color принимает цветовой алиас (green, red, purple) или токен дизайн-системы, opacity — прозрачность от 0 до 1. Цвет уместен, когда линия несёт смысл: граница просроченного периода, разрыв в истории событий.
Отступ
Свойство inset сдвигает горизонтальный разделитель на 72 px от начала строки — чтобы линия начиналась под текстом, а не под иконкой или аватаром. У вертикального разделителя inset укорачивает линию сверху и снизу.
Затухание
Свойство gradient растворяет линию к краям. Такой разделитель мягче обычного и хорошо смотрится внутри плотных блоков, где резкая граница выглядела бы рамкой.
Ориентация
Свойство vertical разворачивает разделитель. Вертикальная линия тянется на высоту соседей, поэтому её родителю нужна высота — обычно это строка display: flex.
Контент
Содержимое слота default встаёт в разрыв линии: разделитель превращается в подпись границы — «или», дата, название секции.
Свойство content-offset увеличивает расстояние от контента до линии. Массив из двух значений дополнительно смещает сам контент: вниз у горизонтального разделителя, вправо — у вертикального.
Рекомендации
Сценарии использования
Альтернативный способ входа
Разделитель с подписью «или» разводит два равнозначных пути и объясняет, что второй — не продолжение первого. content-offset даёт подписи воздух, чтобы она не сливалась с кнопками.
Строки списка
Между строками списка разделитель заменяет рамки: границы видны, но список не превращается в таблицу. Линия ставится между элементами, а не после каждого — у первой и последней строки её нет.
Метаданные записи
Вертикальные разделители разбивают строку фактов — статус, дату, автора — почти не занимая места. Родительской строке достаточно display: flex и высоты, чтобы линии вытянулись по тексту.
Секции формы
Разделитель с подписью в слоте называет новую группу полей. Это спокойнее заголовка: продолжение формы читается как продолжение, а не как начало другой формы.
API
Пропсы
| Имя | Тип | По умолчанию | Описание |
|---|---|---|---|
color | string | undefined | — | Цвет разделителя. |
contentOffset | string | number | (string | number)[] | undefined | — | Увеличивает интервал между элементами контента и строками. Если передается в виде массива, второе значение смещает содержимое слота вниз (или вправо если vertical = true). |
gradient | boolean | undefined | — | Добавляет эффект затухания с обеих сторон. |
inset | boolean | undefined | — | Добавляет отступ для обычных разделителей и уменьшает максимальную высоту для вертикальных разделителей. |
length | string | number | undefined | — | Длина разделителя. Единица измерения по умолчанию — пиксели. |
opacity | string | number | undefined | — | Прозрачность разделителя. |
theme | string | undefined | — | Тема компонента |
thickness | string | number | undefined | — | Толщина разделителя. Единица измерения по умолчанию — пиксели. |
variant | "solid" | "dotted" | "dashed" | "double" | undefined | 'solid' | Вариант отображения разделителя |
vertical | boolean | undefined | — | Отображает разделитель вертикально |
Слоты
| Имя | Тип | Описание |
|---|---|---|
default | any | Текст или контент в разрыве разделителя |