顶级图表配置#

图表外观的许多方面都可以使用 configure_*() 方法在顶级进行配置。这些方法及其设置的属性仅在图表顶级有效,可以被视为设置图表主题的一种方式:它们为整个图表设置默认样式,并且这些默认样式可以被与图表元素相关的特定样式设置所覆盖。

这些方法及其参数将在下面列出

有关图表定制方法的更多讨论,请参见自定义可视化

图表配置#

Chart.configure() 方法为图表添加一个 Config 实例,并接受以下参数

点击显示表格

属性

类型

描述

arc

RectConfig

弧形特定配置

area

AreaConfig

面积特定配置

aria

布尔值

一个布尔标志,指示是否应包含标记和指南的 ARIA 默认属性(仅限 SVG 输出)。如果为 false,则将为所有指南设置 "aria-hidden" 属性,将其从 ARIA 可访问性树中移除,并且 Vega-Lite 不会为标记生成默认描述。

默认值: true

autosize

anyOf(AutosizeType, AutoSizeParams)

如何确定可视化尺寸。如果为字符串,应为 "pad""fit""none" 之一。对象值还可以指定内容尺寸和自动调整尺寸的参数。

默认值: pad

axis

AxisConfig

坐标轴配置,它决定了所有 x 轴和 y 轴的默认属性 <https://vega.github.io/vega-lite/docs/axis.html>。有关坐标轴配置选项的完整列表,请参见坐标轴文档的相应部分 <https://vega.github.io/vega-lite/docs/axis.html#config>

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

带有“band”比例尺的 x 轴配置。

axisXDiscrete

AxisConfig

带有“point”或“band”比例尺的 x 轴配置。

axisXPoint

AxisConfig

带有“point”比例尺的 x 轴配置。

axisXQuantitative

AxisConfig

定量 x 轴配置。

axisXTemporal

AxisConfig

时间 x 轴配置。

axisY

AxisConfig

Y 轴特定配置。

axisYBand

AxisConfig

带有“band”比例尺的 y 轴配置。

axisYDiscrete

AxisConfig

带有“point”或“band”比例尺的 y 轴配置。

axisYPoint

AxisConfig

带有“point”比例尺的 y 轴配置。

axisYQuantitative

AxisConfig

定量 y 轴配置。

axisYTemporal

AxisConfig

时间 y 轴配置。

background

anyOf(Color, ExprRef)

用作整个视图背景的 CSS 颜色属性。

默认值: "white"

bar

BarConfig

条形特定配置

boxplot

BoxPlotConfig

箱体配置

circle

MarkConfig

圆形特定配置

concat

CompositionConfig

所有 concatenation 和 repeat 视图组合操作符(concat, hconcat, vconcatrepeat)的默认配置

countTitle

字符串

计数字段的默认坐标轴和图例标题。

默认值: 'Count of Records

customFormatTypes

布尔值

允许文本标记和指南的 formatType 属性接受注册为 Vega 表达式 <https://vega.github.io/vega-lite/usage/compile.html#format-type>__ 的自定义格式化函数。

errorband

ErrorBandConfig

误差带配置

errorbar

ErrorBarConfig

误差棒配置

facet

CompositionConfig

facet 视图组合操作符的默认配置

fieldTitle

[‘verbal’, ‘functional’, ‘plain’]

定义 Vega-Lite 如何为字段生成标题。有三种可能的样式

  • "verbal"(默认)- 以口头样式显示函数(例如,“字段之和”、“日期的年-月”、“字段(分箱后)”)。

  • "function" - 使用括号和大写文本显示函数(例如,“SUM(field)”、“YEARMONTH(date)”、“BIN(field)”)。

  • "plain" - 仅显示字段名称,不带函数(例如,“field”、“date”、“field”)。

font

字符串

所有文本标记、标题和标签的默认字体。

geoshape

MarkConfig

地理图形特定配置

header

HeaderConfig

头部配置,它决定了所有头部 <https://vega.github.io/vega-lite/docs/header.html>__ 的默认属性。

有关头部配置选项的完整列表,请参见头部文档中的相应部分 <https://vega.github.io/vega-lite/docs/header.html#config>__。

headerColumn

HeaderConfig

头部配置,它决定了列头部 <https://vega.github.io/vega-lite/docs/header.html>__ 的默认属性。

有关头部配置选项的完整列表,请参见头部文档中的相应部分 <https://vega.github.io/vega-lite/docs/header.html#config>__。

headerFacet

HeaderConfig

头部配置,它决定了非行/列 Facet 头部 <https://vega.github.io/vega-lite/docs/header.html>__ 的默认属性。

有关头部配置选项的完整列表,请参见头部文档中的相应部分 <https://vega.github.io/vega-lite/docs/header.html#config>__。

headerRow

HeaderConfig

头部配置,它决定了行头部 <https://vega.github.io/vega-lite/docs/header.html>__ 的默认属性。

有关头部配置选项的完整列表,请参见头部文档中的相应部分 <https://vega.github.io/vega-lite/docs/header.html#config>__。

image

RectConfig

图像特定配置

legend

LegendConfig

图例配置,它决定了所有图例 <https://vega.github.io/vega-lite/docs/legend.html>__ 的默认属性。有关图例配置选项的完整列表,请参见图例文档中的相应部分 <https://vega.github.io/vega-lite/docs/legend.html#config>__。

line

LineConfig

折线特定配置

lineBreak

anyOf(string, ExprRef)

用于将文本字符串断开为多行的分隔符,例如换行符。此属性为文本标记提供全局默认值,该值会被标记或样式配置设置以及 lineBreak 标记编码通道覆盖。如果为信号值,则字符串或正则表达式(regexp)值均有效。

locale

Locale

用于字符串解析和数字与日期值格式化的区域设置定义。区域设置对象应包含带有区域设置定义 <https://vega.github.io/vega/docs/api/locale/>__ 的 number 和/或 time 属性。配置块中提供的区域设置定义可能会被 View 构造函数的 locale 选项覆盖。

mark

MarkConfig

标记配置

normalizedNumberFormat

字符串

如果未指定 normalizedNumberFormatType,则使用 D3 数字格式用于归一化堆叠字段(带有 stack: "normalize" 的字段)的坐标轴标签、文本标记和工具提示。例如,"s" 表示 SI 单位。使用D3 的数字格式模式 <https://github.com/d3/d3-format#locale_format>__。

如果指定了 config.normalizedNumberFormatType 并且 config.customFormatTypestrue,则此值将作为 formatdatum.value 一起传递给 config.numberFormatType 函数。默认值: %

normalizedNumberFormatType

字符串

config.normalizedNumberFormat自定义格式类型 <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>__。

