Прямоугольник
// Спецификация одиночного представления
{
"data": ... ,
"mark": "rect",
"encoding": ... ,
...
}
Примитив rect отображает произвольный прямоугольник.
Содержание страницы
Свойства прямоугольника
// Спецификация одиночного представления
{
...,
"mark": {
"type": "rect",
...
},
"encoding": ... ,
...
}
Помимо общих свойств примитивов, прямоугольнику доступны:
| Свойство | Тип | Описание |
|---|---|---|
width |
number, ExprRef | Ширина примитива. |
height |
number, ExprRef | Высота примитива. |
align |
Align, ExprRef | Горизонтальное выравнивание текста или интервальных примитивов (area, bar, image, rect, rule): "left", "right" или "center".Примечание: ссылки на выражения для интервальных примитивов не поддерживаются. |
baseline |
TextBaseline, ExprRef | Для текста — вертикальная базовая линия: "alphabetic" (по умолчанию), "top", "middle", "bottom", "line-top", "line-bottom" или ссылка на выражение, возвращающее допустимое значение. Варианты line-top и line-bottom действуют подобно top и bottom, но рассчитываются относительно lineHeight, а не только fontSize.Для интервальных примитивов — вертикальное выравнивание: "top", "middle" или "bottom".Примечание: ссылки на выражения для интервальных примитивов не поддерживаются. |
cornerRadius |
number, ExprRef | Радиус скругления углов прямоугольников или дуг, в пикселях. По умолчанию: 0. |
binSpacing |
number | Отступ между столбцами или прямоугольниками для поля, разбитого на интервалы. Обычно используется 0 (предпочитается статистиками) или 1 (стандартное значение столбцов Vega-Lite и стиль примеров D3). Значение неотрицательное.По умолчанию: 0 для rect; 1 для bar. |
Примеры
Тепловая карта
Дискретные поля на осях x и y вместе с rect создают тепловую карту:
Прямоугольники можно использовать и с разбитыми на интервалы количественными или дискретизированными временными полями:
Прямоугольники между границами
Если задать x вместе с x2 и/или y вместе с y2, прямоугольник займёт соответствующий диапазон значений. Например, такой слой может подсветить область от общего минимума до максимума:
Настройка прямоугольников
// Спецификация представления верхнего уровня
{
...,
"config": {
"rect": ...,
...
}
}
Свойство rect объекта config верхнего уровня задаёт стандартные свойства всех прямоугольников. Каналы свойств примитива переопределяют эти значения.
Помимо стандартных свойств прямоугольника, кроме type, style и clip, конфигурация поддерживает дополнительные параметры:
| Свойство | Тип | Описание |
|---|---|---|
continuousBandSize |
number | Размер столбцов или прямоугольников на непрерывных шкалах по умолчанию, неотрицательный. По умолчанию: 5. |
discreteBandSize |
number, RelativeBandSize | Размер столбцов или прямоугольников с дискретным измерением по умолчанию, неотрицательный. Если не задан, используется step - 2, оставляющий промежуток в 2 пикселя. |
minBandSize |
number, ExprRef | Минимальная ширина полосы столбцов и прямоугольников. По умолчанию: 0.25. |