altair.theme.AreaConfigKwds#
- class altair.theme.AreaConfigKwds#
altair.AreaConfig
TypedDict
包装器。- 参数:
- align
文本或范围标记(面积、条形图、图像、矩形、规则线)的水平对齐方式。可选值包括
"left"
、"right"
、"center"
。注意:范围标记不支持表达式引用。
- angle
文本的旋转角度,单位为度。
- aria
一个布尔标志,指示是否应包含ARIA 属性(仅限 SVG 输出)。如果为
false
,则会在输出的 SVG 元素上设置“aria-hidden”属性,从而从 ARIA 可访问性树中移除标记项。- ariaRole
设置标记项的用户界面元素类型,用于ARIA 可访问性(仅限 SVG 输出)。如果指定,此属性将决定“role”属性。警告:此属性是实验性的,未来可能会更改。
- ariaRoleDescription
标记项角色的人类可读、作者本地化描述,用于ARIA 可访问性(仅限 SVG 输出)。如果指定,此属性将决定“aria-roledescription”属性。警告:此属性是实验性的,未来可能会更改。
- aspect
是否保持图像标记的纵横比。
- baseline
对于文本标记,垂直文本基线。可选值包括
"alphabetic"
(默认)、"top"
、"middle"
、"bottom"
、"line-top"
、"line-bottom"
,或提供其中一个有效值的表达式引用。"line-top"
和"line-bottom"
值与"top"
和"bottom"
类似,但它们是相对于lineHeight
计算的,而不是仅相对于fontSize
计算。对于范围标记,标记的垂直对齐方式。可选值包括
"top"
、"middle"
、"bottom"
。注意:范围标记不支持表达式引用。
- blend
用于在当前背景上绘制项目时的颜色混合模式。可以使用任何有效的CSS mix-blend-mode 值。
__默认值:__
"source-over"
- color
默认颜色。
默认值: ■
"#4682b4"
注意
此属性不能用于样式配置中。
fill
和stroke
属性的优先级高于color
,并将覆盖color
。
- cornerRadius
圆角矩形或圆弧角的像素半径。
默认值:
0
- cornerRadiusBottomLeft
圆角矩形左下角的像素半径。
默认值:
0
- cornerRadiusBottomRight
圆角矩形右下角的像素半径。
默认值:
0
- cornerRadiusTopLeft
圆角矩形右上角的像素半径。
默认值:
0
- cornerRadiusTopRight
圆角矩形左上角的像素半径。
默认值:
0
- cursor
鼠标悬停在标记上时使用的光标。可以使用任何有效的CSS cursor 类型。
- description
标记项的文本描述,用于ARIA 可访问性(仅限 SVG 输出)。如果指定,此属性将决定“aria-label”属性。
- dir
文本方向。可选值包括
"ltr"
(从左到右)或"rtl"
(从右到左)。此属性决定了文本在响应 limit 参数时从哪一侧截断。默认值:
"ltr"
- dx
文本标签及其锚点之间的水平偏移量,单位为像素。偏移量在按 angle 属性旋转后应用。
- dy
文本标签及其锚点之间的垂直偏移量,单位为像素。偏移量在按 angle 属性旋转后应用。
- ellipsis
响应 limit 参数而截断的文本所使用的省略号字符串。
默认值:
"…"
- endAngle
圆弧标记的结束角度,单位为弧度。值为
0
表示向上(北),增加的值按顺时针方向进行。- fill
默认填充颜色。此属性优先级高于
config.color
。设置为null
可移除填充。默认值: (无)
- fillOpacity
填充不透明度(值介于 [0,1] 之间)。
默认值:
1
- filled
标记的颜色是应该用作填充颜色还是描边颜色。
默认值: 对于所有
point
、line
和rule
标记以及经纬网数据源的geoshape
标记,false
;否则为true
。注意:此属性不能用于样式配置中。
- font
设置文本的字体(例如,
"Helvetica Neue"
)。- fontSize
字体大小,单位为像素。
默认值:
11
- fontStyle
字体样式(例如,
"italic"
)。- fontWeight
字体粗细。可以是字符串(例如
"bold"
、"normal"
)或数字(100
、200
、300
、…、900
,其中"normal"
=400
,"bold"
=700
)。- height
标记的高度。
- href
鼠标单击时加载的 URL。如果定义,标记将作为超链接。
- innerRadius
圆弧标记的内半径,单位为像素。
innerRadius
是radius2
的别名。默认值:
0
- interpolate
用于线和面积标记的线条插值方法。以下之一:
"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
无效数据模式,定义了标记和相应比例尺应如何表示无效值(连续比例尺中没有为无效值定义输出时的
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
中定义了无效值的输出,则该比例尺的所有值都将被视为“有效”,因为它们可以为比例尺产生合理的输出。因此,此类通道的字段将不会被过滤,也不会导致路径中断。- limit
文本标记的最大长度,单位为像素。如果渲染大小超过限制,文本值将自动截断。
默认值:
0
– 表示无限制- line
一个标志,用于在面积标记顶部覆盖线条,或一个定义覆盖线条属性的对象。
如果此值是空对象 (
{}
) 或true
,将使用具有默认属性的线条。如果此值为
false
,则不会自动向面积标记添加线条。
默认值:
false
。- lineBreak
用于将文本字符串断成多行的分隔符,例如换行符。如果文本是数组值,则忽略此属性。
- lineHeight
多行文本标记的行高,单位为像素(后续文本行之间的间距)。
- opacity
整体不透明度(值介于 [0,1] 之间)。
对于带有
point
、tick
、circle
或square
标记的非聚合图表或分层bar
图表,默认值:0.7
;否则为1
。- order
对于线和轨迹标记,此
order
属性可以设置为null
或false
,以使线条使用数据源中的原始顺序。- orient
非堆叠条形图、刻度线图、面积图和线图的方向。值为水平(默认)或垂直。
对于条形图、规则线图和刻度线图,这决定了条形和刻度的大小应该应用于 x 维度还是 y 维度。
对于面积图,此属性决定了 Vega 输出的 orient 属性。
对于线和轨迹标记,如果未指定
config.sortLineBy
,此属性决定了线上点的排序顺序。对于堆叠图表,这始终由堆叠的方向决定;因此,显式指定的值将被忽略。
- outerRadius
圆弧标记的外半径,单位为像素。
outerRadius
是radius
的别名。默认值:
0
- padAngle
应用于圆弧侧面的角度填充,单位为弧度。
- point
一个标志,用于在线或面积标记顶部覆盖点,或一个定义覆盖点属性的对象。
如果此属性为
"transparent"
,将使用透明点(用于增强工具提示和选择)。如果此属性是空对象 (
{}
) 或true
,将使用具有默认属性的实心点。如果此属性为
false训练,则不会自动向线或面积标记添加点。
默认值:
false
。- radius
对于圆弧标记,主(外)半径,单位为像素。
对于文本标记,文本相对于由
x
和y
属性确定的原点的极坐标径向偏移量,单位为像素。默认值:
min(plot_width, plot_height)/2
- radius2
圆弧标记的次(内)半径,单位为像素。
默认值:
0
- shape
点标记的形状。支持的值包括:
绘图形状:
"circle"
(圆形)、"square"
(方形)、"cross"
(十字形)、"diamond"
(菱形)、"triangle-up"
(向上三角形)、"triangle-down"
(向下三角形)、"triangle-right"
(向右三角形)或"triangle-left"
(向左三角形)。线条符号
"stroke"
居中方向形状:
"arrow"
(箭头)、"wedge"
(楔形)或"triangle"
(三角形)。自定义 SVG 路径字符串(为了正确调整大小,自定义形状路径应定义在一个方形边界框内,其 x 和 y 维度的坐标范围均从 -1 到 1。)
默认值:
"circle"
- size
标记的默认大小。
对于
point
/circle
/square
,这表示标记的像素面积。请注意,此值设置的是符号的面积;边长将随此值的平方根而增加。对于
bar
,这表示条形的带状大小,单位为像素。对于
text
,这表示字体大小,单位为像素。
默认值
对于点、圆形、方形标记为
30
;宽度/高度的step
对于具有离散维度的条形标记为
2
;对于具有连续维度的条形标记为
5
;对于文本标记为
11
。
- smooth
一个布尔标志(默认为 true),指示调整大小时是否应平滑图像。如果为 false,则应直接缩放单个像素,而不是进行平滑插值。对于 SVG 渲染,由于缺乏标准化,此选项可能在某些浏览器中不起作用。
- startAngle
圆弧标记的起始角度,单位为弧度。值为
0
表示向上(北),增加的值按顺时针方向进行。- stroke
默认描边颜色。此属性优先级高于
config.color
。设置为null
可移除描边。默认值: (无)
- strokeCap
线条末端样式的描边帽。可选值包括
"butt"
、"round"
或"square"
。默认值:
"butt"
- strokeDash
用于创建虚线或点线的交替描边、空间长度数组。
- strokeDashOffset
使用描边虚线数组开始绘制的偏移量(单位为像素)。
- strokeJoin
描边线条连接方法。可选值包括
"miter"
、"round"
或"bevel"
。默认值:
"miter"
- strokeMiterLimit
用于斜接线条连接的斜接限制。
- strokeOffset
绘制组描边和填充的像素偏移量。如果未指定,默认行为是动态偏移描边组,使 1 像素的描边宽度与像素网格对齐。
- strokeOpacity
描边不透明度(值介于 [0,1] 之间)。
默认值:
1
- strokeWidth
描边宽度,单位为像素。
- tension
根据插值类型,设置 tension 参数(适用于线和面积标记)。
- text
如果未指定
text
通道的占位符文本- theta
对于圆弧标记,如果未指定 theta2,则表示圆弧长度(单位为弧度),否则表示起始圆弧角度。(值为 0 表示向上或“北”,增加的值按顺时针方向进行。)
对于文本标记,极坐标角度,单位为弧度。
- theta2
圆弧标记的结束角度,单位为弧度。值为 0 表示向上或“北”,增加的值按顺时针方向进行。
- timeUnitBandPosition
时间单位的默认相对带状位置。如果设置为
0
,标记将位于时间单位带状步长的起始位置。如果设置为0.5
,标记将位于时间单位带状步长的中间位置。- timeUnitBandSize
时间单位的默认相对带状大小。如果设置为
1
,标记的带宽将等于时间单位带状步长。如果设置为0.5
,标记的带宽将是时间单位带状步长的一半。- tooltip
鼠标悬停时显示的工具提示文本字符串,或一个定义工具提示应从哪些字段派生的对象。
如果
tooltip
为true
或{"content": "encoding"}
,则将使用encoding
中的所有字段。如果
tooltip
为{"content": "data"}
,则将使用高亮数据点中出现的所有字段。如果设置为
null
或false
,则不使用工具提示。
有关 Vega-Lite 中工具提示的详细讨论,请参阅工具提示文档。
默认值:
null
- url
图像标记的图像文件 URL。
- width
标记的宽度。
- x
标记的 X 坐标,或未指定
x2
或width
时水平"bar"
和"area"
的宽度。此通道的
value
可以是数字或字符串"width"
表示图表的宽度。- x2
范围标记
"area"
、"bar"
、"rect"
和"rule"
的 X2 坐标。此通道的
value
可以是数字或字符串"width"
表示图表的宽度。- y
标记的 Y 坐标,或未指定
y2
或height
时垂直"bar"
和"area"
的高度。此通道的
value
可以是数字或字符串"height"
表示图表的高度。- y2
范围标记
"area"
、"bar"
、"rect"
和"rule"
的 Y2 坐标。此通道的
value
可以是数字或字符串"height"
表示图表的高度。
- __init__(*args, **kwargs)#
方法
__init__
(*args, **kwargs)clear
()copy
()fromkeys
(iterable[, value])创建一个新字典,其键来自 iterable,值设置为 value。
get
(key[, default])如果键在字典中,则返回键的值;否则返回默认值。
items
()keys
()pop
(key[, default])如果未找到键,则返回给定的默认值;否则引发 KeyError。
popitem
(/)移除并返回一个 (key, value) 对作为 2 元组。
setdefault
(key[, default])如果键不在字典中,则插入键并将其值设置为 default。
update
([E, ]**F)如果 E 存在且有 .keys() 方法,则执行:for k in E: D[k] = E[k] 如果 E 存在且没有 .keys() 方法,则执行:for k, v in E: D[k] = v 在任一情况下,接着执行:for k in F: D[k] = F[k]
values
()属性
align
angle
aria
ariaRole
ariaRoleDescription
aspect
baseline
blend
color
cornerRadius
cornerRadiusBottomLeft
cornerRadiusBottomRight
cornerRadiusTopLeft
cornerRadiusTopRight
cursor
description
dir
dx
dy
ellipsis
endAngle
fill
fillOpacity
filled
font
fontSize
fontStyle
fontWeight
height
href
innerRadius
interpolate
invalid
limit
line
lineBreak
lineHeight
opacity
order
orient
outerRadius
padAngle
point
radius
radius2
shape
size
smooth
startAngle
stroke
strokeCap
strokeDash
strokeDashOffset
strokeJoin
strokeMiterLimit
strokeOffset
strokeOpacity
strokeWidth
tension
text
theta
theta2
timeUnitBandPosition
timeUnitBandSize
tooltip
url
width
x
x2
y
y2