Таблица деревом

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

• Записи с одинаковыми полями, которые сравнивают по колонкам: проекты, участники, ключи.
• В ячейке нужно больше, чем строка: плашка состояния, ссылка, два этажа значения, меню строки.
• Список длинный и должен читаться на телефоне — вид «карточками».

Не берите таблицу для сведений об одном объекте — для этого есть свойства. Модель компонента «Таблица», собранного одной структурой, описана на странице Таблица.

Таблица из данных#

Кит.Таблица(Данные) собирает таблицу сама. Данные — таблица значений: колонки и их заголовки берутся из неё (заголовок колонки, по умолчанию её имя), записи — её строки, ячейка — свойство строки по имени колонки.

Что печатается в ячейке:

• строка — текст (экранируется);
• узел — узел; несколько узлов кладут Кит.Холст(…);
• число — без разделителя групп;
• Неопределено и "" — пустая ячейка, а со словом .Пустое(Текст) — этот текст приглушённой надписью (см. «Прочерк в пустой ячейке»).

Дату и Булево кит не форматирует: в каком виде их показать, решает экран. Такое значение останавливает печать исключением, и оно называет колонку.

Данные — массив структур или соответствий: у записи-структуры нет порядка полей, поэтому колонки объявляются словом .Колонка(Ключ, Заголовок) в порядке вызовов. Без объявленных колонок такая таблица не печатается. У таблицы значений слово Колонка находит её колонку и даёт переопределить заголовок и вид.

Колонку, которую показывать не нужно, снимает слово .Когда(Ложь) — вместе с ячейками под ней.

Прочерк в пустой ячейке#

Пустая ячейка в столбце значений читается как недосмотр: значения нет или оно не загрузилось? Слово .Пустое(Текст) у таблицы из данных печатает в ячейке со значением Неопределено или "" этот текст приглушённой надписью — обычно прочерк. Такая ячейка уже не пустая: в таблице карточками она стоит с подписью своей колонки, а не прячется. Разворот прочерка не получает: пустой разворот значит «разворота нет». Без слова — прежняя пустая ячейка, байт в байт.

Прочерк одной колонки задаёт то же слово у колонки — Таблица.Колонка(…).Пустое(Текст): он стоит поверх прочерка таблицы. Пустое("") у колонки снимает прочерк: так пустой остаётся колонка действий, где пусто значит «действия нет», а не «значения нет».

В ручной сборке ячейки собирает автор, поэтому слово там не принимается: прочерк кладут в ячейку сами — Кит.Ячейка(Кит.Надпись("—").Вид("приглушённая")).

Разворот из данных#

.Разворот(ИмяКолонки) называет колонку, чьё значение печатается не ячейкой, а строкой под записью во всю ширину таблицы. Пустое значение разворота не даёт.

Колонки, записи, ячейки#

Таблица собирается и узлами. Порядок рода строгий: в таблицу кладут колонки и записи, в запись — только ячейки. Ячейка — холст. Запись с узлом другого рода (и со строкой) кит не соберёт: такой узел исчез бы с экрана молча.

У записи есть второй холст — разворот, слово Разворот(д…). Он печатается отдельной строкой под записью во всю ширину таблицы. Пустой разворот не печатается.

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

Пустая таблица#

Таблица без записей печатает вместо себя содержимое слова Пусто(…). Строка становится примечанием вида «пусто», узлы кладутся как есть. Пустая шапка над пустым телом — рамка, в которой человеку нечего прочесть.

Когда пустой список — первый экран и человеку есть что сделать, положите в Пусто(…) компонент «Пустое состояние» с действием.

Виды записи, колонки и ячейки#

Выделенная запись залита цветом: одна строка списка отвечает на вопрос, ради которого список открыли («проект по умолчанию»). Узкая колонка и узкая ячейка сжимаются по содержимому — под значок, галочку, счётчик. В таблице из данных узкая колонка сужает и свои ячейки.

Колонка чисел#

Числа в таблице выравнивают по правому краю: разряды встают друг под другом, и 1 204 от 87 отличают взглядом, не читая. Колонка вида «число» (.Вид("число")) так и печатается: заголовок и ячейки — по правому краю, цифры одной ширины (tabular-nums), строка не рвётся. В таблице из данных вид колонки переходит её ячейкам; в ручной сборке ячейке дают тот же вид — Кит.Ячейка(…).Вид("число"). Стрелка сортировки у такого заголовка стоит слева от подписи — подпись остаётся над числами.

В таблице карточками на телефоне число — обычная строка под подписью колонки, слева: справа оно оторвалось бы от своей подписи. Разделитель групп разрядов (1 204) кит в число из данных не ставит — нужен он, отформатируйте число строкой (Формат(Ч, "ЧГ=3")) и оставьте колонке вид «число».

Ячейка «величина» — число с единицей: не переносится и приглушена. Ячейка «столбиком» — два этажа: значение и приписка под ним.

Таблица карточками#

Вид «карточками» на узком экране (до 720 пикселей) печатает запись карточкой. Шапки у неё нет, поэтому ячейка сама несёт подпись своей колонки. Подписи нет у заглавной ячейки, у пустой и у ячейки с меню строки.

Заглавная ячейка стоит первой строкой карточки и крупнее остальных: по ней запись узнают. По умолчанию это первая колонка, другую называет слово .Заглавная() у колонки. У таблицы из данных это слово колонки из Таблица.Колонка(Ключ). Ячейка с меню строки встаёт в правый верхний угол карточки, а лист с пунктами меню на телефоне выезжает снизу, как и раньше.

Колонка, чьи значения называют себя сами («занято 12 КБ из 100», плашка «активна»), от подписи отказывается словом БезПодписиВЗаписи(). Угадывать это по значению кит не берётся. Сузьте окно, чтобы увидеть карточки.

Сортировка колонки#

Слово Сортировка(Адрес, Порядок) у колонки делает её заголовок ссылкой: адрес — тот же список, отсортированный по этой колонке. Порядок — как список отсортирован сейчас: "возр", "убыв" или пустой — не по этой колонке. У отсортированной колонки th получает aria-sort (ascending или descending), и лист рисует стрелку порядка; у прочих стрелка проявляется на наведении и фокусе. Адрес собирает вызывающий: только он знает, как его список называет порядок и какой отбор сохранить. Обычно у отсортированной колонки ссылка ведёт на обратный порядок, у прочих — на прямой, а номер страницы сбрасывается.

Слово БезПерезагрузки() у таблицы (или у одной колонки) делает ссылки сортировки тихими: признак data-quiet встаёт на ссылки, скрипт берёт отсортированный список запросом в фоне и кладёт на место, адрес уходит в историю вкладки. Без скрипта это обычные ссылки. Живой образец с пагинацией и строкой поиска — список проектов.

Неизвестный порядок ("asc") останавливает сборку с перечнем известных; адрес с опасной схемой ссылкой не печатается — заголовок остаётся текстом.

Гайдлайны#

Проекты = Новый ТаблицаЗначений;
Проекты.Колонки.Добавить("Имя");
Проекты.Колонки.Добавить("Состояние");
Проект = Проекты.Добавить();
Проект.Имя = Кит.Код("альфа");
Проект.Состояние = Кит.Плашка("открытый").Вид("ok");
HTML = Кит.Таблица(Проекты).Пусто("Проектов нет.").Рендер();

Таблица = Кит.Таблица(Кит.Колонка("Имя"), Кит.Колонка("Состояние"));
Для Каждого Имя Из СтрРазделить("альфа", ",") Цикл
	Запись = Таблица.Добавить(Кит.Запись());
	Запись.Добавить(Кит.Ячейка()).Добавить(Кит.Код(Имя));
	Запись.Добавить(Кит.Ячейка()).Добавить(Кит.Плашка("открытый").Вид("ok"));
КонецЦикла;
Таблица.Пусто().Добавить(Кит.Примечание("Проектов нет.").Вид("пусто"));
HTML = Таблица.Рендер();

HTML = Кит.Таблица(Кит.Колонка("Имя"), Кит.Колонка("Состояние"))
	.Пусто("По запросу «бета» ничего не найдено").Рендер();

HTML = Кит.Таблица(Кит.Колонка("Имя"), Кит.Колонка("Состояние")).Рендер();

HTML = Кит.Таблица(
	Кит.Колонка("Имя"),
	Кит.Колонка("Состояние"),
	Кит.Запись(Кит.Ячейка(Кит.Код("архив-2024")), Кит.Ячейка(Кит.Плашка("устарел").Вид("warn"))))
	.Рендер();

