Изображение

// Спецификация одиночного представления
{
  "data": ... ,
  "mark": "image",
  "encoding": ... ,
  ...
}

Примитив image позволяет включать в визуализацию внешние изображения, например значки или фотографии. Файлы PNG и JPEG загружаются по указанным адресам.

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

Свойства изображения

// Спецификация одиночного представления
{
  ...,
  "mark": {
    "type": "image",
    ...
  },
  "encoding": ... ,
  ...
}

Помимо общих свойств примитивов, изображению доступны:

Свойство Тип Описание
url URI, ExprRef URL файла изображения для примитивов image.
aspect boolean, 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".

Примечание: ссылки на выражения для интервальных примитивов не поддерживаются.

Примеры

Диаграмма рассеяния с изображениями

Настройка изображений

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

Свойство image объекта config верхнего уровня задаёт стандартные свойства всех изображений. Каналы свойств примитива переопределяют эти значения.

Конфигурация может содержать любые свойства изображений, кроме type, style и clip.