Размещение представлений рядом

Чтобы расположить представления рядом, композиция представлений в Vega-Lite предоставляет следующие операторы объединения:

  • hconcat — горизонтальное объединение;
  • vconcat — вертикальное объединение;
  • concat — объединение с переносом на новые строки.

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

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

Горизонтальное размещение

hconcat принимает массив спецификаций и располагает их в один ряд:

{
  "hconcat": [
    ... // Спецификации представлений
  ],
  ...
}

Помимо общих свойств спецификации представления, спецификация горизонтального объединения имеет следующие свойства:

Свойство Тип Описание
hconcat Spec[] Обязательное. Список представлений, которые нужно объединить и расположить в один ряд.

Пример

Вертикальное размещение

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

{
  "vconcat": [
    ... // Спецификации представлений
  ],
  ...
}

Помимо общих свойств спецификации представления, спецификация вертикального объединения имеет следующие свойства:

Свойство Тип Описание
vconcat Spec[] Обязательное. Список представлений, которые нужно объединить и расположить в один столбец.

Пример

Размещение с переносом строк

concat принимает массив представлений, а columns ограничивает число диаграмм в одной строке:

{
  "concat": [
    ... // Спецификации представлений
  ],
  "columns": ...,
  ...
}

Помимо общих свойств спецификации представления, спецификация объединения с переносом строк имеет следующие свойства:

Свойство Тип Описание
concat Spec[] Обязательное. Список представлений, которые нужно объединить.
columns number Число столбцов в компоновке составного представления. По умолчанию: undefined — число столбцов не ограничено, все представления располагаются в один ряд. Для concat это эквивалентно hconcat, а для facet и repeat — использованию канала column. Примечания: 1) Свойство применяется только к оператору concat с переносом строк (не к hconcat/vconcat) и к операторам facet и repeat с одним определением поля или повторения, без вложенных определений row/column. 2) Значение columns: 1 эквивалентно vconcat для concat и использованию канала row для facet и repeat.

Пример

Общие и независимые направляющие

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

Настройка размещения

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

    "concat": { // Конфигурация объединения
      "spacing": ...,
      "columns": ...,
    },
    ...
  }
}

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

Свойство Тип Описание
columns number Число столбцов в компоновке составного представления. По умолчанию: undefined — число столбцов не ограничено, все представления располагаются в один ряд. Для concat это эквивалентно hconcat, а для facet и repeat — использованию канала column. Примечания: 1) Свойство применяется только к оператору concat с переносом строк (не к hconcat/vconcat) и к операторам facet и repeat с одним определением поля или повторения, без вложенных определений row/column. 2) Значение columns: 1 эквивалентно vconcat для concat и использованию канала row для facet и repeat.
spacing number Расстояние по умолчанию между составными представлениями, в пикселях. По умолчанию: 20.