Конфигурация диаграммы верхнего уровня

Многие свойства внешнего вида диаграммы настраиваются на верхнем уровне методами configure_*(). Эти методы и задаваемые ими свойства допустимы только на верхнем уровне. Они действуют как тема: определяют стандартное оформление всей диаграммы, которое переопределяется настройками отдельных элементов.

Ниже описаны методы и их аргументы:

Диаграмма — Chart.configure.
Оси — Chart.configure_axis.
Заголовки фасетов — Chart.configure_header.
Легенды — Chart.configure_legend.
Примитивы — Chart.configure_mark.
Шкалы — Chart.configure_scale.
Диапазоны шкал — Chart.configure_range.
Проекции — Chart.configure_projection.
Объединение и фасеты — Chart.configure_concat, Chart.configure_facet.
Выборы — Chart.configure_selection.
Заголовок диаграммы — Chart.configure_title.
Область отображения — Chart.configure_view.

Другие подходы описаны в разделе настройки визуализаций.

Конфигурация диаграммы

Метод Chart.configure добавляет к диаграмме экземпляр Config и принимает следующие параметры:

Нажмите, чтобы показать таблицу

Свойство	Тип	Описание
`arc`	`RectConfig`	Настройки примитивов Arc.
`area`	`AreaConfig`	Настройки примитивов Area.
`aria`	`boolean`	Включать ли стандартные атрибуты ARIA для примитивов и направляющих (только вывод SVG). При `false` всем направляющим задаётся атрибут `"aria-hidden"`, исключающий их из дерева доступности ARIA, а Vega-Lite не создаёт стандартные описания примитивов. По умолчанию: `true`.
`autosize`	anyOf(`AutosizeType`, `AutoSizeParams`)	Способ определения размера визуализации. Строковое значение — `"pad"`, `"fit"` или `"none"`. Объект также позволяет задать параметры размера содержимого и автоматического изменения размеров. По умолчанию: `pad`.
`axis`	`AxisConfig`	Настройки, определяющие стандартные свойства всех осей x и y. Полный перечень см. в разделе конфигурации осей.
`axisBand`	`AxisConfig`	Настройки осей со шкалами `"band"`.
`axisBottom`	`AxisConfig`	Настройки оси x у нижнего края диаграммы.
`axisDiscrete`	`AxisConfig`	Настройки осей со шкалами `"point"` или `"band"`.
`axisLeft`	`AxisConfig`	Настройки оси y у левого края диаграммы.
`axisPoint`	`AxisConfig`	Настройки осей со шкалами `"point"`.
`axisQuantitative`	`AxisConfig`	Настройки количественных осей.
`axisRight`	`AxisConfig`	Настройки оси y у правого края диаграммы.
`axisTemporal`	`AxisConfig`	Настройки временных осей.
`axisTop`	`AxisConfig`	Настройки оси x у верхнего края диаграммы.
`axisX`	`AxisConfig`	Настройки оси x.
`axisXBand`	`AxisConfig`	Настройки осей x со шкалами `"band"`.
`axisXDiscrete`	`AxisConfig`	Настройки осей x со шкалами `"point"` или `"band"`.
`axisXPoint`	`AxisConfig`	Настройки осей x со шкалами `"point"`.
`axisXQuantitative`	`AxisConfig`	Настройки количественных осей x.
`axisXTemporal`	`AxisConfig`	Настройки временных осей x.
`axisY`	`AxisConfig`	Настройки оси y.
`axisYBand`	`AxisConfig`	Настройки осей y со шкалами `"band"`.
`axisYDiscrete`	`AxisConfig`	Настройки осей y со шкалами `"point"` или `"band"`.
`axisYPoint`	`AxisConfig`	Настройки осей y со шкалами `"point"`.
`axisYQuantitative`	`AxisConfig`	Настройки количественных осей y.
`axisYTemporal`	`AxisConfig`	Настройки временных осей y.
`background`	anyOf(`Color`, `ExprRef`)	Цвет CSS для фона всей области отображения. По умолчанию: `"white"`.
`bar`	`BarConfig`	Настройки примитивов Bar.
`boxplot`	`BoxPlotConfig`	Настройки диаграмм размаха.
`circle`	`MarkConfig`	Настройки примитивов Circle.
`concat`	`CompositionConfig`	Стандартные настройки всех операторов объединения и повторения представлений: `concat`, `hconcat`, `vconcat` и `repeat`.
`countTitle`	`string`	Стандартный заголовок осей и легенд для полей количества записей. По умолчанию: `Count of Records`.
`customFormatTypes`	`boolean`	Разрешает свойству `formatType` текстовых примитивов и направляющих принимать пользовательскую функцию форматирования, зарегистрированную как выражение Vega.
`errorband`	`ErrorBandConfig`	Настройки полос погрешностей ErrorBand.
`errorbar`	`ErrorBarConfig`	Настройки отрезков погрешностей ErrorBar.
`facet`	`CompositionConfig`	Стандартные настройки оператора фасетного представления `facet`.
`fieldTitle`	['verbal', 'functional', 'plain']	Способ создания заголовков полей Vega-Lite. Доступны три стиля: `"verbal"` (по умолчанию) — словесная запись функции, например `Sum of field`, `Year-month of date`, `field (binned)`. `"function"` — функция в верхнем регистре со скобками, например `SUM(field)`, `YEARMONTH(date)`, `BIN(field)`. `"plain"` — только имя поля без функций, например `field`, `date`, `field`.
`font`	`string`	Стандартный шрифт всех текстовых примитивов, заголовков и подписей.
`geoshape`	`MarkConfig`	Настройки примитивов Geoshape.
`header`	`HeaderConfig`	Стандартные свойства всех заголовков фасетов. Полный перечень см. в разделе конфигурации заголовков.
`headerColumn`	`HeaderConfig`	Стандартные свойства заголовков столбцов. Полный перечень см. в разделе конфигурации заголовков.
`headerFacet`	`HeaderConfig`	Стандартные свойства заголовков фасетов, не связанных со строками или столбцами. Полный перечень см. в разделе конфигурации заголовков.
`headerRow`	`HeaderConfig`	Стандартные свойства заголовков строк. Полный перечень см. в разделе конфигурации заголовков.
`image`	`RectConfig`	Настройки примитивов Image.
`legend`	`LegendConfig`	Стандартные свойства всех легенд. Полный перечень см. в разделе конфигурации легенд.
`line`	`LineConfig`	Настройки примитивов Line.
`lineBreak`	anyOf(`string`, `ExprRef`)	Разделитель для разбиения текста на строки, например символ новой строки. Это общая настройка текстовых примитивов по умолчанию; её переопределяют настройки примитива или стиля и канал кодирования `lineBreak`. Если значение задаётся сигналом, допустимы строки и регулярные выражения `regexp`.
`locale`	`Locale`	Определения локали для разбора строк и форматирования чисел и дат. Объект локали должен содержать свойства `number` и/или `time` с определениями локали. Локаль из блока config может быть переопределена аргументом locale конструктора View.
`mark`	`MarkConfig`	Настройки графических примитивов.
`normalizedNumberFormat`	`string`	Если `normalizedNumberFormatType` не задан, формат D3 для подписей осей, текстовых примитивов и подсказок нормализованных полей с накоплением (`stack: "normalize"`). Например, `"s"` обозначает единицы СИ. Используется синтаксис числовых форматов D3. Если заданы `config.normalizedNumberFormatType` и `config.customFormatTypes: true`, это значение передаётся как `format` вместе с `datum.value` функции `config.numberFormatType`. По умолчанию: `%`.
`normalizedNumberFormatType`	`string`	Пользовательский тип формата для `config.normalizedNumberFormat`. По умолчанию: `undefined`, что соответствует D3-format, доступному как функция `format` в выражениях Vega. Для использования также требуется `customFormatTypes: true`.
`numberFormat`	`string`	Если `numberFormatType` не задан, формат D3 для подписей направляющих, текстовых примитивов и подсказок ненормализованных полей (без `stack: "normalize"`). Например, `"s"` обозначает единицы СИ. Используется синтаксис числовых форматов D3. Если заданы `config.numberFormatType` и `config.customFormatTypes: true`, это значение передаётся как `format` вместе с `datum.value` функции `config.numberFormatType`.
`numberFormatType`	`string`	Пользовательский тип формата для `config.numberFormat`. По умолчанию: `undefined`, что соответствует D3-format, доступному как функция `format` в выражениях Vega. Для использования также требуется `customFormatTypes: true`.
`padding`	anyOf(`Padding`, `ExprRef`)	Стандартный отступ в пикселях от края холста визуализации до прямоугольной области данных. Число задаёт одинаковый отступ со всех сторон. Объект вида `{"left": 5, "top": 5, "right": 5, "bottom": 5}` задаёт отступы отдельно. По умолчанию: `5`.
`params`	array(`TopLevelParameter`)	Динамические переменные или выборы, параметризующие визуализацию.
`point`	`MarkConfig`	Настройки примитивов Point.
`projection`	`ProjectionConfig`	Стандартные свойства всех проекций. Полный перечень см. в разделе конфигурации проекций.
`range`	`RangeConfig`	Словарь стандартных массивов диапазонов или схем для шкал. Полный перечень см. в разделе конфигурации шкал.
`rect`	`RectConfig`	Настройки примитивов Rect.
`rule`	`MarkConfig`	Настройки примитивов Rule.
`scale`	`ScaleConfig`	Стандартные свойства всех шкал. Полный перечень см. в разделе конфигурации шкал.
`selection`	`SelectionConfig`	Словарь стандартных свойств для каждого типа выбора.
`square`	`MarkConfig`	Настройки примитивов Square.
`style`	`StyleConfigIndex`	Словарь, сопоставляющий имена стилей стандартным свойствам примитивов. Значения должны быть допустимыми объектами конфигурации примитивов.
`text`	`MarkConfig`	Настройки примитивов Text.
`tick`	`TickConfig`	Настройки примитивов Tick.
`timeFormat`	`string`	Стандартный формат времени для исходных временных значений без timeUnit в текстовых примитивах, подписях легенд и заголовках фасетов. По умолчанию: `"%b %d, %Y"`. Оси автоматически определяют формат каждой подписи, поэтому эта настройка на них не влияет.
`timeFormatType`	`string`	Пользовательский тип формата для `config.timeFormat`. По умолчанию: `undefined`, что соответствует D3-time-format, доступному как функция `timeFormat` в выражениях Vega. Для использования требуется `customFormatTypes: true`, а `timeUnit` не должен быть задан.
`title`	`TitleConfig`	Стандартные свойства всех заголовков диаграмм. Полный перечень см. в разделе конфигурации заголовков.
`tooltipFormat`	`FormatConfig`	Пользовательские настройки формата подсказок. Если не заданы, используется стандартная конфигурация формата.
`trail`	`LineConfig`	Настройки примитивов Trail.
`view`	`ViewConfig`	Стандартные свойства отдельных представлений.

Конфигурация осей

Настройки осей задают стандартные свойства всех осей диаграммы методом Chart.configure_axis.