默认值: undefined – 这等同于调用 D3-format,D3-format 作为format 在 Vega 表达式中公开 <https://vega.github.io/vega/docs/expressions/#format>__。注意:您还必须将 customFormatTypes 设置为 true 才能使用此功能。

numberFormat

字符串

如果未指定 numberFormatType,则使用 D3 数字格式用于非归一化字段(带有 stack: "normalize" 的字段)的指南标签、文本标记和工具提示。例如,"s" 表示 SI 单位。使用D3 的数字格式模式 <https://github.com/d3/d3-format#locale_format>__。

如果指定了 config.numberFormatType 并且 config.customFormatTypestrue,则此值将作为 formatdatum.value 一起传递给 config.numberFormatType 函数。

numberFormatType

字符串

config.numberFormat自定义格式类型 <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>__。

默认值: undefined – 这等同于调用 D3-format,D3-format 作为format 在 Vega 表达式中公开 <https://vega.github.io/vega/docs/expressions/#format>__。注意:您还必须将 customFormatTypes 设置为 true 才能使用此功能。

padding

anyOf(Padding, ExprRef)

默认可视化内边距,以像素为单位,从可视化画布边缘到数据矩形。如果为数字,则指定所有边的内边距。如果为对象,则值应采用 {"left": 5, "top": 5, "right": 5, "bottom": 5} 格式,以指定可视化每一边的内边距。

默认值: 5

params

数组(TopLevelParameter)

参数化可视化的动态变量或选择。

point

MarkConfig

点特定配置

projection

ProjectionConfig

投影配置,它决定了所有投影 <https://vega.github.io/vega-lite/docs/projection.html>__ 的默认属性。有关投影配置选项的完整列表,请参见投影文档的相应部分 <https://vega.github.io/vega-lite/docs/projection.html#config>__。

range

RangeConfig

一个对象哈希,定义用于比例尺的默认范围数组或方案。有关比例尺范围配置选项的完整列表,请参见比例尺文档的相应部分 <https://vega.github.io/vega-lite/docs/scale.html#config>__。

rect

RectConfig

矩形特定配置

rule

MarkConfig

规则线特定配置

scale

ScaleConfig

比例尺配置决定了所有比例尺 <https://vega.github.io/vega-lite/docs/scale.html>__ 的默认属性。有关比例尺配置选项的完整列表,请参见比例尺文档的相应部分 <https://vega.github.io/vega-lite/docs/scale.html#config>__。

selection

SelectionConfig

一个对象哈希,用于定义每种选择类型的默认属性。

square

MarkConfig

正方形特定配置

style

StyleConfigIndex

一个对象哈希,定义键值映射,以确定具有给定样式 <https://vega.github.io/vega-lite/docs/mark.html#mark-def>__ 的标记的默认属性。键表示样式名称;值必须是有效的标记配置对象 <https://vega.github.io/vega-lite/docs/mark.html#config>__。

text

MarkConfig

文本特定配置

tick

TickConfig

刻度特定配置

timeFormat

字符串

文本标记、图例标签和头部标签中原始时间值(不带时间单位)的默认时间格式。

默认值: "%b %d, %Y" 注意:坐标轴会自动确定每个标签的格式,因此此配置不影响坐标轴。

timeFormatType

字符串

config.timeFormat自定义格式类型 <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>__。

默认值: undefined – 这等同于调用 D3-time-format,D3-time-format 作为timeFormat 在 Vega 表达式中公开 <https://vega.github.io/vega/docs/expressions/#timeFormat>__。注意:您还必须将 customFormatTypes 设置为 true,并且必须定义 timeUnit 才能使用此功能。

title

TitleConfig

标题配置,它决定了所有标题 <https://vega.github.io/vega-lite/docs/title.html>__ 的默认属性。有关标题配置选项的完整列表,请参见标题文档的相应部分 <https://vega.github.io/vega-lite/docs/title.html#config>__。

tooltipFormat

FormatConfig

为工具提示定义自定义格式配置 <https://vega.github.io/vega-lite/docs/config.html#format>__。如果未指定,将应用默认格式配置。

trail

LineConfig

轨迹线特定配置

view

ViewConfig

单一视图图 <https://vega.github.io/vega-lite/docs/spec.html#single>__ 的默认属性。

坐标轴配置#

坐标轴配置定义了坐标轴的默认设置,可以使用 Chart.configure_axis() 方法进行设置。此处定义的属性适用于图中的所有坐标轴。

附加的属性块可以根据方向(“axisX”、“axisY”、“axisLeft”、“axisTop”等)或 band 比例尺类型(“axisBand”)定位更具体的坐标轴类型。例如,在“axisBand”属性下定义的属性仅适用于显示“band”比例尺的坐标轴。如果多个坐标轴配置块应用于单个坐标轴,则基于类型的选项优先于基于方向的选项,后者又优先于通用选项。

方法如下

  • 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 属性 <https://mdn.org.cn/en-US/docs/Web/Accessibility/ARIA>__(仅限 SVG 输出)。如果为 false,则将在输出的 SVG 组上设置“aria-hidden”属性,从而将坐标轴从 ARIA 可访问性树中移除。

默认值: true

bandPosition

anyOf(number, ExprRef)

一个插值分数,指示对于 band 比例尺,坐标轴刻度应放置在哪里。值为 0 时,刻度位于其 band 的左边缘。值为 0.5 时,刻度位于其 band 的中间。

默认值: 0.5

description

anyOf(string, ExprRef)

此坐标轴的文本描述,用于ARIA 可访问性 <https://mdn.org.cn/en-US/docs/Web/Accessibility/ARIA>__(仅限 SVG 输出)。如果 aria 属性为 true,对于 SVG 输出,将把"aria-label" 属性 <https://mdn.org.cn/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>__ 设置为此描述。如果未指定描述,将自动生成。

disable

布尔值

默认禁用坐标轴。

domain

布尔值

一个布尔标志,指示域(坐标轴基线)是否应作为坐标轴的一部分包含在内。

默认值: true

domainCap

anyOf(StrokeCap, ExprRef)

域线的末端样式笔触帽。可选值包括 "butt""round""square"

默认值: "butt"

domainColor

anyOf(anyOf(null, Color), ExprRef)

坐标轴域线的颜色。

默认值: "gray"

domainDash

anyOf(数组(number), ExprRef)

用于虚线域线的交替 [stroke, space] 长度数组。

domainDashOffset

anyOf(number, ExprRef)

开始使用域虚线数组绘制的像素偏移量。

domainOpacity

anyOf(number, ExprRef)

坐标轴域线的透明度。

domainWidth

anyOf(number, ExprRef)

坐标轴域线的笔触宽度

