Прямоугольник

// Спецификация одиночного представления
{
  "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.