Дополнительные блоки свойств нацеливаются на оси конкретного расположения (axisX, axisY, axisLeft, axisTop и другие) или типа шкалы (axisBand). Например, свойства блока axisBand действуют только на оси полосовых шкал.

Если к одной оси применимы несколько блоков, настройки типа шкалы имеют приоритет над настройками расположения, а те — над общими настройками.

Доступны следующие методы:

Chart.configure_axis;
Chart.configure_axisBand;
Chart.configure_axisBottom;
Chart.configure_axisLeft;
Chart.configure_axisRight;
Chart.configure_axisTop;
Chart.configure_axisX;
Chart.configure_axisY;
Chart.configure_axisDiscrete;
Chart.configure_axisPoint;
Chart.configure_axisQuantitative;
Chart.configure_axisTemporal;
Chart.configure_axisXBand;
Chart.configure_axisXDiscrete;
Chart.configure_axisXPoint;
Chart.configure_axisXQuantitative;
Chart.configure_axisXTemporal;
Chart.configure_axisYBand;
Chart.configure_axisYDiscrete;
Chart.configure_axisYPoint;
Chart.configure_axisYQuantitative;
Chart.configure_axisYTemporal;

Их свойства:

Нажмите, чтобы показать таблицу

Свойство	Тип	Описание
`aria`	anyOf(`boolean`, `ExprRef`)	Включать ли атрибуты ARIA (только SVG). При `false` группе SVG задаётся атрибут `aria-hidden`, исключающий ось из дерева доступности ARIA. По умолчанию: `true`.
`bandPosition`	anyOf(`number`, `ExprRef`)	Доля интерполяции, задающая положение делений оси для шкал band. При `0` деления находятся у левого края полосы, при `0.5` — в её середине. По умолчанию: `0.5`.
`description`	anyOf(`string`, `ExprRef`)	Текстовое описание оси для доступности ARIA (только SVG). При `aria: true` используется как атрибут `aria-label` в выводе SVG. Если описание не задано, оно создаётся автоматически.
`disable`	`boolean`	По умолчанию отключать ось.
`domain`	`boolean`	Включать ли базовую линию оси. По умолчанию: `true`.
`domainCap`	anyOf(`StrokeCap`, `ExprRef`)	Форма концов базовой линии оси: `"butt"`, `"round"` или `"square"`. По умолчанию: `"butt"`.
`domainColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Цвет базовой линии оси. По умолчанию: `"gray"`.
`domainDash`	anyOf(array(`number`), `ExprRef`)	Массив чередующихся длин штрихов и пробелов для пунктирной базовой линии оси.
`domainDashOffset`	anyOf(`number`, `ExprRef`)	Начальное смещение рисунка штрихов базовой линии оси в пикселях.
`domainOpacity`	anyOf(`number`, `ExprRef`)	Непрозрачность базовой линии оси.
`domainWidth`	anyOf(`number`, `ExprRef`)	Толщина обводки базовой линии оси. По умолчанию: `1`.
`format`	`Format`	Спецификатор формата чисел и дат в подписях осей, легенд, заголовков панелей и текстовых примитивах. Для `formatType: "number"`, например количественных полей, используется строка шаблона числового формата D3. Для `formatType: "time"`, например временных полей, задаётся строка фиксированного формата времени D3 или объект динамического формата. Динамический формат зависит от детализации входной даты: границы года, месяца, дня, часа и т. д. Для собственного `formatType` значение передаётся зарегистрированной функции как `format` вместе с `datum.value`. По умолчанию: выводится из `numberFormat` для чисел и `timeFormat` для времени в конфигурации форматирования.
`formatType`	`string`	Тип форматирования подписей: `"number"`, `"time"` или зарегистрированный собственный тип. По умолчанию: `time` для временных полей и порядковых/номинальных полей с `timeUnit`; `number` для количественных полей и порядковых/номинальных полей без `timeUnit`.
`grid`	`boolean`	Включать ли линии сетки в ось. По умолчанию: `true` для непрерывных шкал без разбиения на интервалы, иначе `false`.
`gridCap`	anyOf(`StrokeCap`, `ExprRef`)	Форма концов линий сетки: `"butt"`, `"round"` или `"square"`. По умолчанию: `"butt"`.
`gridColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`, `ConditionalAxisColor`)	Цвет линий сетки. По умолчанию: `"lightGray"`.
`gridDash`	anyOf(array(`number`), `ExprRef`, `ConditionalAxisNumberArray`)	Массив чередующихся длин штрихов и пробелов для пунктирных линий сетки.
`gridDashOffset`	anyOf(`number`, `ExprRef`, `ConditionalAxisNumber`)	Начальное смещение рисунка штрихов сетки в пикселях.
`gridOpacity`	anyOf(`number`, `ExprRef`, `ConditionalAxisNumber`)	Непрозрачность линий сетки от `0` до `1`. По умолчанию: `1`.
`gridWidth`	anyOf(`number`, `ExprRef`, `ConditionalAxisNumber`)	Толщина линий сетки в пикселях. По умолчанию: `1`.
`labelAlign`	anyOf(`Align`, `ExprRef`, `ConditionalAxisLabelAlign`)	Горизонтальное выравнивание подписей делений оси, переопределяющее стандартную настройку для текущего расположения оси.
`labelAngle`	anyOf(`number`, `ExprRef`)	Угол поворота подписей оси. По умолчанию: `-90` для номинальных и порядковых полей, иначе `0`.
`labelBaseline`	anyOf(`TextBaseline`, `ExprRef`, `ConditionalAxisLabelBaseline`)	Вертикальная базовая линия подписей делений, переопределяющая стандартную настройку для текущего расположения оси: `"alphabetic"` (по умолчанию), `"top"`, `"middle"`, `"bottom"`, `"line-top"` или `"line-bottom"`. Последние два значения похожи на `"top"` и `"bottom"`, но рассчитываются относительно lineHeight, а не только fontSize.
`labelBound`	anyOf([number, boolean], `ExprRef`)	Скрывать ли подписи за пределами диапазона оси. При `false` анализ выхода за границы не выполняется. При `true` скрываются подписи, выходящие более чем на 1 пиксель. Число задаёт допуск в пикселях — максимальный выход ограничивающего прямоугольника подписи за диапазон. По умолчанию: `false`.
`labelColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`, `ConditionalAxisColor`)	Цвет подписи деления: шестнадцатеричный код или обычное название цвета.
`labelExpr`	`string`	Выражение Vega для настройки подписей. Текст и значение доступны через свойства `label` и `value` объекта `datum`, используемого осью.
`labelFlush`	[boolean, number]	Выравнивать ли первую и последнюю подписи по краям диапазона шкалы. У горизонтальной оси первая выравнивается слева, последняя справа; у вертикальной используются нижняя и верхняя базовые линии текста. Число также задаёт дополнительное смещение в пикселях. Например, `2` выравнивает крайние подписи и сдвигает их на 2 пикселя наружу от центра оси. Это помогает визуально связать подписи с соответствующими делениями. По умолчанию: `true` для оси непрерывной шкалы x, иначе `false`.
`labelFlushOffset`	anyOf(`number`, `ExprRef`)	Дополнительное смещение выровненных по краям подписей в пикселях. Например, `2` сдвигает их на 2 пикселя наружу от центра оси, помогая визуально связать с соответствующими делениями. По умолчанию: `0`.
`labelFont`	anyOf(`string`, `ExprRef`, `ConditionalAxisString`)	Шрифт подписей делений.
`labelFontSize`	anyOf(`number`, `ExprRef`, `ConditionalAxisNumber`)	Размер шрифта подписи в пикселях.
`labelFontStyle`	anyOf(`FontStyle`, `ExprRef`, `ConditionalAxisLabelFontStyle`)	Начертание шрифта подписей делений.
`labelFontWeight`	anyOf(`FontWeight`, `ExprRef`, `ConditionalAxisLabelFontWeight`)	Насыщенность шрифта подписей делений оси.
`labelLimit`	anyOf(`number`, `ExprRef`)	Максимальная ширина подписей делений оси в пикселях. По умолчанию: `180`.
`labelLineHeight`	anyOf(`number`, `ExprRef`)	Высота строки в пикселях для многострочных подписей или текста с базовой линией `"line-top"` или `"line-bottom"`.
`labelOffset`	anyOf(`number`, `ExprRef`, `ConditionalAxisNumber`)	Дополнительное смещение подписей в пикселях, сверх tickOffset. По умолчанию: `0`.
`labelOpacity`	anyOf(`number`, `ExprRef`, `ConditionalAxisNumber`)	Непрозрачность подписей.
`labelOverlap`	anyOf(`LabelOverlap`, `ExprRef`)	Стратегия устранения перекрытия подписей оси. При `false` подписи не удаляются. При `true` или `"parity"` удаляется каждая вторая подпись, что подходит для обычных линейных осей. При `"greedy"` подписи просматриваются последовательно и удаляются, если перекрывают последнюю видимую; это часто лучше подходит для логарифмических осей. По умолчанию: `true` для неноминальных полей с нелогарифмическими шкалами, `"greedy"` для логарифмических шкал, иначе `false`.
`labelPadding`	anyOf(`number`, `ExprRef`, `ConditionalAxisNumber`)	Отступ между подписями и делениями в пикселях. По умолчанию: `2`.
`labelSeparation`	anyOf(`number`, `ExprRef`)	Минимальный промежуток между ограничивающими прямоугольниками подписей, при котором они считаются неперекрывающимися; по умолчанию `0`. Игнорируется, если устранение перекрытия через labelOverlap отключено.
`labels`	`boolean`	Включать ли подписи в ось. По умолчанию: `true`.
`maxExtent`	anyOf(`number`, `ExprRef`)	Максимальная область в пикселях для делений и подписей оси. Определяет максимальное смещение заголовка. По умолчанию: `undefined`.
`minExtent`	anyOf(`number`, `ExprRef`)	Минимальная область в пикселях для делений и подписей оси. Определяет минимальное смещение заголовка. По умолчанию: `30` для оси y, `undefined` для оси x.
`offset`	anyOf(`number`, `ExprRef`)	Смещение оси в пикселях от края содержащей её группы или прямоугольной области данных. По умолчанию: определяется свойством offset конфигурации оси, стандартное значение которого — `0`.
`orient`	anyOf(`AxisOrient`, `ExprRef`)	Расположение оси: `"top"`, `"bottom"`, `"left"` или `"right"`. Позволяет уточнить тип, например разместить ось y у правого края диаграммы. По умолчанию: `"bottom"` для осей x, `"left"` для осей y.
`position`	anyOf(`number`, `ExprRef`)	Положение точки привязки оси в пикселях. Для осей x сверху или снизу задаёт координату x группы оси; для осей y слева или справа — координату y. По умолчанию: `0`.
`style`	anyOf(`string`, array(`string`))	Строка или массив строк с именами пользовательских стилей оси. Стиль — именованный набор свойств оси из конфигурации стилей. В массиве более поздние стили переопределяют ранние. По умолчанию: отсутствует. Указанный стиль дополняет стандартные настройки. Например, ось x со `style: "foo"` использует config.axisX и config.style.foo, причём foo имеет больший приоритет.
`tickBand`	anyOf(['center', 'extent'], `ExprRef`)	Для полосовых шкал размещать деления и сетку в центре полосы (`"center"`, по умолчанию) или на её границах (`"extent"`), обозначая интервалы.
`tickCap`	anyOf(`StrokeCap`, `ExprRef`)	Форма концов линий делений: `"butt"`, `"round"` или `"square"`. По умолчанию: `"butt"`.
`tickColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`, `ConditionalAxisColor`)	Цвет делений оси. По умолчанию: `"gray"`.
`tickCount`	anyOf(`number`, `TimeInterval`, `TimeIntervalStep`, `ExprRef`)	Желаемое число делений количественной оси. Фактическое число может отличаться, чтобы значения были удобными — кратными 2, 5 или 10 — и входили в диапазон шкалы. Для шкал `"time"` и `"utc"` можно указать временной интервал: `"millisecond"`, `"second"`, `"minute"`, `"hour"`, `"day"`, `"week"`, `"month"` или `"year"`. Объект вида `{"interval": "month", "step": 3}` также задаёт число шагов: в этом примере деления создаются на границах кварталов — в январе, апреле, июле и октябре. По умолчанию: `ceil(width/40)` для x и `ceil(height/40)` для y.
`tickDash`	anyOf(array(`number`), `ExprRef`, `ConditionalAxisNumberArray`)	Массив чередующихся длин штрихов и пробелов для пунктирных линий делений.
`tickDashOffset`	anyOf(`number`, `ExprRef`, `ConditionalAxisNumber`)	Начальное смещение рисунка штрихов делений в пикселях.
`tickExtra`	`boolean`	Добавлять ли дополнительное деление в начальном положении оси. Полезно для полосовых шкал с делениями на границах полос вместо центров. Используется вместе с `bandPosition: 1` и `padding: 0` оси.
`tickMinStep`	anyOf(`number`, `ExprRef`)	Минимальный желаемый шаг между делениями в единицах области определения шкалы. Например, `1` не допускает расстояния менее одной единицы. При необходимости tickCount корректируется, чтобы обеспечить этот шаг.
`tickOffset`	anyOf(`number`, `ExprRef`)	Смещение делений, подписей и линий сетки в пикселях.
`tickOpacity`	anyOf(`number`, `ExprRef`, `ConditionalAxisNumber`)	Непрозрачность делений.
`tickRound`	`boolean`	Округлять ли пиксельные координаты до ближайшего целого. По умолчанию: `true`.
`tickSize`	anyOf(`number`, `ExprRef`, `ConditionalAxisNumber`)	Размер делений оси в пикселях. По умолчанию: `5`.
`tickWidth`	anyOf(`number`, `ExprRef`, `ConditionalAxisNumber`)	Толщина делений в пикселях. По умолчанию: `1`.
`ticks`	`boolean`	Включать ли деления оси. По умолчанию: `true`.
`title`	anyOf(`Text`, `null`)	Заголовок поля. При `null` удаляется. По умолчанию: формируется из имени поля и преобразования (`aggregate`, `bin`, `timeUnit`). Агрегирование включается в заголовок, например `"Sum of Profit"`; группировка по интервалам и единицы времени — в скобках: `"Profit (binned)"`, `"Transaction Date (year-month)"`. Без преобразования используется имя поля. Примечания: Формат заголовка можно настроить свойством `fieldTitle` конфигурации или функцией `fieldTitle` в параметрах компиляции. Если заголовок задан и у поля, и у оси, заголовка панели или легенды, используется заголовок оси, панели или легенды.
`titleAlign`	anyOf(`Align`, `ExprRef`)	Горизонтальное выравнивание заголовков осей.
`titleAnchor`	anyOf(`TitleAnchor`, `ExprRef`)	Положение точки привязки текста заголовка оси.
`titleAngle`	anyOf(`number`, `ExprRef`)	Угол заголовка оси в градусах.
`titleBaseline`	anyOf(`TextBaseline`, `ExprRef`)	Вертикальная базовая линия заголовка оси: `"alphabetic"` (по умолчанию), `"top"`, `"middle"`, `"bottom"`, `"line-top"` или `"line-bottom"`. Последние два значения похожи на `"top"` и `"bottom"`, но рассчитываются относительно lineHeight, а не только fontSize.
`titleColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Цвет заголовка: шестнадцатеричный код или обычное название цвета.
`titleFont`	anyOf(`string`, `ExprRef`)	Шрифт заголовка, например `"Helvetica Neue"`.
`titleFontSize`	anyOf(`number`, `ExprRef`)	Размер шрифта заголовка.
`titleFontStyle`	anyOf(`FontStyle`, `ExprRef`)	Начертание шрифта заголовка.
`titleFontWeight`	anyOf(`FontWeight`, `ExprRef`)	Насыщенность шрифта заголовка: строка, например `"bold"` или `"normal"`, либо число `100`, `200`, `300`, …, `900`. Значению `"normal"` соответствует `400`, а `"bold"` — `700`.
`titleLimit`	anyOf(`number`, `ExprRef`)	Максимальная ширина заголовка оси в пикселях.
`titleLineHeight`	anyOf(`number`, `ExprRef`)	Высота строки в пикселях для многострочного заголовка или текста с базовой линией `"line-top"` или `"line-bottom"`.
`titleOpacity`	anyOf(`number`, `ExprRef`)	Непрозрачность заголовка оси.
`titlePadding`	anyOf(`number`, `ExprRef`)	Отступ между заголовком и осью в пикселях.
`titleX`	anyOf(`number`, `ExprRef`)	Координата x заголовка относительно группы оси.
`titleY`	anyOf(`number`, `ExprRef`)	Координата y заголовка относительно группы оси.
`translate`	anyOf(`number`, `ExprRef`)	Смещение системы координат при размещении оси. По умолчанию обе координаты сдвигаются на 0.5 пикселя, чтобы линии обводки совпадали с пиксельной сеткой. Для векторной графики такое смещение может быть нежелательно; тогда translate можно изменить, например на ноль. По умолчанию: `0.5`.
`values`	anyOf(array(`number`), array(`string`), array(`boolean`), array(`DateTime`), `ExprRef`)	Явно заданные видимые значения делений оси.
`zindex`	`number`	Неотрицательный целочисленный z-index оси. При `0` ось отрисовывается за всеми элементами диаграммы. Значение `1` или больше помещает её перед ними. По умолчанию: `0`, позади примитивов.

