Список сущностей

Список показывает однородные сущности, даёт сузить выдачу и перейти к любой из них. Строка сама несёт частые действия, поэтому за мелкой правкой не нужно открывать сущность целиком.

Статус: experimental · в системе с 2026-08

Когда использовать

  • Однородных сущностей больше, чем помещается на экран, и человек ищет среди них нужную.
  • Частые действия — включение, смена цены, дубль — делаются прямо из строки.

Не использовать:

  • Сущностей единицы и отбор не нужен.
  • Записи разнородны и не сравниваются по общим колонкам.
  • Нужна одна сущность целиком — это «Редактор сущности».

Состав

Юнит или компонентРоль
entity-idИдентификатор записи в строке.
popover-previewМиниатюра креатива с раскрытием в строке.
segmented-controlПереключение представления выдачи: строки или таблица.
titleЗаголовок блока отбора, выдачи или сводки над списком.
labelПодпись группы фильтров, счётчика или значения в строке.
user-lineВладелец или автор сущности в строке выдачи и ячейке таблицы.
cardИменованный блок отбора или группы строк с дочерними узлами.
islandПоверхность региона без заголовка: блок фильтров, сводка над таблицей.
chartСхематичная динамика над списком: форма тренда за период отбора.
textareaДлинное значение в отборе или быстрой правке строки: список идентификаторов, комментарий.
input-numberЧисловая граница отбора: ставка, лимит, порог показателя.
drag-and-dropПорядок строк, который задаёт человек: приоритет в списке отбора.
select-toggleОтбор значений режимом «включить или исключить» над выдачей.
user-cardВладелец строки: имя и идентификатор пользователя в выдаче.
action-panelРяд отбора над списком: контролы в теле, выбранные фильтры чипами в слоте.
selectСортировка и размер страницы.
inputПоиск по выдаче и переход к номеру страницы.
comboboxОтбор по значению из длинного справочника.
multi-selectОтбор сразу по нескольким значениям.
input-date-rangeОтбор по периоду: даты создания, активности, отчёта.
toolbarКоманды над выдачей одной строкой: обновить, настроить колонки, сменить представление.
toggle-buttonРежим выдачи, который включают и выключают: закреплённый фильтр, настройка колонок.
flipperНаправление сортировки и другие циклические режимы выдачи в тулбаре.
tagПрименённые фильтры и метки строки.
tableТабличное представление выдачи.
statusСостояние сущности в строке.
indicatorСчётчики выбранного в панели массовых действий и состояние строки одной точкой, когда подпись Status избыточна.
iconЗначок состояния в строке и ячейке: скрыто у превью, ошибка у значения.
thumbnailМиниатюра превью креатива в строке и ячейке выдачи; скрытое превью — значок EyeSlash в рамке.
extra-groupСводные счётчики строки через слеш: показы, клики, лимиты.
switchВключение сущности прямо из строки.
checkboxВыбор строки для массового действия; в таблице — первая колонка.
checkbox-groupНабор признаков в панели над выдачей: видимые колонки таблицы, режимы отбора.
avatarВладелец сущности в строке.
dividerГраница между частями строки или группами выдачи.
paginationПереход между страницами выдачи.
alertПричина пустой или неполной выдачи.
linkПереход к сущности и к связанным разделам.
buttonСоздание сущности, отбор, обновление выдачи и действия строки.
menuОстальные действия строки за одной кнопкой: дубль, добавить креатив, архив — поверх выдачи.
popoverБыстрая правка одного значения прямо из строки: цена, пополнение — поверх выдачи.
tooltipПояснение к значению или значку строки по наведению — поверх выдачи.
dialogПодтверждение архивации или другого необратимого действия над строкой — поверх выдачи.
drawerОтбор, который не помещается в ряд: поля фильтров панелью поверх выдачи.
column-settingsСостав и порядок колонок таблицы — поверх выдачи, по кнопке в ряду отбора.
entities-list-dialogМассив значений строками поверх поля отбора: список id, доменов, площадок.
toastРезультат действия над строкой без ухода из выдачи — поверх выдачи.

Ограничения

  • Обязательно: Держать отбор над выдачей, а переход по страницам — под ней: человек сначала сужает, потом листает.
  • Обязательно: Показывать панель массовых действий только при выбранных строках и называть в ней, сколько и чего выбрано: действие над невидимым набором — ошибка.
  • Обязательно: Показывать применённые фильтры отдельно от контролов отбора, чтобы их можно было снять по одному.
  • Обязательно: Сохранять размер страницы и порядок сортировки при переходе между страницами.
  • Рекомендуется: Давать строке только те действия, которые не требуют открывать сущность целиком.
  • Запрещено: Прятать пустую выдачу без объяснения: человек должен понять, отбор виноват или данных нет.
  • Запрещено: Делать номера страниц индикатором прогресса или этапов — это Steps.

Логика отклика

  1. Обзор Человек открывает раздел. Выдача показывает первую страницу в сохранённом порядке.
  2. Отбор Человек ищет или сужает выдачу фильтрами. Применённые фильтры собираются отдельной строкой, выдача пересобирается с первой страницы.
  3. Действие Человек меняет что-то прямо в строке. Строка отражает изменение, не теряя позицию в выдаче.
  4. Переход Человек листает страницы или открывает сущность. Размер страницы и порядок сохраняются; открытая сущность знает, откуда пришли.

Контекстный пример

Правильно

Отбор сверху, страницы снизу, действия в строке

Контролы отбора и применённые фильтры разделены, строка несёт частые действия, переход по страницам стоит под выдачей.

input tag status pagination

Неправильно

Фильтры вперемешку с выдачей

Контролы отбора соседствуют со строками, применённые фильтры не видны и снимаются только сбросом всего, а страницы листаются кнопкой посреди выдачи.

input button

Скелет экрана

  1. toolbarПредставление, поиск, сортировка и размер страницы.
  2. selectionДействия над выбранными строками: массовая смена состояния, счётчики выбранного, выбрать всё и снять выбор. Появляется, когда выбрана хотя бы одна строка.
  3. filtersПрименённые фильтры отдельной строкой, каждый снимается по отдельности.
  4. itemsСтроки выдачи в выбранном представлении.
  5. paginationПереход между страницами выдачи и её объём.
  6. actionsСоздание сущности и действия над всей выдачей; стоят в титульной строке страницы.