Поле данных
// Спецификация одиночного представления или слоя
{
...,
"mark/layer": ...,
"encoding": { // Кодирование
...: {
"field": ..., // Поле
"type": "quantitative",
...
},
...
},
...
}
Определение поля канала кодирования должно содержать field, чтобы связать канал с полем данных. Определение поля сортировки также может содержать field, чтобы сортировать кодируемое поле по другому полю.
field принимает два вида значений.
1) Строка с именем поля данных.
Простой случай — строка с именем поля. Например, "precipitation" привязывает количество осадков к положению по оси X:
Для вложенных объектов можно использовать путь JavaScript через точку (foo.bar) или квадратные скобки с кавычками (foo['bar']). Если точка или скобка входит в само имя поля, её нужно экранировать обратной косой чертой: для имени a.b укажите a\.b, для a[0] — a\[0\].
В строке JSON обратная косая черта тоже экранируется. Поэтому значение a\.b записывается в JSON как "a\\.b". Кавычки внутри строки записываются как \", перевод строки — \n, возврат каретки — \r, табуляция — \t.
2) Объект, задающий перебираемые значения оператора repeat.
Если диаграмма повторяется по нескольким полям, свойство field может содержать объект со ссылкой на текущую строку или столбец повторения. Например, {"repeat": "column"} назначает оси X поле текущего столбца для создания гистограмм разных полей:
Подробнее об операторе и дополнительных примерах — на странице repeat.