Конфигурация заголовков фасетов

Метод Chart.configure_header задаёт стандартные свойства заголовков фасетов: шрифт, цвет, размер и положение названия и подписей. Пример:

import altair as alt
from altair.datasets import data

source = data.cars.url

chart = alt.Chart(source).mark_point().encode(
    x='Horsepower:Q',
    y='Miles_per_Gallon:Q',
    color='Origin:N',
    column='Origin:N'
).properties(
    width=180,
    height=180
)

chart.configure_header(
    titleColor='green',
    titleFontSize=14,
    labelColor='red',
    labelFontSize=14
)

Дополнительные блоки свойств нацеливаются на конкретные типы заголовков. Доступны методы:

Chart.configure_header;
Chart.configure_headerColumn;
Chart.configure_headerFacet;
Chart.configure_headerRow.

Они принимают следующие свойства:

Нажмите, чтобы показать таблицу

Свойство	Тип	Описание
`format`	`Format`	Спецификатор формата чисел и дат в подписях осей, легенд, заголовков панелей и текстовых примитивах. Для `formatType: "number"`, например количественных полей, используется строка шаблона числового формата D3. Для `formatType: "time"`, например временных полей, задаётся строка фиксированного формата времени D3 или объект динамического формата. Динамический формат зависит от детализации входной даты: границы года, месяца, дня, часа и т. д. Для собственного `formatType` значение передаётся зарегистрированной функции как `format` вместе с `datum.value`. По умолчанию: выводится из `numberFormat` для чисел и `timeFormat` для времени в конфигурации форматирования.
`formatType`	`string`	Тип форматирования подписей: `"number"`, `"time"` или зарегистрированный собственный тип. По умолчанию: `time` для временных полей и порядковых/номинальных полей с `timeUnit`; `number` для количественных полей и порядковых/номинальных полей без `timeUnit`.
`labelAlign`	anyOf(`Align`, `ExprRef`)	Горизонтальное выравнивание подписей заголовка: `"left"`, `"center"` или `"right"`.
`labelAnchor`	`TitleAnchor`	Положение точки привязки подписей: `"start"`, `"middle"` или `"end"`. При расположении подписей сверху эти значения соответствуют выравниванию слева, по центру и справа.
`labelAngle`	`number`	Угол поворота подписей заголовка. По умолчанию: `0` для заголовков столбцов, `-90` для заголовков строк.
`labelBaseline`	anyOf(`TextBaseline`, `ExprRef`)	Вертикальная базовая линия подписей заголовка: `"alphabetic"` (по умолчанию), `"top"`, `"middle"`, `"bottom"`, `"line-top"` или `"line-bottom"`. Последние два значения похожи на `"top"` и `"bottom"`, но рассчитываются относительно `titleLineHeight`, а не только `titleFontSize`.
`labelColor`	anyOf(`Color`, `ExprRef`)	Цвет подписи заголовка: шестнадцатеричный код или обычное название цвета.
`labelExpr`	`string`	Выражение Vega для настройки подписей. Текст и значение подписи доступны через свойства `label` и `value` объекта `datum`, используемого заголовком.
`labelFont`	anyOf(`string`, `ExprRef`)	Шрифт подписи заголовка.
`labelFontSize`	anyOf(`number`, `ExprRef`)	Размер шрифта подписи заголовка в пикселях.
`labelFontStyle`	anyOf(`FontStyle`, `ExprRef`)	Начертание шрифта подписи заголовка.
`labelFontWeight`	anyOf(`FontWeight`, `ExprRef`)	Насыщенность шрифта подписи заголовка.
`labelLimit`	anyOf(`number`, `ExprRef`)	Максимальная длина подписи заголовка в пикселях. Более длинный текст автоматически сокращается. По умолчанию: `0`, без ограничения.
`labelLineHeight`	anyOf(`number`, `ExprRef`)	Высота строки в пикселях для многострочных подписей заголовка или текста заголовка с базовой линией `"line-top"` или `"line-bottom"`.
`labelOrient`	`Orient`	Расположение подписи заголовка: `"top"`, `"bottom"`, `"left"` или `"right"`.
`labelPadding`	anyOf(`number`, `ExprRef`)	Отступ между подписью заголовка фасета и диаграммой в пикселях. По умолчанию: `10`.
`labels`	`boolean`	Включать ли подписи в заголовок. По умолчанию: `true`.
`orient`	`Orient`	Сокращённая настройка для одновременного задания `labelOrient` и `titleOrient`.
`title`	`null`	Значение `null` отключает заголовок оси, легенды или фасета.
`titleAlign`	anyOf(`Align`, `ExprRef`)	Горизонтальное выравнивание названия заголовка фасета относительно точки привязки.
`titleAnchor`	`TitleAnchor`	Положение точки привязки названия: `"start"`, `"middle"` или `"end"`. При расположении сверху эти значения соответствуют выравниванию слева, по центру и справа.
`titleAngle`	`number`	Угол поворота названия заголовка фасета. По умолчанию: `0`.
`titleBaseline`	anyOf(`TextBaseline`, `ExprRef`)	Вертикальная базовая линия названия заголовка фасета: `"alphabetic"` (стандартный вариант), `"top"`, `"middle"`, `"bottom"`, `"line-top"` или `"line-bottom"`. Последние два значения похожи на `"top"` и `"bottom"`, но рассчитываются относительно `titleLineHeight`, а не только `titleFontSize`. По умолчанию: `"middle"`.
`titleColor`	anyOf(`Color`, `ExprRef`)	Цвет названия заголовка фасета: шестнадцатеричный код или обычное название цвета.
`titleFont`	anyOf(`string`, `ExprRef`)	Шрифт названия заголовка фасета, например `"Helvetica Neue"`.
`titleFontSize`	anyOf(`number`, `ExprRef`)	Размер шрифта названия заголовка фасета.
`titleFontStyle`	anyOf(`FontStyle`, `ExprRef`)	Начертание шрифта названия заголовка фасета.
`titleFontWeight`	anyOf(`FontWeight`, `ExprRef`)	Насыщенность шрифта названия заголовка фасета: строка, например `"bold"` или `"normal"`, либо число `100`, `200`, `300`, …, `900`. Значению `"normal"` соответствует `400`, а `"bold"` — `700`.
`titleLimit`	anyOf(`number`, `ExprRef`)	Максимальная длина названия заголовка фасета в пикселях. Более длинный текст автоматически сокращается. По умолчанию: `0`, без ограничения.
`titleLineHeight`	anyOf(`number`, `ExprRef`)	Высота строки в пикселях для многострочного названия заголовка фасета или текста с базовой линией `"line-top"` или `"line-bottom"`.
`titleOrient`	`Orient`	Расположение названия заголовка фасета: `"top"`, `"bottom"`, `"left"` или `"right"`.
`titlePadding`	anyOf(`number`, `ExprRef`)	Отступ между названием и подписью заголовка фасета в пикселях. По умолчанию: `10`.

