altair.theme.TickConfigKwds#
- class altair.theme.TickConfigKwds#
altair.TickConfig
TypedDict
包装器。- 参数:
- align
文本或范围标记(区域、条形、图像、矩形、规则线)的水平对齐方式。取值为
"left"
,"right"
,"center"
之一。注意: 范围标记不支持表达式引用。
- angle
文本的旋转角度,单位为度。
- aria
一个布尔标志,指示是否应包含 ARIA 属性(仅限 SVG 输出)。如果为
false
,则会在输出 SVG 元素上设置“aria-hidden”属性,将标记项从 ARIA 可访问性树中移除。- ariaRole
为 ARIA 可访问性设置标记项的用户界面元素类型(仅限 SVG 输出)。如果指定,此属性确定“role”属性。警告:此属性是实验性的,将来可能会更改。
- ariaRoleDescription
标记项角色的人类可读、作者本地化的描述,用于 ARIA 可访问性(仅限 SVG 输出)。如果指定,此属性确定“aria-roledescription”属性。警告:此属性是实验性的,将来可能会更改。
- aspect
是否保持图像标记的纵横比。
- bandSize
刻度线的宽度。
默认值: step 的 3/4(水平刻度线的宽度 step,垂直刻度线的高度 step)。
- 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"
注意
此属性不能在 style config 中使用。
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
,tick
,circle
, 或square
标记以及 graticule 数据源的geoshape
标记,为false
;否则为true
。注意: 此属性不能在 style config 中使用。
- 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
多行文本标记的行高,单位为像素(后续文本行之间的间距)。
- opacity
整体不透明度(值介于 [0,1] 之间)。
默认值: 对于非聚合图,如果标记为
point
,tick
,circle
, 或square
,或者分层条形图,为0.7
;否则为1
。- order
对于线和轨迹标记,此
order
属性可以设置为null
或false
,使线条使用数据源中的原始顺序。- orient
非堆叠条形图、刻度图、区域图和线图的方向。值为水平(默认)或垂直。
对于 bar, rule 和 tick,这决定了条形和刻度的大小应该应用于 x 维度还是 y 维度。
对于 area,此属性决定了 Vega 输出的 orient 属性。
对于 line 和 trail 标记,如果未指定
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"
, or"triangle-left"
。线条符号
"stroke"
中心定向形状
"arrow"
,"wedge"
, or"triangle"
自定义 SVG 路径字符串(为了正确缩放,自定义形状路径应定义在一个方形边界框内,x 和 y 维度上的坐标范围从 -1 到 1)。
默认值:
"circle"
- size
标记的默认大小。
对于
point
/circle
/square
,这表示标记的像素区域。请注意,此值设置符号的区域;边长将随此值的平方根而增加。对于
bar
,这表示条形的带宽,单位为像素。对于
text
,这表示字体大小,单位为像素。
默认值
对于 point, circle, square 标记,为
30
;width/height 的step
对于离散维度的 bar 标记,为
2
;对于连续维度的 bar 标记,为
5
;对于 text 标记,为
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 表示向上或“北”,增加的值按顺时针方向进行。
- thickness
刻度线的粗细。
默认值:
1
- 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])创建一个新字典,键来自 iterable,值设置为 value。
get
(key[, default])如果 key 在字典中,返回 key 的值,否则返回 default。
()items
()keys
pop
(key[, default])如果未找到 key,如果给定 default 则返回 default;否则引发 KeyError。
(/)popitem
移除并返回一个 (key, value) 对,作为 2-tuple。
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
bandSize
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
lineBreak
lineHeight
opacity
order
orient
outerRadius
padAngle
radius
radius2
shape
size
smooth
startAngle
stroke
strokeCap
strokeDash
strokeDashOffset
strokeJoin
strokeMiterLimit
strokeOffset
strokeOpacity
strokeWidth
tension
text
theta
theta2
thickness
timeUnitBandPosition
timeUnitBandSize
tooltip
url
width
此通道的
value
可以是一个数字或表示绘图宽度的字符串"width"
。此通道的
value
可以是一个数字或表示绘图宽度的字符串"width"
。范围
"area"
,"bar"
,"rect"
, 和"rule"
的 X2 坐标。此通道的
value
可以是一个数字或表示绘图高度的字符串"height"
。