Типы свойств

Здесь перечислены общие типы значений, которые принимают свойства спецификации Vega-Lite. Тип значения свойства отличается от типа данных поля: например, свойство width принимает число, а поле данных может иметь тип "quantitative".

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

Простые типы

Любое значение — Any

Допускается любое буквальное значение: строка, число, логическое значение или null.

Массив — Array

Допускаются массивы, например [], [1, 2, 3] и ["foo", "bar"]. Обозначения Number[] и String[] указывают тип каждого элемента массива.

Во многих свойствах элементами массива могут быть ссылки на сигналы Vega, например [{"signal": "width"}, {"signal": "height"}].

Логическое значение — Boolean

Допускаются true и false.

Цвет — Color

Допускается корректная строка цвета CSS: "#f304d3", "#ccc", "rgb(253, 12, 134)" или "steelblue".

Ссылка на выражение — ExprRef

Объект со свойством expr, содержащим выражение Vega. Например, цвет примитива можно задать как {"expr": "lab(50,10,30)"}.

Выражение — Expression

Для собственных вычислений Vega-Lite использует язык выражений Vega. К текущей записи данных обращаются через переменную datum, например datum.price * datum.count.

Подробнее см. документацию выражений Vega.

Число — Number

Допускаются числовые значения: 1, 3.14, 1e5.

Объект — Object

Допускается объект, например {"left": 5, "right": 30, "top": 5, "bottom": 50}. Разрешённые ключи и типы их значений зависят от конкретного свойства.

Строка — String

Допускаются строки, например "bold", "step-before" и "". Разрешённые строковые значения зависят от конкретного свойства.

Текст — Text

Допускается строка или массив строк для многострочного текста.

Адрес — URL

Допускается корректная строка URL, указывающая ресурс. Примеры: "data/stocks.csv", "images/logo.png", "https://vega.github.io/".

Специальные объектные типы