Skip to content

CdsFooter

Подвал приложения: копирайт и служебные ссылки на обычных страницах, панель действий — на формах. Макет замеряет высоту подвала и резервирует место, так что он не перекрывает последнюю строку контента.

Storybook GitLab
Покрытие тестами: 97% — хорошее покрытие
API в спеках
12 / 12 пропсы, события, слоты и exposed, у которых есть тест
Тест-кейсы
21 юнит · 0 браузерных
Известные баги
1 зафиксированы тестом it.fails
Покрытие кода
96.7% строк · 85.7% ветвей замер v4.0.0-alpha.13
A11y (axe)
6 рекомендаций в 6 историях замер v4.0.0-alpha.11

Подвал работает только внутри CdsLayout — вне макета он ничего не отрисует и предупредит об этом в консоли. Верхнюю панель приложения собирает CdsHeader, содержимое обеих — CdsToolbar.

Вариации ​

Разделитель ​

Подвал прижат к нижнему краю и перекрывает контент, поэтому его границу стоит обозначить: bordered рисует линию, elevated — тень вверх. Тень нужнее, когда под подвалом продолжается длинный список.

Sandbox Storybook

Цвет ​

Свойство bg-color красит фон подвала алиасом палитры, color — текст и иконки внутри. Если задан только фон, цвет текста подбирается контрастным автоматически.

Sandbox Storybook

Плавающий режим ​

Свойство reveal прячет подвал при прокрутке вниз и возвращает при прокрутке вверх. Событие @reveal сообщает о смене видимости — например, чтобы подстроить счётчик выбранного.

Sandbox Storybook

Видимость ​

Свойство model-value убирает подвал совсем: макет перестаёт резервировать под него место, и контент занимает всю высоту. Так прячут панель действий, пока форма не изменена.

Sandbox Storybook

Рекомендации ​

Сценарии использования ​

Подвал сайта ​

Копирайт слева, служебные ссылки справа — привычная раскладка, которую ищут внизу страницы. Высота задаётся содержимым, height подсказывает макету ожидаемое значение до первого замера.

Sandbox Storybook

Панель действий формы ​

На длинной форме кнопки «Отмена» и «Опубликовать» живут в подвале: они видны на любой прокрутке, и до них не нужно добираться. CdsToolbarTitle растягивается и прижимает кнопки к правому краю, elevated отделяет панель от полей.

Sandbox Storybook

API ​

Пропсы

ИмяТипПо умолчаниюОписание
bgColorstring | undefined—Цвет фона компонента
borderedboolean | undefinedfalseОтображение границы.
colorstring | undefined—Цвет компонента
elevatedboolean | undefinedfalseОтображение тени.
heightstring | number | undefined50Высота элемента.
modelValueboolean | undefinedtrueВидимость элемента в макете.
revealboolean | undefinedfalseПлавающий режим: элемент появляется/скрывается при скролле.
revealOffsetnumber | undefined250Порог скролла (px), до которого плавающий элемент остаётся видимым.
themestring | undefined—Тема компонента

События

ИмяТипОписание
focusin[event: FocusEvent]Фокус внутри подвала.
reveal[value: boolean]Изменение видимости плавающего подвала.

Слоты

ИмяТипОписание
defaultanyСодержимое подвала (CdsToolbar и др.).