Конфигурация легенд

Метод Chart.configure_legend настраивает внешний вид легенд: положение, шрифты, ограничивающие рамки, цвета и другие свойства. Пример:

import altair as alt
from altair.datasets import data

source = data.cars.url

chart = alt.Chart(source).mark_point().encode(
    x='Horsepower:Q',
    y='Miles_per_Gallon:Q',
    color='Origin:N'
)

chart.configure_legend(
    strokeColor='gray',
    fillColor='#EEEEEE',
    padding=10,
    cornerRadius=10,
    orient='top-right'
)

Дополнительные свойства приведены в таблице:

Нажмите, чтобы показать таблицу

Свойство	Тип	Описание
`aria`	anyOf(`boolean`, `ExprRef`)	Включать ли атрибуты ARIA (только SVG). При `false` группе SVG задаётся атрибут `aria-hidden`, исключающий легенду из дерева доступности ARIA. По умолчанию: `true`.
`clipHeight`	anyOf(`number`, `ExprRef`)	Высота в пикселях для обрезки элементов символьной легенды и ограничения их размера.
`columnPadding`	anyOf(`number`, `ExprRef`)	Горизонтальный промежуток между элементами символьной легенды в пикселях. По умолчанию: `10`.
`columns`	anyOf(`number`, `ExprRef`)	Число столбцов для элементов символьной легенды. Значение `0` или меньше задаёт одну строку с отдельным столбцом для каждого элемента.
`cornerRadius`	anyOf(`number`, `ExprRef`)	Радиус скругления углов всей легенды.
`description`	anyOf(`string`, `ExprRef`)	Текстовое описание легенды для доступности ARIA (только SVG). При `aria: true` используется как атрибут `aria-label` в выводе SVG. Если не задано, создаётся автоматически.
`direction`	`Orientation`	Направление легенды: `"vertical"` или `"horizontal"`. По умолчанию: сверху и снизу — `"horizontal"`; слева и справа — `"vertical"`; в углах — `"horizontal"` для градиентной легенды и `"vertical"` для символьной.
`disable`	`boolean`	По умолчанию отключать легенду.
`fillColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Цвет заливки фона всей легенды.
`gradientDirection`	anyOf(`Orientation`, `ExprRef`)	Стандартное направление градиентной легенды: `"horizontal"` или `"vertical"`. По умолчанию: `"vertical"`.
`gradientHorizontalMaxLength`	`number`	Максимальная длина горизонтальной градиентной легенды, если config.legend.gradientLength не задан. По умолчанию: `200`.
`gradientHorizontalMinLength`	`number`	Минимальная длина горизонтальной градиентной легенды, если config.legend.gradientLength не задан. По умолчанию: `100`.
`gradientLabelLimit`	anyOf(`number`, `ExprRef`)	Максимальная длина подписей цветового градиента в пикселях.
`gradientLabelOffset`	anyOf(`number`, `ExprRef`)	Вертикальное смещение подписей цветового градиента в пикселях. По умолчанию: `2`.
`gradientLength`	anyOf(`number`, `ExprRef`)	Длина основной оси цветового градиента в пикселях: высота вертикального или ширина горизонтального градиента. По умолчанию: `200`.
`gradientOpacity`	anyOf(`number`, `ExprRef`)	Непрозрачность цветового градиента.
`gradientStrokeColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Цвет обводки градиента: шестнадцатеричный код или обычное название цвета. По умолчанию: `"lightGray"`.
`gradientStrokeWidth`	anyOf(`number`, `ExprRef`)	Толщина обводки градиента в пикселях. По умолчанию: `0`.
`gradientThickness`	anyOf(`number`, `ExprRef`)	Толщина цветового градиента в пикселях: ширина вертикального или высота горизонтального градиента. По умолчанию: `16`.
`gradientVerticalMaxLength`	`number`	Максимальная длина вертикальной градиентной легенды, если config.legend.gradientLength не задан. По умолчанию: `200`.
`gradientVerticalMinLength`	`number`	Минимальная длина вертикальной градиентной легенды, если config.legend.gradientLength не задан. По умолчанию: `100`.
`gridAlign`	anyOf(`LayoutAlign`, `ExprRef`)	Выравнивание строк и столбцов символьной легенды: `"all"`, `"each"` или `none`. Подробнее см. размещение в сетке. По умолчанию: `"each"`.
`labelAlign`	anyOf(`Align`, `ExprRef`)	Выравнивание подписи легенды: left, center или right.
`labelBaseline`	anyOf(`TextBaseline`, `ExprRef`)	Базовая линия подписи легенды: `"top"`, `"middle"`, `"bottom"` или `"alphabetic"`. По умолчанию: `"middle"`.
`labelColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Цвет подписи легенды: шестнадцатеричный код или обычное название цвета.
`labelFont`	anyOf(`string`, `ExprRef`)	Шрифт подписи легенды.
`labelFontSize`	anyOf(`number`, `ExprRef`)	Размер шрифта подписи легенды. По умолчанию: `10`.
`labelFontStyle`	anyOf(`FontStyle`, `ExprRef`)	Начертание шрифта подписи легенды.
`labelFontWeight`	anyOf(`FontWeight`, `ExprRef`)	Насыщенность шрифта подписи легенды.
`labelLimit`	anyOf(`number`, `ExprRef`)	Максимальная ширина подписей делений легенды в пикселях. По умолчанию: `160`.
`labelOffset`	anyOf(`number`, `ExprRef`)	Смещение подписи легенды. По умолчанию: `4`.
`labelOpacity`	anyOf(`number`, `ExprRef`)	Непрозрачность подписей.
`labelOverlap`	anyOf(`LabelOverlap`, `ExprRef`)	Стратегия устранения перекрытия подписей градиентной легенды. При `false` подписи не удаляются. При `true` или `"parity"` удаляется каждая вторая. При `"greedy"` подписи просматриваются последовательно и удаляются, если перекрывают последнюю видимую; это часто лучше подходит для логарифмических шкал. По умолчанию: `"greedy"` для логарифмических шкал, иначе `true`.
`labelPadding`	anyOf(`number`, `ExprRef`)	Отступ между легендой и её подписями в пикселях.
`labelSeparation`	anyOf(`number`, `ExprRef`)	Минимальный промежуток между ограничивающими прямоугольниками подписей, при котором они считаются неперекрывающимися; по умолчанию `0`. Игнорируется, если устранение перекрытия через labelOverlap отключено.
`layout`	`ExprRef`
`legendX`	anyOf(`number`, `ExprRef`)	Пользовательская координата x легенды с orient: "none".
`legendY`	anyOf(`number`, `ExprRef`)	Пользовательская координата y легенды с orient: "none".
`offset`	anyOf(`number`, `ExprRef`)	Смещение легенды от прямоугольной области данных и осей в пикселях. По умолчанию: `18`.
`orient`	`LegendOrient`	Расположение легенды в сцене: `"left"`, `"right"`, `"top"`, `"bottom"`, `"top-left"`, `"top-right"`, `"bottom-left"`, `"bottom-right"` или `"none"`. По умолчанию: `"right"`.
`padding`	anyOf(`number`, `ExprRef`)	Отступ между границей и содержимым группы легенды. По умолчанию: `0`.
`rowPadding`	anyOf(`number`, `ExprRef`)	Вертикальный промежуток между элементами символьной легенды в пикселях. По умолчанию: `2`.
`strokeColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Цвет обводки границы всей легенды.
`strokeDash`	anyOf(array(`number`), `ExprRef`)	Рисунок штрихов обводки границы всей легенды.
`strokeWidth`	anyOf(`number`, `ExprRef`)	Толщина обводки границы всей легенды.
`symbolBaseFillColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Стандартная заливка символов легенды. Применяется только при отсутствии цветового кодирования шкалы fill для легенды. По умолчанию: `"transparent"`.
`symbolBaseStrokeColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Стандартная обводка символов легенды. Применяется только при отсутствии цветового кодирования шкалы fill для легенды. По умолчанию: `"gray"`.
`symbolDash`	anyOf(array(`number`), `ExprRef`)	Массив чередующихся длин штрихов и пробелов для пунктирной обводки символов.
`symbolDashOffset`	anyOf(`number`, `ExprRef`)	Начальное смещение рисунка штрихов обводки символов в пикселях.
`symbolDirection`	anyOf(`Orientation`, `ExprRef`)	Стандартное направление символьной легенды: `"horizontal"` или `"vertical"`. По умолчанию: `"vertical"`.
`symbolFillColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Цвет символа легенды.
`symbolLimit`	anyOf(`number`, `ExprRef`)	Максимальное допустимое число элементов символьной легенды. Дополнительные элементы исключаются.
`symbolOffset`	anyOf(`number`, `ExprRef`)	Горизонтальное смещение символов легенды в пикселях. По умолчанию: `0`.
`symbolOpacity`	anyOf(`number`, `ExprRef`)	Непрозрачность символов легенды.
`symbolSize`	anyOf(`number`, `ExprRef`)	Размер символа легенды в пикселях. По умолчанию: `100`.
`symbolStrokeColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Цвет обводки символов легенды.
`symbolStrokeWidth`	anyOf(`number`, `ExprRef`)	Толщина обводки символа. По умолчанию: `1.5`.
`symbolType`	anyOf(`SymbolShape`, `ExprRef`)	Форма символа: circle (по умолчанию), square, cross, diamond, triangle-up, triangle-down, triangle-right, triangle-left, линейный символ stroke или направленные формы с центром в начале координат: arrow, wedge, triangle. Также допустима пользовательская строка контура SVG. Для правильного масштабирования её координаты должны находиться в квадрате от -1 до 1 по обеим осям. По умолчанию: `"circle"`.
`tickCount`	anyOf(`TickCount`, `ExprRef`)	Желаемое число значений делений количественной легенды.
`title`	`null`	Значение `null` отключает заголовок оси, легенды или фасета.
`titleAlign`	anyOf(`Align`, `ExprRef`)	Горизонтальное выравнивание заголовков легенды. По умолчанию: `"left"`.
`titleAnchor`	anyOf(`TitleAnchor`, `ExprRef`)	Положение точки привязки заголовков легенды.
`titleBaseline`	anyOf(`TextBaseline`, `ExprRef`)	Вертикальная базовая линия заголовка легенды: `"alphabetic"` (стандартный вариант), `"top"`, `"middle"`, `"bottom"`, `"line-top"` или `"line-bottom"`. Последние два значения похожи на `"top"` и `"bottom"`, но рассчитываются относительно lineHeight, а не только fontSize. По умолчанию: `"top"`.
`titleColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Цвет заголовка легенды: шестнадцатеричный код или обычное название цвета.
`titleFont`	anyOf(`string`, `ExprRef`)	Шрифт заголовка легенды.
`titleFontSize`	anyOf(`number`, `ExprRef`)	Размер шрифта заголовка легенды.
`titleFontStyle`	anyOf(`FontStyle`, `ExprRef`)	Начертание шрифта заголовка легенды.
`titleFontWeight`	anyOf(`FontWeight`, `ExprRef`)	Насыщенность шрифта заголовка легенды: строка, например `"bold"` или `"normal"`, либо число `100`, `200`, `300`, …, `900`. Значению `"normal"` соответствует `400`, а `"bold"` — `700`.
`titleLimit`	anyOf(`number`, `ExprRef`)	Максимальная ширина заголовка легенды в пикселях. По умолчанию: `180`.
`titleLineHeight`	anyOf(`number`, `ExprRef`)	Высота строки в пикселях для многострочного заголовка или текста с базовой линией `"line-top"` или `"line-bottom"`.
`titleOpacity`	anyOf(`number`, `ExprRef`)	Непрозрачность заголовка легенды.
`titleOrient`	anyOf(`Orient`, `ExprRef`)	Расположение заголовка легенды.
`titlePadding`	anyOf(`number`, `ExprRef`)	Отступ между заголовком и легендой в пикселях. По умолчанию: `5`.
`unselectedOpacity`	`number`	Непрозрачность невыбранных элементов легенды. По умолчанию: `0.35`.
`zindex`	anyOf(`number`, `ExprRef`)	Целочисленный z-index, определяющий порядок слоя группы легенды относительно осей, примитивов и других легенд.

Конфигурация примитивов и их стилей

Метод Chart.configure_mark задаёт стандартные свойства всех примитивов диаграммы. Объект config также предоставляет настройки конкретных типов, например Chart.configure_area, для задания стандартных свойств каждого типа.

Для общих настроек всех примитивов используйте:

Chart.configure_mark.

Для настроек отдельных типов:

Chart.configure_arc;
Chart.configure_area;
Chart.configure_bar;
Chart.configure_boxplot;
Chart.configure_circle;
Chart.configure_errorband;
Chart.configure_errorbar;
Chart.configure_geoshape;
Chart.configure_image;
Chart.configure_line;
Chart.configure_point;
Chart.configure_rect;
Chart.configure_rule;
Chart.configure_square;
Chart.configure_text;
Chart.configure_tick;
Chart.configure_trail;

Каждый из этих методов принимает следующие свойства:

Нажмите, чтобы показать таблицу

Свойство	Тип	Описание
`align`	anyOf(`Align`, `ExprRef`)	Горизонтальное выравнивание текста или примитивов с диапазоном: area, bar, image, rect, rule. Значения: `"left"`, `"right"`, `"center"`. Для примитивов с диапазоном ссылки на выражения не поддерживаются.
`angle`	anyOf(`number`, `ExprRef`)	Угол поворота текста в градусах.
`aria`	anyOf(`boolean`, `ExprRef`)	Добавлять ли атрибуты ARIA для доступности; только для SVG. При `false` выходной SVG-элемент получает `aria-hidden`, и примитив исключается из дерева доступности ARIA.
`ariaRole`	anyOf(`string`, `ExprRef`)	Тип элемента пользовательского интерфейса для доступности ARIA (только SVG). Если задан, определяет атрибут `role`. Внимание: экспериментальное свойство, которое может измениться.
`ariaRoleDescription`	anyOf(`string`, `ExprRef`)	Понятное человеку описание роли примитива, локализованное автором, для доступности ARIA (только SVG). Если задано, определяет атрибут `aria-roledescription`. Внимание: экспериментальное свойство, которое может измениться.
`aspect`	anyOf(`boolean`, `ExprRef`)	Сохранять ли соотношение сторон изображения.
`baseline`	anyOf(`TextBaseline`, `ExprRef`)	Для текста — вертикальная базовая линия: `"alphabetic"`, используемая по умолчанию, `"top"`, `"middle"`, `"bottom"`, `"line-top"`, `"line-bottom"` либо ссылка на выражение, возвращающее допустимое значение. line-top и line-bottom похожи на top и bottom, но вычисляются относительно `lineHeight`, а не только `fontSize`. Для примитивов с диапазоном — вертикальное выравнивание `"top"`, `"middle"` или `"bottom"`; ссылки на выражения для них не поддерживаются.
`blend`	anyOf(`Blend`, `ExprRef`)	Режим смешивания цвета примитива с текущим фоном. Допускается любое значение CSS `mix-blend-mode`. По умолчанию: `"source-over"`.
`color`	anyOf(`Color`, `Gradient`, `ExprRef`)	Стандартный цвет. По умолчанию: ■ `"#4682b4"`. Нельзя задавать в конфигурации стилей. Свойства `fill` и `stroke` имеют больший приоритет и переопределяют `color`.
`cornerRadius`	anyOf(`number`, `ExprRef`)	Радиус скругления углов прямоугольников или дуг в пикселях. По умолчанию: `0`.
`cornerRadiusBottomLeft`	anyOf(`number`, `ExprRef`)	Радиус скругления нижнего левого угла прямоугольника в пикселях. По умолчанию: `0`.
`cornerRadiusBottomRight`	anyOf(`number`, `ExprRef`)	Радиус скругления нижнего правого угла прямоугольника в пикселях. По умолчанию: `0`.
`cornerRadiusTopLeft`	anyOf(`number`, `ExprRef`)	Радиус скругления верхнего левого угла прямоугольника в пикселях. По умолчанию: `0`.
`cornerRadiusTopRight`	anyOf(`number`, `ExprRef`)	Радиус скругления верхнего правого угла прямоугольника в пикселях. По умолчанию: `0`.
`cursor`	anyOf(`Cursor`, `ExprRef`)	Указатель мыши при наведении на примитив. Допускается любой тип указателя CSS.
`description`	anyOf(`string`, `ExprRef`)	Текстовое описание примитива для доступности ARIA; только для SVG. Если задано, определяет атрибут `aria-label`.
`dir`	anyOf(`TextDirection`, `ExprRef`)	Направление текста: `"ltr"` — слева направо, `"rtl"` — справа налево. Определяет, с какой стороны текст обрезается по параметру limit. По умолчанию: `"ltr"`.
`dx`	anyOf(`number`, `ExprRef`)	Горизонтальное смещение подписи относительно точки привязки, в пикселях. Применяется после поворота свойством angle.
`dy`	anyOf(`number`, `ExprRef`)	Вертикальное смещение подписи относительно точки привязки, в пикселях. Применяется после поворота свойством angle.
`ellipsis`	anyOf(`string`, `ExprRef`)	Строка многоточия для текста, обрезанного по limit. По умолчанию: `"…"`.
`endAngle`	anyOf(`number`, `ExprRef`)	Конечный угол примитива Arc в радианах. Значение `0` соответствует направлению вверх, на север; угол увеличивается по часовой стрелке.
`fill`	anyOf(`Color`, `Gradient`, `null`, `ExprRef`)	Стандартный цвет заливки; имеет больший приоритет, чем `config.color`. Значение `null` убирает заливку. По умолчанию: отсутствует.
`fillOpacity`	anyOf(`number`, `ExprRef`)	Непрозрачность заливки в диапазоне `[0,1]`. По умолчанию: `1`.
`filled`	`boolean`	Использовать ли цвет примитива для заливки вместо обводки. По умолчанию: `false` для point, line, rule и geoshape с источником graticule; для остальных — `true`. Нельзя задавать в конфигурации стилей.
`font`	anyOf(`string`, `ExprRef`)	Гарнитура текста, например `"Helvetica Neue"`.
`fontSize`	anyOf(`number`, `ExprRef`)	Размер шрифта в пикселях. По умолчанию: `11`.
`fontStyle`	anyOf(`FontStyle`, `ExprRef`)	Начертание шрифта, например `"italic"`.
`fontWeight`	anyOf(`FontWeight`, `ExprRef`)	Насыщенность шрифта: строка, например `"bold"` или `"normal"`, либо число `100`, `200`, `300`, …, `900`. normal соответствует `400`, bold — `700`.
`height`	anyOf(`number`, `ExprRef`)	Высота примитивов.
`href`	anyOf(`URI`, `ExprRef`)	URL для перехода при щелчке мышью. При заданном значении примитив действует как гиперссылка.
`innerRadius`	anyOf(`number`, `ExprRef`)	Внутренний радиус дуги в пикселях; псевдоним `radius2`. По умолчанию: `0`.
`interpolate`	anyOf(`Interpolate`, `ExprRef`)	Способ интерполяции линий и областей: `"linear"` — последовательность прямых отрезков. `"linear-closed"` — замкнутые отрезки, образующие многоугольник. `"step"` — чередующиеся горизонтальные и вертикальные отрезки. `"step-before"` — чередующиеся вертикальные и горизонтальные отрезки. `"step-after"` — чередующиеся горизонтальные и вертикальные отрезки. `"basis"` — B-сплайн с дублированием крайних контрольных точек. `"basis-open"` — открытый B-сплайн, который может не проходить через начало или конец. `"basis-closed"` — замкнутый B-сплайн. `"cardinal"` — кардинальный сплайн с дублированием крайних контрольных точек. `"cardinal-open"` — открытый кардинальный сплайн: может не проходить через начало и конец, но проходит через остальные контрольные точки. `"cardinal-closed"` — замкнутый кардинальный сплайн. `"bundle"` — аналог basis, но tension используется для выпрямления сплайна. `"monotone"` — кубическая интерполяция, сохраняющая монотонность по y.
`invalid`	anyOf(`MarkInvalidDataMode`, `null`)	Режим обработки некорректных данных: `null` и `NaN` на непрерывных шкалах без заданного результата для таких значений. `"filter"` исключает некорректные значения из примитивов и шкал. Линии, области и trail соединяют допустимые точки, словно некорректных строк нет. `"break-paths-filter-domains"` разрывает пути в некорректных точках. Для примитивов без пути эквивалентен `"filter"`. Все диапазоны шкал исключают отфильтрованные точки. `"break-paths-show-domains"` разрывает пути и скрывает некорректные точки остальных примитивов. Диапазоны всех шкал включают эти точки. `"show"` или `null` показывает все точки в примитивах и диапазонах шкал. Шкала использует результат из `config.scale.invalid`; если он не задан, некорректные значения отображаются как ноль, когда он входит в шкалу, или как минимум шкалы, когда ноль не входит. `"break-paths-show-path-domains"`, используемый по умолчанию, эквивалентен `"break-paths-show-domains"` для line/area/trail и `"filter"` для остальных примитивов. Если для шкалы канала задан результат некорректных значений в `config.scale.invalid`, все её значения считаются допустимыми. Поля такого канала не фильтруются и не вызывают разрывов пути.
`limit`	anyOf(`number`, `ExprRef`)	Максимальная длина текстового примитива в пикселях. Текст автоматически обрезается, если его отображаемый размер превышает предел. По умолчанию: `0`, без ограничения.
`lineBreak`	anyOf(`string`, `ExprRef`)	Разделитель для разбиения текста на строки, например символ новой строки. Игнорируется, если текст задан массивом.
`lineHeight`	anyOf(`number`, `ExprRef`)	Высота строки в пикселях, то есть расстояние между соседними строками многострочного текста.
`opacity`	anyOf(`number`, `ExprRef`)	Общая непрозрачность в диапазоне `[0,1]`. По умолчанию: `0.7` для неагрегированных диаграмм с point, tick, circle, square или столбчатых диаграмм со слоями; иначе `1`.
`order`	[null, boolean]	Для line и trail значение `null` или `false` сохраняет исходный порядок данных при построении линии.
`orient`	`Orientation`	Ориентация диаграмм bar без накопления, tick, area и line: horizontal, используемая по умолчанию, либо vertical. Для bar, rule и tick определяет, к x или y применяется размер. Для area задаёт orient результата Vega. Для line и trail определяет порядок сортировки точек, если `config.sortLineBy` не задан. При накоплении ориентация определяется самим накоплением, и явно заданное значение игнорируется.
`outerRadius`	anyOf(`number`, `ExprRef`)	Внешний радиус дуги в пикселях; псевдоним `radius`. По умолчанию: `0`.
`padAngle`	anyOf(`number`, `ExprRef`)	Угловой отступ по сторонам дуги, в радианах.
`radius`	anyOf(`number`, `ExprRef`)	Для arc — основной внешний радиус в пикселях. Для text — радиальное смещение текста в полярных координатах от начала, заданного x и y. По умолчанию: `min(plot_width, plot_height)/2`.
`radius2`	anyOf(`number`, `ExprRef`)	Второй, внутренний радиус дуги в пикселях. По умолчанию: `0`.
`shape`	anyOf(anyOf(`SymbolShape`, `string`), `ExprRef`)	Форма точек. Поддерживаются `"circle"`, `"square"`, `"cross"`, `"diamond"`, `"triangle-up"`, `"triangle-down"`, `"triangle-right"`, `"triangle-left"`; символ линии `"stroke"`; направленные формы `"arrow"`, `"wedge"`, `"triangle"`; пользовательская строка пути SVG. Для правильного размера путь должен находиться в квадрате с координатами от -1 до 1 по обеим осям. По умолчанию: `"circle"`.
`size`	anyOf(`number`, `ExprRef`)	Стандартный размер примитива. Для point/circle/square — площадь в пикселях; длины сторон растут пропорционально квадратному корню из этого значения. Для bar — размер полосы в пикселях, для text — размер шрифта. По умолчанию: `30` для point/circle/square; `step` ширины/высоты; `2` для bar с дискретным измерением; `5` для bar с непрерывным измерением; `11` для text.
`smooth`	anyOf(`boolean`, `ExprRef`)	Сглаживать ли изображение при изменении размера; по умолчанию `true`. При `false` отдельные пиксели масштабируются непосредственно, без сглаживающей интерполяции. Для SVG настройка может не работать в некоторых браузерах из-за отсутствия стандартизации.
`startAngle`	anyOf(`number`, `ExprRef`)	Начальный угол примитива Arc в радианах. Значение `0` соответствует направлению вверх, на север; угол увеличивается по часовой стрелке.
`stroke`	anyOf(`Color`, `Gradient`, `null`, `ExprRef`)	Стандартный цвет обводки; имеет больший приоритет, чем `config.color`. Значение `null` убирает обводку. По умолчанию: отсутствует.
`strokeCap`	anyOf(`StrokeCap`, `ExprRef`)	Форма концов линии: `"butt"`, `"round"` или `"square"`. По умолчанию: `"butt"`.
`strokeDash`	anyOf(array(`number`), `ExprRef`)	Массив чередующихся длин штриха и промежутка для пунктирных и штриховых линий.
`strokeDashOffset`	anyOf(`number`, `ExprRef`)	Смещение в пикселях, с которого начинается рисунок штриховой линии.
`strokeJoin`	anyOf(`StrokeJoin`, `ExprRef`)	Способ соединения сегментов обводки: `"miter"`, `"round"` или `"bevel"`. По умолчанию: `"miter"`.
`strokeMiterLimit`	anyOf(`number`, `ExprRef`)	Предел острого соединения, при превышении которого оно срезается.
`strokeOffset`	anyOf(`number`, `ExprRef`)	Смещение в пикселях для отрисовки обводки и заливки группы. Если не задано, группы с обводкой динамически смещаются так, чтобы обводка шириной 1 пиксель совпадала с пиксельной сеткой.
`strokeOpacity`	anyOf(`number`, `ExprRef`)	Непрозрачность обводки в диапазоне `[0,1]`. По умолчанию: `1`.
`strokeWidth`	anyOf(`number`, `ExprRef`)	Толщина обводки в пикселях.
`tension`	anyOf(`number`, `ExprRef`)	Параметр натяжения для line и area, в зависимости от типа интерполяции.
`text`	anyOf(`Text`, `ExprRef`)	Текст-заполнитель, если канал text не указан.
`theta`	anyOf(`number`, `ExprRef`)	Для arc — угловая длина дуги в радианах, если `theta2` не задан, иначе начальный угол. Ноль направлен вверх, или на север; положительные значения идут по часовой стрелке. Для text — угол в полярных координатах, в радианах.
`theta2`	anyOf(`number`, `ExprRef`)	Конечный угол дуги в радианах. Ноль направлен вверх, или на север; положительные значения идут по часовой стрелке.
`time`	anyOf(`number`, `ExprRef`)
`timeUnitBandPosition`	`number`	Стандартное относительное положение полосы временной единицы. При `0` примитивы располагаются в начале шага временной полосы, при `0.5` — в середине.
`timeUnitBandSize`	`number`	Стандартный относительный размер полосы временной единицы. При `1` ширина примитивов равна шагу временной полосы, при `0.5` — половине шага.
`tooltip`	anyOf(`number`, `string`, `boolean`, `TooltipContent`, `ExprRef`, `null`)	Строка подсказки при наведении или объект, определяющий её поля. При `true` или `{"content": "encoding"}` используются все поля `encoding`; при `{"content": "data"}` — все поля наведённой точки данных. При `null` или `false` подсказка отсутствует. Подробнее см. подсказки Vega-Lite. По умолчанию: `null`.
`url`	anyOf(`URI`, `ExprRef`)	URL файла изображения для примитива image.
`width`	anyOf(`number`, `ExprRef`)	Ширина примитивов.
`x`	anyOf(`number`, `string`, `ExprRef`)	Координата x примитива или ширина горизонтальных bar и area, если не заданы `x2` или `width`. Значение может быть числом или строкой `"width"`, обозначающей ширину диаграммы.
`x2`	anyOf(`number`, `string`, `ExprRef`)	Вторая координата x для area, bar, rect и rule с диапазоном. Значение может быть числом или строкой `"width"`, обозначающей ширину диаграммы.
`y`	anyOf(`number`, `string`, `ExprRef`)	Координата y примитива или высота вертикальных bar и area, если не заданы `y2` или `height`. Значение может быть числом или строкой `"height"`, обозначающей высоту диаграммы.
`y2`	anyOf(`number`, `string`, `ExprRef`)	Вторая координата y для area, bar, rect и rule с диапазоном. Значение может быть числом или строкой `"height"`, обозначающей высоту диаграммы.

Помимо стандартных свойств выше, значения по умолчанию можно задавать именованными стилями. Передайте их именованными аргументами методу Chart.configure_style. Чтобы применить стиль, укажите свойство style в объекте определения примитива.

Конфигурация шкал

Метод Chart.configure_scale принимает следующие свойства:

Нажмите, чтобы показать таблицу

Свойство	Тип	Описание
`animationDuration`	`number`	Стандартная длительность анимации в секундах для временных кодирований, кроме шкал band. По умолчанию: `5`.
`bandPaddingInner`	anyOf(`number`, `ExprRef`)	Стандартный внутренний отступ полосовых шкал x и y. По умолчанию: `nestedOffsetPaddingInner` для шкал x/y с вложенными шкалами смещения x/y; `barBandPaddingInner` для примитивов Bar (`0.1` по умолчанию); `rectBandPaddingInner` для примитивов Rect и остальных типов (`0` по умолчанию).
`bandPaddingOuter`	anyOf(`number`, `ExprRef`)	Стандартный внешний отступ полосовых шкал x и y. По умолчанию: `paddingInner/2`, благодаря чему ширина или высота равна числу уникальных значений, умноженному на шаг.
`bandWithNestedOffsetPaddingInner`	anyOf(`number`, `ExprRef`)	Стандартный внутренний отступ полосовых шкал x и y с вложенным кодированием xOffset или yOffset. По умолчанию: `0.2`.
`bandWithNestedOffsetPaddingOuter`	anyOf(`number`, `ExprRef`)	Стандартный внешний отступ полосовых шкал x и y с вложенным кодированием xOffset или yOffset. По умолчанию: `0.2`.
`barBandPaddingInner`	anyOf(`number`, `ExprRef`)	Стандартный внутренний отступ полосовых порядковых шкал x и y для примитивов `"bar"`. По умолчанию: `0.1`.
`clamp`	anyOf(`boolean`, `ExprRef`)	При `true` значения за пределами области определения данных ограничиваются минимальным или максимальным выходным значением шкалы.
`continuousPadding`	anyOf(`number`, `ExprRef`)	Стандартный отступ непрерывных шкал x и y. По умолчанию: ширина столбца для непрерывной шкалы x вертикального столбца или непрерывной шкалы y горизонтального столбца; в остальных случаях — `0`.
`framesPerSecond`	`number`	Стандартная частота кадров в секунду для временных шкал band. По умолчанию: `2`.
`invalid`	`ScaleInvalidDataConfig`	Объект выходных значений шкал для недопустимых значений: null и NaN на непрерывной шкале. Ключи — каналы шкал. Значения — `"zero-or-min"` (ноль, если шкала его включает, иначе минимум) или определения вида `{value: ...}`. Например, `config.scale.invalid: {color: {value: "#aaa"}}` окрашивает все недопустимые значения в `#aaa`. Подробнее см. недопустимые данные.
`maxBandSize`	`number`	Стандартный максимум при отображении количественных полей в размер `size`/`bandSize` столбцов. Если не задан (по умолчанию), используется размер оси — ширина или высота — минус `1`.
`maxFontSize`	`number`	Стандартный максимум шкалы размера `size`/`fontSize` текстовых примитивов для количественных полей. По умолчанию: `40`.
`maxOpacity`	`number`	Стандартный максимум непрозрачности при отображении поля в канал opacity. По умолчанию: `0.8`.
`maxSize`	`number`	Стандартное максимальное значение шкалы размера точек.
`maxStrokeWidth`	`number`	Стандартный максимум шкалы strokeWidth для примитивов Rule и Line и шкалы size для примитивов Trail. По умолчанию: `4`.
`minBandSize`	`number`	Стандартный минимум шкалы размера `size`/`bandSize` примитивов Bar и Tick для количественных полей. По умолчанию: `2`.
`minFontSize`	`number`	Стандартный минимум шкалы размера `size`/`fontSize` текстовых примитивов для количественных полей. По умолчанию: `8`.
`minOpacity`	`number`	Стандартный минимум непрозрачности при отображении поля в канал opacity. По умолчанию: `0.3`.
`minSize`	`number`	Стандартное минимальное значение шкалы размера точек. По умолчанию: `9`.
`minStrokeWidth`	`number`	Стандартный минимум шкалы strokeWidth для примитивов Rule и Line и шкалы size для примитивов Trail. По умолчанию: `1`.
`offsetBandPaddingInner`	anyOf(`number`, `ExprRef`)	Стандартный внутренний отступ полосовых шкал xOffset и yOffset. По умолчанию: `0`.
`offsetBandPaddingOuter`	anyOf(`number`, `ExprRef`)	Стандартный внешний отступ полосовых шкал xOffset и yOffset. По умолчанию: `0`.
`pointPadding`	anyOf(`number`, `ExprRef`)	Стандартный внешний отступ точечных порядковых шкал x и y. По умолчанию: `0.5`, благодаря чему ширина или высота равна числу уникальных значений, умноженному на шаг.
`quantileCount`	`number`	Стандартное число элементов выходного диапазона квантильной шкалы. По умолчанию: `4`.
`quantizeCount`	`number`	Стандартное число элементов выходного диапазона квантованной шкалы. По умолчанию: `4`.
`rectBandPaddingInner`	anyOf(`number`, `ExprRef`)	Стандартный внутренний отступ полосовых порядковых шкал x и y для примитивов `"rect"`. По умолчанию: `0`.
`round`	anyOf(`boolean`, `ExprRef`)	При `true` числовые выходные значения округляются до целых, что полезно для привязки к пиксельной сетке. Доступно только для шкал x, y и size.
`tickBandPaddingInner`	anyOf(`number`, `ExprRef`)	Стандартный внутренний отступ полосовых порядковых шкал x и y для примитивов `"tick"`. По умолчанию: `0.25`.
`useUnaggregatedDomain`	`boolean`	Использовать диапазон исходных данных до агрегации как область определения шкалы агрегированной оси. Соответствует стандартному заданию `domain: "unaggregate"` для агрегированных количественных полей. Работает только для агрегатных функций с результатом внутри исходного диапазона: `"mean"`, `"average"`, `"median"`, `"q1"`, `"q3"`, `"min"`, `"max"`. Для функций с результатом вне этого диапазона, например `"count"` и `"sum"`, настройка игнорируется. По умолчанию: `false`.
`xReverse`	anyOf(`boolean`, `ExprRef`)	По умолчанию изменять направление шкалы x на обратное; полезно для диаграмм с направлением справа налево.
`zero`	`boolean`	Стандартное значение `scale.zero` для непрерывных шкал, кроме шкал x/y столбчатых диаграмм и диаграмм с областями без заданного диапазона и шкал size. По умолчанию: `true`.

Конфигурация диапазонов шкал

Метод Chart.configure_range настраивает выходные диапазоны шкал и принимает следующие свойства:

Нажмите, чтобы показать таблицу

Свойство	Тип	Описание
`category`	anyOf(`RangeScheme`, array(`Color`))	Стандартная цветовая схема категориальных данных.
`diverging`	anyOf(`RangeScheme`, array(`Color`))	Стандартная цветовая схема расходящихся количественных шкал.
`heatmap`	anyOf(`RangeScheme`, array(`Color`))	Стандартная цветовая схема количественных тепловых карт.
`ordinal`	anyOf(`RangeScheme`, array(`Color`))	Стандартная цветовая схема ранжированных данных.
`ramp`	anyOf(`RangeScheme`, array(`Color`))	Стандартная цветовая схема последовательных количественных шкал.
`symbol`	array(`SymbolShape`)	Массив имён или контуров символов для стандартной палитры форм.

Конфигурация проекций

Метод Chart.configure_projection принимает следующие свойства:

Нажмите, чтобы показать таблицу

Свойство	Тип	Описание
`center`	anyOf(`Vector2<number>`, `ExprRef`)	Центр проекции: массив из долготы и широты в градусах. По умолчанию: `[0, 0]`.
`clipAngle`	anyOf(`number`, `ExprRef`)	Угловой радиус круга обрезки проекции в градусах. При `null` вместо обрезки малым кругом применяется разрез по антимеридиану.
`clipExtent`	anyOf(`Vector2<Vector2<number>>`, `ExprRef`)	Границы обрезки области отображения проекции в пикселях: `[[x0, y0], [x1, y1]]`, где x0 — левый край, y0 — верхний, x1 — правый, y1 — нижний. При `null` обрезка по области отображения не выполняется.
`coefficient`	anyOf(`number`, `ExprRef`)	Параметр coefficient проекции `hammer`. По умолчанию: `2`.
`distance`	anyOf(`number`, `ExprRef`)	Для проекции `satellite` — расстояние от центра сферы до точки наблюдения, выраженное в радиусах сферы. Рекомендуемый максимальный угол обрезки для заданного distance — `acos(1 / distance)`, переведённый в градусы. При дополнительном наклоне может потребоваться более строгая обрезка. По умолчанию: `2.0`.
`extent`	anyOf(`Vector2<Vector2<number>>`, `ExprRef`)
`fit`	anyOf(`Fit`, array(`Fit`), `ExprRef`)
`fraction`	anyOf(`number`, `ExprRef`)	Параметр fraction проекции `bottomley`. По умолчанию: `0.5`, соответствующее sin(ψ) при ψ = π/6.
`lobes`	anyOf(`number`, `ExprRef`)	Число долей проекций, поддерживающих многодольное представление: `berghaus`, `gingery` или `healpix`. Стандартное значение зависит от типа проекции.
`parallel`	anyOf(`number`, `ExprRef`)	Параметр parallel для поддерживающих его проекций: `armadillo`, `bonne`, `craig`, `cylindricalEqualArea`, `cylindricalStereographic`, `hammerRetroazimuthal`, `loximuthal` или `rectangularPolyconic`. Стандартное значение зависит от типа проекции.
`parallels`	anyOf(array(`number`), `ExprRef`)	Две стандартные параллели конической проекции, определяющие расположение карты. Стандартное значение зависит от конкретной конической проекции.
`pointRadius`	anyOf(`number`, `ExprRef`)	Стандартный радиус в пикселях для геометрий GeoJSON Point и MultiPoint. Задаёт постоянное значение по умолчанию. Для изменения радиуса по данным используйте соответствующий параметр преобразований GeoPath и GeoShape. По умолчанию: `4.5`.
`precision`	anyOf(`number`, `ExprRef`)	Порог адаптивной передискретизации проекции в пикселях. Соответствует расстоянию Дугласа — Пекера. Если не задан, возвращается текущая точность передискретизации проекции, стандартное значение которой — `√0.5 ≅ 0.70710…`.
`radius`	anyOf(`number`, `ExprRef`)	Параметр radius проекции `airy` или `gingery`. Стандартное значение зависит от типа проекции.
`ratio`	anyOf(`number`, `ExprRef`)	Параметр ratio проекции `hill`, `hufnagel` или `wagner`. Стандартное значение зависит от типа проекции.
`reflectX`	anyOf(`boolean`, `ExprRef`)	Отражать ли координату x, меняя её знак в выходном результате.
`reflectY`	anyOf(`boolean`, `ExprRef`)	Отражать ли координату y, меняя её знак в выходном результате.
`rotate`	anyOf(anyOf(`Vector2<number>`, `Vector3<number>`), `ExprRef`)	Поворот проекции вокруг сферических осей: массив из двух или трёх углов в градусах `[lambda, phi, gamma]`. Они соответствуют рысканию, тангажу и крену. По умолчанию: `[0, 0, 0]`.
`scale`	anyOf(`number`, `ExprRef`)	Коэффициент масштаба проекции, переопределяющий автоматическую подгонку. Стандартное значение зависит от проекции. Расстояния между проецируемыми точками линейно зависят от коэффициента, но его значения не эквивалентны для разных проекций.
`size`	anyOf(`Vector2<number>`, `ExprRef`)	Вместе с fit задаёт ширину и высоту в пикселях области, к которой автоматически подгоняется проекция.
`spacing`	anyOf(`number`, `ExprRef`)	Параметр spacing проекции `lagrange`. По умолчанию: `0.5`.
`tilt`	anyOf(`number`, `ExprRef`)	Угол наклона проекции `satellite` в градусах. По умолчанию: `0`.
`translate`	anyOf(`Vector2<number>`, `ExprRef`)	Смещение проекции: массив из двух элементов `[tx, ty]`.
`type`	anyOf(`ProjectionType`, `ExprRef`)	Тип картографической проекции. Регистр не учитывается: например, `"albers"` и `"Albers"` задают одну проекцию. Полный перечень см. в документации типов проекций. По умолчанию: `equalEarth`.

Конфигурация объединения и фасетов

Методы Chart.configure_concat и Chart.configure_facet настраивают различные свойства объединённых и фасетных диаграмм:

Нажмите, чтобы показать таблицу

Свойство Тип Описание

Свойство	Тип	Описание
`columns`	`number`	Число столбцов композиции. По умолчанию: `undefined`, то есть неограниченное число столбцов в одной строке. Для `concat` это эквивалент `hconcat`, для `facet` и `repeat` — использование канала `column`. Примечания: Свойство применяется только к переносимому `concat`, а не `hconcat`/`vconcat`, и к `facet`/`repeat` с одним полем или определением повторения без вложенного разбиения по строкам и столбцам. Значение `1` эквивалентно `vconcat` для `concat` и каналу `row` для `facet`/`repeat`.
`spacing`	`number`	Стандартный промежуток между составными представлениями в пикселях. По умолчанию: `20`.

columns

number

Число столбцов композиции.

По умолчанию: undefined, то есть неограниченное число столбцов в одной строке. Для concat это эквивалент hconcat, для facet и repeat — использование канала column.

Примечания:

Свойство применяется только к переносимому concat, а не hconcat/vconcat, и к facet/repeat с одним полем или определением повторения без вложенного разбиения по строкам и столбцам.
Значение 1 эквивалентно vconcat для concat и каналу row для facet/repeat.

spacing

number

Стандартный промежуток между составными представлениями в пикселях.

По умолчанию: 20.

Конфигурация выборов

Метод Chart.configure_selection принимает следующие свойства:

Нажмите, чтобы показать таблицу

Свойство Тип Описание

Свойство	Тип	Описание
`interval`	`IntervalSelectionConfigWithoutType`	Стандартное определение интервального выбора. Допустимы все свойства и преобразования интервального выбора, кроме `type`. Например, `interval: {"translate": false}` по умолчанию отключает перемещение области выбора.
`point`	`PointSelectionConfigWithoutType`	Стандартное определение точечного выбора. Допустимы все свойства и преобразования точечного выбора, кроме `type`. Например, `point: {"on": "dblclick"}` по умолчанию задаёт выбор двойным щелчком.

interval

IntervalSelectionConfigWithoutType

Стандартное определение интервального выбора. Допустимы все свойства и преобразования интервального выбора, кроме type.

Например, interval: {"translate": false} по умолчанию отключает перемещение области выбора.

point

PointSelectionConfigWithoutType

Стандартное определение точечного выбора. Допустимы все свойства и преобразования точечного выбора, кроме type.

Например, point: {"on": "dblclick"} по умолчанию задаёт выбор двойным щелчком.

Конфигурация заголовка диаграммы

