Заголовок представления
Свойство title в спецификации представления Vega-Lite добавляет к диаграмме описательный заголовок. Его можно задать строкой или объектом со свойствами заголовка.
У следующей столбчатой диаграммы заголовок «Простая столбчатая диаграмма» задан строкой:
Свойства объекта заголовка
Объект title может содержать следующие свойства:
| Свойство | Тип | Назначение |
|---|---|---|
text |
Text или ExprRef | Текст заголовка. Тип Text допускает строку или массив строк. |
align |
Align | Горизонтальное выравнивание текста заголовка: "left", "center" или "right". |
anchor |
TitleAnchor | Опорная позиция заголовка: "start", "middle" или "end". Например, при размещении сверху они соответствуют выравниванию слева, по центру и справа. По умолчанию: "middle" для одиночных и многослойных представлений, "start" для остальных составных представлений. Примечание оригинала: настройка anchor доступна только для одиночных и многослойных представлений; в остальных составных представлениях всегда используется "start". |
angle |
number или ExprRef | Угол поворота текста заголовка и подзаголовка в градусах. |
baseline |
TextBaseline | Вертикальная базовая линия текста заголовка и подзаголовка: "alphabetic" (по умолчанию), "top", "middle", "bottom", "line-top" или "line-bottom". Последние два значения похожи на "top" и "bottom", но рассчитываются относительно lineHeight, а не только fontSize. |
color |
Color, null или ExprRef | Цвет текста заголовка. |
dx |
number или ExprRef | Дополнительное смещение координаты x текста заголовка и подзаголовка. |
dy |
number или ExprRef | Дополнительное смещение координаты y текста заголовка и подзаголовка. |
font |
string или ExprRef | Имя шрифта заголовка. |
fontSize |
number или ExprRef | Размер шрифта заголовка в пикселях. |
fontStyle |
FontStyle или ExprRef | Начертание шрифта заголовка. |
fontWeight |
FontWeight или ExprRef | Насыщенность шрифта заголовка: строка, например "bold" или "normal", либо число 100, 200, 300, …, 900. Значению "normal" соответствует 400, а "bold" — 700. |
frame |
TitleFrame, string или ExprRef | Область отсчёта для опорной позиции: "bounds" — полная ограничивающая область, "group" — ширина или высота группы. |
limit |
number или ExprRef | Максимальная допустимая длина текста заголовка и подзаголовка в пикселях. |
lineHeight |
number или ExprRef | Высота строки в пикселях для многострочного заголовка либо текста с базовой линией "line-top" или "line-bottom". |
offset |
number или ExprRef | Смещение группы заголовка в пикселях перпендикулярно краю диаграммы, вдоль которого она располагается. |
orient |
TitleOrient или ExprRef | Сторона размещения заголовка: "top", "bottom", "left" или "right". |
style |
string или string[] | Стиль примитива, применяемый к тексту заголовка. По умолчанию: "group-title". |
subtitle |
Text | Текст подзаголовка: строка или массив строк. |
subtitleColor |
Color, null или ExprRef | Цвет текста подзаголовка. |
subtitleFont |
string или ExprRef | Имя шрифта подзаголовка. |
subtitleFontSize |
number или ExprRef | Размер шрифта подзаголовка в пикселях. |
subtitleFontStyle |
FontStyle или ExprRef | Начертание шрифта подзаголовка. |
subtitleFontWeight |
FontWeight или ExprRef | Насыщенность шрифта подзаголовка: строка, например "bold" или "normal", либо число 100, 200, 300, …, 900. Значению "normal" соответствует 400, а "bold" — 700. |
subtitleLineHeight |
number или ExprRef | Высота строки многострочного подзаголовка в пикселях. |
subtitlePadding |
number или ExprRef | Расстояние в пикселях между заголовком и подзаголовком. |
zindex |
number | Целочисленный индекс, определяющий порядок отрисовки группы заголовка относительно групп осей, примитивов и легенд. По умолчанию: 0. |
Например, значение "anchor": "start" сдвигает заголовок к началу области размещения:
// Спецификация представления верхнего уровня
{
...,
"config": {
"title": {
...
}
}
}
Конфигурация заголовков
Чтобы задать общую тему оформления всех заголовков, конфигурация заголовка (config: {title: {...}}) поддерживает все свойства заголовка.