Конфигурация

{
  ...,
  "config": {                // Конфигурация
    ...,                     // Настройки верхнего уровня
    "axis"      : { ... },   // Настройки: оси
    "header"    : { ... },   // Настройки: заголовки панелей
    "legend"    : { ... },   // Настройки: легенды
    "mark"      : { ... },   // Настройки: примитивы
    "style"     : { ... },   // Настройки: стили
    "range"     : { ... },   // Настройки: выходные диапазоны шкал
    "scale"     : { ... },   // Настройки: шкалы
    "projection": { ... },   // Настройки: проекции
    "selection" : { ... },   // Настройки: выделения
    "title"     : { ... },   // Настройки: заголовок
    "view"      : { ... },    // Настройки: представление
    "concat"    : { ... },    // Настройки: объединение и повторение
    "facet"     : { ... },    // Настройки: панели
    "locale"    : { ... },    // Настройки: локаль
    "aria"      : ...        // Настройки: доступность ARIA
  }
}

Объект config задаёт значения по умолчанию для всей диаграммы. С его помощью можно создать единый стиль осей, легенд, примитивов, шкал и составных представлений. Объект config Vega-Lite включает конфигурацию базового языка Vega.

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

• Общие свойства конфигурации
• Форматы чисел и времени
  • Собственная функция форматирования
  • Отдельный формат для подсказок
• Направляющие элементы
  • Оси
  • Заголовки панелей
  • Легенды
  • Встроенные стили направляющих элементов
• Графические примитивы
• Именованные стили
• Шкалы и цветовые диапазоны
• Географическая проекция
• Выделения
• Заголовок диаграммы
• Представление и композиция
• Настройки локали
• Настройки ARIA

Общие свойства конфигурации

Форматы чисел и времени

Эти свойства влияют на текстовые примитивы, оси, заголовки панелей, легенды и подсказки:

Собственная функция форматирования

(1) Зарегистрируйте функцию выражения Vega, принимающую значение данных и необязательные параметры формата:

vega.expressionFunction('customFormatA', function(datum, params) {
  ...
  return "<formatted string>";
});

(2) Задайте customFormatTypes: true:

{
  ...,
  "config": {"customFormatTypes": true}
}

(3) После этого используйте имя функции в formatType у текста или направляющих элементов:

{
  "format": <params>,
  "formatType": "customFormatA"
}

Отдельный формат для подсказок

Подсказка обычно располагает большим местом, чем подписи оси. Поэтому на диаграмме можно показывать короткий формат, а в подсказке — более точное число. В следующем примере ось y использует d без десятичных знаков, чтобы подписи не были слишком длинными, а подсказка — более точный .8f. Для этого добавьте свойство tooltipFormat, соответствующее типу FormatConfig:

Направляющие элементы

Оси

Объект axis задаёт свойства всех осей. Дополнительные блоки применяются по ориентации (axisX, axisY, axisLeft, axisTop и другие), типу шкалы (axisBand), типу данных (axisDiscrete, axisQuantitative, axisTemporal) или сочетанию ориентации и типа (например, axisXTemporal). axisBand действует только на шкалы band. Если к оси применимы несколько блоков, настройки по типу имеют приоритет над настройками по ориентации, а те — над общими. Подробнее — на странице «Ось».

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

Легенды

Встроенные стили направляющих элементов

• "guide-label" — подписи осей, легенд и панелей;
• "guide-title" — их названия;
• "group-title" — заголовки диаграмм.

Подробнее об именованных стилях — на странице «Графические примитивы».

Графические примитивы

config.mark действует для всех примитивов. Блок с именем типа, например config.area, задаёт значения по умолчанию только для этого типа.

Именованные стили

config.style определяет наборы свойств, которые затем выбираются по имени в объекте примитива или оси. Это позволяет единообразно оформлять несколько элементов. Пример находится в разделе о стилях примитивов.

Шкалы и цветовые диапазоны

Географическая проекция

Выделения

Заголовок диаграммы

Представление и композиция

Каждая конфигурация композиции (concat и facet) поддерживает следующие свойства:

Повторение использует те же настройки, что и размещение рядом.

Настройки локали

Настройки ARIA