Блоки

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

Что такое блок

У каждого блока есть номер (чтобы на него можно было сослаться), тип (что это за блок), заголовок (необязательный), ширина, настройки содержимого и, если нужно, действия-кнопки. Ширина считается по сетке из 12 частей: 12 — на всю ширину страницы, 6 — половина, 4 — треть. Так рядом можно поставить два или три блока.

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

Все 29 типов блоков

Типы собраны в шесть групп. Ниже — что делает каждый из них.

ТипГруппаЧто это
markdownтекст и структураосновной текст: абзацы, списки, выделения, ссылки, схемы-диаграммы, картинки и файлы прямо в тексте
journalтекст и структуражурнал записей: строки дописывают сами читатели — по строке на запись, без агента
headingтекст и структураподзаголовок внутри страницы, с уровнем от 1 до 4
heroтекст и структуракрупный заголовок-баннер с подписью и кнопками, при желании с картинкой
calloutтекст и структуравыделенный блок-обращение: подсказка, предупреждение, важное замечание
quoteтекст и структурацитата с автором и должностью
listтекст и структурасписок: маркированный, нумерованный или с галочками
icon-gridтекст и структурасетка одинаковых карточек: значок, заголовок, короткий текст
dividerтекст и структураразделитель или пустой отступ между частями страницы
tabsтекст и структуранесколько вкладок с разным содержимым, открыта одна
accordionтекст и структурасвёрнутые блоки-«гармошки»: раскрывается тот, что нужен
timelineтекст и структуралента событий по датам на вертикальной линии
stepperтекст и структурапошаговая инструкция с нумерованными кружками
imageмедиаодна картинка с подписью, при желании — ссылкой
galleryмедианабор картинок сеткой, с просмотром крупно
sliderмедиакарусель слайдов со своими кнопками на каждом
videoмедиавидео с вашего сервера или с внешнего сервиса
filesмедиасписок файлов на скачивание с размером и подписью
embedмедиавстроенный чужой блок: карта, форма, внешний сервис
cardsнавигациякарточки-ссылки на другие страницы портала
tableданныетаблица с колонками и строками, с закреплённой шапкой; помещается в ширину страницы — текст в ячейках переносится, а прокрутка вбок остаётся только там, где иначе никак; у ячеек бывают значки, цвет и кнопки, у строки — свой цвет; отдельные ячейки агент может открыть для правки прямо на странице
peopleданныекарточки сотрудников: фото, имя, должность, контакты
kpiданныеплитки с главными цифрами: показатель, единица, изменение
feedданныелента записей: дата, заголовок, короткий текст, картинка
vizданныевизуализация из вашей базы: 33 вида — показатель, шкала, таблица, график, карта и другие
actionsдействиятолько кнопки, без собственного содержимого
chartдинамическиеграфик, данные для которого считает скрипт
scriptдинамическиеготовый текст, который собирает скрипт
formдинамическиеформа с полями и кнопкой отправки

Какие блоки умеют считать данные

Данные на страницу приходят двумя путями. Первый — расчётный скрипт: семь типов блоков могут брать содержимое не из текста, а из программы на Python. Это значит, что цифры на странице всегда свежие — из вашей системы, а не вбитые руками. Считать данные умеют: list (список), table (таблица), kpi (плитки с цифрами), feed (лента записей), chart (график), script (готовый текст) и form (форма).

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

Что общего у всех блоков

  • Заголовок — необязательный. Если он есть, над содержимым появляется название блока.
  • Ширина — от 1 до 12 частей страницы. По умолчанию блок занимает всю ширину.
  • Кнопки действий — до трёх на блок. Это может быть ссылка, переход по порталу, запрос агенту или запуск скрипта (см. Кнопки и действия).
  • Подвал со свежестью — у блоков с расчётными данными и у визуализаций внизу видно, когда данные обновились, и есть кнопка обновления.

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

Оформление внутри списков, таблиц и карточек

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

Ссылка внутри карточки срабатывает сама: нажатие ведёт по ней, а не открывает карточку целиком. Ссылки в тексте, в карточках и в лентах открываются в той же вкладке — читатель не теряет место, где читал; новая вкладка появляется только там, где так задумано: у кнопки-перехода с настройкой «в новой вкладке», у визуализации или у ячейки таблицы. А оформление остаётся одной строкой — список или отдельный абзац внутри ячейки или карточки не появится, иначе таблица поехала бы. Сами таблицы помещаются в ширину страницы: текст в ячейках переносится, и читать строку удобно без прокрутки вбок.

Записи, которые ведут сами читатели

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

Дописывается журнал так же привычно, как заметки: поле ввода внизу, Enter — и запись на месте. Начали список — он продолжается сам: маркер или номер подставляется, и каждая следующая запись встаёт в тот же список. Пустая строка — тоже строка: она видна, и её можно поправить или удалить, так что записи удобно разделять отступами. Правка — щелчком по строке (на телефоне — вторым касанием), Enter сохраняет, Shift+Enter переносит строку, Backspace в начале строки склеивает её с предыдущей. Удаление срабатывает сразу, без вопросов. Всё это видно мгновенно, не дожидаясь ответа сервера; если сохранить не удалось, ничего не теряется — текст вернётся в поле или в строку, а ошибка будет сказана словами.

Второй — правимая ячейка таблицы. Агент отмечает нужные ячейки, и в них появляется карандаш: щёлкнули — поправили — Enter. Так удобно держать в таблице то, что меняется часто: статус, ответственного, дату. Значки, цвет и кнопки в ячейке при правке остаются на месте. Работает это только для вошедших в портал и только на обычных страницах: на публичном сайте, в таблицах со считающимися данными и на страницах-образцах ячейки и журнал показываются только для чтения — иначе одна запись меняла бы сразу все адреса образца.

Обе правки сохраняются сразу в файлы страницы и попадают в историю версий наравне с правками агента. Поэтому в записи и в ячейках не подставляются переменные страницы: текст сохраняется ровно так, как его набрали. Агент при этом продолжает работать: если он добавит запись выше вашей, ваша правка всё равно применится к своей строке.

Если блок сломался

Один неудачный блок никогда не ломает страницу целиком. Незнакомый тип показывается спокойной пометкой с названием типа и надписью Этот блок управляется агентом. А если блок не смог отобразиться из-за ошибки, на его месте появляется сообщение Не удалось отобразить блок с кнопкой Копировать подробности — эту подсказку можно передать агенту, чтобы он поправил. Все остальные блоки страницы при этом рисуются как обычно.

Где посмотреть примеры

Все 29 типов собраны в демонстрационном портале: там есть и карусель, и вкладки, и графики, и формы — на живых примерах видно, как блок ведёт себя в деле. Попросите агента открыть этот демонстрационный набор, если хотите посмотреть тип блока перед тем, как ставить его на свою страницу.

Дальше: как кнопки на блоках ведут себя — в разделе Кнопки и действия; откуда берутся живые цифры — в разделе Источники данных и визуализации; как считать данные для блоков — в разделе Динамические блоки на Python; как проверяются блоки — в разделе Проверки страниц.

← Оглавление документации