Заголовок панели

Заголовки задают название и подписи для панельных диаграмм. Название заголовка описывает поле, по которому диаграмма разбивается на панели, а подписи — значение этого поля для каждой отдельной диаграммы.

По умолчанию Vega-Lite автоматически создаёт заголовки со стандартными свойствами для каналов row и column панельного представления. Чтобы изменить свойства заголовка, задайте объект header в определении поля строки или столбца.

Помимо свойства header в определении поля строки или столбца, можно задать значения по умолчанию для всех заголовков через конфигурацию заголовков объекта config: config: {header: {...}}.

Содержание страницы

• Свойства заголовка
  • Общие настройки
  • Подписи панелей
  • Название поля
  • Пример
• Настройка заголовков по умолчанию

Свойства заголовка

// Спецификация одиночного представления или слоёв
{
  ...,
  "mark/layer": ...,
  "encoding": {
    "row": {
      "field": ...,
      "type": ...,
      "header": {...}, // Заголовок панели
      ...
    },
    "x": ...,
    "y": ...,
    ...
  }
}

// Спецификация панельной диаграммы
{
  ...,
  "facet": {
    "row/column": {
      "field": ...,
      "type": ...,
      "header": {...}, // Заголовок панели
      ...
    },
    ...
  },
  "spec": ...
}

Объект header в определении поля строки или столбца может содержать следующие группы свойств.

Общие настройки

См. также: конфигурации стилей guide-title и guide-label позволяют задавать общее оформление подписей и названий осей, легенд и заголовков панелей.

Подписи панелей

Название поля

Пример

В этом примере свойства заголовка изменяют размер шрифта названия и подписей панельной диаграммы.

Настройка заголовков по умолчанию

// Спецификация представления верхнего уровня
{
  ...,
  "config": {
    "header": {...},               // Заголовок панели
    "headerRow": {...},
    "headerColumn": {...},
    "headerFacet": {...},
    ...
  }
}

Свойство header объекта config верхнего уровня задаёт значения по умолчанию для всех заголовков. Свойства заголовка, заданные в определении поля строки, столбца или панели, переопределяют эти значения. Дополнительные блоки свойств позволяют настраивать конкретные виды заголовков по каналам разбиения: "headerRow", "headerColumn" и "headerFacet".

Конфигурация заголовков может содержать любые свойства заголовка.