默认值: 1

format

anyOf(string, Dict)

与默认的 "number""time" 格式类型一起使用时,用于指南(坐标轴、图例、头部)标签和文本标记的文本格式模式。

  • 如果格式类型为 "number"(例如,用于定量字段),这是 D3 的数字格式模式 <https://github.com/d3/d3-format#locale_format>__。

  • 如果格式类型为 "time"(例如,用于时间字段),这是 D3 的时间格式模式 <https://github.com/d3/d3-time-format#locale_format>__。

有关更多示例,请参见格式文档 <https://vega.github.io/vega-lite/docs/format.html>__。

自定义 formatType <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>__ 一起使用时,此值将作为 formatdatum.value 一起传递给注册的函数。

默认值: 数字格式的 numberFormat <https://vega.github.io/vega-lite/docs/config.html#format>__ 配置和时间格式的 timeFormat <https://vega.github.io/vega-lite/docs/config.html#format>__ 配置派生而来。

formatType

字符串

标签的格式类型。可选值包括 "number""time",或注册的自定义格式类型 <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>__。

默认值

  • 时间字段以及带有 timeUnit 的有序和无序字段,默认为 "time"

  • 定量字段以及不带 timeUnit 的有序和无序字段,默认为 "number"

grid

布尔值

一个布尔标志,指示网格线是否应作为坐标轴的一部分包含在内

默认值: 对于未分箱的连续比例尺 <https://vega.github.io/vega-lite/docs/scale.html#continuous>__ 为 true;否则为 false

gridCap

anyOf(StrokeCap, ExprRef)

网格线的末端样式笔触帽。可选值包括 "butt""round""square"

默认值: "butt"

gridColor

anyOf(anyOf(null, Color), ExprRef, ConditionalAxisColor)

网格线的颜色。

默认值: "lightGray"

gridDash

anyOf(数组(number), ExprRef, ConditionalAxisNumberArray)

用于虚线网格线的交替 [stroke, space] 长度数组。

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""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

字符串

用于自定义标签的Vega 表达式 <https://vega.github.io/vega/docs/expressions/>__。

注意:可以通过坐标轴底层 datum 对象的 labelvalue 属性访问标签文本和值。

labelFlush

[布尔值, 数字]

指示第一个和最后一个坐标轴标签是否应与比例尺范围齐平对齐。水平坐标轴的齐平对齐将左对齐第一个标签并右对齐最后一个标签。对于垂直坐标轴,则应用底部和顶部文本基线。如果此属性是数字,它还指示偏移第一个和最后一个标签的像素数;例如,值为 2 将齐平对齐第一个和最后一个标签,并将其从坐标轴中心向外推出 2 像素。额外的调整有时有助于标签更好地与相应的坐标轴刻度在视觉上分组。

默认值: 对于连续 x 比例尺的坐标轴为 true。否则为 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

布尔值

一个布尔标志,指示是否应将标签包含在坐标轴中。

默认值: true

maxExtent

anyOf(number, ExprRef)

坐标轴刻度和标签应使用的最大像素范围。这确定了坐标轴标题的最大偏移值。

默认值: undefined

minExtent

anyOf(number, ExprRef)

坐标轴刻度和标签应使用的最小像素范围。这确定了坐标轴标题的最小偏移值。

默认值: y 轴为 30;x 轴为 undefined

offset

anyOf(number, ExprRef)

坐标轴相对于包含组或数据矩形边缘的像素偏移量。

默认值:axis config <https://vega.github.io/vega-lite/docs/config.html#facet-scale-config>__ 的 offset 派生而来(默认为 0

orient

anyOf(AxisOrient, ExprRef)

坐标轴的方向。可选值包括 "top""bottom""left""right"。方向可用于进一步指定坐标轴类型(例如,朝向图表右边缘的 y 轴)。

默认值: x 轴为 "bottom",y 轴为 "left"

position

anyOf(number, ExprRef)

坐标轴的锚点位置(像素)。对于朝向顶部或底部的 x 轴,这设置了坐标轴组的 x 坐标。对于朝向左侧或右侧的 y 轴,这设置了坐标轴组的 y 坐标。

默认值: 0

style

anyOf(string, array(string))

一个字符串或字符串数组,指示要应用于坐标轴的自定义样式名称。样式是在 style configuration <https://vega.github.io/vega-lite/docs/mark.html#style-config>__ 中定义的坐标轴属性的命名集合。如果 style 是一个数组,后面的样式将覆盖前面的样式。

默认值: (无) 注意: 任何指定的样式都会增强默认样式。例如,带有 "style": "foo" 的 x 轴标记将使用 config.axisXconfig.style.foo(指定的样式 "foo" 具有更高的优先级)。

tickBand

anyOf([‘center’, ‘extent’], ExprRef)

对于 band 比例尺,指示刻度和网格线是放置在 band 的 "center"(默认值)还是放置在 band 的 "extent"s 以指示区间

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} 的对象值间隔指定器包含期望的间隔步数。在此,刻度将为每个季度(1 月、4 月、7 月、10 月)边界生成。

默认值: 使用公式确定,x 为 ceil(width/40),y 为 ceil(height/40)

tickDash

anyOf(数组(number), ExprRef, ConditionalAxisNumberArray)

用于虚线刻度线的交替 [描边, 间隙] 长度数组。

tickDashOffset

anyOf(number, ExprRef, ConditionalAxisNumber)

开始绘制刻度线虚线数组的像素偏移量。

tickExtra

布尔值

一个布尔标志,指示是否应为坐标轴的起始位置添加额外的坐标轴刻度。此标志对于为 band 比例尺设置坐标轴样式非常有用,以便将刻度放置在 band 边界而不是 band 中间。与 "bandPosition": 1 和坐标轴 "padding" 值为 0 一起使用。

tickMinStep

anyOf(number, ExprRef)

坐标轴刻度之间的最小期望步长,以比例尺域值表示。例如,值 1 表示刻度之间不应小于 1 个单位的距离。如果指定了 tickMinStep,必要时将调整 tickCount 值以强制执行最小步长值。

tickOffset

anyOf(number, ExprRef)

应用于刻度、标签和网格线的像素位置偏移量。

tickOpacity

anyOf(number, ExprRef, ConditionalAxisNumber)

刻度的不透明度。

tickRound

布尔值

一个布尔标志,指示像素位置值是否应四舍五入到最接近的整数。

默认值: true

tickSize

anyOf(number, ExprRef, ConditionalAxisNumber)

坐标轴刻度的像素大小。

默认值: 5

tickWidth

anyOf(number, ExprRef, ConditionalAxisNumber)

刻度的像素宽度。

默认值: 1

ticks

布尔值

一个布尔值,确定坐标轴是否应包含刻度。

默认值: true

title

anyOf(Text, null)

字段的标题。如果为 null,则移除标题。

默认值: 由字段名称和转换函数(aggregatebintimeUnit)派生。如果字段具有聚合函数,则该函数作为标题的一部分显示(例如,"Sum of Profit")。如果字段被分箱或应用了时间单位,则应用的函数显示在括号中(例如,"Profit (binned)""Transaction Date (year-month)")。否则,标题仅为字段名称。

注意:

  1. 您可以通过在 config <https://vega.github.io/vega-lite/docs/config.html>__ 中提供 fieldTitle <https://vega.github.io/vega-lite/docs/config.html#top-level-config>__ 属性或通过 compile function's options <https://vega.github.io/vega-lite/usage/compile.html#field-title>__ 提供 fieldTitle function 来自定义默认字段标题格式。

  2. 如果同时定义了字段定义的 title 和坐标轴、标题或图例的 title,则使用坐标轴/标题/图例的标题。

titleAlign

anyOf(Align, ExprRef)

坐标轴标题的水平文本对齐方式。

titleAnchor

anyOf(TitleAnchor, ExprRef)

用于放置坐标轴标题的文本锚点位置。

titleAngle

anyOf(number, ExprRef)

坐标轴标题的旋转角度(度)。

titleBaseline

anyOf(TextBaseline, ExprRef)

坐标轴标题的垂直文本基线。可选值包括 "alphabetic"(默认值)、"top""middle""bottom""line-top""line-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")或数字(100200300、……、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)

坐标轴布局的坐标空间平移偏移量。默认情况下,坐标轴会进行 x 和 y 坐标各 0.5 像素的平移偏移,以便使描边线与像素网格对齐。但是,对于矢量图形输出,这些像素特定的调整可能是不期望的,此时可以更改 translate(例如,更改为零)。

默认值: 0.5

values

anyOf(array(number), array(string), array(boolean), array(DateTime), ExprRef)

显式设置可见的坐标轴刻度值。

zindex

number

一个非负整数,表示坐标轴的 z-index。如果 zindex 为 0,则坐标轴应绘制在所有图表元素后面。若要将它们置于前面,将 zindex 设置为 1 或更大。

默认值: 0(在标记后面)。

标题配置#

标题配置定义了标题的默认设置,包括标题和标签的字体、颜色、大小和位置,可以使用 Chart.configure_header() 方法进行设置。这里有一个例子

import altair as alt
from vega_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

anyOf(string, Dict)

与默认的 "number""time" 格式类型一起使用时,用于指南(坐标轴、图例、头部)标签和文本标记的文本格式模式。

  • 如果格式类型为 "number"(例如,用于定量字段),这是 D3 的数字格式模式 <https://github.com/d3/d3-format#locale_format>__。

  • 如果格式类型为 "time"(例如,用于时间字段),这是 D3 的时间格式模式 <https://github.com/d3/d3-time-format#locale_format>__。

有关更多示例,请参见格式文档 <https://vega.github.io/vega-lite/docs/format.html>__。

自定义 formatType <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>__ 一起使用时,此值将作为 formatdatum.value 一起传递给注册的函数。

默认值: 数字格式的 numberFormat <https://vega.github.io/vega-lite/docs/config.html#format>__ 配置和时间格式的 timeFormat <https://vega.github.io/vega-lite/docs/config.html#format>__ 配置派生而来。

formatType

字符串

标签的格式类型。可选值包括 "number""time",或注册的自定义格式类型 <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>__。

默认值

  • 时间字段以及带有 timeUnit 的有序和无序字段,默认为 "time"

  • 定量字段以及不带 timeUnit 的有序和无序字段,默认为 "number"

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""line-top""line-bottom" 值的作用类似于 "top""bottom",但它们是相对于 titleLineHeight 而不是仅相对于 titleFontSize 计算的。

labelColor

anyOf(Color, ExprRef)

标题标签的颜色,可以是十六进制颜色码或常规颜色名称。

labelExpr

字符串

用于自定义标签的Vega 表达式 <https://vega.github.io/vega/docs/expressions/>__。

注意: 标签文本和值可以通过标题的后端 datum 对象的 labelvalue 属性访问。

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

布尔值

一个布尔标志,指示是否应将标签包含在标题中。

默认值: 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""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")或数字(100200300、……、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 vega_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 attributes <https://mdn.org.cn/en-US/docs/Web/Accessibility/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 accessibility <https://mdn.org.cn/en-US/docs/Web/Accessibility/ARIA>__(仅限 SVG 输出)。如果 aria 属性为 true,对于 SVG 输出,将 "aria-label" attribute <https://mdn.org.cn/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>__ 设置为此描述。如果未指定描述,则会自动生成。

direction

Orientation

图例的方向,可选值包括 "vertical""horizontal"

默认值

  • 对于朝向顶部/底部的图例,方向为 "horizontal"

  • 对于朝向左侧/右侧的图例,方向为 "vertical"

  • 对于朝向顶部/底部-左侧/右侧的图例,渐变图例方向为 "horizontal",符号图例方向为 "vertical"

disable

布尔值

默认禁用图例

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。有关更多信息,请参阅 grid layout documentation <https://vega.github.io/vega/docs/layout>__。

默认值: "each"

labelAlign

anyOf(Align, ExprRef)

图例标签的对齐方式,可以是左对齐、居中对齐或右对齐。

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)

朝向为“none”的图例的自定义 x 位置。

legendY

anyOf(number, ExprRef)

朝向为“none”的图例的自定义 y 位置。

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(数组(number), ExprRef)

整个图例的边框描边虚线模式。

strokeWidth

anyOf(number, ExprRef)

整个图例的边框描边宽度。

symbolBaseFillColor

anyOf(anyOf(null, Color), ExprRef)

图例符号的默认填充颜色。仅在图例没有 "fill" 比例颜色编码时应用。

默认值: "transparent"

symbolBaseStrokeColor

anyOf(anyOf(null, Color), ExprRef)

图例符号的默认描边颜色。仅在图例没有 "fill" 比例颜色编码时应用。

默认值: "gray"

symbolDash