Метод Chart.configure_title задаёт шрифт, цвет, положение и ориентацию заголовка. Пример:

import altair as alt
from altair.datasets import data

source = data.cars.url

chart = alt.Chart(source).mark_point().encode(
    x='Horsepower:Q',
    y='Miles_per_Gallon:Q',
).properties(
    title='Cars Data'
)

chart.configure_title(
    fontSize=20,
    font='Courier',
    anchor='start',
    color='gray'
)

Дополнительные свойства:

Нажмите, чтобы показать таблицу

Свойство	Тип	Описание
`align`	`Align`	Горизонтальное выравнивание текста заголовка: `"left"`, `"center"` или `"right"`.
`anchor`	anyOf(`TitleAnchor`, `ExprRef`)	Положение точки привязки заголовка и подзаголовка: `"start"`, `"middle"` или `"end"`. При расположении сверху эти значения соответствуют выравниванию слева, по центру и справа.
`angle`	anyOf(`number`, `ExprRef`)	Угол поворота заголовка и подзаголовка в градусах.
`aria`	anyOf(`boolean`, `ExprRef`)	Включать ли атрибуты ARIA (только SVG). При `false` группе SVG задаётся атрибут `aria-hidden`, исключающий заголовок из дерева доступности ARIA. По умолчанию: `true`.
`baseline`	`TextBaseline`	Вертикальная базовая линия заголовка и подзаголовка: `"alphabetic"` (по умолчанию), `"top"`, `"middle"`, `"bottom"`, `"line-top"` или `"line-bottom"`. Последние два значения похожи на `"top"` и `"bottom"`, но рассчитываются относительно lineHeight, а не только fontSize.
`color`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Цвет текста заголовка.
`dx`	anyOf(`number`, `ExprRef`)	Дополнительное смещение координаты x заголовка и подзаголовка.
`dy`	anyOf(`number`, `ExprRef`)	Дополнительное смещение координаты y заголовка и подзаголовка.
`font`	anyOf(`string`, `ExprRef`)	Название шрифта заголовка.
`fontSize`	anyOf(`number`, `ExprRef`)	Размер шрифта заголовка в пикселях.
`fontStyle`	anyOf(`FontStyle`, `ExprRef`)	Начертание шрифта заголовка.
`fontWeight`	anyOf(`FontWeight`, `ExprRef`)	Насыщенность шрифта заголовка: строка, например `"bold"` или `"normal"`, либо число `100`, `200`, `300`, …, `900`. Значению `"normal"` соответствует `400`, а `"bold"` — `700`.
`frame`	anyOf(anyOf(`TitleFrame`, `string`), `ExprRef`)	Область отсчёта точки привязки: `"bounds"` — весь ограничивающий прямоугольник, `"group"` — ширина или высота группы.
`limit`	anyOf(`number`, `ExprRef`)	Максимальная допустимая длина заголовка и подзаголовка в пикселях.
`lineHeight`	anyOf(`number`, `ExprRef`)	Высота строки в пикселях для многострочного заголовка или текста с базовой линией `"line-top"` или `"line-bottom"`.
`offset`	anyOf(`number`, `ExprRef`)	Перпендикулярное смещение группы заголовка в пикселях относительно её положения у края диаграммы.
`orient`	anyOf(`TitleOrient`, `ExprRef`)	Стандартное расположение заголовка: `"top"`, `"bottom"`, `"left"` или `"right"`.
`subtitleColor`	anyOf(anyOf(`null`, `Color`), `ExprRef`)	Цвет текста подзаголовка.
`subtitleFont`	anyOf(`string`, `ExprRef`)	Название шрифта подзаголовка.
`subtitleFontSize`	anyOf(`number`, `ExprRef`)	Размер шрифта подзаголовка в пикселях.
`subtitleFontStyle`	anyOf(`FontStyle`, `ExprRef`)	Начертание шрифта подзаголовка.
`subtitleFontWeight`	anyOf(`FontWeight`, `ExprRef`)	Насыщенность шрифта подзаголовка: строка, например `"bold"` или `"normal"`, либо число `100`, `200`, `300`, …, `900`. Значению `"normal"` соответствует `400`, а `"bold"` — `700`.
`subtitleLineHeight`	anyOf(`number`, `ExprRef`)	Высота строки многострочного подзаголовка в пикселях.
`subtitlePadding`	anyOf(`number`, `ExprRef`)	Отступ между заголовком и подзаголовком в пикселях.
`zindex`	anyOf(`number`, `ExprRef`)	Целочисленный z-index, определяющий порядок слоя группы заголовка относительно осей, примитивов и легенд. По умолчанию: `0`.

Конфигурация области отображения

Метод Chart.configure_view настраивает область отображения — часть экрана, в которой показываются данные и шкалы. Вот несколько доступных визуальных настроек:

import altair as alt
from altair.datasets import data

source = data.cars.url

chart = alt.Chart(source).mark_point().encode(
    x='Horsepower:Q',
    y='Miles_per_Gallon:Q',
)

chart.configure_view(
    continuousHeight=200,
    continuousWidth=200,
    strokeWidth=4,
    fill='#FFEEDD',
    stroke='red',
)

Дополнительные свойства приведены в таблице:

Нажмите, чтобы показать таблицу

Свойство	Тип	Описание
`clip`	`boolean`	Обрезать ли отображение по границам области.
`continuousHeight`	`number`	Стандартная высота при непрерывном поле по вертикали или широте, а также для примитивов Arc. По умолчанию: `300`.
`continuousWidth`	`number`	Стандартная ширина при непрерывном поле x или longitude, а также для примитивов Arc. По умолчанию: `300`.
`cornerRadius`	anyOf(`number`, `ExprRef`)	Радиус скругления углов прямоугольников или дуг в пикселях. По умолчанию: `0`.
`cursor`	`Cursor`	Курсор мыши над областью отображения. Допустим любой корректный тип курсора CSS.
`discreteHeight`	anyOf(`number`, dict)	Стандартная высота для примитивов, отличных от Arc, при дискретном поле y или отсутствии поля y. Число задаёт фиксированную высоту, а объект `{step: number}` — высоту одного дискретного шага. По умолчанию: размер шага на основе `config.view.step`.
`discreteWidth`	anyOf(`number`, dict)	Стандартная ширина для примитивов, отличных от Arc, при дискретном поле x или отсутствии поля x. Число задаёт фиксированную ширину, а объект `{step: number}` — ширину одного дискретного шага. По умолчанию: размер шага на основе `config.view.step`.
`fill`	anyOf(`Color`, `null`, `ExprRef`)	Цвет заливки. По умолчанию: `undefined`.
`fillOpacity`	anyOf(`number`, `ExprRef`)	Непрозрачность заливки в диапазоне `[0,1]`. По умолчанию: `1`.
`opacity`	anyOf(`number`, `ExprRef`)	Общая непрозрачность в диапазоне `[0,1]`. По умолчанию: `0.7` для неагрегированных диаграмм с point, tick, circle, square или столбчатых диаграмм со слоями; иначе `1`.
`step`	`number`	Стандартный размер шага дискретных полей x и y.
`stroke`	anyOf(`Color`, `null`, `ExprRef`)	Цвет обводки. По умолчанию: `"#ddd"`.
`strokeCap`	anyOf(`StrokeCap`, `ExprRef`)	Форма концов линии: `"butt"`, `"round"` или `"square"`. По умолчанию: `"butt"`.
`strokeDash`	anyOf(array(`number`), `ExprRef`)	Массив чередующихся длин штриха и промежутка для пунктирных и штриховых линий.
`strokeDashOffset`	anyOf(`number`, `ExprRef`)	Смещение в пикселях, с которого начинается рисунок штриховой линии.
`strokeJoin`	anyOf(`StrokeJoin`, `ExprRef`)	Способ соединения сегментов обводки: `"miter"`, `"round"` или `"bevel"`. По умолчанию: `"miter"`.
`strokeMiterLimit`	anyOf(`number`, `ExprRef`)	Предел острого соединения, при превышении которого оно срезается.
`strokeOpacity`	anyOf(`number`, `ExprRef`)	Непрозрачность обводки в диапазоне `[0,1]`. По умолчанию: `1`.
`strokeWidth`	anyOf(`number`, `ExprRef`)	Толщина обводки в пикселях.