altair.theme.RectConfigKwds#
- class altair.theme.RectConfigKwds#
altair.RectConfig
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"
。注意: 不支持对范围标记使用表达式引用。
- binSpacing
分组字段的条形之间的偏移。理想值可以是 0(统计学家偏爱)或 1(Vega-Lite 默认值,D3 示例风格)。
默认值:
1
- blend
在当前背景上绘制项目时的颜色混合模式。可以使用任何有效的CSS mix-blend-mode 值。
__默认值:__
"source-over"
- color
默认颜色。
默认值: ■
"#4682b4"
注意
此属性不能用于样式配置。
fill
和stroke
属性的优先级高于color
,并将覆盖color
。
- continuousBandSize
连续刻度上条形的默认大小。
默认值:
5
- cornerRadius
圆角矩形或弧形角落的半径,单位为像素。
默认值:
0
- cornerRadiusBottomLeft
圆角矩形左下角的半径,单位为像素。
默认值:
0
- cornerRadiusBottomRight
圆角矩形右下角的半径,单位为像素。
默认值:
0
- cornerRadiusTopLeft
圆角矩形右上角的半径,单位为像素。
默认值:
0
- cornerRadiusTopRight
圆角矩形左上角的半径,单位为像素。
默认值:
0
- cursor
鼠标悬停在标记上时使用的鼠标光标。可以使用任何有效的CSS cursor 类型。
- description
标记项的文本描述,用于ARIA 可访问性(仅限 SVG 输出)。如果指定,此属性决定了“aria-label”属性。
- dir
文本方向。可选值为
"ltr"
(从左到右)或"rtl"
(从右到左)。此属性决定了根据 limit 参数进行截断时文本的方向。默认值:
"ltr"
- discreteBandSize
具有离散维度的条形的默认大小。如果未指定,默认大小为
step-2
,这会在条形之间提供 2 像素的偏移。- 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
– 表示无限制- lineBreak
一个分隔符,例如换行符,用于将文本字符串拆分成多行。如果文本是数组值,则忽略此属性。
- lineHeight
多行文本标记的行高(后续文本行之间的间距),单位为像素。
- minBandSize
条形和矩形标记的最小带宽。默认值:
0.25
- 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
应用于弧形两侧的角填充,单位为弧度。
- 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 path 字符串(为了正确缩放,自定义形状路径应定义在围绕 -1 到 1 沿 x 和 y 两个维度的方形边界框内。)
默认值:
"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
标记的宽度,或未指定
x2
或width
的水平"bar"
和"area"
的宽度。- 此通道的
value
可以是数字或表示绘图宽度的字符串"width"
。 x
标记的 X 坐标,或未指定
x2
或width
的水平"bar"
和"area"
的宽度。- 此通道的
value
可以是数字或表示绘图宽度的字符串"width"
。 x2
标记的 X 坐标,或未指定
x2
或width
的水平"bar"
和"area"
的宽度。- 范围标记
"area"
,"bar"
,"rect"
, 和"rule"
的 X2 坐标。 y
标记的 Y 坐标,或未指定
y2
或height
的垂直"bar"
和"area"
的高度。- 此通道的
value
可以是数字或表示绘图高度的字符串"height"
。 y2
标记的 Y 坐标,或未指定
y2
或height
的垂直"bar"
和"area"
的高度。
-
范围标记
"area"
,"bar"
,"rect"
, 和"rule"
的 Y2 坐标。
__init__(*args, **kwargs)#
方法
()__init__
(*args, **kwargs)clear
()copy
fromkeys
(iterable[, value])创建一个新字典,其键来自可迭代对象,值设置为 value。
get
(key[, default])如果字典中存在 key,则返回 key 对应的值,否则返回 default。
()items
()keys
pop
(key[, default])如果找不到 key,则返回 default(如果提供);否则引发 KeyError。
(/)popitem
移除并返回一个 (key, value) 对,作为 2 元组。
setdefault
(key[, default])如果字典中不存在 key,则插入 key 并将值设置为 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
binSpacing
blend
color
continuousBandSize
cornerRadius
cornerRadiusBottomLeft
cornerRadiusBottomRight
cornerRadiusTopLeft
cornerRadiusTopRight
cursor
description
dir
discreteBandSize
dx
dy
ellipsis
endAngle
fill
fillOpacity
filled
font
fontSize
fontStyle
fontWeight
height
href
innerRadius
interpolate
invalid
limit
lineBreak
lineHeight
minBandSize
opacity
order
orient
outerRadius
padAngle
radius
radius2
shape
size
smooth
startAngle
stroke
strokeCap
strokeDash
strokeDashOffset
strokeJoin
strokeMiterLimit
strokeOffset
strokeOpacity
strokeWidth
tension
text
theta
theta2
timeUnitBandPosition
timeUnitBandSize
tooltip
url
width
此通道的
value
可以是数字或表示绘图宽度的字符串"width"
。此通道的
value
可以是数字或表示绘图宽度的字符串"width"
。范围标记
"area"
,"bar"
,"rect"
, 和"rule"
的 X2 坐标。此通道的
value
可以是数字或表示绘图高度的字符串"height"
。