Размещение представлений рядом
Чтобы расположить представления рядом, композиция представлений в 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. |