HTML = Кит.Таблица(
	Кит.Колонка("Имя"),
	Кит.Колонка("Состояние"),
	Кит.Запись(Кит.Ячейка("архив-2024"), Кит.Ячейка("устарел"))).Рендер();

Доступность#

• Колонка печатается th scope="col": скринридер называет заголовок колонки перед каждой ячейкой.
• Сортируемая колонка — ссылка в заголовке, текущий порядок — aria-sort у th: скринридер говорит «по возрастанию» вместе с заголовком. aria-sort стоит у одной колонки за раз, как велит ARIA; стрелка декоративна, смысл несёт атрибут.
• Подпись таблицы (Таблица.Подпись("…")) печатается caption — именем таблицы для скринридера.
• Колонку без подписи (узкую, под значок) называет содержимое ячеек: значку дайте подпись, она станет его доступным именем.
• Таблица обёрнута прокруткой: широкая таблица не ломает страницу на узком экране.

Справка#

Таблица — раскладка списка. Из данных, как в 1С: таблица значений даёт колонки
(заголовок колонки, по умолчанию имя) и записи (её строки, ячейка — свойство строки
по имени колонки); массив структур или соответствий даёт записи, а колонки объявляются
словом Колонка(Ключ, Заголовок). Значение ячейки: строка — текст, узел — узел (несколько
узлов кладут Кит.Холст), число — без разделителя групп, Неопределено и "" — пустая
ячейка; дату и Булево форматирует вызывающий. Без данных таблица собирается руками
из Кит.Колонка и Кит.Запись. Слова: Вид («карточками» — на узком экране запись
становится карточкой, а ячейка несёт подпись своей колонки), Колонка, Пусто(д…),
Разворот(ИмяКолонки).

Параметры:
 Р1    - ТаблицаЗначений, Массив, ЭлементЭкрана, Неопределено - данные таблицы либо
         первый ребёнок ручной сборки.
 Р2…Р8 - ЭлементЭкрана - (необязательные) колонки и записи ручной сборки.

Возвращаемое значение:
 ЭлементЭкрана

Колонка — заголовок столбца. Холст: заголовок бывает не только текстом. Вид словом:
«узкая» (столбец сжимается по содержимому и не переносится) | «число» (заголовок и
ячейки по правому краю, цифры одной ширины; в таблице из данных вид переходит
ячейкам) | "" (обычная). Слово
Сортировка(Адрес, «возр» | «убыв» | "") делает заголовок ссылкой сортировки с aria-sort
(выпуск 0.13).

Параметры:
 Подпись    - Строка - текст заголовка; пустой оставляет колонку без подписи.
 Устаревший - Неопределено - не задаётся: вид колонки теперь словом Вид(…).

Возвращаемое значение:
 ЭлементЭкрана

Запись — строка таблицы: в неё кладут ячейки. Развёрнутая подробность записи
наполняется словом Разворот(д…) и печатается строкой под ней во всю ширину. Вид
словом: «выделенная» (строка залита цветом: одна запись списка отвечает на вопрос,
ради которого список открыли) | "" (обычная).

Параметры:
 Р1…Р8 - ЭлементЭкрана - (необязательные) ячейки.

Возвращаемое значение:
 ЭлементЭкрана

Ячейка — холст внутри записи: в неё кладут любые элементы, а не готовую разметку. Вид
словом: «величина» (число с единицей: не переносится, приглушено) | «столбиком»
(двухэтажная ячейка: строка значения и приписка под ней) | «узкая» (ячейка сжимается
по содержимому: значок, галочка, счётчик) | «число» (по правому краю, цифры одной
ширины — под колонкой вида «число») | "" (обычная).

Параметры:
 Р1…Р8 - ЭлементЭкрана, Строка - (необязательные) содержимое; строка — текст.

Возвращаемое значение:
 ЭлементЭкрана

Колонка таблицы из данных. У таблицы значений колонка уже есть — слово находит её и даёт
переопределить заголовок; у массива колонки объявляются этим словом в порядке вызовов.

Параметры:
 Ключ      - Строка - имя колонки таблицы значений либо ключ структуры записи.
 Заголовок - Строка - (необязательный) заголовок столбца; у таблицы значений по умолчанию
             её заголовок колонки, у массива — пусто.

