Легенда

Подобно осям, легенды показывают смысл шкал. Оси помогают интерпретировать шкалы положения, а легенды — шкалы с такими выходными значениями, как цвета, формы и размеры.

По умолчанию Vega-Lite автоматически создаёт легенды со стандартными свойствами для каналов color, opacity, size и shape, когда они кодируют поля данных. Свойство legend в определении поля канала свойств примитива можно задать объектом для настройки свойств легенды или установить в null, чтобы убрать легенду.

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

• Виды легенд
• Объединение легенд
• Свойства легенды
  • Общие свойства
  • Градиент
  • Подписи
  • Символы
  • Расположение символов
  • Название
• Конфигурация легенд

Виды легенд

По умолчанию Vega-Lite создаёт градиентные легенды для цветовых каналов с количественными полями без разбиения на интервалы и с временными полями.

В остальных случаях создаются символьные легенды.

Объединение легенд

Если несколько каналов кодируют одни и те же поля, Vega-Lite автоматически объединяет их легенды. Например, следующая диаграмма кодирует Origin цветом (color) и формой (shape); в результате легенда показывает и кодируемые цвета, и формы.

Свойства легенды

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

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

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

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

Градиент

Подписи

Символы

Расположение символов

Название

Конфигурация легенд

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

Конфигурация config: {legend: {...}} задаёт общую тему легенд и поддерживает все свойства легенды, кроме direction (вместо него используются отдельные gradientDirection и symbolDirection), format, tickCount, values и zindex.

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