API парсера

Парсер Vega принимает спецификацию Vega в формате JSON и создаёт описание потока данных для выполнения визуализации.

Справочник API парсера

# vega.parse(specification[, config, options]) Исходный код

Разбирает спецификацию Vega в формате JSON и возвращает описание реактивного графа потока данных визуализации. Описание имеет формат JSON модуля vega-runtime. Чтобы создать визуализацию, передайте это описание конструктору представления Vega.

Необязательный объект config задаёт исходные параметры оформления примитивов, шкал, осей и легенд. Через него можно менять размещение, цвета, гарнитуры, размеры шрифта и другие свойства темы диаграммы. Если передать null, используется стандартная конфигурация. Если передать объект, его свойства объединяются со стандартной конфигурацией и имеют приоритет при совпадении ключей.

Помимо аргумента метода parse, свойства конфигурации можно указать в блоке "config" верхнего уровня спецификации Vega. Настройки из спецификации имеют приоритет над настройками, переданными методу.

Объект options позволяет изменить работу парсера. Поддерживается следующий параметр:

  • ast: логическое значение (по умолчанию false), определяющее, включать ли в результат абстрактные синтаксические деревья (AST) выражений Vega. По умолчанию результат содержит только созданные фрагменты кода JavaScript. Этот параметр позволяет заменить генерацию кода Vega другим вычислителем выражений, например из пакета vega-interpreter. ≥ 5.12