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

• У объекта есть своя страница: проект, документ, группа, пакет.
• Человеку нужно сразу понять, что перед ним, в каком оно состоянии и что с ним можно сделать.
• У объекта есть одно главное действие — команда установки, «Настройки», «Опубликовать».

Не берите шапку объекта для страницы-списка или раздела настроек — там нужен заголовок страницы. Запись внутри списка показывает сводка.

Полная шапка#

Имя обязательно. Иконка стоит перед именем, Подпись — вид объекта мелко рядом. Под ними идут Плашки, Описание, Мета и Команда — блок команды с копированием.

В дереве холста шапка собирается словами: имя позицией, действия — детьми, а каждая плашка и каждый пункт меты — своим словом (см. Язык узлов).

Вид — слаг объекта для атрибута data-kind: строчная латиница, цифры и дефис. Своего оформления у вида нет, атрибут нужен листу и скриптам инсталляции. Слаг с другими символами в разметку не попадает.

Другой объект#

Другой объект — другой значок, подпись и слаг. Шапка та же: кит не держит словаря видов.

Признак у имени#

Признаки — значки сразу за именем, в той же строке заголовка: подписан, закреплён, проверен. Это свойство самого имени, поэтому место ему — у имени, а не среди плашек состояния. Значок размером с букву стоит по средней линии и держится за последний символ имени: на новую строку один он не уходит.

Подпись признака обязательна: без неё кит бросает исключение. Признак с неизвестным глифом не печатается.

Действия#

Действия — кнопки справа от имени; на узком экране они переносятся под него. Это доверенная разметка, собранная компонентом кнопка.

Гайдлайны#

Действия = Набор.Кнопка().Отрисовать(Новый Структура("Подпись, Вариант", "Настройки", "вторичная"))
	+ Набор.Кнопка().Отрисовать(Новый Структура("Подпись, Иконка", "Опубликовать", "стрелка"));

HTML = Набор.ШапкаОбъекта().Отрисовать(Новый Структура("Имя, Подпись, Действия",
	"годовой-отчёт", "документ", Действия));

Действия = Набор.Кнопка().Отрисовать("Настройки")
	+ Набор.Кнопка().Отрисовать("Опубликовать")
	+ Набор.Кнопка().Отрисовать("Скачать");

HTML = Набор.ШапкаОбъекта().Отрисовать(Новый Структура("Имя, Подпись, Действия",
	"годовой-отчёт", "документ", Действия));

Признаки = Новый Массив();
Признаки.Добавить(Новый Структура("Иконка, Подпись", "замок", "Подписан ключом издателя"));

Плашки = Новый Массив();
Плашки.Добавить(Новый Структура("Текст, Вид", "устаревший", "warn"));

HTML = Набор.ШапкаОбъекта().Отрисовать(Новый Структура("Имя, Признаки, Плашки",
	"годовой-отчёт", Признаки, Плашки));

Плашки = Новый Массив();
Плашки.Добавить(Новый Структура("Текст, Вид", "подписан", "ok"));
Плашки.Добавить(Новый Структура("Текст, Вид", "устаревший", "warn"));

HTML = Набор.ШапкаОбъекта().Отрисовать(Новый Структура("Имя, Плашки",
	"годовой-отчёт", Плашки));

HTML = Набор.ШапкаОбъекта().Отрисовать(Новый Структура("Имя, Подпись, Описание",
	"отчёт", "документ", "Сводный отчёт за период"));

HTML = Набор.ШапкаОбъекта().Отрисовать(Новый Структура("Имя, Подпись, Описание",
	"отчёт", "документ", "Этот документ содержит сводный отчёт за выбранный период, "
	+ "собранный из всех проектов, в которых вы участвуете, с учётом прав доступа, "
	+ "фильтров и настроек, сохранённых в вашем профиле, и обновляется каждую ночь."));

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

• Имя печатается <h1>. На странице объекта это единственный <h1>: другие заголовки — второго уровня и ниже.
• Шапка печатается <header> с классом objhead.
• Признак у имени — значок с role="img" и <title> из подписи: это и доступное имя, и всплывающая подсказка.
• Значок перед именем и значки меты декоративны. В мете подпись звучит скрытым текстом, как в ряду меты.
• Без Имени кит шапку не соберёт: страница объекта осталась бы без заголовка.

Узлом холста#

На холсте действия шапки кладут детьми узла, а признак у имени — словом Знак(Иконка, Подпись).

Модель#

Структура ниже — прежний вид модели; в дереве холста её поля пишут слова Кит.ШапкаОбъекта, а Действия становятся детьми узла.

Отрисовывает шапку объекта.

Параметры:
 Модель - Структура - Имя (ОБЯЗАТЕЛЬНО), Вид (слаг для data-kind: строчная латиница,
          цифры и дефис; всё прочее в разметку не попадает), Иконка (имя из НаборИконок),
          Подпись (подпись вида рядом с именем), Описание, Плашки (массив моделей
          компонента Плашка), Мета (массив структур Подпись, Значение, Значок, Адрес —
          с адресом значение становится ссылкой), Команда (модель БлокКоманды, главный
          CTA), Действия (ДОВЕРЕННЫЙ HTML кнопок), Признаки (массив структур Иконка,
          Подпись — значки сразу за именем в той же строке: имя глифа из НаборИконок
          и подпись, она же доступное имя и всплывающая подсказка значка; значок
          держится за последний символ имени и на новую строку один не уходит;
          признак с неизвестным глифом не печатается).

Возвращаемое значение:
 Строка - фрагмент <header class="objhead">. Кидается исключением, если Имя пусто
          либо у признака нет подписи.

Шапка объекта — первый экран проекта, группы, участника; дети узла становятся её
действиями. Слова: Иконка, Описание, Подпись, Вид (слаг для data-kind), Знак(Иконка,
Подпись), Мета(Подпись, Значение, Значок, Адрес), Плашка(узел | текст), Команда(Текст).

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

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