顶级图表配置#
图表外观的许多方面都可以使用 configure_*()
方法在顶级进行配置。这些方法及其设置的属性仅在图表顶级有效,可以被视为设置图表主题的一种方式:它们为整个图表设置默认样式,并且这些默认样式可以被与图表元素相关的特定样式设置所覆盖。
这些方法及其参数将在下面列出
图表配置
Chart.configure()
坐标轴配置
Chart.configure_axis()
头部配置
Chart.configure_header()
图例配置
Chart.configure_legend()
标记和标记样式配置
Chart.configure_mark()
比例尺配置
Chart.configure_scale()
比例尺范围配置
Chart.configure_range()
投影配置
Chart.configure_projection()
Concat 和 Facet 配置
Chart.configure_concat()
,Chart.configure_facet()
选择配置
Chart.configure_selection()
标题配置
Chart.configure_title()
视图配置
Chart.configure_view()
有关图表定制方法的更多讨论,请参见自定义可视化。
图表配置#
Chart.configure()
方法为图表添加一个 Config
实例,并接受以下参数
点击显示表格
属性 |
类型 |
描述 |
---|---|---|
arc |
弧形特定配置 |
|
area |
面积特定配置 |
|
aria |
|
一个布尔标志,指示是否应包含标记和指南的 ARIA 默认属性(仅限 SVG 输出)。如果为 false,则将为所有指南设置 默认值: |
autosize |
anyOf( |
如何确定可视化尺寸。如果为字符串,应为 默认值: |
axis |
坐标轴配置,它决定了所有 |
|
axisBand |
带有“band”比例尺的坐标轴配置。 |
|
axisBottom |
图表底部边缘的 x 轴配置。 |
|
axisDiscrete |
带有“point”或“band”比例尺的坐标轴配置。 |
|
axisLeft |
图表左侧边缘的 y 轴配置。 |
|
axisPoint |
带有“point”比例尺的坐标轴配置。 |
|
axisQuantitative |
定量坐标轴配置。 |
|
axisRight |
图表右侧边缘的 y 轴配置。 |
|
axisTemporal |
时间坐标轴配置。 |
|
axisTop |
图表顶部边缘的 x 轴配置。 |
|
axisX |
X 轴特定配置。 |
|
axisXBand |
带有“band”比例尺的 x 轴配置。 |
|
axisXDiscrete |
带有“point”或“band”比例尺的 x 轴配置。 |
|
axisXPoint |
带有“point”比例尺的 x 轴配置。 |
|
axisXQuantitative |
定量 x 轴配置。 |
|
axisXTemporal |
时间 x 轴配置。 |
|
axisY |
Y 轴特定配置。 |
|
axisYBand |
带有“band”比例尺的 y 轴配置。 |
|
axisYDiscrete |
带有“point”或“band”比例尺的 y 轴配置。 |
|
axisYPoint |
带有“point”比例尺的 y 轴配置。 |
|
axisYQuantitative |
定量 y 轴配置。 |
|
axisYTemporal |
时间 y 轴配置。 |
|
background |
用作整个视图背景的 CSS 颜色属性。 默认值: |
|
bar |
条形特定配置 |
|
boxplot |
箱体配置 |
|
circle |
圆形特定配置 |
|
concat |
所有 concatenation 和 repeat 视图组合操作符( |
|
countTitle |
|
计数字段的默认坐标轴和图例标题。 默认值: |
customFormatTypes |
|
允许文本标记和指南的 |
errorband |
误差带配置 |
|
errorbar |
误差棒配置 |
|
facet |
|
|
fieldTitle |
[‘verbal’, ‘functional’, ‘plain’] |
定义 Vega-Lite 如何为字段生成标题。有三种可能的样式
|
font |
|
所有文本标记、标题和标签的默认字体。 |
geoshape |
地理图形特定配置 |
|
header |
头部配置,它决定了所有 有关头部配置选项的完整列表,请参见 |
|
headerColumn |
头部配置,它决定了列 有关头部配置选项的完整列表,请参见 |
|
headerFacet |
头部配置,它决定了非行/列 Facet 有关头部配置选项的完整列表,请参见 |
|
headerRow |
头部配置,它决定了行 有关头部配置选项的完整列表,请参见 |
|
image |
图像特定配置 |
|
legend |
图例配置,它决定了所有 |
|
line |
折线特定配置 |
|
lineBreak |
anyOf( |
用于将文本字符串断开为多行的分隔符,例如换行符。此属性为文本标记提供全局默认值,该值会被标记或样式配置设置以及 lineBreak 标记编码通道覆盖。如果为信号值,则字符串或正则表达式(regexp)值均有效。 |
locale |
用于字符串解析和数字与日期值格式化的区域设置定义。区域设置对象应包含带有 |
|
mark |
标记配置 |
|
normalizedNumberFormat |
|
如果未指定 normalizedNumberFormatType,则使用 D3 数字格式用于归一化堆叠字段(带有 如果指定了 |
normalizedNumberFormatType |
|
默认值: |
numberFormat |
|
如果未指定 numberFormatType,则使用 D3 数字格式用于非归一化字段(不带有 如果指定了 |
numberFormatType |
|
默认值: |
padding |
默认可视化内边距,以像素为单位,从可视化画布边缘到数据矩形。如果为数字,则指定所有边的内边距。如果为对象,则值应采用 默认值: |
|
params |
参数化可视化的动态变量或选择。 |
|
point |
点特定配置 |
|
projection |
投影配置,它决定了所有 |
|
range |
一个对象哈希,定义用于比例尺的默认范围数组或方案。有关比例尺范围配置选项的完整列表,请参见 |
|
rect |
矩形特定配置 |
|
rule |
规则线特定配置 |
|
scale |
比例尺配置决定了所有 |
|
selection |
一个对象哈希,用于定义每种选择类型的默认属性。 |
|
square |
正方形特定配置 |
|
style |
一个对象哈希,定义键值映射,以确定具有给定 |
|
text |
文本特定配置 |
|
tick |
刻度特定配置 |
|
timeFormat |
|
文本标记、图例标签和头部标签中原始时间值(不带时间单位)的默认时间格式。 默认值: |
timeFormatType |
|
默认值: |
title |
标题配置,它决定了所有 |
|
tooltipFormat |
为工具提示定义 |
|
trail |
轨迹线特定配置 |
|
view |
|
坐标轴配置#
坐标轴配置定义了坐标轴的默认设置,可以使用 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( |
一个布尔标志,指示是否应包含 默认值: |
bandPosition |
anyOf( |
一个插值分数,指示对于 默认值: |
description |
anyOf( |
此坐标轴的文本描述,用于 |
disable |
|
默认禁用坐标轴。 |
domain |
|
一个布尔标志,指示域(坐标轴基线)是否应作为坐标轴的一部分包含在内。 默认值: |
domainCap |
域线的末端样式笔触帽。可选值包括 默认值: |
|
domainColor |
坐标轴域线的颜色。 默认值: |
|
domainDash |
anyOf(数组( |
用于虚线域线的交替 [stroke, space] 长度数组。 |
domainDashOffset |
anyOf( |
开始使用域虚线数组绘制的像素偏移量。 |
domainOpacity |
anyOf( |
坐标轴域线的透明度。 |
domainWidth |
anyOf( |
坐标轴域线的笔触宽度 默认值: |
format |
anyOf( |
与默认的
有关更多示例,请参见 与 默认值: 数字格式的 |
formatType |
|
标签的格式类型。可选值包括 默认值
|
grid |
|
一个布尔标志,指示网格线是否应作为坐标轴的一部分包含在内 默认值: 对于未分箱的 |
gridCap |
网格线的末端样式笔触帽。可选值包括 默认值: |
|
gridColor |
anyOf(anyOf( |
网格线的颜色。 默认值: |
gridDash |
anyOf(数组( |
用于虚线网格线的交替 [stroke, space] 长度数组。 |
gridDashOffset |
anyOf( |
开始使用网格虚线数组绘制的像素偏移量。 |
gridOpacity |
anyOf( |
网格线的笔触透明度(值在 [0,1] 之间) 默认值: |
gridWidth |
anyOf( |
网格线宽度,以像素为单位。 默认值: |
labelAlign |
anyOf( |
坐标轴刻度标签的水平文本对齐方式,覆盖当前坐标轴方向的默认设置。 |
labelAngle |
anyOf( |
坐标轴标签的旋转角度。 默认值: 对于名义字段和有序字段为 |
labelBaseline |
坐标轴刻度标签的垂直文本基线,覆盖当前坐标轴方向的默认设置。可选值包括 |
|
labelBound |
anyOf([number, boolean], |
指示如果标签超出坐标轴范围是否应隐藏。如果为 默认值: |
labelColor |
anyOf(anyOf( |
刻度标签的颜色,可以是十六进制颜色码或常规颜色名称。 |
labelExpr |
|
用于自定义标签的 注意:可以通过坐标轴底层 |
labelFlush |
[布尔值, 数字] |
指示第一个和最后一个坐标轴标签是否应与比例尺范围齐平对齐。水平坐标轴的齐平对齐将左对齐第一个标签并右对齐最后一个标签。对于垂直坐标轴,则应用底部和顶部文本基线。如果此属性是数字,它还指示偏移第一个和最后一个标签的像素数;例如,值为 2 将齐平对齐第一个和最后一个标签,并将其从坐标轴中心向外推出 2 像素。额外的调整有时有助于标签更好地与相应的坐标轴刻度在视觉上分组。 默认值: 对于连续 x 比例尺的坐标轴为 |
labelFlushOffset |
anyOf( |
指示偏移齐平调整标签的像素数。例如,值为 默认值: |
labelFont |
anyOf( |
刻度标签的字体。 |
labelFontSize |
anyOf( |
标签的字体大小,以像素为单位。 |
labelFontStyle |
标题的字体样式。 |
|
labelFontWeight |
坐标轴刻度标签的字体粗细。 |
|
labelLimit |
anyOf( |
坐标轴刻度标签允许的最大像素宽度。 默认值: |
labelLineHeight |
anyOf( |
多行标签文本或带有 |
labelOffset |
anyOf( |
像素单位的标签位置偏移量,附加到 tickOffset。 默认值: |
labelOpacity |
anyOf( |
标签的不透明度。 |
labelOverlap |
anyOf( |
用于解决坐标轴标签重叠问题的策略。如果设置为 默认值: 对于非标称字段和非对数比例尺为 |
labelPadding |
anyOf( |
标签和刻度之间的像素填充量。 默认值: |
labelSeparation |
anyOf( |
标签边界框之间必须保持的最小间隔,以使其被视为不重叠(默认值 |
labels |
|
一个布尔标志,指示是否应将标签包含在坐标轴中。 默认值: |
maxExtent |
anyOf( |
坐标轴刻度和标签应使用的最大像素范围。这确定了坐标轴标题的最大偏移值。 默认值: |
minExtent |
anyOf( |
坐标轴刻度和标签应使用的最小像素范围。这确定了坐标轴标题的最小偏移值。 默认值: y 轴为 |
offset |
anyOf( |
坐标轴相对于包含组或数据矩形边缘的像素偏移量。 默认值: 由 |
orient |
anyOf( |
坐标轴的方向。可选值包括 默认值: x 轴为 |
position |
anyOf( |
坐标轴的锚点位置(像素)。对于朝向顶部或底部的 x 轴,这设置了坐标轴组的 x 坐标。对于朝向左侧或右侧的 y 轴,这设置了坐标轴组的 y 坐标。 默认值: |
style |
anyOf( |
一个字符串或字符串数组,指示要应用于坐标轴的自定义样式名称。样式是在 默认值: (无) 注意: 任何指定的样式都会增强默认样式。例如,带有 |
tickBand |
anyOf([‘center’, ‘extent’], |
对于 band 比例尺,指示刻度和网格线是放置在 band 的 |
tickCap |
刻度线末端样式的描边端点类型。可选值包括 默认值: |
|
tickColor |
anyOf(anyOf( |
坐标轴刻度的颜色。 默认值: |
tickCount |
anyOf( |
对于可视化定量比例尺的坐标轴,期望的刻度数量。最终数量可能会有所不同,以便值是“良好”的(2、5、10 的倍数)并位于基础比例尺的范围内。 对于 默认值: 使用公式确定,x 为 |
tickDash |
anyOf(数组( |
用于虚线刻度线的交替 [描边, 间隙] 长度数组。 |
tickDashOffset |
anyOf( |
开始绘制刻度线虚线数组的像素偏移量。 |
tickExtra |
|
一个布尔标志,指示是否应为坐标轴的起始位置添加额外的坐标轴刻度。此标志对于为 |
tickMinStep |
anyOf( |
坐标轴刻度之间的最小期望步长,以比例尺域值表示。例如,值 |
tickOffset |
anyOf( |
应用于刻度、标签和网格线的像素位置偏移量。 |
tickOpacity |
anyOf( |
刻度的不透明度。 |
tickRound |
|
一个布尔标志,指示像素位置值是否应四舍五入到最接近的整数。 默认值: |
tickSize |
anyOf( |
坐标轴刻度的像素大小。 默认值: |
tickWidth |
anyOf( |
刻度的像素宽度。 默认值: |
ticks |
|
一个布尔值,确定坐标轴是否应包含刻度。 默认值: |
title |
anyOf( |
字段的标题。如果为 默认值: 由字段名称和转换函数( 注意:
|
titleAlign |
坐标轴标题的水平文本对齐方式。 |
|
titleAnchor |
anyOf( |
用于放置坐标轴标题的文本锚点位置。 |
titleAngle |
anyOf( |
坐标轴标题的旋转角度(度)。 |
titleBaseline |
anyOf( |
坐标轴标题的垂直文本基线。可选值包括 |
titleColor |
标题的颜色,可以是十六进制颜色码或常规颜色名称。 |
|
titleFont |
anyOf( |
标题的字体。(例如, |
titleFontSize |
anyOf( |
标题的字体大小。 |
titleFontStyle |
标题的字体样式。 |
|
titleFontWeight |
anyOf( |
标题的字体粗细。这可以是字符串(例如 |
titleLimit |
anyOf( |
坐标轴标题允许的最大像素宽度。 |
titleLineHeight |
anyOf( |
多行标题文本或基线为 |
titleOpacity |
anyOf( |
坐标轴标题的不透明度。 |
titlePadding |
anyOf( |
标题和坐标轴之间的像素填充量。 |
titleX |
anyOf( |
坐标轴标题相对于坐标轴组的 X 坐标。 |
titleY |
anyOf( |
坐标轴标题相对于坐标轴组的 Y 坐标。 |
translate |
anyOf( |
坐标轴布局的坐标空间平移偏移量。默认情况下,坐标轴会进行 x 和 y 坐标各 0.5 像素的平移偏移,以便使描边线与像素网格对齐。但是,对于矢量图形输出,这些像素特定的调整可能是不期望的,此时可以更改 translate(例如,更改为零)。 默认值: |
values |
anyOf(array( |
显式设置可见的坐标轴刻度值。 |
zindex |
|
一个非负整数,表示坐标轴的 z-index。如果 zindex 为 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( |
与默认的
有关更多示例,请参见 与 默认值: 数字格式的 |
formatType |
|
标签的格式类型。可选值包括 默认值
|
labelAlign |
标题标签的水平文本对齐方式。可选值包括 |
|
labelAnchor |
用于放置标签的锚点位置。可选值包括 |
|
labelAngle |
|
标题标签的旋转角度。 默认值: 列标题为 |
labelBaseline |
anyOf( |
标题标签的垂直文本基线。可选值包括 |
labelColor |
标题标签的颜色,可以是十六进制颜色码或常规颜色名称。 |
|
labelExpr |
|
用于自定义标签的 注意: 标签文本和值可以通过标题的后端 |
labelFont |
anyOf( |
标题标签的字体。 |
labelFontSize |
anyOf( |
标题标签的像素字体大小。 |
labelFontStyle |
标题标签的字体样式。 |
|
labelFontWeight |
anyOf( |
标题标签的字体粗细。 |
labelLimit |
anyOf( |
标题标签的最大像素长度。如果渲染大小超出限制,文本值将自动截断。 默认值: |
labelLineHeight |
anyOf( |
多行标题标签或基线为 |
labelOrient |
标题标签的方向。可选值包括 |
|
labelPadding |
anyOf( |
刻面标题的标签与图表之间的像素填充量。 默认值: |
labels |
|
一个布尔标志,指示是否应将标签包含在标题中。 默认值: |
orient |
用于同时设置 labelOrient 和 titleOrient 的快捷方式。 |
|
title |
|
设置为 null 可禁用坐标轴、图例或标题的标题。 |
titleAlign |
标题标题的水平文本对齐方式(相对于锚点)。 |
|
titleAnchor |
用于放置标题的锚点位置。可选值包括 |
|
titleAngle |
|
标题标题的旋转角度。 默认值: |
titleBaseline |
anyOf( |
标题标题的垂直文本基线。可选值包括 默认值: |
titleColor |
标题标题的颜色,可以是十六进制颜色码或常规颜色名称。 |
|
titleFont |
anyOf( |
标题标题的字体。(例如, |
titleFontSize |
anyOf( |
标题标题的字体大小。 |
titleFontStyle |
标题标题的字体样式。 |
|
titleFontWeight |
anyOf( |
标题标题的字体粗细。这可以是字符串(例如 |
titleLimit |
anyOf( |
标题标题的最大像素长度。如果渲染大小超出限制,文本值将自动截断。 默认值: |
titleLineHeight |
anyOf( |
多行标题标题文本或基线为 |
titleOrient |
标题标题的方向。可选值包括 |
|
titlePadding |
anyOf( |
刻面标题的标题与标签之间的像素填充量。 默认值: |
图例配置#
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( |
一个布尔标志,指示是否应包含 默认值: |
clipHeight |
anyOf( |
用于裁剪符号图例条目并限制其大小的像素高度。 |
columnPadding |
anyOf( |
符号图例条目之间的水平像素填充量。 默认值: |
columns |
anyOf( |
排列符号图例条目的列数。值小于等于 |
cornerRadius |
anyOf( |
整个图例的圆角半径。 |
description |
anyOf( |
此图例的文本描述,用于 |
direction |
图例的方向,可选值包括 默认值
|
|
disable |
|
默认禁用图例 |
fillColor |
整个图例的背景填充颜色。 |
|
gradientDirection |
anyOf( |
渐变图例的默认方向( 默认值: |
gradientHorizontalMaxLength |
|
当 默认值: |
gradientHorizontalMinLength |
|
当 默认值: |
gradientLabelLimit |
anyOf( |
色带渐变标签允许的最大像素长度。 |
gradientLabelOffset |
anyOf( |
色带渐变标签的垂直像素偏移量。 默认值: |
gradientLength |
anyOf( |
颜色渐变主轴的像素长度。该值对应于垂直渐变的高度或水平渐变的宽度。 默认值: |
gradientOpacity |
anyOf( |
颜色渐变的不透明度。 |
gradientStrokeColor |
渐变描边的颜色,可以是十六进制颜色码或常规颜色名称。 默认值: |
|
gradientStrokeWidth |
anyOf( |
渐变描边的像素宽度。 默认值: |
gradientThickness |
anyOf( |
颜色渐变的像素厚度。该值对应于垂直渐变的宽度或水平渐变的高度。 默认值: |
gradientVerticalMaxLength |
|
当 默认值: |
gradientVerticalMinLength |
|
当 默认值: |
gridAlign |
anyOf( |
应用于符号图例行和列的对齐方式。支持的字符串值包括 默认值: |
labelAlign |
图例标签的对齐方式,可以是左对齐、居中对齐或右对齐。 |
|
labelBaseline |
anyOf( |
图例标签基线的位置,可以是 默认值: |
labelColor |
图例标签的颜色,可以是十六进制颜色码或常规颜色名称。 |
|
labelFont |
anyOf( |
图例标签的字体。 |
labelFontSize |
anyOf( |
图例标签的字体大小。 默认值: |
labelFontStyle |
图例标签的字体样式。 |
|
labelFontWeight |
anyOf( |
图例标签的字体粗细。 |
labelLimit |
anyOf( |
图例刻度标签允许的最大像素宽度。 默认值: |
labelOffset |
anyOf( |
图例标签的偏移量。 默认值: |
labelOpacity |
anyOf( |
标签的不透明度。 |
labelOverlap |
anyOf( |
用于解决渐变图例中标签重叠问题的策略。如果为 默认值: 对数比例尺为 |
labelPadding |
anyOf( |
图例和图例标签之间的像素填充量。 |
labelSeparation |
anyOf( |
标签边界框之间必须保持的最小间隔,以使其被视为不重叠(默认值 |
layout |
||
legendX |
anyOf( |
朝向为“none”的图例的自定义 x 位置。 |
legendY |
anyOf( |
朝向为“none”的图例的自定义 y 位置。 |
offset |
anyOf( |
图例相对于数据矩形和坐标轴的像素偏移量。 默认值: |
orient |
图例的方向,它决定了图例在场景中的位置。可选值包括 默认值: |
|
padding |
anyOf( |
图例组边框和内容之间的填充量。 默认值: |
rowPadding |
anyOf( |
符号图例条目之间的垂直像素填充量。 默认值: |
strokeColor |
整个图例的边框描边颜色。 |
|
strokeDash |
anyOf(数组( |
整个图例的边框描边虚线模式。 |
strokeWidth |
anyOf( |
整个图例的边框描边宽度。 |
symbolBaseFillColor |
图例符号的默认填充颜色。仅在图例没有 默认值: |
|
symbolBaseStrokeColor |
图例符号的默认描边颜色。仅在图例没有 默认值: |
|
symbolDash |
anyOf(数组( |
用于虚线符号描边的交替 [描边, 间隙] 长度数组。 |
symbolDashOffset |
anyOf( |
开始绘制符号描边虚线数组的像素偏移量。 |
symbolDirection |
anyOf( |
符号图例的默认方向( 默认值: |
symbolFillColor |
图例符号的颜色, |
|
symbolLimit |
anyOf( |
符号图例允许的最大条目数量。额外的条目将被丢弃。 |
symbolOffset |
anyOf( |
图例符号的水平像素偏移量。 默认值: |
symbolOpacity |
anyOf( |
图例符号的不透明度。 |
symbolSize |
anyOf( |
图例符号的像素大小。 默认值: |
symbolStrokeColor |
图例符号的描边颜色。 |
|
symbolStrokeWidth |
anyOf( |
符号描边的宽度。 默认值: |
symbolType |
anyOf( |
符号形状。可选值包括绘图形状 默认值: |
tickCount |
定量图例期望的刻度值数量。 |
|
title |
|
设置为 null 可禁用坐标轴、图例或标题的标题。 |
titleAlign |
图例标题的水平文本对齐方式。 默认值: |
|
titleAnchor |
anyOf( |
用于放置图例标题的文本锚点位置。 |
titleBaseline |
anyOf( |
图例标题的垂直文本基线。可选值包括 默认值: |
titleColor |
图例标题的颜色,可以是十六进制颜色码或常规颜色名称。 |
|
titleFont |
anyOf( |
图例标题的字体。 |
titleFontSize |
anyOf( |
图例标题的字体大小。 |
titleFontStyle |
图例标题的字体样式。 |
|
titleFontWeight |
anyOf( |
图例标题的字体粗细。这可以是字符串(例如 |
titleLimit |
anyOf( |
图例标题允许的最大像素宽度。 默认值: |
titleLineHeight |
anyOf( |
多行标题文本或基线为 |
titleOpacity |
anyOf( |
图例标题的不透明度。 |
titleOrient |
图例标题的方向。 |
|
titlePadding |
anyOf( |
标题和图例之间的像素填充量。 默认值: |
unselectedOpacity |
|
未选定图例条目的不透明度。 默认值 0.35. |
zindex |
anyOf( |
指示图例组相对于其他坐标轴、标记和图例组的层叠顺序的整数 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 |
文本或范围标记(area, bar, image, rect, rule)的水平对齐方式。可选值包括 注意: 范围标记不支持表达式引用。 |
|
angle |
anyOf( |
文本的旋转角度,单位为度。 |
aria |
anyOf( |
一个布尔标志,指示是否应包含 |
ariaRole |
anyOf( |
为标记项设置用户界面元素的类型,用于 |
ariaRoleDescription |
anyOf( |
标记项角色的可读、作者本地化的描述,用于 |
aspect |
anyOf( |
是否保持图像标记的纵横比。 |
baseline |
anyOf( |
对于文本标记,垂直文本基线。可选值包括 对于范围标记,标记的垂直对齐方式。可选值包括 注意: 范围标记不支持表达式引用。 |
blend |
在当前背景上绘制项目时使用的颜色混合模式。可以使用任何有效的 默认值: |
|
color |
默认颜色。 默认值: :raw-html: 注意
|
|
cornerRadius |
anyOf( |
圆角矩形或弧形角的像素半径。 默认值: |
cornerRadiusBottomLeft |
anyOf( |
圆角矩形左下角的像素半径。 默认值: |
cornerRadiusBottomRight |
anyOf( |
圆角矩形右下角的像素半径。 默认值: |
cornerRadiusTopLeft |
anyOf( |
圆角矩形右上角的像素半径。 默认值: |
cornerRadiusTopRight |
anyOf( |
圆角矩形左上角的像素半径。 默认值: |
cursor |
鼠标悬停在标记上时使用的鼠标光标。可以使用任何有效的 |
|
description |
anyOf( |
标记项的文本描述,用于 |
dir |
anyOf( |
文本的方向。可选值包括 默认值: |
dx |
anyOf( |
文本标签及其锚点之间的水平像素偏移量。偏移量在通过 angle 属性旋转后应用。 |
dy |
anyOf( |
文本标签及其锚点之间的垂直像素偏移量。偏移量在通过 angle 属性旋转后应用。 |
ellipsis |
anyOf( |
响应 limit 参数而截断文本时使用的省略号字符串。 默认值: |
endAngle |
anyOf( |
弧形标记的结束角度(弧度)。值 |
fill |
默认填充颜色。此属性的优先级高于 默认值: (无) |
|
fillOpacity |
anyOf( |
填充不透明度(值在 [0,1] 之间)。 默认值: |
filled |
|
标记的颜色是作为填充颜色使用还是作为描边颜色使用。 默认值: 对于所有 注意: 此属性不能在 |
font |
anyOf( |
设置文本的字体(例如, |
fontSize |
anyOf( |
字体大小,单位为像素。 默认值: |
fontStyle |
字体样式(例如, |
|
fontWeight |
anyOf( |
字体粗细。这可以是字符串(例如 |
height |
anyOf( |
标记的高度。 |
href |
鼠标点击时加载的 URL。如果定义了此属性,则标记充当超链接。 |
|
innerRadius |
anyOf( |
弧形标记的像素内半径。 默认值: |
interpolate |
anyOf( |
用于线和面积标记的线条插值方法。以下之一
|
invalid |
anyOf( |
无效数据模式,定义了标记和相应的比例尺应如何表示无效值(连续比例尺中没有为无效值定义输出时的
注意: 如果任何通道的比例尺在 |
limit |
anyOf( |
文本标记的最大像素长度。如果渲染大小超出限制,文本值将自动截断。 默认值: |
lineBreak |
anyOf( |
用于将文本字符串分解为多行的分隔符,例如换行符。如果文本是数组值,则忽略此属性。 |
lineHeight |
anyOf( |
多行文本标记的像素行高(后续文本行之间的间距)。 |
opacity |
anyOf( |
整体不透明度(值在 [0,1] 之间)。 默认值: 对于使用 |
order |
[null, boolean] |
对于线标记和轨迹标记,此 |
orient |
非堆叠柱状图、刻度图、面积图和折线图的方向。值可以是水平(默认)或垂直。
|
|
outerRadius |
anyOf( |
弧形标记的外半径,单位像素。 默认值: |
padAngle |
anyOf( |
应用于弧形两侧的角填充,单位弧度。 |
radius |
anyOf( |
对于弧形标记,主要(外)半径,单位像素。 对于文本标记,文本相对于由 默认值: |
radius2 |
anyOf( |
弧形标记的次要(内)半径,单位像素。 默认值: |
shape |
anyOf(anyOf( |
点标记的形状。支持的值包括:
默认值: |
size |
anyOf( |
标记的默认大小。
默认值
|
smooth |
anyOf( |
一个布尔标志(默认为 true),指示图像在调整大小时是否应进行平滑处理。如果为 false,则应直接缩放单个像素而不是进行插值平滑处理。对于 SVG 渲染,由于缺乏标准化,此选项在某些浏览器中可能无效。 |
startAngle |
anyOf( |
弧形标记的起始角度,单位弧度。值为 |
stroke |
默认描边颜色。此属性具有比 默认值: (无) |
|
strokeCap |
线条末端的描边帽样式。可以是 默认值: |
|
strokeDash |
anyOf(数组( |
一个包含交替描边和空间长度的数组,用于创建虚线或点线。 |
strokeDashOffset |
anyOf( |
开始使用描边虚线数组绘制的偏移量(单位像素)。 |
strokeJoin |
anyOf( |
描边线的连接方式。可以是 默认值: |
strokeMiterLimit |
anyOf( |
对线连接进行斜角处理时的斜接限制。 |
strokeOffset |
anyOf( |
绘制组描边和填充的像素偏移量。如果未指定,默认行为是动态偏移描边的组,使 1 像素的描边宽度与像素网格对齐。 |
strokeOpacity |
anyOf( |
描边不透明度(取值范围 [0,1])。 默认值: |
strokeWidth |
anyOf( |
描边宽度,单位像素。 |
tension |
anyOf( |
根据插值类型,设置张力参数(用于线标记和面积标记)。 |
text |
如果未指定 |
|
theta |
anyOf( |
|
theta2 |
anyOf( |
弧形标记的结束角度,单位弧度。值为 0 表示向上或“北方”,增加值按顺时针方向进行。 |
timeUnitBandPosition |
|
时间单位的默认相对带位置。如果设置为 |
timeUnitBandSize |
|
时间单位的默认相对带大小。如果设置为 |
tooltip |
anyOf( |
鼠标悬停时显示的工具提示文本字符串,或定义应从哪些字段派生工具提示的对象。
有关 Vega-Lite 中工具提示的详细讨论,请参阅 默认值: |
url |
图像标记的图像文件 URL。 |
|
width |
anyOf( |
标记的宽度。 |
x |
anyOf( |
标记的 X 坐标,或者未指定 此通道的 |
x2 |
anyOf( |
范围标记 此通道的 |
y |
anyOf( |
标记的 Y 坐标,或者未指定 此通道的 |
y2 |
anyOf( |
范围标记 此通道的 |
除了上述默认标记属性外,还可以使用 Chart.configure_style()
方法中定义为关键字参数的命名样式进一步自定义默认值。然后可以通过在标记定义对象中包含 style 属性来调用样式。
比例尺配置#
可以使用 Chart.configure_scale()
配置比例尺,该方法具有以下属性:
点击显示表格
属性 |
类型 |
描述 |
---|---|---|
bandPaddingInner |
anyOf( |
默认值
|
bandPaddingOuter |
anyOf( |
默认值: |
bandWithNestedOffsetPaddingInner |
anyOf( |
带有嵌套 默认值: |
bandWithNestedOffsetPaddingOuter |
anyOf( |
带有嵌套 默认值: |
barBandPaddingInner |
anyOf( |
默认值: |
clamp |
anyOf( |
如果为 true,则超过数据域的值将被限制到最小或最大范围值。 |
continuousPadding |
anyOf( |
连续 x/y 比例尺的默认填充。 默认值: 垂直条形的连续 x 比例尺和水平条形的连续 y 比例尺的条形宽度;否则为 |
invalid |
一个对象,为无效值(连续比例尺上的 null 和 NaN)定义每个通道的比例尺输出。
示例: 将此 更多详情请参阅 [https://vega.github.io/vega-lite/docs/invalid-data.html](无效数据文档)。 |
|
maxBandSize |
|
将定量字段映射到条形大小/带宽的默认最大值。 如果未定义(默认),我们将使用轴的大小(宽度或高度)- 1。 |
maxFontSize |
|
将定量字段映射到文本大小/字体大小比例尺的默认最大值。 默认值: |
maxOpacity |
|
将字段映射到不透明度的默认最大不透明度。 默认值: |
maxSize |
|
点大小比例尺的默认最大值。 |
maxStrokeWidth |
|
规则线和线标记的描边宽度比例尺以及轨迹标记的大小比例尺的默认最大描边宽度。 默认值: |
minBandSize |
|
将定量字段映射到条形和刻度大小/带宽比例尺的默认最小值。 默认值: |
minFontSize |
|
将定量字段映射到文本大小/字体大小比例尺的默认最小值。 默认值: |
minOpacity |
|
将字段映射到不透明度的默认最小不透明度。 默认值: |
minSize |
|
点大小比例尺的默认最小值。 默认值: |
minStrokeWidth |
|
规则线和线标记的描边宽度比例尺以及轨迹标记的大小比例尺的默认最小描边宽度。 默认值: |
offsetBandPaddingInner |
anyOf( |
xOffset/yOffset 带状比例尺的默认内填充。 默认值: |
offsetBandPaddingOuter |
anyOf( |
xOffset/yOffset 带状比例尺的默认外填充。 默认值: |
pointPadding |
anyOf( |
默认值: |
quantileCount |
|
默认值: |
quantizeCount |
|
默认值: |
rectBandPaddingInner |
anyOf( |
默认值: |
round |
anyOf( |
如果为 true,则将数字输出值四舍五入为整数。这有助于与像素网格对齐。(仅适用于 |
tickBandPaddingInner |
anyOf( |
默认值: |
useUnaggregatedDomain |
|
对于聚合轴,使用聚合前的数据源范围作为比例尺域,而不是聚合数据。 这等效于默认将聚合的定量字段的 此属性仅适用于生成值在原始数据域范围内的聚合函数( 默认值: |
xReverse |
anyOf( |
默认反转 x 比例尺(对从右到左的图表很有用)。 |
zero |
|
默认值: |
比例尺范围配置#
可以使用 Chart.configure_range()
配置比例尺范围,该方法具有以下属性:
点击显示表格
属性 |
类型 |
描述 |
---|---|---|
category |
anyOf( |
分类数据的默认 |
diverging |
anyOf( |
发散定量渐变色带的默认 |
heatmap |
anyOf( |
定量热力图的默认 |
ordinal |
anyOf( |
有序数据的默认 |
ramp |
anyOf( |
顺序定量渐变色带的默认 |
symbol |
array( |
默认形状调色板的 |
投影配置#
可以使用 Chart.configure_projection()
配置投影,该方法具有以下属性:
点击显示表格
属性 |
类型 |
描述 |
---|---|---|
center |
anyOf( |
投影中心,一个包含经度和纬度(单位为度)的双元素数组。 默认值: |
clipAngle |
anyOf( |
投影裁剪圆的半径,指定为角度(单位为度)。如果为 |
clipExtent |
anyOf( |
投影视口的裁剪范围,指定为像素边界。范围边界指定为一个数组 |
coefficient |
anyOf( |
默认值: |
distance |
anyOf( |
对于 默认值: |
extent |
anyOf( |
|
fit |
||
fraction |
anyOf( |
默认值: |
lobes |
anyOf( |
支持多瓣视图的投影( |
parallel |
anyOf( |
支持该参数的投影( |
parallels |
anyOf(数组( |
对于圆锥投影,定义地图布局的 |
pointRadius |
anyOf( |
绘制 GeoJSON 默认值: |
precision |
anyOf( |
投影的 |
radius |
anyOf( |
|
ratio |
anyOf( |
|
reflectX |
anyOf( |
设置输出中 x 维度是否被反射(取反)。 |
reflectY |
anyOf( |
设置输出中 y 维度是否被反射(取反)。 |
rotate |
anyOf(anyOf( |
投影的三轴旋转到指定角度,必须是包含两个或三个数字的数组 [ 默认值: |
scale |
anyOf( |
投影的比例(缩放)因子,覆盖自动拟合。默认比例尺是特定于投影的。比例因子与投影点之间的距离呈线性关系;但是,不同投影的比例因子值不等效。 |
size |
anyOf( |
与 fit 结合使用,提供应将投影自动拟合的区域的宽度和高度(单位像素)。 |
spacing |
anyOf( |
默认值: |
tilt |
anyOf( |
默认值: |
translate |
anyOf( |
投影的平移偏移,作为双元素数组 |
type |
anyOf( |
要使用的地图投影。此值不区分大小写,例如 默认值: |
拼接和分面配置#
可以使用 Chart.configure_concat()
和 Chart.configure_facet()
配置拼接图和分面图的各个方面,这些方法具有以下属性:
点击显示表格
属性 |
类型 |
描述 |
---|---|---|
columns |
|
视图组合布局中包含的列数。 默认值: 注意:
|
spacing |
|
组合子视图之间的默认间距,单位像素。 默认值: |
选择配置#
可以使用 Chart.configure_selection()
配置选择,该方法具有以下属性:
点击显示表格
属性 |
类型 |
描述 |
---|---|---|
interval |
例如,将 |
|
point |
例如,将 |
标题配置#
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 |
标题文本的水平文本对齐方式。可以是 |
|
anchor |
anyOf( |
放置标题和副标题文本的锚点位置。可以是 |
angle |
anyOf( |
标题和副标题文本的角度,单位为度。 |
aria |
anyOf( |
一个布尔标志,指示是否应包含 默认值: |
baseline |
标题和副标题文本的垂直文本基线。可以是 |
|
color |
标题文本颜色。 |
|
dx |
anyOf( |
标题和副标题文本 x 坐标的 delta 偏移。 |
dy |
anyOf( |
标题和副标题文本 y 坐标的 delta 偏移。 |
font |
anyOf( |
标题文本的字体名称。 |
fontSize |
anyOf( |
标题文本的字体大小,单位像素。 |
fontStyle |
标题文本的字体样式。 |
|
fontWeight |
anyOf( |
标题文本的字体粗细。可以是字符串(例如 |
frame |
anyOf(anyOf( |
锚点位置的参考框架,可以是 |
limit |
anyOf( |
标题和副标题文本允许的最大长度,单位像素。 |
lineHeight |
anyOf( |
多行标题文本或基线为 |
offset |
anyOf( |
相对于图表边缘的位置,用于将标题组正交偏移的像素值。 |
orient |
anyOf( |
默认标题方向( |
subtitleColor |
副标题文本颜色。 |
|
subtitleFont |
anyOf( |
副标题文本的字体名称。 |
subtitleFontSize |
anyOf( |
副标题文本的字体大小,单位像素。 |
subtitleFontStyle |
副标题文本的字体样式。 |
|
subtitleFontWeight |
anyOf( |
副标题文本的字体粗细。可以是字符串(例如 |
subtitleLineHeight |
anyOf( |
多行副标题文本的行高,单位像素。 |
subtitlePadding |
anyOf( |
标题和副标题文本之间的填充,单位像素。 |
zindex |
anyOf( |
整数 z-index,指示标题组相对于其他轴、标记和图例组的层叠顺序。 默认值: |
视图配置#
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 |
|
当图表有连续 y 字段用于 x 或纬度,或有弧形标记时,默认高度。 默认值: |
continuousWidth |
|
当图表有连续字段用于 x 或经度,或有弧形标记时,默认宽度。 默认值: |
cornerRadius |
anyOf( |
圆角矩形或弧形角的像素半径。 默认值: |
cursor |
视图上使用的鼠标光标。可以使用任何有效的 |
|
discreteHeight |
anyOf( |
当图表有非弧形标记且有离散 y 字段或没有 y 字段时,默认高度。高度可以是一个数字表示固定高度,也可以是一个 默认值: 基于 |
discreteWidth |
anyOf( |
当图表有非弧形标记且有离散 x 字段或没有 x 字段时,默认宽度。宽度可以是一个数字表示固定宽度,也可以是一个 默认值: 基于 |
fill |
填充颜色。 默认值: |
|
fillOpacity |
anyOf( |
填充不透明度(值在 [0,1] 之间)。 默认值: |
opacity |
anyOf( |
整体不透明度(值在 [0,1] 之间)。 默认值: 对于使用 |
step |
|
x/y 离散字段的默认步长。 |
stroke |
描边颜色。 默认值: |
|
strokeCap |
线条末端的描边帽样式。可以是 默认值: |
|
strokeDash |
anyOf(数组( |
一个包含交替描边和空间长度的数组,用于创建虚线或点线。 |
strokeDashOffset |
anyOf( |
开始使用描边虚线数组绘制的偏移量(单位像素)。 |
strokeJoin |
anyOf( |
描边线的连接方式。可以是 默认值: |
strokeMiterLimit |
anyOf( |
对线连接进行斜角处理时的斜接限制。 |
strokeOpacity |
anyOf( |
描边不透明度(取值范围 [0,1])。 默认值: |
strokeWidth |
anyOf( |
描边宽度,单位像素。 |