Скелетон — временная заглушка, которая показывает примерную форму содержимого при загрузке. Подходит, если заранее известно расположение элементов.
<kbq-skeleton> — базовый элемент, простой прямоугольный блок. Ширина и высота настраиваются с помощью CSS-стилей. Несколько блоков можно объединить в собственную композицию, если нет подходящего шаблона.
Шаблоны — готовые заглушки для компонентов Koobiq. Их можно сочетать, чтобы создать заглушку целой страницы.
KbqSkeletonTypography формирует заглушку с высотой строк, соответствующей выбранному стилю типографики Koobiq. Если строк несколько, их ширина чередуется случайным образом — неровный правый край создает большее сходство с абзацем текста.
Заглушки для кнопки, бейджа, тега, иконки и ссылки повторяют высоту компонентов, а ширину можно настроить.
KbqSkeletonGroup показывает ряд однотипных заглушек: кнопок, бейджей, тегов, иконок или ссылок.
Компонент KbqSkeletonDl показывает заглушку для набора параметров и их значений.
Во время загрузки таблицы или AG grid компонент KbqSkeletonTable имитирует структуру таблицы. Можно настроить:
Компонент KbqSkeletonFormField работает как единая заглушка для подписи, поля и подсказки под полем. Шаблон поддерживает многострочное поле и расположение подписи слева.
Шаблон KbqSkeletonAccordion отображает заглушку компонента Accordion. Группы представлены в свернутом виде.
Шаблон KbqSkeletonCheckable показывает в упрощенном виде подпись и компонент Checkbox, Radio button или Toggle. Дополнительно можно отобразить подсказку.
KbqSkeletonTabs создает заглушку для вкладок. Содержимое вкладки можно настраивать. По умолчанию оно представлено в виде текста.
KbqSkeletonTree показывает заглушку для иерархического списка. Второй узел раскрыт для отображения вложенности.
Провайдер kbqSkeletonPresetsConfigurationProvider настраивает шаблоны для всего приложения или отдельных страниц.
import { kbqSkeletonPresetsConfigurationProvider } from '@koobiq/components/skeleton';
@Component({
providers: [
kbqSkeletonPresetsConfigurationProvider({
typographyLines: 1,
dlRows: 3,
tableRows: 3,
tableColumns: 3,
groupCount: 3,
accordionRows: 3,
checkableRows: 1,
tabsCount: 3,
tabsContentLines: 3,
treeRows: 3,
treeChildren: 3
})
]
})Директива kbqSkeleton превращает загруженные элементы и содержимое в заглушки, которые учитывают их размер.
Во время загрузки на месте блока кода отображается скелетон фиксированной высоты.
Данные загружаются частями. Заглушки скрываются по мере обновления.
Скелетон подходит, если:
Скелетон не подходит: