Ось

Оси предоставляют линии, деления и подписи, показывающие, как диапазон позиций соответствует диапазону данных. Проще говоря, оси визуализируют шкалы.

По умолчанию Vega-Lite автоматически создаёт оси со стандартными свойствами для каналов x и y, когда они кодируют поля данных. Свойство axis в определении поля канала X или Y можно задать объектом для настройки свойств оси либо установить в null, чтобы удалить ось.

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

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

• Свойства оси
  • Общие свойства
    • Выравнивание осей нескольких представлений
  • Линия оси
  • Подписи
    • Первая буква названия месяца
  • Деления
    • Сетка между примитивами
  • Название оси
    • Настройка названия
  • Линии сетки
  • Условные свойства оси
  • Условные свойства и многострочные подписи
• Настройка осей по умолчанию

Свойства оси

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

Для настройки оси задайте объект axis в определении канала кодирования. В этом разделе перечислены все свойства осей.

См. также: интерактивная статья «A Guide to Guides: Axes & Legends in Vega» демонстрирует оси и легенды в базовом языке Vega.

Общие свойства

Пример: minExtent для выравнивания осей нескольких представлений

Vega-Lite рассчитывает место под подписи автоматически. Чтобы выровнять оси разных представлений, можно явно задать minExtent и, при необходимости, maxExtent:

Линия оси

Подписи

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

Пример: labelExpr для первой буквы названия месяца

Деления

Пример: tickBand для сетки между примитивами

С помощью tickBand деления и линии сетки можно переместить между метками:

Название оси

Пример: настройка названия

Пример настройки названия оси x:

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

Линии сетки

Условные свойства оси

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

Каждое деление, линия сетки и подпись используют объект данных со следующими полями, доступными в проверочном условии свойства оси:

• label — текст подписи;
• value — значение данных;
• index — относительный номер от 0 у первого деления до 1 у последнего.

Пример: условные свойства оси и многострочные подписи

В примере штриховка сетки и делений зависит от того, совпадает ли дата с началом года. Через labelExpr выводятся двухстрочные подписи, а год показывается только у января:

В диаграмме ниже некоторые подписи и деления условно скрываются через labelColor и tickColor:

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

// Спецификация представления верхнего уровня
{
  ...,
  "config": {
    "axis": ...,
    "axisX": ...,
    "axisY": ...,
    "axisLeft": ...,
    "axisRight": ...,
    "axisTop": ...,
    "axisBottom": ...,
    "axisBand": ...,
    "axisQuantitative": ...,
    "axisTemporal": ...,
    ...
  }
}

Конфигурация осей задаёт настройки по умолчанию. Свойства axis объекта config верхнего уровня применяются ко всем осям.

Дополнительные блоки настраивают более конкретные виды осей: по ориентации (axisX, axisY, axisLeft, axisTop и т. п.), полосовому типу шкалы (axisBand), типу данных шкалы (axisDiscrete, axisQuantitative, axisTemporal) или сочетанию ориентации и типа шкалы/данных, например axisXTemporal. Так, свойства axisBand применяются только к осям полосовых шкал "band".

Конфигурация поддерживает все свойства оси, кроме position, orient, format, values и zindex. Также поддерживается disable:

Примечания:

• Если к одной оси применимы несколько блоков конфигурации, настройки по типу имеют приоритет над настройками по ориентации, а те — над общими настройками.
• Если у конфигурации оси задан style, он имеет более низкий приоритет, чем любые свойства этой конфигурации.
• Полный порядок приоритета каждого свойства, от высокого к низкому:
  • свойства оси (axis.*);
  • стиль оси (config.style[axis.style].*);
  • конфигурация по ориентации и типу, например config.axisXBand.*;
  • конфигурация по типу, например config.axisBand.*;
  • конфигурация по ориентации (config.axisX/Y.*);
  • общая конфигурация (config.axis.*);
  • стиль конфигурации по ориентации и типу, например config.style[config.axisXBand.style].*;
  • стиль конфигурации по типу, например config.style[config.axisBand.style].*;
  • стиль конфигурации по ориентации, например config.style[config.axisX.style].*;
  • стиль общей конфигурации (config.style[config.axis.style].*).

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