anyOf(数组(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(默认值)、squarecrossdiamondtriangle-uptriangle-downtriangle-righttriangle-left,直线符号 stroke,或中心对齐的方向形状 arrowwedgetriangle。或者,可以提供自定义 SVG path string <https://mdn.org.cn/en-US/docs/Web/SVG/Tutorial/Paths>__。为了获得正确的大小,自定义形状路径应定义在一个正方形边界框内,其 x 和 y 维度坐标范围从 -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""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")或数字(100200300、……、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() 方法设置,该方法设置图表中所有标记的默认属性。此外,配置对象还使用标记类型(例如 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 attributes <https://mdn.org.cn/en-US/docs/Web/Accessibility/ARIA>__(仅限 SVG 输出)。如果为 false,则在输出 SVG 元素上设置“aria-hidden”属性,将标记项从 ARIA 可访问性树中移除。

ariaRole

anyOf(string, ExprRef)

为标记项设置用户界面元素的类型,用于 ARIA accessibility <https://mdn.org.cn/en-US/docs/Web/Accessibility/ARIA>__(仅限 SVG 输出)。如果指定,此属性确定“role”属性。警告:此属性为实验性属性,将来可能会更改。

ariaRoleDescription

anyOf(string, ExprRef)

标记项角色的可读、作者本地化的描述,用于 ARIA accessibility <https://mdn.org.cn/en-US/docs/Web/Accessibility/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 <https://mdn.org.cn/en-US/docs/Web/CSS/mix-blend-mode>__ 值。

默认值: "source-over"

color

anyOf(Color, Gradient, ExprRef)

默认颜色。

默认值: :raw-html:<span style="color: #4682b4;"> ■ :raw-html:</span> "#4682b4"

注意

  • 此属性不能在 style config <https://vega.github.io/vega-lite/docs/mark.html#style-config>__ 中使用。

  • The fill and stroke properties have higher precedence than color and will override 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 cursor type <https://mdn.org.cn/en-US/docs/Web/CSS/cursor#Values>__ 值。

description

anyOf(string, ExprRef)

标记项的文本描述,用于 ARIA accessibility <https://mdn.org.cn/en-US/docs/Web/Accessibility/ARIA>__(仅限 SVG 输出)。如果指定,此属性确定 "aria-label" attribute <https://mdn.org.cn/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>__。

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)

弧形标记的结束角度(弧度)。值 0 表示向上(北方),值增大表示顺时针方向。

fill

anyOf(Color, Gradient, null, ExprRef)

默认填充颜色。此属性的优先级高于 config.color。设置为 null 可移除填充。

默认值: (无)

fillOpacity

anyOf(number, ExprRef)

填充不透明度(值在 [0,1] 之间)。

默认值: 1

filled

布尔值

标记的颜色是作为填充颜色使用还是作为描边颜色使用。

默认值: 对于所有 pointlinerule 标记以及 graticule <https://vega.github.io/vega-lite/docs/data.html#graticule>__ 数据源的 geoshape 标记为 false;否则为 true

注意: 此属性不能在 style config <https://vega.github.io/vega-lite/docs/mark.html#style-config>__ 中使用。

font

anyOf(string, ExprRef)

设置文本的字体(例如,"Helvetica Neue")。

fontSize

anyOf(number, ExprRef)

字体大小,单位为像素。

默认值: 11

fontStyle

anyOf(FontStyle, ExprRef)

字体样式(例如,"italic")。

fontWeight

anyOf(FontWeight, ExprRef)

字体粗细。这可以是字符串(例如 "bold""normal")或数字(100200300、……、900,其中 "normal" = 400"bold" = 700)。

height

anyOf(number, ExprRef)

标记的高度。

href

anyOf(URI, ExprRef)

鼠标点击时加载的 URL。如果定义了此属性,则标记充当超链接。

innerRadius

anyOf(number, ExprRef)

弧形标记的像素内半径。innerRadiusradius2 的别名。

默认值: 0

interpolate

anyOf(Interpolate, ExprRef)

用于线和面积标记的线条插值方法。以下之一

  • "linear": 分段线性段,如折线。

  • "linear-closed": 闭合线性段形成多边形。

  • "step": 在水平和垂直段之间交替,如阶梯函数。

  • "step-before": 在垂直和水平段之间交替,如阶梯函数。

  • "step-after": 在水平和垂直段之间交替,如阶梯函数。

  • "basis": B 样条曲线,端点控制点重复。

  • "basis-open": 开口 B 样条曲线;可能不与起点或终点相交。

  • "basis-closed": 闭合 B 样条曲线,如循环。

  • "cardinal": Cardinal 样条曲线,端点控制点重复。

  • "cardinal-open": 开口 Cardinal 样条曲线;可能不与起点或终点相交,但会与其他控制点相交。

  • "cardinal-closed": 闭合 Cardinal 样条曲线,如循环。

  • "bundle": 等同于 basis,但使用 tension 参数来拉直样条曲线。

  • "monotone": 保留 y 单调性的三次插值。

invalid

anyOf(MarkInvalidDataMode, null)

无效数据模式,定义了标记和相应的比例尺应如何表示无效值(连续比例尺中没有为无效值定义输出时的 nullNaN)。

  • "filter" — 从可视化的标记比例尺排除所有无效值。对于路径标记(line, area, trail),此选项将创建连接有效点的路径,就像包含无效值的数据行不存在一样。

  • "break-paths-filter-domains" — 在无效值处中断路径标记(line, area, trail)。对于非路径标记,这等同于 "filter"。所有比例尺域将排除这些过滤后的数据点。

  • "break-paths-show-domains" — 在无效值处中断路径标记(line, area, trail)。对于非路径标记,隐藏无效值。所有比例尺域将包含这些过滤后的数据点(对于路径和非路径标记)。

  • "show"null — 在标记和比例尺域中显示所有数据点。每个比例尺将使用 config.scale.invalid 中定义的无效值输出,如果未指定,默认情况下无效值将产生与零(如果比例尺包含零)或最小值(如果比例尺不包含零)相同的视觉值。

  • "break-paths-show-path-domains"(默认值)— 对于基于路径的标记(line/area/trail),这等同于 "break-paths-show-domains";对于非路径标记,这等同于 "filter"

注意: 如果任何通道的比例尺在 config.scale.invalid 中定义了无效值的输出,则这些比例尺的所有值都将被视为“有效”,因为它们可以为比例尺产生合理的输出。因此,此类通道的字段将不会被过滤,也不会导致路径中断。

limit

anyOf(number, ExprRef)

文本标记的最大像素长度。如果渲染大小超出限制,文本值将自动截断。

默认值: 0 – 表示无限制

lineBreak

anyOf(string, ExprRef)

用于将文本字符串分解为多行的分隔符,例如换行符。如果文本是数组值,则忽略此属性。

lineHeight

anyOf(number, ExprRef)

多行文本标记的像素行高(后续文本行之间的间距)。

opacity

anyOf(number, ExprRef)

整体不透明度(值在 [0,1] 之间)。

默认值: 对于使用 point, tick, circle, 或 square 标记的非聚合图,或叠加的 bar 图表,默认值为 0.7;否则为 1

order

[null, boolean]

对于线标记和轨迹标记,此 order 属性可以设置为 nullfalse,以使线使用数据源中的原始顺序。

orient

Orientation

非堆叠柱状图、刻度图、面积图和折线图的方向。值可以是水平(默认)或垂直。

  • 对于条形、规则线和刻度,这决定了条形和刻度的大小应该应用于 x 维度还是 y 维度。

  • 对于面积图,此属性决定了 Vega 输出的 orient 属性。

  • 对于线标记和轨迹标记,如果未指定 config.sortLineBy,则此属性决定了线中点的排序顺序。对于堆叠图表,此属性始终由堆叠的方向决定;因此,显式指定的值将被忽略。

outerRadius

anyOf(number, ExprRef)

弧形标记的外半径,单位像素。outerRadiusradius 的别名。

默认值: 0

padAngle

anyOf(number, ExprRef)

应用于弧形两侧的角填充,单位弧度。

radius

anyOf(number, ExprRef)

对于弧形标记,主要(外)半径,单位像素。

对于文本标记,文本相对于由 xy 属性确定的原点的极坐标径向偏移,单位像素。

默认值: 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 path string <https://mdn.org.cn/en-US/docs/Web/SVG/Tutorial/Paths>__(SVG 路径字符串)。(为了正确的大小调整,自定义形状路径应在坐标范围从 -1 到 1 的方形边界框内定义,包括 x 和 y 维度。)

默认值: "circle"

size

anyOf(number, ExprRef)

标记的默认大小。

  • 对于 point/circle/square,这表示标记的像素面积。注意,此值设置的是符号的面积;边长将随此值的平方根增加。

  • 对于 bar,这表示条形的带大小,单位像素。

  • 对于 text,这表示字体大小,单位像素。

默认值

  • 点、圆、方形标记的默认大小为 30;宽度/高度的 step

  • 离散维度的条形标记默认大小为 2

  • 连续维度的条形标记默认大小为 5

  • 文本标记默认大小为 11

smooth

anyOf(boolean, ExprRef)

一个布尔标志(默认为 true),指示图像在调整大小时是否应进行平滑处理。如果为 false,则应直接缩放单个像素而不是进行插值平滑处理。对于 SVG 渲染,由于缺乏标准化,此选项在某些浏览器中可能无效。

startAngle

anyOf(number, ExprRef)

弧形标记的起始角度,单位弧度。值为 0 表示向上(北方),增加值按顺时针方向进行。

stroke

anyOf(Color, Gradient, null, ExprRef)

默认描边颜色。此属性具有比 config.color 更高的优先级。设置为 null 以移除描边。

默认值: (无)

strokeCap

anyOf(StrokeCap, ExprRef)

线条末端的描边帽样式。可以是 "butt"(平角)、"round"(圆角)或 "square"(方角)之一。

默认值: "butt"

strokeDash

anyOf(数组(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)

根据插值类型,设置张力参数(用于线标记和面积标记)。

text

anyOf(Text, ExprRef) (之一)

如果未指定 text 通道,则使用的占位符文本。

theta

anyOf(number, ExprRef)

  • 对于弧形标记,如果未指定 theta2,则表示弧长,单位弧度;否则表示起始弧角。(值为 0 表示向上或“北方”,增加值按顺时针方向进行。)

  • 对于文本标记,表示极坐标角度,单位弧度。

theta2

anyOf(number, ExprRef)

弧形标记的结束角度,单位弧度。值为 0 表示向上或“北方”,增加值按顺时针方向进行。

timeUnitBandPosition

number

时间单位的默认相对带位置。如果设置为 0,标记将位于时间单位带步长的起始处。如果设置为 0.5,标记将位于时间单位带步长的中间。

timeUnitBandSize

number

时间单位的默认相对带大小。如果设置为 1,标记的带宽将等于时间单位带步长。如果设置为 0.5,标记的带宽将是时间单位带步长的一半。

tooltip

anyOf(number, string, boolean, TooltipContent, ExprRef, null) (之一)

鼠标悬停时显示的工具提示文本字符串,或定义应从哪些字段派生工具提示的对象。

  • 如果 tooltiptrue{"content": "encoding"},则将使用 encoding 中的所有字段。

  • 如果 tooltip{"content": "data"},则将使用高亮数据点中出现的所有字段。

  • 如果设置为 nullfalse,则不使用工具提示。

有关 Vega-Lite 中工具提示的详细讨论,请参阅 tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>__ 文档。

默认值: null

url

anyOf(URI, ExprRef)

图像标记的图像文件 URL。

width

anyOf(number, ExprRef)

标记的宽度。

x

anyOf(number, string, ExprRef) (之一)

标记的 X 坐标,或者未指定 x2width 的水平 "bar""area" 的宽度。

此通道的 value 可以是一个数字,或者一个字符串 "width" 表示图表的宽度。

x2

anyOf(number, string, ExprRef) (之一)

范围标记 "area", "bar", "rect", 和 "rule" 的 X2 坐标。

此通道的 value 可以是一个数字,或者一个字符串 "width" 表示图表的宽度。

y

anyOf(number, string, ExprRef) (之一)

标记的 Y 坐标,或者未指定 y2height 的垂直 "bar""area" 的高度。

此通道的 value 可以是一个数字,或者一个字符串 "height" 表示图表的高度。

y2

anyOf(number, string, ExprRef) (之一)

范围标记 "area", "bar", "rect", 和 "rule" 的 Y2 坐标。

此通道的 value 可以是一个数字,或者一个字符串 "height" 表示图表的高度。

除了上述默认标记属性外,还可以使用 Chart.configure_style() 方法中定义为关键字参数的命名样式进一步自定义默认值。然后可以通过在标记定义对象中包含 style 属性来调用样式。

比例尺配置#

可以使用 Chart.configure_scale() 配置比例尺,该方法具有以下属性:

点击显示表格

属性

类型

描述

bandPaddingInner

anyOf(number, ExprRef)

xy 带状比例尺的默认内填充。

默认值

  • 带有嵌套 x/y 偏移比例尺的 x/y 比例尺的 nestedOffsetPaddingInner

  • 条形标记的 barBandPaddingInner (默认为 0.1)

  • 矩形及其他标记的 rectBandPaddingInner (默认为 0)

bandPaddingOuter

anyOf(number, ExprRef)

xy 带状比例尺的默认外填充。

默认值: paddingInner/2 (这使得 宽度/高度 = 唯一值数量 * 步长)

bandWithNestedOffsetPaddingInner

anyOf(number, ExprRef)

带有嵌套 xOffsetyOffset 编码的 xy 带状比例尺的默认内填充。

默认值: 0.2

bandWithNestedOffsetPaddingOuter

anyOf(number, ExprRef)

带有嵌套 xOffsetyOffset 编码的 xy 带状比例尺的默认外填充。

默认值: 0.2

barBandPaddingInner

anyOf(number, ExprRef)

"bar" 标记的 xy 带状序数比例尺的默认内填充。

默认值: 0.1

clamp

anyOf(boolean, ExprRef)

如果为 true,则超过数据域的值将被限制到最小或最大范围值。

continuousPadding

anyOf(number, ExprRef)

连续 x/y 比例尺的默认填充。

默认值: 垂直条形的连续 x 比例尺和水平条形的连续 y 比例尺的条形宽度;否则为 0

invalid

ScaleInvalidDataConfig

一个对象,为无效值(连续比例尺上的 null 和 NaN)定义每个通道的比例尺输出。

  • 此对象中的键是比例尺通道。

  • 值可以是 "zero-or-min"(如果比例尺包含零,则使用零;否则使用最小值),或一个值定义 {value: ...}

示例: 将此 config.scale.invalid 属性设置为 {color: {value: '#aaa'}} 将使可视化使用 ‘#aaa’ 颜色绘制所有无效值。

更多详情请参阅 [https://vega.github.io/vega-lite/docs/invalid-data.html](无效数据文档)。

maxBandSize

number

将定量字段映射到条形大小/带宽的默认最大值。

如果未定义(默认),我们将使用轴的大小(宽度或高度)- 1。

maxFontSize

number

将定量字段映射到文本大小/字体大小比例尺的默认最大值。

默认值: 40

maxOpacity

number

将字段映射到不透明度的默认最大不透明度。

默认值: 0.8

maxSize

number

点大小比例尺的默认最大值。

maxStrokeWidth

number

规则线和线标记的描边宽度比例尺以及轨迹标记的大小比例尺的默认最大描边宽度。

默认值: 4

minBandSize

number

将定量字段映射到条形和刻度大小/带宽比例尺的默认最小值。

默认值: 2

minFontSize

number

将定量字段映射到文本大小/字体大小比例尺的默认最小值。

默认值: 8

minOpacity

number

将字段映射到不透明度的默认最小不透明度。

默认值: 0.3

minSize

number

点大小比例尺的默认最小值。

默认值: 9

minStrokeWidth

number

规则线和线标记的描边宽度比例尺以及轨迹标记的大小比例尺的默认最小描边宽度。

默认值: 1

offsetBandPaddingInner

anyOf(number, ExprRef)

xOffset/yOffset 带状比例尺的默认内填充。

默认值: 0

offsetBandPaddingOuter

anyOf(number, ExprRef)

xOffset/yOffset 带状比例尺的默认外填充。

默认值: 0

pointPadding

anyOf(number, ExprRef)

xy 点状序数比例尺的默认外填充。

默认值: 0.5 (这使得 宽度/高度 = 唯一值数量 * 步长)

quantileCount

number

quantile <https://vega.github.io/vega-lite/docs/scale.html#quantile>__ 比例尺的默认范围基数。

默认值: 4

quantizeCount

number

quantize <https://vega.github.io/vega-lite/docs/scale.html#quantize>__ 比例尺的默认范围基数。

默认值: 4

rectBandPaddingInner

anyOf(number, ExprRef)

"rect" 标记的 xy 带状序数比例尺的默认内填充。

默认值: 0

round

anyOf(boolean, ExprRef)

如果为 true,则将数字输出值四舍五入为整数。这有助于与像素网格对齐。(仅适用于 xysize 比例尺。)

tickBandPaddingInner

anyOf(number, ExprRef)

"tick" 标记的 xy 带状序数比例尺的默认内填充。

默认值: 0.25

useUnaggregatedDomain

布尔值

对于聚合轴,使用聚合前的数据源范围作为比例尺域,而不是聚合数据。

这等效于默认将聚合的定量字段的 domain 设置为 "unaggregate"

此属性仅适用于生成值在原始数据域范围内的聚合函数("mean""average""median""q1""q3""min""max")。对于生成值在原始数据域之外的其他聚合(例如 "count""sum"),此属性将被忽略。

默认值: false

xReverse

anyOf(boolean, ExprRef)

默认反转 x 比例尺(对从右到左的图表很有用)。

zero

布尔值

continuous <https://vega.github.io/vega-lite/docs/scale.html#continuous>__ 比例尺的默认 scale.zero,以下情况除外:(1) 非范围条形或面积图的 x/y 比例尺;(2) 大小比例尺。

默认值: true

比例尺范围配置#

可以使用 Chart.configure_range() 配置比例尺范围,该方法具有以下属性:

点击显示表格

属性

类型

描述

category

anyOf(RangeScheme, array(Color)) (之一)

分类数据的默认 color scheme <https://vega.github.io/vega/docs/schemes/>__(颜色方案)。

diverging

anyOf(RangeScheme, array(Color)) (之一)

发散定量渐变色带的默认 color scheme <https://vega.github.io/vega/docs/schemes/>__(颜色方案)。

heatmap

anyOf(RangeScheme, array(Color)) (之一)

定量热力图的默认 color scheme <https://vega.github.io/vega/docs/schemes/>__(颜色方案)。

ordinal

anyOf(RangeScheme, array(Color)) (之一)

有序数据的默认 color scheme <https://vega.github.io/vega/docs/schemes/>__(颜色方案)。

ramp

anyOf(RangeScheme, array(Color)) (之一)

顺序定量渐变色带的默认 color scheme <https://vega.github.io/vega/docs/schemes/>__(颜色方案)。

symbol

array(SymbolShape) (数组)

默认形状调色板的 symbol <https://vega.github.io/vega/docs/marks/symbol/>__ 名称或路径数组。

投影配置#

可以使用 Chart.configure_projection() 配置投影,该方法具有以下属性:

点击显示表格

属性

类型

描述

center

anyOf(Vector2<number>, ExprRef) (之一)

投影中心,一个包含经度和纬度(单位为度)的双元素数组。

默认值: [0, 0]

clipAngle

anyOf(number, ExprRef)

投影裁剪圆的半径,指定为角度(单位为度)。如果为 null,则切换到 antimeridian <http://bl.ocks.org/mbostock/3788999>__(对跖线)裁剪而不是小圆裁剪。

clipExtent

anyOf(Vector2<Vector2<number>>, ExprRef) (之一)

投影视口的裁剪范围,指定为像素边界。范围边界指定为一个数组 [[x0, y0], [x1, y1]],其中 x0 是视口的左侧,y0 是顶部,x1 是右侧,y1 是底部。如果为 null,则不执行视口裁剪。

coefficient

anyOf(number, ExprRef)

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)

bottomley 投影的分数参数。

默认值: 0.5,对应于 sin(ψ) 其中 ψ = π/6。

lobes

anyOf(number, ExprRef)

支持多瓣视图的投影(berghausgingeryhealpix)中的瓣数。默认值根据投影类型而异。

parallel

anyOf(number, ExprRef)

支持该参数的投影(armadillobonnecraigcylindricalEqualAreacylindricalStereographichammerRetroazimuthalloximuthalrectangularPolyconic)的 parallel 参数。默认值根据投影类型而异。

parallels

anyOf(数组(number), ExprRef)

对于圆锥投影,定义地图布局的 两个标准纬线 <https://en.wikipedia.org/wiki/Map_projection#Conic>__。默认值取决于使用的具体圆锥投影。

pointRadius

anyOf(number, ExprRef)

绘制 GeoJSON PointMultiPoint 几何体时使用的默认半径(单位像素)。此参数设置一个常量默认值。要根据数据修改点半径,请参阅 GeoPath 和 GeoShape 变换的相应参数。

默认值: 4.5

precision

anyOf(number, ExprRef)

投影的 自适应重采样 <http://bl.ocks.org/mbostock/3795544>__ 的阈值,指定为像素值。此值对应于 Douglas-Peucker 距离 <http://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm>__。如果未指定 precision,则返回投影当前的重采样精度,默认为 √0.5 0.70710…

radius

anyOf(number, ExprRef)

airygingery 投影的半径参数。默认值根据投影类型而异。

ratio

anyOf(number, ExprRef)

hillhufnagelwagner 投影的比例参数。默认值根据投影类型而异。

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)

lagrange 投影的间距参数。

默认值: 0.5

tilt

anyOf(number, ExprRef)

satellite 投影的倾斜角度(单位为度)。

默认值: 0

translate

anyOf(Vector2<number>, ExprRef) (之一)

投影的平移偏移,作为双元素数组 [tx, ty]

type

anyOf(ProjectionType, ExprRef) (之一)

要使用的地图投影。此值不区分大小写,例如 "albers""Albers" 指的是同一种投影类型。您可以在 文档中找到所有有效的投影类型 <https://vega.github.io/vega-lite/docs/projection.html#projection-types>__。

默认值: equalEarth

拼接和分面配置#

可以使用 Chart.configure_concat()Chart.configure_facet() 配置拼接图和分面图的各个方面,这些方法具有以下属性:

点击显示表格

属性

类型

描述

columns

number

视图组合布局中包含的列数。

默认值: undefined – 将假定无限列数(单行)。这等同于 hconcat(对于 concat)以及使用 column 通道(对于 facetrepeat)。

注意:

  1. 此属性仅适用于:

  • 通用(可换行)concat 运算符(非 hconcat/vconcat

  • 具有一个字段/重复定义(无行/列嵌套)的 facetrepeat 运算符

  1. columns 设置为 1 等同于 vconcat(对于 concat)以及使用 row 通道(对于 facetrepeat)。

spacing

number

组合子视图之间的默认间距,单位像素。

默认值: 20

选择配置#

可以使用 Chart.configure_selection() 配置选择,该方法具有以下属性:

点击显示表格

属性

类型

描述

interval

IntervalSelectionConfigWithoutType

interval <https://vega.github.io/vega-lite/docs/parameter.html#select>__ 选择的默认定义。可以在此处指定间隔选择定义的所有属性和变换(type 除外)。

例如,将 interval 设置为 {"translate": false} 将默认禁用移动间隔选择的功能。

point

PointSelectionConfigWithoutType

point <https://vega.github.io/vega-lite/docs/parameter.html#select>__ 选择的默认定义。可以在此处指定点选择定义的所有属性和变换(type 除外)。

例如,将 point 设置为 {"on": "dblclick"} 将默认在双击时填充点选择。

标题配置#

Chart.configure_title() 方法允许配置图表标题,包括字体、颜色、位置和方向。以下是一个示例:

import altair as alt
from vega_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 属性 <https://mdn.org.cn/en-US/docs/Web/Accessibility/ARIA>__(仅限 SVG 输出)。如果为 false,则输出 SVG 组将设置“aria-hidden”属性,从而将标题从 ARIA 可访问性树中移除。

默认值: true

baseline

TextBaseline

标题和副标题文本的垂直文本基线。可以是 "alphabetic"(字母基线,默认)、"top"(顶部)、"middle"(中间)、"bottom"(底部)、"line-top"(行顶部)或 "line-bottom"(行底部)之一。"line-top""line-bottom" 的操作类似于 "top""bottom",但它们是相对于 lineHeight 计算的,而不是单独相对于 fontSize 计算。

color

anyOf(anyOf(null, Color), ExprRef)

标题文本颜色。

dx

anyOf(number, ExprRef)

标题和副标题文本 x 坐标的 delta 偏移。

dy

anyOf(number, ExprRef)

标题和副标题文本 y 坐标的 delta 偏移。

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 vega_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

布尔值

视图是否应该被裁剪。

continuousHeight

number

当图表有连续 y 字段用于 x 或纬度,或有弧形标记时,默认高度。

默认值: 200

continuousWidth

number

当图表有连续字段用于 x 或经度,或有弧形标记时,默认宽度。

默认值: 200

cornerRadius

anyOf(number, ExprRef)

圆角矩形或弧形角的像素半径。

默认值: 0

cursor

Cursor

视图上使用的鼠标光标。可以使用任何有效的 CSS cursor type <https://mdn.org.cn/en-US/docs/Web/CSS/cursor#Values>__(CSS 光标类型)。

discreteHeight

anyOf(number, dict) (之一)

当图表有非弧形标记且有离散 y 字段或没有 y 字段时,默认高度。高度可以是一个数字表示固定高度,也可以是一个 {step: number} 形式的对象,定义每个离散步长的高度。

默认值: 基于 config.view.step 的步长。

discreteWidth

anyOf(number, dict) (之一)

当图表有非弧形标记且有离散 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] 之间)。

默认值: 对于使用 point, tick, circle, 或 square 标记的非聚合图,或叠加的 bar 图表,默认值为 0.7;否则为 1

step

number

x/y 离散字段的默认步长。

stroke

anyOf(Color, null, ExprRef) (之一)

描边颜色。

默认值: "#ddd"

strokeCap

anyOf(StrokeCap, ExprRef)

线条末端的描边帽样式。可以是 "butt"(平角)、"round"(圆角)或 "square"(方角)之一。

默认值: "butt"

strokeDash

anyOf(数组(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)

描边宽度,单位像素。