Скелетон — временная заглушка, которая показывает примерную форму содержимого при загрузке. Подходит, если заранее известно расположение элементов.

<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 превращает загруженные элементы и содержимое в заглушки, которые учитывают их размер.

Denial-of-service attack
Critical
Protection is enabled on three servers
In computing, a denial-of-service attack (DoS attack) is a cyber-attack in which the perpetrator seeks to make a machine or network resource unavailable to its intended users by temporarily or indefinitely disrupting services of a host connected to a network.

Во время загрузки на месте блока кода отображается скелетон фиксированной высоты.

Данные загружаются частями. Заглушки скрываются по мере обновления.

Скелетон подходит, если:

  • структура страницы или ее раздела известна заранее, а данные загружаются впервые;
  • загрузка занимает несколько секунд.

Скелетон не подходит:

  • для быстрой загрузки (менее 1 секунды). В таком случае скелетон вызовет мерцание интерфейса;
  • для реакции на действия пользователя. Например, для сохранения, удаления или отправки формы подходит круговой индикатор;
  • для длительных процессов. Например, для конвертации файлов или передачи данных подходит полоса загрузки или круговой индикатор;
  • если при обновлении возможно оставить прежнее содержимое на экране. Состояние обновления отображают отдельно;
  • если загрузка уже обозначена другим индикатором.
Предложения по улучшению
Если вы нашли ошибку или хотите доработать статью, создайте запрос на GitHub.