Заголовок представления

Свойство 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: {...}}) поддерживает все свойства заголовка.