顶级图表配置

图表外观的许多方面可以使用顶部级别的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 实例添加到图表中，并接受以下参数：

Click to show table

属性	类型	描述
弧	RectConfig	弧特定配置
区域	AreaConfig	区域特定配置
aria	boolean	一个布尔标志，用于指示是否应为标记和指南（仅SVG输出）包含ARIA默认属性。如果为false，则"aria-hidden"属性将为所有指南设置，从而将其从ARIA可访问性树中移除，并且Vega-Lite不会为标记生成默认描述。 默认值： true。
自动调整大小	anyOf(AutosizeType, AutoSizeParams)	可视化大小应如何确定。如果是字符串，应该是 "pad"、"fit" 或 "none" 之一。对象值还可以指定内容大小和自动调整大小的参数。 默认值: pad
坐标轴	AxisConfig	坐标轴配置，决定所有 x 和 y 坐标轴 的默认属性。有关坐标轴配置选项的完整列表，请参见 相应 章节 的 坐标轴 文档 。
轴带	AxisConfig	用于具有“带”刻度的坐标轴配置。
底部坐标轴	AxisConfig	图表底部边缘的x轴配置。
轴离散	AxisConfig	用于“点”或“带”刻度的轴配置。
左侧轴	AxisConfig	图表左边缘的y轴配置。
轴点	AxisConfig	用于“点”刻度的轴配置。
轴定量	AxisConfig	定量轴的配置。
右轴	AxisConfig	图表右边缘的y轴配置。
轴时间	AxisConfig	时间轴的配置。
轴顶部	AxisConfig	图表顶部边缘的x轴配置。
轴X	AxisConfig	X轴特定配置。
轴X带	AxisConfig	用于带状刻度的x轴配置。
轴X离散	AxisConfig	用于“点”或“带”比例尺的x轴配置。
axisXPoint	AxisConfig	用于“点”刻度的 x 轴配置。
轴X定量	AxisConfig	用于x-定量轴的配置。
轴X时间	AxisConfig	x时间轴的配置。
轴Y	AxisConfig	Y轴特定配置。
轴Y带	AxisConfig	用于“带”刻度的y轴配置。
axisYDiscrete	AxisConfig	用于具有“点”或“带”刻度的y轴的配置。
axisYPoint	AxisConfig	用于“点”刻度的y轴配置。
axisYQuantitative	AxisConfig	y-定量轴的配置。
轴Y时间	AxisConfig	y-时间轴的配置。
背景	anyOf(Color, ExprRef)	用于作为整个视图背景的CSS颜色属性。 默认值： "white"
条形	BarConfig	条形特定配置
箱线图	BoxPlotConfig	盒子配置
圆	MarkConfig	圆形特定配置
连接	CompositionConfig	所有连接和重复视图组合运算符的默认配置 (concat, hconcat, vconcat, 和 repeat)
计数标题	字符串	计数字段的默认轴和图例标题。 默认值： '计数 记录。
自定义格式类型	布尔值	允许formatType属性用于文本标记和指南，以接受一个自定义格式化函数注册 为 一个 Vega 表达式 __。
误差带	ErrorBandConfig	误差带配置
误差条	ErrorBarConfig	误差条配置
面	CompositionConfig	默认配置用于facet视图组合操作符
字段标题	[‘verbal’, ‘functional’, ‘plain’]	定义Vega-Lite为字段生成标题的方式。有三种可能的样式： "verbal" （默认）- 以口头风格显示函数（例如，“字段的总和”，“日期的年-月”，“字段（分箱）”）。 "function" - 使用括号和大写文本显示函数（例如，“SUM(field)”，“YEARMONTH(date)”，“BIN(field)”。 "plain" - 仅显示字段名称而不包含函数（例如，“field”，“date”，“field”）。
字体	string	所有文本标记、标题和标签的默认字体。
地理形状	MarkConfig	地理形状特定配置
标题	HeaderConfig	标题配置，决定所有 headers __ 的默认属性。 有关标题配置选项的完整列表，请参见 corresponding section of in the header documentation __。
标题列	HeaderConfig	标题配置，决定列的默认属性 headers __。 有关标题配置选项的完整列表，请参见 corresponding section of in the header documentation __。
headerFacet	HeaderConfig	头部配置，决定非行/列面板 headers __ 的默认属性。 有关完整的头部配置选项列表，请参阅 corresponding section of in the header documentation __。
表头行	HeaderConfig	表头配置，确定行 headers __ 的默认属性。 有关完整的表头配置选项列表，请参见 相应的 部分 在 表头 文档 __。
图像	RectConfig	图像特定配置
图例	LegendConfig	图例配置，决定所有 legends 的默认属性。有关图例配置选项的完整列表，请参见 corresponding section of in the legend documentation 。
行	LineConfig	行特定配置
行分隔符	anyOf(string, ExprRef)	一个分隔符，例如换行符，用于将文本字符串分成多行。此属性提供了文本标记的全局默认值，可以被标记或样式配置设置以及行分隔符标记编码通道覆盖。如果是信号值，则字符串或正则表达式（regexp）值均有效。
区域设置	Locale	用于字符串解析和数字、日期值格式化的区域设置定义。区域设置对象应包含 number 和/或 time 属性，并具有 locale definitions __。 在配置块中提供的区域设置定义可以被视图构造函数的区域设置选项覆盖。
标记	MarkConfig	标记配置
规范化数字格式	字符串	如果未指定 normalizedNumberFormatType，D3 数字格式用于规范化堆叠字段的坐标轴标签、文本标记和工具提示（具有 stack: "normalize" 的字段）。例如 "s" 用于 SI 单位。使用 D3的 数字 格式 模式 __。 如果 config.normalizedNumberFormatType 被指定，并且 config.customFormatTypes 是 true，此值将作为 格式 传递，同时与 datum.value 一起传递给 config.numberFormatType 函数。 默认值： %
规范化数字格式类型	字符串	自定义 格式 类型 __ 用于 config.normalizedNumberFormat. 默认值： 未定义 – 这相当于调用 D3-format，它作为 格式 在 Vega-Expression __ 公开。注意： 您还必须将 customFormatTypes 设置为 true 以使用此功能。
numberFormat	string	如果未指定 numberFormatType，则为引导标签、文本标记和非归一化字段（没有 stack: "normalize"）的工具提示使用 D3 数字格式。例如 "s" 用于 SI 单位。使用 D3's number format pattern __。 如果 config.numberFormatType 被指定并且 config.customFormatTypes 是 true，则该值将作为 format 与 datum.value 一起传递给 config.numberFormatType 函数。
数字格式类型	字符串	自定义 格式 类型 __ 用于 config.numberFormat. 默认值： 未定义 – 这相当于调用 D3-format，它作为 format 在 Vega-Expression __ 被公开。注意： 您还必须将 customFormatTypes 设置为 true 以使用此功能。
填充	anyOf(Padding, ExprRef)	从可视化画布的边缘到数据矩形的默认可视化填充，以像素为单位。如果是一个数字，指定所有边的填充。如果是一个对象，值应具有格式 {"left": 5, "top": 5, "right": 5, "bottom": 5} 以指定可视化的每一侧的填充。 默认值: 5
参数	数组(TopLevelParameter)	动态变量或选择，用于参数化可视化。
点	MarkConfig	点特定配置
投影	ProjectionConfig	投影配置，确定所有 projections 的默认属性。有关投影配置选项的完整列表，请参阅 corresponding section of the projection documentation 。
范围	RangeConfig	一个对象哈希，定义了用于比例尺的默认范围数组或方案。有关比例尺范围配置选项的完整列表，请参阅相应 节 的 比例尺 文档 __。
矩形	RectConfig	矩形特定配置
规则	MarkConfig	规则特定配置
比例	ScaleConfig	比例配置确定所有 scales 的默认属性。有关比例配置选项的完整列表，请参阅 corresponding section of the scale documentation 。
选择	SelectionConfig	用于定义每种选择类型的默认属性的对象哈希。
平方	MarkConfig	平方特定配置
样式	StyleConfigIndex	一个对象哈希，定义键值映射，以确定具有给定 style 的标记的默认属性。键代表样式名称；值必须是有效的 mark configuration objects 。
文本	MarkConfig	文本特定配置
滴答	TickConfig	滴答特定配置
时间格式	字符串	用于文本标记、图例标签和标题标签的原始时间值（没有时间单位）的默认时间格式。 默认值： "%b %d, %Y" 注意： 坐标轴会自动确定每个标签的格式，因此此配置不会影响坐标轴。
时间格式类型	字符串	自定义 格式 类型 __ 用于 config.timeFormat。 默认值： 未定义 – 与调用 D3-time-format 等效，D3-time-format 被展示为 timeFormat 在 Vega-Expression __。 注意： 您还必须将 customFormatTypes 设置为 真，并且必须不 定义 timeUnit 才能使用此功能。
标题	TitleConfig	标题配置，确定所有 titles 的默认属性。有关标题配置选项的完整列表，请参阅 corresponding section of the title documentation 。
提示格式	FormatConfig	为工具提示定义 custom format configuration __。如果未指定，将应用默认格式配置。
轨迹	LineConfig	特定于轨迹的配置
视图	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()

他们具有以下属性：

Click to show table

NoneNone

属性	类型	描述
无障碍属性	anyOf(布尔值, ExprRef)	一个布尔标志，指示是否应包含ARIA 属性 __（仅限SVG输出）。如果false，则“aria-hidden”属性将应用于输出的SVG组，从而从ARIA可访问性树中移除轴。 默认值为： true
带位置	任意(数字, ExprRef)	一个插值分数，指示对于 带 规模，轴刻度应该放置的位置。值为 0 时，刻度位于其带的左边缘。值为 0.5 时，刻度位于其带的中间。 默认值： 0.5
描述	anyOf(string, ExprRef)	这个轴的文本描述用于 ARIA 可访问性 __（仅限 SVG 输出）。如果 aria 属性为 true，对于 SVG 输出，"aria-label" 属性 __ 将被设置为这个描述。如果描述未指定，它将被自动生成。
禁用	boolean	默认情况下禁用轴。
域	boolean	一个布尔标志，指示域（坐标轴基线）是否应作为轴的一部分包含。 默认值： true
domainCap	anyOf(StrokeCap, ExprRef)	域线条结束样式的笔触封套。可以是 "butt"、 "round" 或 "square" 之一。 默认值： "butt"
域颜色	anyOf(anyOf(null, Color), ExprRef)	坐标轴域线的颜色。 默认值： "gray"。
domainDash	anyOf(array(number), ExprRef)	一种用于虚线域线的交替 [笔划，间距] 长度的数组。
domainDashOffset	anyOf(number, ExprRef)	开始绘制领域虚线数组的像素偏移量。
域的不透明度	anyOf(number, ExprRef)	轴域线的透明度。
域宽度	anyOf(number, ExprRef)	轴域线的笔画宽度 默认值： 1
格式	anyOf(string, Dict)	当与默认"number"和"time"格式类型一起使用时，指南（坐标轴、图例、头部）和文本标记的文本格式模式。 如果格式类型是"number"（例如，用于定量字段），这是D3的number format pattern __。 如果格式类型是"time"（例如，用于时间字段），这是D3的time format pattern __。 更多示例请参见format documentation __。 当与custom formatType __一起使用时，此值将作为format与datum.value一起传递给注册的函数。 默认值： 从numberFormat __配置中派生用于数字格式，从timeFormat __配置中派生用于时间格式。
格式类型	string	标签的格式类型。可以是 "number"、 "time"，或一个 已注册 自定义 格式 类型 __。 默认值： "time" 用于时间字段以及具有 timeUnit 的序数和名义字段。 "number" 用于定量字段以及没有 timeUnit 的序数和名义字段。
网格	boolean	一个布尔标志，指示是否应将网格线包含为轴的一部分 默认值： true 对于 continuous scales __，如果未分箱；否则， false。
gridCap	anyOf(StrokeCap, ExprRef)	网格线的末端样式的笔画帽。可以是 "butt"、 "round" 或 "square" 之一。 默认值： "butt"
网格颜色	anyOf(anyOf(null, Color), ExprRef, ConditionalAxisColor)	网格线的颜色。 默认值： "lightGray"。
gridDash	anyOf(array(number), ExprRef, ConditionalAxisNumberArray)	一个用于虚线网格线的交替 [笔画, 空间] 长度的数组。
gridDashOffset	anyOf(number, ExprRef, ConditionalAxisNumber)	绘制网格虚线数组的起始像素偏移量。
网格透明度	anyOf(number, ExprRef, ConditionalAxisNumber)	网格的笔画透明度（值在[0,1]之间） 默认值： 1
网格宽度	anyOf(number, ExprRef, ConditionalAxisNumber)	网格宽度，以像素为单位。 默认值： 1
标签对齐	anyOf(Align, ExprRef, ConditionalAxisLabelAlign)	轴刻度标签的水平文本对齐，覆盖当前轴方向的默认设置。
标签角度	anyOf(number, ExprRef)	轴标签的旋转角度。 默认值： -90 用于名义和序数字段；其他情况下为 0。
标签基线	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。
标签颜色	anyOf(anyOf(null, Color), ExprRef, ConditionalAxisColor)	刻度标签的颜色，可以是十六进制颜色代码或常规颜色名称。
标签表达式	字符串	Vega 表达式 __ 用于自定义标签。 注意： 标签文本和值可以通过轴的基础 datum 对象的 label 和 value 属性进行访问。
标签对齐	[布尔值，数字]	指示第一个和最后一个坐标轴标签是否应与刻度范围对齐。对于水平轴，左侧对齐第一个标签并右侧对齐最后一个标签。对于垂直轴，则应用底部和顶部文本基线。如果此属性是一个数字，它还表示第一个和最后一个标签的偏移像素数；例如，值为2将使第一个和最后一个标签对齐，并将它们向外推2个像素。这额外的调整有时可以帮助标签更好地与相应的坐标轴刻度视觉分组。 默认值：对于连续x轴的坐标轴，true。否则，false。
标签冲突偏移	anyOf(数字, ExprRef)	指示以像素为单位的偏移量，用于调整冲突标签。例如，值为 2 将会将冲突调整的标签向外推 2 像素。偏移量可以帮助标签更好地与相应的坐标轴刻度在视觉上进行分组。 默认值： 0。
标签字体	anyOf(string, ExprRef, ConditionalAxisString)	刻度标签的字体。
标签字体大小	anyOf(number, ExprRef, ConditionalAxisNumber)	标签的字体大小，以像素为单位。
标签字体样式	anyOf(FontStyle, ExprRef, ConditionalAxisLabelFontStyle)	标题的字体样式。
标签字体粗细	anyOf(FontWeight, ExprRef, ConditionalAxisLabelFontWeight)	轴刻度标签的字体粗细。
标签限制	任何(数字, 表达式引用)	轴刻度标签允许的最大像素宽度。 默认值： 180
标签行高	anyOf(number, ExprRef)	用于多行标签文本或带有 "line-top" 或 "line-bottom" 基线的标签文本的像素行高。
标签偏移	任意(数字, ExprRef, ConditionalAxisNumber)	应用于标签的像素位置偏移，附加于tickOffset。 默认值： 0
标签不透明度	anyOf(number, ExprRef, ConditionalAxisNumber)	标签的透明度。
标签重叠	anyOf(LabelOverlap, ExprRef)	用于解决轴标签重叠的策略。如果 false（默认值），将不尝试减少重叠。如果设置为 true 或 "parity"，将使用删除每隔一个标签的策略（这对标准线性轴效果良好）。如果设置为 "greedy"，将对标签进行线性扫描，移除与最后一个可见标签重叠的标签（这通常对对数缩放轴效果更好）。 默认值： 对于非名义字段，非对数刻度的值为 true；对于对数刻度的值为 "greedy"；否则为 false。
标签填充	anyOf(number, ExprRef, ConditionalAxisNumber)	标签与刻度之间的像素填充。 默认值： 2
标签间隔	anyOf(number, ExprRef)	为了被认为是非重叠的，标签边框框之间必须保持的最小间隔（默认 0）。如果未启用 labelOverlap 解析，则此属性会被忽略。
标签	boolean	一个布尔标志，用于指示是否应将标签作为轴的一部分包含。 默认值： true。
最大范围	anyOf(number, ExprRef)	轴刻度和标签应使用的最大像素范围。这决定了轴标题的最大偏移值。 默认值： undefined.
minExtent	anyOf(number, ExprRef)	坐标轴刻度和标签应使用的最小范围（以像素为单位）。这决定了坐标轴标题的最小偏移值。 默认值： y 轴为 30; x 轴为 undefined。
偏移量	anyOf(number, ExprRef)	在像素中，偏移量用于将轴从封闭组或数据矩形的边缘移开。 默认值： 来源于 axis config __ 的 offset (0 默认值)
方向	anyOf(AxisOrient, ExprRef)	坐标轴的方向。可以是 "top"、"bottom"、"left" 或 "right" 之一。方向可用于进一步专业化坐标轴类型（例如，y轴朝向图表的右边缘）。 默认值： x轴为 "bottom"，y轴为 "left"。
位置	anyOf(number, ExprRef)	轴的锚点位置，以像素为单位。对于顶部或底部方向的 x 轴，这设置了轴组的 x 坐标。对于左或右方向的 y 轴，这设置了轴组的 y 坐标。 默认值: 0
样式	anyOf(string, array(string))	一个字符串或字符串数组，指示要应用于轴的自定义样式的名称。样式是一个命名的轴属性集合，在style configuration __中定义。如果样式是一个数组，则后面的样式将覆盖前面的样式。 默认值：（无） 注意：任何指定的样式都会增强默认样式。例如，具有"style": "foo"的x轴标记将使用config.axisX和config.style.foo（指定的样式"foo"具有更高的优先级）。
刻度带	anyOf([‘center’, ‘extent’], ExprRef)	对于带状刻度，指示刻度和网格线是否应放置在带的 "center"（默认）或在带的 "extent" 上以表示区间
刻度线帽	anyOf(StrokeCap, ExprRef)	刻度线的结束样式的笔画帽。可以是 "butt"、"round" 或 "square" 之一。 默认值： "butt"
刻度线颜色	anyOf(anyOf(null, Color), ExprRef, ConditionalAxisColor)	坐标轴刻度线的颜色。 默认值： "gray"
刻度数量	任意（数字, 时间间隔, 时间间隔步长, 表达式引用）	期望的刻度数量，用于可视化定量刻度的坐标轴。结果数量可能不同，以便值是“好看的”（2、5、10的倍数）并位于基础刻度范围内。 对于类型为 "时间" 或 "utc" 的刻度，刻度数量可以是时间间隔说明符。合法的字符串值是 "毫秒", "秒", "分钟", "小时", "天", "周", "月"，以及 "年"。另外，一个对象值的间隔说明符形式为 {"间隔": "月", "步长": 3} 包括期望的间隔步数。在这里，为每个季度（1月、4月、7月、10月）边界生成刻度。 默认值: 使用公式 ceil(width/40) 对 x 进行计算，使用 ceil(height/40) 对 y 进行计算。
tickDash	anyOf(array(number), ExprRef, ConditionalAxisNumberArray)	用于虚线刻度标记的长度数组，以[线条长度，间隔长度]交替排列。
刻度虚线偏移量	anyOf(number, ExprRef, ConditionalAxisNumber)	绘制刻度标记虚线数组时开始绘制的像素偏移量。
tickExtra	boolean	布尔标志，指示是否应为轴的初始位置添加额外的刻度。这一标志在样式设置中非常有用，适用于band比例，以便在带边界上放置刻度，而不是在带的中间。与"bandPosition": 1 和轴"padding" 值为0一起使用。
刻度最小步长	anyOf(number, ExprRef)	轴刻度之间的最小期望步长，以比例域值为单位。例如，值为1表示刻度之间不得少于1单位。如果指定了tickMinStep，则tickCount值将根据需要进行调整，以强制执行最小步长值。
tickOffset	anyOf(number, ExprRef)	应用于刻度、标签和网格线的像素位置偏移。
刻度线透明度	anyOf(number, ExprRef, ConditionalAxisNumber)	刻度线的透明度。
tickRound	boolean	布尔标志，指示像素位置值是否应该舍入到最接近的整数。 默认值： true
刻度大小	anyOf(number, ExprRef, ConditionalAxisNumber)	轴刻度的像素大小。 默认值： 5
刻度宽度	anyOf(number, ExprRef, ConditionalAxisNumber)	刻度的宽度，以像素为单位。 默认值： 1
刻度	boolean	布尔值，决定坐标轴是否应包含刻度。 默认值： true
标题	anyOf(Text, null)	字段的标题。如果null，标题将被删除。 默认值：来自字段名称和转换函数（aggregate、bin和timeUnit）。如果字段有聚合函数，函数将作为标题的一部分显示（例如，"Sum of Profit"）。如果字段被分箱或应用了时间单位，则应用的函数将显示在括号中（例如，"Profit (binned)"、"Transaction Date (year-month)"）。否则，标题就是字段名称。 注意： 您可以通过在config __中提供fieldTitle __属性，或通过fieldTitle 函数 通过 compile 函数的 选项 __来定制默认字段标题格式。 如果字段定义的title和轴、头部或图例的title都被定义，则将使用轴/头部/图例标题。
标题对齐	anyOf(Align, ExprRef)	轴标题的水平文本对齐方式。
标题锚点	anyOf(TitleAnchor, ExprRef)	用于放置轴标题的文本锚点位置。
标题角度	anyOf(number, ExprRef)	轴标题的角度（单位：度）。
标题基线	anyOf(TextBaseline, ExprRef)	轴标题的垂直文本基线。可以是 "alphabetic"（默认）、 "top"、 "middle"、 "bottom"、 "line-top"或 "line-bottom"。 "line-top" 和 "line-bottom" 的值类似于 "top" 和 "bottom"，但相对于 lineHeight 而不是仅仅 fontSize 进行计算。
标题颜色	anyOf(anyOf(null, Color), ExprRef)	标题的颜色，可以是十六进制颜色代码或常规颜色名称。
标题字体	anyOf(string, ExprRef)	标题的字体。(例如，"Helvetica Neue")。
标题字体大小	anyOf(number, ExprRef)	标题的字体大小。
标题字体样式	anyOf(FontStyle, ExprRef)	标题的字体样式。
标题字体粗细	任何一个(FontWeight, ExprRef)	标题的字体粗细。这可以是一个字符串（例如 "bold", "normal"）或一个数字 (100, 200, 300, …, 900 其中 "normal" = 400 和 "bold" = 700）。
标题限制	anyOf(number, ExprRef)	轴标题允许的最大像素宽度。
标题行高	anyOf(number, ExprRef)	多行标题文本或带有"line-top"或"line-bottom"基线的标题文本的像素行高。
标题透明度	anyOf(number, ExprRef)	坐标轴标题的透明度。
标题填充	anyOf(number, ExprRef)	标题与轴之间的填充，单位为像素。
标题X	anyOf(number, ExprRef)	轴标题相对于轴组的X坐标。
标题Y	anyOf(number, ExprRef)	轴标题相对于轴组的Y坐标。
翻译	anyOf(number, ExprRef)	坐标空间的翻译偏移，用于轴布局。默认情况下，轴通过在x和y坐标上应用0.5像素的偏移进行转换，以使描边线与像素网格对齐。然而，对于矢量图形输出，这些特定于像素的调整可能是不希望的，在这种情况下，可以更改translate（例如，设置为零）。 默认值： 0.5
值	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()

他们具有以下属性：

Click to show table

属性	类型	描述
格式	anyOf(string, Dict)	当与默认"number"和"time"格式类型一起使用时，指南（坐标轴、图例、头部）和文本标记的文本格式模式。 如果格式类型是"number"（例如，用于定量字段），这是D3的number format pattern <https://github.com/d3/d3-format#locale_format>__。 如果格式类型是"time"（例如，用于时间字段），这是D3的time format pattern <https://github.com/d3/d3-time-format#locale_format>__。 更多示例请参见format documentation <https://vega.github.io/vega-lite/docs/format.html>__。 当与custom formatType <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>__一起使用时，此值将作为format与datum.value一起传递给注册的函数。 默认值： 从numberFormat <https://vega.github.io/vega-lite/docs/config.html#format>__配置中派生用于数字格式，从timeFormat <https://vega.github.io/vega-lite/docs/config.html#format>__配置中派生用于时间格式。
格式类型	string	标签的格式类型。可以是 "number"、 "time"，或一个 已注册 自定义 格式 类型 <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>__。 默认值： "time" 用于时间字段以及具有 timeUnit 的序数和名义字段。 "number" 用于定量字段以及没有 timeUnit 的序数和名义字段。
标签对齐	anyOf(Align, ExprRef)	表头标签的水平文本对齐。可以是 "left"、"center" 或 "right" 之一。
标签锚点	TitleAnchor	放置标签的锚点位置。可以是 "start", "middle", 或 "end"。例如，当标签方向为顶部时，这些锚点位置分别对应左对齐、居中或右对齐的标签。
标签角度	number	表头标签的旋转角度。 默认值：列标题为 0，行标题为 -90。
标签基线	任意(TextBaseline, ExprRef)	标题标签的垂直文本基线。可以是 "alphabetic"（默认）、"top"、"middle"、"bottom"、"line-top" 或 "line-bottom"。"line-top" 和 "line-bottom" 的值类似于 "top" 和 "bottom"，但相对于 titleLineHeight 而不是单独的 titleFontSize 进行计算。
标签颜色	anyOf(Color, ExprRef)	标题标签的颜色，可以是十六进制颜色代码或常规颜色名称。
标签表达式	字符串	Vega 表达式 __ 用于自定义标签。 注意： 标签文本和值可以通过标头的支持 datum 对象的 label 和 value 属性来访问。
标签字体	anyOf(string, ExprRef)	标题标签的字体。
标签字体大小	anyOf(number, ExprRef)	头部标签的字体大小，以像素为单位。
标签字体风格	anyOf(FontStyle, ExprRef)	标题标签的字体风格。
标签字体粗细	anyOf(FontWeight, ExprRef)	标题标签的字体粗细。
标签限制	任意(数字, ExprRef)	标题标签的最大长度（以像素为单位）。如果渲染大小超过限制，文本值将自动截断。 默认值： 0，表示没有限制
标签行高	anyOf(number, ExprRef)	多行标题标签或标题文本的像素行高，基线为 "line-top" 或 "line-bottom"。
标签方向	Orient	标题标签的方向。可以是 "top"、"bottom"、"left" 或 "right"。
标签填充	anyOf(number, ExprRef)	图形与分面头标签之间的填充，单位为像素。 默认值： 10
标签	boolean	一个布尔标志，指示是否应将标签包含在头部中。 默认值： true。
方向	Orient	同时设置labelOrient和titleOrient的快捷方式。
标题	null	设置为 null 以禁用轴、图例或标题的标题。
标题对齐	anyOf(Align, ExprRef)	标题的水平文本对齐（相对于锚点）。
标题锚点	TitleAnchor	放置标题的锚点位置。可以是 "start"、 "middle" 或 "end"之一。例如，在顶部方向时，这些锚点位置对应于左对齐、居中或右对齐的标题。
标题角度	number	标题的旋转角度。 默认值： 0。
标题基线	anyOf(TextBaseline, ExprRef)	头部标题的垂直文本基线。可以是 "alphabetic"（默认）、"top"、"middle"、"bottom"、"line-top" 或 "line-bottom"。"line-top" 和 "line-bottom" 的值的操作方式类似于 "top" 和 "bottom"，但它们是相对于 titleLineHeight 而不是仅仅 titleFontSize 计算的。 默认值： "middle"
标题颜色	anyOf(Color, ExprRef)	标题的颜色，可以是十六进制颜色代码或常规颜色名称。
标题字体	anyOf(string, ExprRef)	表头标题的字体。(例如，"Helvetica Neue").
标题字体大小	anyOf(number, ExprRef)	标题的字体大小。
标题字体样式	anyOf(FontStyle, ExprRef)	标题的字体样式。
标题字体粗细	任何一个(FontWeight, ExprRef)	标题的字体粗细。可以是字符串（例如 "bold", "normal"）或数字（100, 200, 300, …, 900，其中 "normal" = 400 和 "bold" = 700）。
标题限制	任意(number, ExprRef)	标题的最大长度（以像素为单位）。如果渲染的尺寸超过限制，文本值将会自动截断。 默认值： 0，表示没有限制
标题行高度	anyOf(number, ExprRef)	多行标题文本或带有 "line-top" 或 "line-bottom" 基线的标题文本的像素行高。
标题方向	Orient	标题的方向。可以是 "top"、 "bottom"、 "left" 或 "right"。
标题内边距	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'
)

附加属性在下表中总结：

Click to show table

属性	类型	描述
aria	anyOf(boolean, ExprRef)	一个布尔标志，指示是否应包含ARIA attributes __（仅限于SVG输出）。如果false，则“aria-hidden”属性将被设置在输出的SVG组上，从ARIA可访问性树中删除图例。 默认值： true
剪辑高度	anyOf(number, ExprRef)	以像素为单位剪辑符号图例条目的高度并限制它们的大小。
列边距	anyOf(number, ExprRef)	符号图例条目之间的水平边距，以像素为单位。 默认值： 10。
列	任何的(number, ExprRef)	排列符号图例条目的列数。值为0或更低表示每个条目一列的单行。
圆角半径	anyOf(number, ExprRef)	完整图例的圆角半径。
描述	anyOf(string, ExprRef)	此图例的文本描述，用于ARIA 无障碍 __（仅SVG输出）。如果aria属性为true，对于SVG输出，"aria-label" 属性 __将被设置为此描述。如果未指定描述，它将被自动生成。
方向	Orientation	图例的方向，可以是 "vertical" 或 "horizontal"之一。 默认值： 对于顶部/底部orient的图例，"horizontal" 对于左侧/右侧orient的图例，"vertical" 对于顶部/底部-left/right-orient的图例，渐变图例使用 "horizontal"，符号图例使用 "vertical"。
禁用	boolean	默认禁用图例
填充颜色	anyOf(anyOf(null, Color), ExprRef)	完整图例的背景填充颜色。
渐变方向	anyOf(Orientation, ExprRef)	渐变图例的默认方向 ("horizontal" 或 "vertical")。 默认值： "vertical"。
gradientHorizontalMaxLength	number	当 config.legend.gradientLength 未定义时，水平渐变的最大图例长度。 默认值： 200
水平渐变的最小图例长度	number	当 config.legend.gradientLength 未定义时，水平渐变的最小图例长度。 默认值： 100
gradientLabelLimit	anyOf(number, ExprRef)	颜色渐变标签允许的最大长度（以像素为单位）。
渐变标签偏移量	anyOf(number, ExprRef)	颜色梯度标签的垂直偏移量，单位为像素。 默认值： 2.
gradientLength	anyOf(number, ExprRef)	颜色渐变主轴的长度（以像素为单位）。该值对应于垂直渐变的高度或水平渐变的宽度。 默认值： 200。
渐变不透明度	anyOf(number, ExprRef)	颜色渐变的透明度。
渐变边框颜色	anyOf(anyOf(null, Color), ExprRef)	渐变边框的颜色，可以是十六进制颜色代码或常规颜色名称。 默认值： "lightGray"。
渐变笔触宽度	anyOf(number, ExprRef)	渐变笔触的宽度，以像素为单位。 默认值： 0。
gradientThickness	anyOf(number, ExprRef)	颜色渐变的厚度（以像素为单位）。此值对应于垂直渐变的宽度或水平渐变的高度。 默认值： 16。
渐变垂直最大长度	number	当 config.legend.gradientLength 未定义时，垂直渐变的最大图例长度。 默认值： 200
渐变垂直最小长度	number	当 config.legend.gradientLength 未定义时，垂直渐变的最小图例长度。 默认值： 100
gridAlign	anyOf(LayoutAlign, ExprRef)	应用于符号图例行和列的对齐方式。支持的字符串值为 "all", "each"（默认值），和 none。更多信息，请参见 grid layout documentation __. 默认值： "each"。
标签对齐	anyOf(Align, ExprRef)	图例标签的对齐方式，可以是左对齐、居中或右对齐。
标签基线	任何一个(TextBaseline, ExprRef)	图例标签的基线位置，可以是 "top", "middle", "bottom", 或 "alphabetic"。 默认值： "middle"。
标签颜色	anyOf(anyOf(null, Color), ExprRef)	图例标签的颜色，可以是十六进制颜色代码或常规颜色名称。
标签字体	anyOf(string, ExprRef)	图例标签的字体。
标签字体大小	anyOf(number, ExprRef)	图例标签的字体大小。 默认值： 10。
标签字体样式	anyOf(FontStyle, ExprRef)	图例标签的字体样式。
标签字体粗细	anyOf(FontWeight, ExprRef)	图例标签的字体粗细。
标签限制	任何(数字, ExprRef)	图例刻度标签的最大允许像素宽度。 默认值： 160。
标签偏移	anyOf(number, ExprRef)	图例标签的偏移量。 默认值： 4。
标签不透明度	anyOf(number, ExprRef)	标签的不透明度。
标签重叠	anyOf(LabelOverlap, ExprRef)	用于解决渐变图例中标签重叠的策略。如果 false，则不尝试减少重叠。如果设置为 true 或 "parity"，则使用删除每隔一个标签的策略。如果设置为 "greedy"，则对标签进行线性扫描，删除任何与最后一个可见标签重叠的标签（这通常在对数刻度轴上效果更好）。 默认值： "greedy" 对于 log scales 否则 true`。
标签填充	anyOf(number, ExprRef)	图例与图例标签之间的像素填充。
标签间隔	anyOf(number, ExprRef)	为了被认为是非重叠的，标签边框框之间必须保持的最小间隔（默认 0）。如果未启用 labelOverlap 解析，则此属性会被忽略。
布局	ExprRef
legendX	anyOf(number, ExprRef)	自定义图例的 x 轴位置，方向为“无”。
legendY	anyOf(number, ExprRef)	自定义图例的y轴位置，方向为“none”。
偏移量	anyOf(number, ExprRef)	以像素为单位的偏移量，用于将图例从数据矩形和轴上移开。 默认值： 18。
方向	LegendOrient	图例的方向，决定图例在场景中的位置。可以是 "left"，"right"，"top"，"bottom"，"top-left"，"top-right"，"bottom-left"，"bottom-right"，"none" 之一。 默认值： "right"
内边距	anyOf(number, ExprRef)	图例组边框与内容之间的内边距。 默认值： 0。
行内边距	anyOf(number, ExprRef)	符号图例条目之间的垂直边距（单位：像素）。 默认值： 2。
笔画颜色	anyOf(anyOf(null, Color), ExprRef)	完整图例的边框笔画颜色。
strokeDash	anyOf(array(number), ExprRef)	完整图例的边框笔画虚线样式。
描边宽度	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)	开始绘制符号笔划虚线数组的像素偏移量。
符号方向	anyOf(Orientation, ExprRef)	符号图例的默认方向 ("horizontal" 或 "vertical")。 默认值： "vertical"。
符号填充颜色	anyOf(anyOf(null, Color), ExprRef)	图例符号的颜色，
符号限制	anyOf(number, ExprRef)	符号图例允许的最大条目数。额外的条目将被忽略。
符号偏移	任何(数字, ExprRef)	图例符号的水平像素偏移。 默认值： 0。
符号不透明度	anyOf(number, ExprRef)	图例符号的不透明度。
符号大小	任意值(数字, ExprRef)	图例符号的大小，以像素为单位。 默认值： 100。
符号描边颜色	anyOf(anyOf(null, Color), ExprRef)	图例符号的描边颜色。
符号描边宽度	anyOf(number, ExprRef)	符号描边的宽度。 默认值： 1.5。
符号类型	anyOf(SymbolShape, ExprRef)	符号形状。绘图形状之一 circle（默认）， square， cross， diamond， triangle-up， triangle-down， triangle-right，或 triangle-left，线符号 stroke，或中心方向形状之一 arrow， wedge，或 triangle。另外，可以提供自定义 SVG path 字符串 __。为了正确的大小，自定义形状路径应定义在一个边界框内，坐标范围在 x 和 y 维度上均为 -1 到 1。 默认值： "circle"。
刻度计数量	任意(TickCount, ExprRef)	定量图例所需的刻度值数量。
标题	null	设置为 null 以禁用轴、图例或标题的标题。
标题对齐	anyOf(Align, ExprRef)	图例标题的水平文本对齐方式。 默认值： "left"。
标题锚点	anyOf(TitleAnchor, ExprRef)	放置图例标题的文本锚点位置。
标题基线	anyOf(TextBaseline, ExprRef)	图例标题的垂直文本基线。可以为 "alphabetic"（默认），"top"，"middle"，"bottom"，"line-top" 或 "line-bottom"。"line-top" 和 "line-bottom" 的值与 "top" 和 "bottom" 类似，但它们是相对于 lineHeight 而非单独的 fontSize 计算的。 默认值： "top"。
标题颜色	anyOf(anyOf(null, Color), ExprRef)	图例标题的颜色，可以是十六进制颜色代码或常规颜色名称。
标题字体	anyOf(string, ExprRef)	图例标题的字体。
标题字体大小	anyOf(number, ExprRef)	图例标题的字体大小。
标题字体样式	anyOf(FontStyle, ExprRef)	图例标题的字体样式。
标题字体粗细	任何(FontWeight, ExprRef)	图例标题的字体粗细。可以是字符串（例如 "bold", "normal"）或数字（100, 200, 300, …, 900，其中 "normal" = 400， "bold" = 700）。
标题限制	anyOf(number, ExprRef)	图例标题的最大允许像素宽度。 默认值： 180。
标题行高	anyOf(number, ExprRef)	多行标题文本或带有"line-top"或"line-bottom"基线的标题文本的像素行高。
标题不透明度	anyOf(number, ExprRef)	图例标题的透明度。
标题方向	anyOf(Orient, ExprRef)	图例标题的方向。
标题内边距	anyOf(number, ExprRef)	标题和图例之间的内边距，单位为像素。 默认值： 5。
未选中不透明度	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()

以上每种方法都接受以下属性：

Click to show table

属性	类型	描述
对齐	anyOf(Align, ExprRef)	文本或范围标记（区域、条形、图像、矩形、规则）的水平对齐。可以是 "left"、"right"、"center"之一。 注意：范围标记不支持表达式引用。
角度	anyOf(number, ExprRef)	文本的旋转角度，以度为单位。
可访问性属性	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”属性。警告：此属性是实验性的，并可能在将来更改。
方面	anyOf(boolean, ExprRef)	是否保持图像标记的纵横比。
基线	anyOf(TextBaseline, ExprRef)	对于文本标记，垂直文本基线。可以是 "alphabetic"（默认）、"top"、"middle"、"bottom"、"line-top"、"line-bottom" 之一，或者提供有效值之一的表达式引用。"line-top" 和 "line-bottom" 的值的操作类似于 "top" 和 "bottom"，但相对于 lineHeight 而不是单独的 fontSize 进行计算。 对于范围标记，标记的垂直对齐方式。可以是 "top"、"middle"、"bottom" 之一。 注意：范围标记不支持表达式引用。
混合	anyOf(Blend, ExprRef)	在当前背景上绘制项目的颜色混合模式。可以使用任何有效的 CSS mix-blend-mode __ 值。 默认值： "source-over"
颜色	anyOf(Color, Gradient, ExprRef)	默认颜色。 默认值： :raw-html: style="color: #4682b4;"> ■ :raw-html: "#4682b4" 注意： 该属性不能在 style config __ 中使用。 fill 和 stroke 属性的优先级高于 color，并将覆盖 color。
圆角半径	anyOf(number, ExprRef)	圆角矩形或弧形的角的半径（以像素为单位）。 默认值： 0
左下角圆角半径	anyOf(number, ExprRef)	圆角矩形左下角的半径，单位为像素。 默认值： 0
右下角圆角半径	anyOf(number, ExprRef)	圆角矩形右下角的半径，单位为像素。 默认值： 0
左上角圆角半径	anyOf(number, ExprRef)	圆角矩形的右上角的半径（以像素为单位）。 默认值： 0
右上角圆角半径	任何(数字, ExprRef)	圆角矩形左上角的半径（以像素为单位）。 默认值： 0
光标	anyOf(Cursor, ExprRef)	在标记上使用的鼠标光标。可以使用任何有效的 CSS cursor type 。
描述	anyOf(string, ExprRef)	标记项的文本描述，用于 ARIA 无障碍 __（仅 SVG 输出）。如果指定，则该属性决定 "aria-label" 属性 __。
dir	anyOf(TextDirection, ExprRef)	文本的方向。可以是 "ltr"（从左到右）或 "rtl"（从右到左）。此属性决定在响应限制参数时，哪一侧会被截断。 默认值： "ltr"
dx	anyOf(number, ExprRef)	文本标签与其锚点之间的水平偏移量，以像素为单位。偏移量是在angle属性旋转之后应用的。
dy	anyOf(number, ExprRef)	文本标签与其锚点之间的垂直偏移量，单位为像素。该偏移量在angle属性旋转后应用。
省略号	anyOf(string, ExprRef)	响应限值参数时用于文本截断的省略号字符串。 默认值： "…"
结束角度	anyOf(number, ExprRef)	弧形标记的结束角度（以弧度为单位）。值 0 表示向上（北），增加的值按顺时针方向递增。
填充	anyOf(Color, Gradient, null, ExprRef)	默认填充颜色。此属性的优先级高于 config.color。设置为 null 以移除填充。 默认值： (无)
填充不透明度	anyOf(number, ExprRef)	填充不透明度（值在 [0,1] 之间）。 默认值： 1
填充	boolean	标记的颜色是否应该作为填充颜色而不是描边颜色。 默认值： 对于所有 point、 line 和 rule 标记以及 graticule __ 数据源的 geoshape 标记，默认值为 false；否则，默认值为 true。 注意： 此属性不能在 style config __ 中使用。
字体	anyOf(string, ExprRef)	设置文本的字形（例如，"Helvetica Neue"）。
字体大小	anyOf(number, ExprRef)	字体大小，以像素为单位。 默认值： 11
字体样式	anyOf(FontStyle, ExprRef)	字体样式（例如，"italic"）。
字体粗细	anyOf(FontWeight, ExprRef)	字体的粗细。可以是字符串（例如 "bold", "normal"）或数字 (100, 200, 300, …, 900，其中 "normal" = 400 和 "bold" = 700）。
高度	anyOf(number, ExprRef)	标记的高度。
链接	anyOf(URI, ExprRef)	在鼠标点击时加载的URL。如果定义了，标记将作为超链接。
内半径	anyOf(number, ExprRef)	弧形标记的内半径（以像素为单位）。 innerRadius 是 radius2 的别名。 默认值： 0
插值	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": 相当于基础，除了张力参数用于拉直样条。 "monotone": 保持y单调性的三次插值。
无效	anyOf(MarkInvalidDataMode, null)	无效数据模式，定义了标记和相应比例尺应如何表示无效值（null 和 NaN 在没有为无效值定义输出的连续比例尺中）。 "filter" — 排除 可视化的 标记 和 比例尺 中的所有无效值。对于路径标记（用于线、区域、轨迹），此选项将创建连接有效点的路径，仿佛无效值的数据行不存在。 "break-paths-filter-domains" — 在无效值处断开路径标记（用于线、区域、轨迹）。对于非路径标记，这等同于 "filter"。所有 比例尺 域将 排除 这些被过滤的数据点。 "break-paths-show-domains" — 在无效值处断开路径（用于线、区域、轨迹）。隐藏非路径标记的无效值。所有 比例尺 域将 包含 这些被过滤的数据点（对于路径和非路径标记均如此）。 "show" 或 null — 在标记和比例尺域中显示所有数据点。每个比例尺将使用在 config.scale.invalid 中定义的无效值的输出，或者如果未指定，默认的无效值将产生与零相同的视觉值（如果比例尺包含零）或最小值（如果比例尺不包含零）。 "break-paths-show-path-domains"（默认） — 对于基于路径的标记（线/区域/轨迹）相当于 "break-paths-show-domains"，而对于非路径标记则相当于 "filter"。 注意：如果任何通道的比例尺为无效值定义了输出在 config.scale.invalid 中，则所有比例尺的值将被视为“有效”，因为它们可以为比例尺产生合理的输出。因此，这些通道的字段将不会被过滤，也不会导致路径断开。
限制	anyOf(number, ExprRef)	文本标记的最大长度（以像素为单位）。如果渲染的大小超过限制，文本值将自动截断。 默认值： 0 – 表示无限制
换行符	anyOf(string, ExprRef)	一个分隔符，例如换行符，用于将文本字符串分割成多行。如果文本是数组值，则此属性会被忽略。
行高	anyOf(number, ExprRef)	多行文本标记的像素行高（文本后续行之间的间距）。
不透明度	anyOf(number, ExprRef)	总体不透明度（值在[0,1]之间）。 默认值： 对于具有point、tick、circle或square标记的非聚合图，0.7；否则为1。
顺序	[null, boolean]	对于线条和轨迹标记，此 order 属性可以设置为 null 或 false 以使线条使用数据源中的原始顺序。
方向	Orientation	非堆叠条形图、刻度图、面积图和折线图的方向。值可以是水平（默认）或垂直。 对于条形、规则和刻度，这决定了条形和刻度的大小应该应用于x维度还是y维度。 对于面积图，这个属性决定了Vega输出的orient属性。 对于折线和轨迹标记，如果config.sortLineBy未被指定，此属性决定了折线中点的排序顺序。对于堆叠图，这始终由堆叠的方向决定；因此显式指定的值将被忽略。
外半径	anyOf(number, ExprRef)	弧形标记的外半径（以像素为单位）。 outerRadius 是 radius 的别名。 默认值： 0
padAngle	anyOf(number, ExprRef)	应用于弧的两侧的角度填充，单位为弧度。
半径	anyOf(number, ExprRef)	对于弧形标记，主要（外部）半径，单位为像素。 对于文本标记，文本相对于由 x 和 y 属性确定的原点的极坐标径向偏移，单位为像素。 默认值： min(plot_width, plot_height)/2
radius2	anyOf(number, ExprRef)	弧形标记的次级（内）半径，单位为像素。 默认值： 0
形状	anyOf(anyOf(SymbolShape, string), ExprRef)	点标记的形状。支持的值包括： 绘图形状： "circle", "square", "cross", "diamond", "triangle-up", "triangle-down", "triangle-right", 或 "triangle-left". 线条符号 "stroke" 居中的方向形状 "arrow", "wedge", 或 "triangle" 自定义 SVG 路径 字符串 __ （为了正确的尺寸，自定义形状路径应在一个坐标范围从 -1 到 1 的正方形边界框内定义，x 和 y 维度均如此。） 默认值： "circle"
大小	anyOf(number, ExprRef)	标记的默认大小。 对于 point/circle/square，这表示标记的像素面积。注意，该值设置符号的面积；边长将随着该值的平方根而增加。 对于 bar，这表示条形的带宽，单位为像素。 对于 text，这表示字体大小，单位为像素。 默认值： 30 用于点、圆、方形标记；宽度/高度的 step 2 用于具有离散维度的条形标记； 5 用于具有连续维度的条形标记； 11 用于文本标记。
平滑	anyOf(boolean, ExprRef)	一个布尔标志（默认值为true），指示在调整图像大小时是否应进行平滑处理。如果为false，则个别像素应直接缩放，而不是通过平滑插值。如果是SVG渲染，由于缺乏标准化，此选项在某些浏览器中可能无效。
起始角度	anyOf(number, ExprRef)	弧标记的起始角度（弧度）。0 的值表示向上（北方），增加的值顺时针方向进行。
描边	anyOf(Color, Gradient, null, ExprRef)	默认描边颜色。该属性的优先级高于 config.color。设置为 null 以移除描边。 默认值: (无)
线条末端样式的笔触帽。	anyOf(StrokeCap, ExprRef)	线条末端样式的笔触帽。可以是 "butt"、"round" 或 "square" 之一。 默认值： "butt"
strokeDash	anyOf(array(number), ExprRef)	一个交替的笔画和空格长度的数组，用于创建虚线或点线。
笔划虚线偏移	anyOf(number, ExprRef)	开始使用笔划虚线数组绘制的偏移量（以像素为单位）。
线条连接	任何一个(StrokeJoin, ExprRef)	线条连接方法。可以是 "miter"、 "round" 或 "bevel" 之一。 默认值： "miter"
斜接限制	anyOf(number, ExprRef)	用于斜接线接的斜接限制。
描边偏移量	anyOf(number, ExprRef)	绘制组的描边和填充的像素偏移。如果未指定，默认行为是动态偏移描边组，以使1像素的描边宽度与像素网格对齐。
描边透明度	anyOf(number, ExprRef)	描边的不透明度（值在[0,1]之间）。 默认值： 1
笔画宽度	anyOf(number, ExprRef)	笔画的宽度，以像素为单位。
张力	anyOf(number, ExprRef)	根据插值类型，设置张力参数（用于线条和区域标记）。
文本	anyOf(Text, ExprRef)	如果text通道未指定，则显示占位符文本
theta	anyOf(number, ExprRef)	对于弧标记，如果未指定theta2，则为弧长（以弧度为单位），否则为起始弧角。（值为0表示向上或“北”，增加的值顺时针增加。） 对于文本标记，极坐标角（以弧度为单位）。
theta2	anyOf(number, ExprRef)	弧标记的结束角度，以弧度表示。值为0表示向上或“北”，增加的值顺时针递增。
时间单位带位置	number	时间单位的默认相对带位置。如果设置为 0，标记将位于时间单位带步骤的开始。如果设置为 0.5，标记将位于时间单位带步骤的中间。
时间单位带大小	number	时间单位的默认相对带大小。如果设置为 1，标记的带宽将等于时间单位带的步长。如果设置为 0.5，标记的带宽将是时间单位带步长的一半。
工具提示	anyOf(number, string, boolean, TooltipContent, ExprRef, null)	当鼠标悬停时显示的工具提示文本字符串，或定义工具提示应从哪些字段派生的对象。 如果 tooltip 是 true 或 {"content": "encoding"}，那么将使用所有来自 encoding 的字段。 如果 tooltip 是 {"content": "data"}，那么将使用出现在高亮数据点中的所有字段。 如果设置为 null 或 false，则不使用工具提示。 有关Vega-Lite中工具提示的详细讨论，请参见 tooltip __ 文档。 默认值： null
网址	anyOf(URI, ExprRef)	图像标记的图像文件的URL。
宽度	anyOf(number, ExprRef)	标记的宽度。
x	anyOf(number, string, ExprRef)	标记的 X 坐标，或者在未指定 x2 或 width 的情况下，水平 "bar" 和 "area" 的宽度。 该通道的 value 可以是一个数字或字符串 "width"，用于图形的宽度。
x2	anyOf(number, string, ExprRef)	X2 坐标用于范围 "area", "bar", "rect", 和 "rule"。 该通道的 value 可以是一个数字或字符串 "width"，表示图形的宽度。
y	anyOf(number, string, ExprRef)	标记的Y坐标，或在未指定y2或height的情况下，垂直"bar"和"area"的高度。 此通道的value可以是一个数字，或者是字符串"height"，表示绘图的高度。
y2	anyOf(number, string, ExprRef)	范围的 Y2 坐标 "area", "bar", "rect", 和 "rule"。 这个通道的 value 可以是一个数字或字符串 "height"，表示绘图的高度。

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

缩放配置

刻度可以通过 Chart.configure_scale() 配置，具有以下属性：

Click to show table

属性	类型	描述
带内填充	anyOf(number, ExprRef)	默认的内填充用于 x 和 y 带比例尺。 默认值： nestedOffsetPaddingInner 适用于具有嵌套 x/y 偏移比例尺的 x/y 比例尺。 barBandPaddingInner 适用于条形标记（默认值为 0.1） rectBandPaddingInner 适用于矩形和其他标记（默认值为 0）
带外边距	任何一个(数字, ExprRef)	默认的外边距用于 x 和 y 带比例尺。 默认值： paddingInner/2 (这使得 宽度/高度 = 唯一值的数量 * 步长)
带嵌套偏移填充的内部边距	任意(number, ExprRef)	嵌套的 xOffset 和 yOffset 编码的 x 和 y 带比例尺的默认内部填充。 默认值： 0.2
带嵌套偏移填充的外边距	任意一个(number, ExprRef)	带有嵌套的xOffset和yOffset编码的x和y带刻度的默认外边距。 默认值： 0.2
条带内边距	任意的(number, ExprRef)	默认的内边距用于x和y条带序数比例的"bar"标记。 默认值： 0.1
夹紧	anyOf(boolean, ExprRef)	如果为真，超过数据域的值将被限制为最小或最大范围值
连续填充	anyOf(number, ExprRef)	连续 x/y 轴的默认填充。 默认: 垂直条形的连续 x 轴和水平条形的连续 y 轴的条形宽度；0 则为其他情况。
无效	ScaleInvalidDataConfig	一个对象，用于定义每个通道对于无效值（在连续尺度上的null和NaN）的缩放输出。 这个对象中的键是缩放通道。 值可以是 "zero-or-min"（如果缩放包括零或最小值则使用零，否则使用最小值）或一个值定义 {value: ...}。 示例：将这个 config.scale.invalid 属性设置为 {color: {value: '#aaa'}} 将使可视化的颜色为所有无效值着色为‘#aaa’。 有关更多详细信息，请参阅 [https://vega.github.io/vega-lite/docs/invalid-data.html](Invalid Data Docs)。
最大带宽大小	number	将定量字段映射到条形的大小/带宽的默认最大值。 如果未定义（默认），我们将使用轴的大小（宽度或高度） - 1。
最大字体大小	number	将定量字段映射到文本的大小/字体大小比例的默认最大值。 默认值： 40
最大不透明度	数字	将字段映射到不透明度的默认最大不透明度。 默认值： 0.8
最大尺寸	number	点大小比例的默认最大值。
最大笔画宽度	number	规则和线条标记的笔画宽度缩放的默认最大笔画宽度，以及轨迹标记的大小。 默认值： 4
最小带宽大小	数字	将定量字段映射到条形和刻度的大小/带宽规模的默认最小值。 默认值： 2
最小字体大小	数字	将定量字段映射到文本的大小/字体大小比例的默认最小值。 默认值： 8
最小不透明度	number	将字段映射到不透明度的默认最小不透明度。 默认值： 0.3
最小尺寸	number	点大小比例的默认最小值。 默认值： 9
最小描边宽度	数字	规则和线标记的描边宽度尺度的默认最小描边宽度，以及轨迹标记的大小。 默认值： 1
偏移带内边距	任意值(number, ExprRef)	xOffset/yOffset 的带标度的默认内边距。 默认值： 0
外部偏移带填充	任意(number, ExprRef)	xOffset/yOffset 的带标度的默认外部填充。 默认值： 0
点间距	anyOf(number, ExprRef)	默认的外部填充用于 x 和 y 点序数刻度。 默认值： 0.5 (这使得 宽度/高度 = 唯一值的数量 * 步长)
分位数计数	数字	默认范围基数用于 quantile __ 标度。 默认值： 4
量化计数	数字	默认范围基数用于 quantize __ 规模。 默认值： 4
矩形带内边距	任意值(数字, ExprRef)	“rect”标记的x和y带序数尺度的默认内边距。 默认值： 0
四舍五入	anyOf(boolean, ExprRef)	如果为真，数值输出值将四舍五入为整数。这对于对齐像素网格非常有帮助。（仅适用于 x, y, 和 size 尺度。）
刻度带内边距	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 轴比例（对从右到左的图表有用）。
零	布尔值	默认 scale.zero 用于 连续 __ 规模，除了 (1) 非范围条形图或区域图的 x/y 规模和 (2) 大小规模。 默认值： true

缩放范围配置

缩放范围可以通过 Chart.configure_range() 进行配置，具有以下属性：

Click to show table

属性	类型	描述
类别	anyOf(RangeScheme, array(Color))	默认 color scheme __ 用于分类数据。
发散	anyOf(RangeScheme, array(Color))	默认 color scheme __ 用于发散的定量变化。
热图	anyOf(RangeScheme, array(Color))	默认 color scheme __ 用于定量热图。
序数	anyOf(RangeScheme, array(Color))	默认 color scheme __ 用于排名有序的数据。
梯度	anyOf(RangeScheme, array(Color))	默认 color scheme __ 用于顺序定量梯度。
符号	数组(SymbolShape)	默认形状调色板的symbol __名称或路径的数组。

投影配置

投影可以使用 Chart.configure_projection() 进行配置，具有以下属性：

Click to show table

属性	类型	描述
中心	anyOf(Vector2, ExprRef)	投影的中心，一个包含经度和纬度（以度为单位）的两元素数组。 默认值： [0, 0]
剪切角度	anyOf(number, ExprRef)	投影的剪切圆半径到指定的角度（以度为单位）。如果 null，则切换到 antimeridian __ 切割而不是小圆剪切。
剪裁范围	anyOf(Vector2>, ExprRef)	投影的视口剪裁范围，以指定的像素边界为准。范围边界被指定为数组 [[x0, y0], [x1, y1]]，其中 x0 是视口的左侧， y0 是顶部， x1 是右侧， y1 是底部。如果 null，则不执行视口剪裁。
系数	anyOf(number, ExprRef)	hammer 投影的系数参数。 默认值： 2
距离	anyOf(number, ExprRef)	对于卫星投影，从球体中心到视点的距离，作为球体半径的比例。给定距离的推荐最大裁剪角度为acos(1 / distance)转换为度数。如果也应用了倾斜，则可能需要更保守的裁剪。 默认值： 2.0
范围	任何一个(Vector2>, ExprRef)
适配	anyOf(Fit, array(Fit), ExprRef)
分数	anyOf(number, ExprRef)	用于bottomley投影的分数参数。 默认值： 0.5，对应于 sin(ψ)，其中 ψ = π/6。
叶片	anyOf(number, ExprRef)	支持多叶片视图的投影中的叶片数量： berghaus, gingery, 或 healpix。默认值根据投影类型而异。
并行	anyOf(number, ExprRef)	支持的投影的并行参数： armadillo， bonne， craig， cylindricalEqualArea， cylindricalStereographic， hammerRetroazimuthal， loximuthal，或 rectangularPolyconic。 默认值根据投影类型而变化。
平行线	anyOf(array(number), ExprRef)	对于圆锥投影，两个 标准 平行线 __ 定义地图布局。默认值取决于使用的特定圆锥投影。
点半径	anyOf(number, ExprRef)	绘制GeoJSON Point 和 MultiPoint 几何图形时使用的默认半径（以像素为单位）。此参数设置一个恒定的默认值。要根据数据修改点半径，请参阅GeoPath和GeoShape变换的相应参数。 默认值： 4.5
精度	任意类型(数字, ExprRef)	投影的 自适应 重采样 __ 到指定像素值的阈值。该值对应于 道格拉斯-普克算法 距离 __。如果未指定精度，则返回投影的当前重采样精度，默认为 √0.5 ≅ 0.70710…。
半径	anyOf(number, ExprRef)	用于airy或gingery投影的半径参数。默认值依据投影类型而异。
比率	anyOf(number, ExprRef)	对于hill、hufnagel或wagner投影的比率参数。默认值根据投影类型而变化。
reflectX	anyOf(boolean, ExprRef)	设置在输出中是否反射（取反）x维度。
reflectY	anyOf(boolean, ExprRef)	设置输出中y维度是否被反射（取反）。
旋转	anyOf(anyOf(Vector2, Vector3), ExprRef)	投影在指定角度上的三轴旋转，这些角度必须是一个两元素或三元素的数字数组 [lambda, phi, gamma]，指定每个球面轴的旋转角度（以度为单位）。 （这些对应于偏航、俯仰和滚转。） 默认值： [0, 0, 0]
比例	anyOf(number, ExprRef)	投影的比例（缩放）因子，覆盖自动适配。默认比例是特定于投影的。比例因子与投影点之间的距离线性对应；但是，比例因子值在不同投影之间并不等价。
大小	anyOf(Vector2, ExprRef)	与 fit 一起使用，提供投影应该自动适配的区域的宽度和高度（以像素为单位）。
间距	anyOf(number, ExprRef)	用于lagrange投影的间距参数。 默认值： 0.5
倾斜	anyOf(number, ExprRef)	用于卫星投影的倾斜角度（以度为单位）。 默认值： 0。
翻译	anyOf(Vector2, ExprRef)	投影的平移偏移量，表示为一个包含两个元素的数组 [tx, ty].
类型	anyOf(ProjectionType, ExprRef)	要使用的地图投影。该值是不区分大小写的，例如 "albers" 和 "Albers" 表示相同的投影类型。你可以在 文档 __ 中找到所有有效的投影类型。 默认值： equalEarth

连接与面板配置

可以使用 Chart.configure_concat() 和 Chart.configure_facet() 配置 concat 和 facet 图表的各个方面，这些具有以下属性：

Click to show table

属性	类型	描述
列	number	要包含在视图组合布局中的列数。 默认值: undefined – 将假定为无限数量的列（单行）。这相当于 hconcat（用于 concat）以及使用 column 通道（用于 facet 和 repeat）。 注意: 此属性仅适用于： 通用（可换行的）concat 操作符（不是 hconcat/vconcat） 带有一个字段/重复定义的 facet 和 repeat 操作符（没有行/列嵌套） 将 columns 设置为 1 相当于 vconcat（用于 concat）以及使用 row 通道（用于 facet 和 repeat）。
间距	number	已组合子视图之间的默认间距（以像素为单位）。 默认值: 20

选择配置

选择可以使用 Chart.configure_selection() 进行配置，具有以下属性：

Click to show table

属性	类型	描述
区间	IntervalSelectionConfigWithoutType	用于interval __选择的默认定义。除了type以外，区间选择定义的所有属性和变换可以在这里指定。 例如，将interval设置为{"translate": false}将默认禁用移动区间选择的能力。
点	PointSelectionConfigWithoutType	一个 point __ 选择的默认定义。所有点选择定义的属性和变换（除了 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'
)

附加标题配置选项列在下面的表格中：

Click to show table

NoneNone

属性	类型	描述
对齐	Align	标题文本的水平对齐。可以是 "left"、 "center" 或 "right" 之一。
锚点	anyOf(TitleAnchor, ExprRef)	用于放置标题和副标题文本的锚点位置。可以是 "start"、"middle" 或 "end" 之一。例如，若方向为顶部，则这些锚点位置对应于左对齐、居中对齐或右对齐的标题。
角度	anyOf(number, ExprRef)	标题和副标题文本的角度（以度为单位）。
aria	anyOf(boolean, ExprRef)	一个布尔标志，指示是否应该包含ARIA 属性 __（仅限SVG输出）。如果false，则会在输出的SVG组上设置“aria-hidden”属性，从而从ARIA可访问性树中移除标题。 默认值： true
基线	TextBaseline	标题和副标题文本的垂直基线。可选值包括 "alphabetic"（默认）、 "top"、 "middle"、 "bottom"、 "line-top" 或 "line-bottom"。 "line-top" 和 "line-bottom" 值的操作类似于 "top" 和 "bottom"，但根据 lineHeight 而不是仅根据 fontSize 计算。
颜色	anyOf(anyOf(null, Color), ExprRef)	标题文本的文字颜色。
dx	anyOf(number, ExprRef)	标题和副标题文本的 x 坐标增量偏移。
dy	anyOf(number, ExprRef)	标题和副标题文本的 y 坐标的增量偏移量。
字体	anyOf(string, ExprRef)	标题文本的字体名称。
字体大小	anyOf(number, ExprRef)	标题文本的字体大小（以像素为单位）。
字体样式	anyOf(FontStyle, ExprRef)	标题文本的字体样式。
字体粗细	anyOf(FontWeight, ExprRef)	标题文本的字体粗细。可以是字符串（例如 "bold", "normal"）或数字 (100, 200, 300, …, 900，其中 "normal" = 400 和 "bold" = 700）。
框架	anyOf(anyOf(TitleFrame, string), ExprRef)	锚点位置的参考框架，选择以下之一："bounds"（相对于完整边界框锚定）或"group"（相对于组的宽度或高度锚定）。
限制	anyOf(number, ExprRef)	标题和副标题文本允许的最大长度（以像素为单位）。
行高	anyOf(number, ExprRef)	多行标题文本或带有"line-top"或"line-bottom"基线的标题文本的像素行高。
偏移量	anyOf(number, ExprRef)	以像素为单位的正交偏移量，用于将标题组从其在图表边缘位置的位移。
方向	anyOf(TitleOrient, ExprRef)	默认标题方向 ("top", "bottom", "left", 或 "right")
字幕颜色	anyOf(anyOf(null, Color), ExprRef)	字幕文本的颜色。
副标题字体	anyOf(string, ExprRef)	字幕文本的字体名称。
字幕字体大小	anyOf(number, ExprRef)	字幕文本的字体大小（单位：像素）。
副标题字体样式	anyOf(FontStyle, ExprRef)	副标题文本的字体样式。
副标题字体粗细	anyOf(FontWeight, ExprRef)	副标题文本的字体粗细。可以是字符串（例如 "bold", "normal"）或数字 (100, 200, 300, …, 900，其中 "normal" = 400 和 "bold" = 700).
副标题行高	anyOf(number, ExprRef)	多行字幕文本的行高（单位：像素）。
副标题内边距	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',
)

附加属性汇总在下表中：

Click to show table

属性	类型	描述
clip	boolean	视图是否应该被裁剪。
连续高度	number	当图表具有连续的 y 字段用于 x 或纬度，或具有弧形标记时的默认高度。 默认值： 200
连续宽度	number	当图表具有连续的 x 轴或经度字段，或者具有弧形标记时的默认宽度。 默认值： 200
圆角半径	anyOf(number, ExprRef)	圆角矩形或弧形的角的半径（以像素为单位）。 默认值： 0
光标	Cursor	在视图中使用的鼠标光标。可以使用任何有效的 CSS cursor type 。
离散高度	anyOf(number, dict)	当图形具有非弧形标记且具有离散 y 字段或没有 y 字段时的默认高度。高度可以是一个数字，表示固定高度，或者是一个形式为 {step: number} 的对象，定义每个离散步骤的高度。 默认值： 基于 config.view.step 的步长大小。
离散宽度	anyOf(number, dict)	当图表没有弧形标记并且有离散的 x 字段或没有 x 字段时的默认宽度。宽度可以是一个表示固定宽度的数字，也可以是一个格式为 {step: number} 的对象，用于定义每个离散步骤的宽度。 默认值：基于 config.view.step 的步长。
填充	anyOf(Color, null, ExprRef)	填充颜色。 默认值： undefined
填充不透明度	anyOf(number, ExprRef)	填充不透明度（值在 [0,1] 之间）。 默认值： 1
不透明度	anyOf(number, ExprRef)	总体不透明度（值在[0,1]之间）。 默认值： 对于具有point、tick、circle或square标记的非聚合图，0.7；否则为1。
步骤	number	x-/y-离散字段的默认步长.
笔画	anyOf(Color, null, ExprRef)	笔画颜色。 默认值： "#ddd"
线条末端样式的笔触帽。	anyOf(StrokeCap, ExprRef)	线条末端样式的笔触帽。可以是 "butt"、"round" 或 "square" 之一。 默认值： "butt"
strokeDash	anyOf(array(number), ExprRef)	一个交替的笔画和空格长度的数组，用于创建虚线或点线。
笔划虚线偏移	anyOf(number, ExprRef)	开始使用笔划虚线数组绘制的偏移量（以像素为单位）。
线条连接	任何一个(StrokeJoin, ExprRef)	线条连接方法。可以是 "miter"、 "round" 或 "bevel" 之一。 默认值： "miter"
斜接限制	anyOf(number, ExprRef)	用于斜接线接的斜接限制。
描边透明度	anyOf(number, ExprRef)	描边的不透明度（值在[0,1]之间）。 默认值： 1
笔画宽度	anyOf(number, ExprRef)	笔画的宽度，以像素为单位。