Возвращаемое значение:
 ЭлементЭкрана - узел колонки: слова Вид(«узкая»), БезПодписиВЗаписи, Когда.

Разворот. У записи таблицы — отдельный холст, который печатается строкой под записью
во всю ширину таблицы (пустой разворот не печатается вовсе); с аргументами наполняет его
и возвращает саму запись. У таблицы из данных — имя колонки, чьё значение печатается
разворотом под записью, а не ячейкой.

Параметры:
 Р1 - ЭлементЭкрана, Строка, Неопределено - (необязательный) у записи — содержимое
      разворота (до Р8); у таблицы из данных — имя колонки разворота.
 Р2 - ЭлементЭкрана, Строка, Неопределено - (необязательный)
 Р3 - ЭлементЭкрана, Строка, Неопределено - (необязательный)
 Р4 - ЭлементЭкрана, Строка, Неопределено - (необязательный)
 Р5 - ЭлементЭкрана, Строка, Неопределено - (необязательный)
 Р6 - ЭлементЭкрана, Строка, Неопределено - (необязательный)
 Р7 - ЭлементЭкрана, Строка, Неопределено - (необязательный)
 Р8 - ЭлементЭкрана, Строка, Неопределено - (необязательный)

Возвращаемое значение:
 ЭлементЭкрана - у записи без аргументов холст разворота, иначе этот же элемент.

Прочерк в пустой ячейке таблицы из данных: значение Неопределено или пустая строка
печатается этим текстом приглушённой надписью, а не пустотой. Ячейка с прочерком
не пустая: в таблице карточками она стоит с подписью своей колонки. В ручной сборке
ячейки собирает автор, поэтому там слово не принимается.
У колонки (Таблица.Колонка(…).Пустое(…)) слово задаёт прочерк одной этой колонки поверх
прочерка таблицы; Пустое("") снимает его у колонки — ячейка меню или действий, где
пусто значит «действия нет», а не «значения нет».

Параметры:
 Текст - Строка - прочерк, например "—" (экранируется при печати); у колонки "" — без прочерка.

Возвращаемое значение:
 ЭлементЭкрана - эта же таблица (колонка).

Колонка сортирует список: заголовок становится ссылкой на адрес, а колонка, по которой
список уже отсортирован, получает aria-sort. Адрес собирает вызывающий: только он знает,
как его список называет порядок и что ещё в адресе сохранить. Обычно у отсортированной
колонки ссылка ведёт на обратный порядок, у прочих — на прямой.

Параметры:
 Адрес_  - Строка - адрес списка, отсортированного по этой колонке.
 Порядок - Строка - (необязательный) как список отсортирован сейчас: «возр», «убыв»
           или "" — не по этой колонке.

Возвращаемое значение:
 ЭлементЭкрана - этот же элемент.

Холст, который таблица печатает ВМЕСТО себя, когда записей в ней нет. Строка одна —
примечание вида «пусто»; узлы наполняют холст как есть. У реестра строка одна —
пояснение его пустого состояния. У поля выбора значка — вариант «без значка» первой
ячейкой: Р1 — его подпись (пусто — словарь iconpicker.none), Р2 — свой значок пустого
варианта (дев-сборка 10): приглушённый глиф вместо перечёркнутого круга и видимая подпись
рядом — «По издателю» у провайдера входа, где пусто значит «подберётся сам».

Параметры:
 Р1 - ЭлементЭкрана, Строка, Неопределено - (необязательный) текст или узлы пустой
      выдачи, до Р8.
 Р2 - ЭлементЭкрана, Строка, Неопределено - (необязательный)
 Р3 - ЭлементЭкрана, Строка, Неопределено - (необязательный)
 Р4 - ЭлементЭкрана, Строка, Неопределено - (необязательный)
 Р5 - ЭлементЭкрана, Строка, Неопределено - (необязательный)
 Р6 - ЭлементЭкрана, Строка, Неопределено - (необязательный)
 Р7 - ЭлементЭкрана, Строка, Неопределено - (необязательный)
 Р8 - ЭлементЭкрана, Строка, Неопределено - (необязательный)

Возвращаемое значение:
 ЭлементЭкрана - без аргументов холст пустой выдачи; с аргументами — эта таблица (реестр).

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

Возвращаемое значение:
 ЭлементЭкрана - этот же элемент.