altair.Axis#
- class altair.Axis(aria=Undefined, bandPosition=Undefined, description=Undefined, domain=Undefined, domainCap=Undefined, domainColor=Undefined, domainDash=Undefined, domainDashOffset=Undefined, domainOpacity=Undefined, domainWidth=Undefined, format=Undefined, formatType=Undefined, grid=Undefined, gridCap=Undefined, gridColor=Undefined, gridDash=Undefined, gridDashOffset=Undefined, gridOpacity=Undefined, gridWidth=Undefined, labelAlign=Undefined, labelAngle=Undefined, labelBaseline=Undefined, labelBound=Undefined, labelColor=Undefined, labelExpr=Undefined, labelFlush=Undefined, labelFlushOffset=Undefined, labelFont=Undefined, labelFontSize=Undefined, labelFontStyle=Undefined, labelFontWeight=Undefined, labelLimit=Undefined, labelLineHeight=Undefined, labelOffset=Undefined, labelOpacity=Undefined, labelOverlap=Undefined, labelPadding=Undefined, labelSeparation=Undefined, labels=Undefined, maxExtent=Undefined, minExtent=Undefined, offset=Undefined, orient=Undefined, position=Undefined, style=Undefined, tickBand=Undefined, tickCap=Undefined, tickColor=Undefined, tickCount=Undefined, tickDash=Undefined, tickDashOffset=Undefined, tickExtra=Undefined, tickMinStep=Undefined, tickOffset=Undefined, tickOpacity=Undefined, tickRound=Undefined, tickSize=Undefined, tickWidth=Undefined, ticks=Undefined, title=Undefined, titleAlign=Undefined, titleAnchor=Undefined, titleAngle=Undefined, titleBaseline=Undefined, titleColor=Undefined, titleFont=Undefined, titleFontSize=Undefined, titleFontStyle=Undefined, titleFontWeight=Undefined, titleLimit=Undefined, titleLineHeight=Undefined, titleOpacity=Undefined, titlePadding=Undefined, titleX=Undefined, titleY=Undefined, translate=Undefined, values=Undefined, zindex=Undefined, **kwds)#
Axis 模式封装器。
- 参数:
- ariabool, dict,
ExprRef
布尔标志,指示是否应包含 ARIA 属性(仅限 SVG 输出)。如果为
false
,则将在输出 SVG 组上设置“aria-hidden”属性,从而将轴从 ARIA 无障碍树中移除。默认值:
true
- bandPositiondict, float,
ExprRef
一个插值分数,指示对于
band
比例尺,轴刻度应放置在哪里。值为0
会将刻度放在其带状区域的左边缘。值为0.5
会将刻度放在其带状区域的中间。默认值:
0.5
- descriptionstr, dict,
ExprRef
此轴的文本描述,用于 ARIA 无障碍功能(仅限 SVG 输出)。如果
aria
属性为 true,则对于 SVG 输出,将 “aria-label”属性设置为此描述。如果未指定描述,则会自动生成。- domainbool
布尔标志,指示域(轴基线)是否应作为轴的一部分包含在内。
默认值:
true
- domainCapdict,
ExprRef
,StrokeCap
, Literal[‘butt’, ‘round’, ‘square’] 域线末端的笔划帽样式。可以是
"butt"
、"round"
或"square"` 中的一个。
默认值:
"butt"
- domainColorstr, dict,
Color
,ExprRef
,HexColor
,ColorName
, Literal[‘black’, ‘silver’, ‘gray’, ‘white’, ‘maroon’, ‘red’, ‘purple’, ‘fuchsia’, ‘green’, ‘lime’, ‘olive’, ‘yellow’, ‘navy’, ‘blue’, ‘teal’, ‘aqua’, ‘orange’, ‘aliceblue’, ‘antiquewhite’, ‘aquamarine’, ‘azure’, ‘beige’, ‘bisque’, ‘blanchedalmond’, ‘blueviolet’, ‘brown’, ‘burlywood’, ‘cadetblue’, ‘chartreuse’, ‘chocolate’, ‘coral’, ‘cornflowerblue’, ‘cornsilk’, ‘crimson’, ‘cyan’, ‘darkblue’, ‘darkcyan’, ‘darkgoldenrod’, ‘darkgray’, ‘darkgreen’, ‘darkgrey’, ‘darkkhaki’, ‘darkmagenta’, ‘darkolivegreen’, ‘darkorange’, ‘darkorchid’, ‘darkred’, ‘darksalmon’, ‘darkseagreen’, ‘darkslateblue’, ‘darkslategray’, ‘darkslategrey’, ‘darkturquoise’, ‘darkviolet’, ‘deeppink’, ‘deepskyblue’, ‘dimgray’, ‘dimgrey’, ‘dodgerblue’, ‘firebrick’, ‘floralwhite’, ‘forestgreen’, ‘gainsboro’, ‘ghostwhite’, ‘gold’, ‘goldenrod’, ‘greenyellow’, ‘grey’, ‘honeydew’, ‘hotpink’, ‘indianred’, ‘indigo’, ‘ivory’, ‘khaki’, ‘lavender’, ‘lavenderblush’, ‘lawngreen’, ‘lemonchiffon’, ‘lightblue’, ‘lightcoral’, ‘lightcyan’, ‘lightgoldenrodyellow’, ‘lightgray’, ‘lightgreen’, ‘lightgrey’, ‘lightpink’, ‘lightsalmon’, ‘lightseagreen’, ‘lightskyblue’, ‘lightslategray’, ‘lightslategrey’, ‘lightsteelblue’, ‘lightyellow’, ‘limegreen’, ‘linen’, ‘magenta’, ‘mediumaquamarine’, ‘mediumblue’, ‘mediumorchid’, ‘mediumpurple’, ‘mediumseagreen’, ‘mediumslateblue’, ‘mediumspringgreen’, ‘mediumturquoise’, ‘mediumvioletred’, ‘midnightblue’, ‘mintcream’, ‘mistyrose’, ‘moccasin’, ‘navajowhite’, ‘oldlace’, ‘olivedrab’, ‘orangered’, ‘orchid’, ‘palegoldenrod’, ‘palegreen’, ‘paleturquoise’, ‘palevioletred’, ‘papayawhip’, ‘peachpuff’, ‘peru’, ‘pink’, ‘plum’, ‘powderblue’, ‘rosybrown’, ‘royalblue’, ‘saddlebrown’, ‘salmon’, ‘sandybrown’, ‘seagreen’, ‘seashell’, ‘sienna’, ‘skyblue’, ‘slateblue’, ‘slategray’, ‘slategrey’, ‘snow’, ‘springgreen’, ‘steelblue’, ‘tan’, ‘thistle’, ‘tomato’, ‘turquoise’, ‘violet’, ‘wheat’, ‘whitesmoke’, ‘yellowgreen’, ‘rebeccapurple’], None 轴域线的颜色。
默认值:
"gray"
。- domainDashdict, Sequence[float],
ExprRef
用于虚线域线的交替 [笔划,间距] 长度数组。
- domainDashOffsetdict, float,
ExprRef
开始绘制域虚线数组的像素偏移量。
- domainOpacitydict, float,
ExprRef
轴域线的透明度。
- domainWidthdict, float,
ExprRef
轴域线的笔划宽度。
默认值:
1
- formatstr, dict,
Dict
当与默认的
"number"
和"time"
格式类型一起使用时,这是指南(轴、图例、标题)和文本标记标签的文本格式模式。有关更多示例,请参见格式文档。
当与自定义格式类型一起使用时,此值将作为
format
与datum.value
一起传递给注册函数。默认值: 对于数字格式,派生自numberFormat 配置;对于时间格式,派生自timeFormat 配置。
- formatTypestr
标签的格式类型。可以是
"number"
、"time"
或注册的自定义格式类型之一。默认值
对于带有
timeUnit
的时间字段以及有序和名义字段,为"time"`。
对于定量字段以及不带
timeUnit
的有序和名义字段,为"number"`。
- gridbool
布尔标志,指示网格线是否应作为轴的一部分包含在内。
默认值: 对于未分箱的连续比例尺,为
true`;否则为
false`。
- gridCapdict,
ExprRef
,StrokeCap
, Literal[‘butt’, ‘round’, ‘square’] 网格线末端的笔划帽样式。可以是
"butt"
、"round"
或"square"` 中的一个。
默认值:
"butt"
- gridColorstr, dict,
Color
,ExprRef
,HexColor
,ColorName
,ConditionalAxisColor
, Literal[‘black’, ‘silver’, ‘gray’, ‘white’, ‘maroon’, ‘red’, ‘purple’, ‘fuchsia’, ‘green’, ‘lime’, ‘olive’, ‘yellow’, ‘navy’, ‘blue’, ‘teal’, ‘aqua’, ‘orange’, ‘aliceblue’, ‘antiquewhite’, ‘aquamarine’, ‘azure’, ‘beige’, ‘bisque’, ‘blanchedalmond’, ‘blueviolet’, ‘brown’, ‘burlywood’, ‘cadetblue’, ‘chartreuse’, ‘chocolate’, ‘coral’, ‘cornflowerblue’, ‘cornsilk’, ‘crimson’, ‘cyan’, ‘darkblue’, ‘darkcyan’, ‘darkgoldenrod’, ‘darkgray’, ‘darkgreen’, ‘darkgrey’, ‘darkkhaki’, ‘darkmagenta’, ‘darkolivegreen’, ‘darkorange’, ‘darkorchid’, ‘darkred’, ‘darksalmon’, ‘darkseagreen’, ‘darkslateblue’, ‘darkslategray’, ‘darkslategrey’, ‘darkturquoise’, ‘darkviolet’, ‘deeppink’, ‘deepskyblue’, ‘dimgray’, ‘dimgrey’, ‘dodgerblue’, ‘firebrick’, ‘floralwhite’, ‘forestgreen’, ‘gainsboro’, ‘ghostwhite’, ‘gold’, ‘goldenrod’, ‘greenyellow’, ‘grey’, ‘honeydew’, ‘hotpink’, ‘indianred’, ‘indigo’, ‘ivory’, ‘khaki’, ‘lavender’, ‘lavenderblush’, ‘lawngreen’, ‘lemonchiffon’, ‘lightblue’, ‘lightcoral’, ‘lightcyan’, ‘lightgoldenrodyellow’, ‘lightgray’, ‘lightgreen’, ‘lightgrey’, ‘lightpink’, ‘lightsalmon’, ‘lightseagreen’, ‘lightskyblue’, ‘lightslategray’, ‘lightslategrey’, ‘lightsteelblue’, ‘lightyellow’, ‘limegreen’, ‘linen’, ‘magenta’, ‘mediumaquamarine’, ‘mediumblue’, ‘mediumorchid’, ‘mediumpurple’, ‘mediumseagreen’, ‘mediumslateblue’, ‘mediumspringgreen’, ‘mediumturquoise’, ‘mediumvioletred’, ‘midnightblue’, ‘mintcream’, ‘mistyrose’, ‘moccasin’, ‘navajowhite’, ‘oldlace’, ‘olivedrab’, ‘orangered’, ‘orchid’, ‘palegoldenrod’, ‘palegreen’, ‘paleturquoise’, ‘palevioletred’, ‘papayawhip’, ‘peachpuff’, ‘peru’, ‘pink’, ‘plum’, ‘powderblue’, ‘rosybrown’, ‘royalblue’, ‘saddlebrown’, ‘salmon’, ‘sandybrown’, ‘seagreen’, ‘seashell’, ‘sienna’, ‘skyblue’, ‘slateblue’, ‘slategray’, ‘slategrey’, ‘snow’, ‘springgreen’, ‘steelblue’, ‘tan’, ‘thistle’, ‘tomato’, ‘turquoise’, ‘violet’, ‘wheat’, ‘whitesmoke’, ‘yellowgreen’, ‘rebeccapurple’], None 网格线的颜色。
默认值:
"lightGray"
。- gridDashdict, Sequence[float],
ExprRef
,ConditionalAxisNumberArray
用于虚线网格线的交替 [笔划,间距] 长度数组。
- gridDashOffsetdict, float,
ExprRef
,ConditionalAxisNumber
开始绘制网格虚线数组的像素偏移量。
- gridOpacitydict, float,
ExprRef
,ConditionalAxisNumber
网格的笔划透明度(值在 [0,1] 之间)。
默认值:
1
- gridWidthdict, float,
ExprRef
,ConditionalAxisNumber
网格线的宽度,以像素为单位。
默认值:
1
- labelAligndict,
Align
,ExprRef
,ConditionalAxisLabelAlign
, Literal[‘left’, ‘center’, ‘right’] 轴刻度标签的水平文本对齐方式,覆盖当前轴方向的默认设置。
- labelAngledict, float,
ExprRef
轴标签的旋转角度。
默认值: 对于名义字段和有序字段,为
-90`;否则为
0`。
- labelBaselinedict,
ExprRef
,Baseline
,TextBaseline
,ConditionalAxisLabelBaseline
, Literal[‘alphabetic’, ‘line-bottom’, ‘line-top’, ‘top’, ‘middle’, ‘bottom’] 轴刻度标签的垂直文本基线,覆盖当前轴方向的默认设置。可以是
"alphabetic"
(默认)、"top"
、"middle"
、"bottom"
、"line-top"
或"line-bottom"` 中的一个。
"line-top"
和"line-bottom"
值的作用类似于"top"
和"bottom"
,但它们是相对于 lineHeight 计算的,而不是仅相对于 fontSize。- labelBoundbool, dict, float,
ExprRef
指示标签是否应在超出轴范围时隐藏。如果为
false
(默认值),则不执行边界重叠分析。如果为true
,则当标签超出轴范围超过 1 像素时,标签将被隐藏。如果此属性为数字,则它指定像素容差:标签边界框超出轴范围的最大量。默认值:
false
。- labelColorstr, dict,
Color
,ExprRef
,HexColor
,ColorName
,ConditionalAxisColor
, Literal[‘black’, ‘silver’, ‘gray’, ‘white’, ‘maroon’, ‘red’, ‘purple’, ‘fuchsia’, ‘green’, ‘lime’, ‘olive’, ‘yellow’, ‘navy’, ‘blue’, ‘teal’, ‘aqua’, ‘orange’, ‘aliceblue’, ‘antiquewhite’, ‘aquamarine’, ‘azure’, ‘beige’, ‘bisque’, ‘blanchedalmond’, ‘blueviolet’, ‘brown’, ‘burlywood’, ‘cadetblue’, ‘chartreuse’, ‘chocolate’, ‘coral’, ‘cornflowerblue’, ‘cornsilk’, ‘crimson’, ‘cyan’, ‘darkblue’, ‘darkcyan’, ‘darkgoldenrod’, ‘darkgray’, ‘darkgreen’, ‘darkgrey’, ‘darkkhaki’, ‘darkmagenta’, ‘darkolivegreen’, ‘darkorange’, ‘darkorchid’, ‘darkred’, ‘darksalmon’, ‘darkseagreen’, ‘darkslateblue’, ‘darkslategray’, ‘darkslategrey’, ‘darkturquoise’, ‘darkviolet’, ‘deeppink’, ‘deepskyblue’, ‘dimgray’, ‘dimgrey’, ‘dodgerblue’, ‘firebrick’, ‘floralwhite’, ‘forestgreen’, ‘gainsboro’, ‘ghostwhite’, ‘gold’, ‘goldenrod’, ‘greenyellow’, ‘grey’, ‘honeydew’, ‘hotpink’, ‘indianred’, ‘indigo’, ‘ivory’, ‘khaki’, ‘lavender’, ‘lavenderblush’, ‘lawngreen’, ‘lemonchiffon’, ‘lightblue’, ‘lightcoral’, ‘lightcyan’, ‘lightgoldenrodyellow’, ‘lightgray’, ‘lightgreen’, ‘lightgrey’, ‘lightpink’, ‘lightsalmon’, ‘lightseagreen’, ‘lightskyblue’, ‘lightslategray’, ‘lightslategrey’, ‘lightsteelblue’, ‘lightyellow’, ‘limegreen’, ‘linen’, ‘magenta’, ‘mediumaquamarine’, ‘mediumblue’, ‘mediumorchid’, ‘mediumpurple’, ‘mediumseagreen’, ‘mediumslateblue’, ‘mediumspringgreen’, ‘mediumturquoise’, ‘mediumvioletred’, ‘midnightblue’, ‘mintcream’, ‘mistyrose’, ‘moccasin’, ‘navajowhite’, ‘oldlace’, ‘olivedrab’, ‘orangered’, ‘orchid’, ‘palegoldenrod’, ‘palegreen’, ‘paleturquoise’, ‘palevioletred’, ‘papayawhip’, ‘peachpuff’, ‘peru’, ‘pink’, ‘plum’, ‘powderblue’, ‘rosybrown’, ‘royalblue’, ‘saddlebrown’, ‘salmon’, ‘sandybrown’, ‘seagreen’, ‘seashell’, ‘sienna’, ‘skyblue’, ‘slateblue’, ‘slategray’, ‘slategrey’, ‘snow’, ‘springgreen’, ‘steelblue’, ‘tan’, ‘thistle’, ‘tomato’, ‘turquoise’, ‘violet’, ‘wheat’, ‘whitesmoke’, ‘yellowgreen’, ‘rebeccapurple’], None 刻度标签的颜色,可以是十六进制颜色码或常规颜色名称。
- labelExprstr
用于自定义标签的Vega 表达式。
注意: 可以通过轴底层
datum
对象的label
和value
属性访问标签文本和值。- labelFlushbool, float
指示第一个和最后一个轴标签是否应与比例尺范围齐平对齐。水平轴的齐平对齐将左对齐第一个标签并右对齐最后一个标签。对于垂直轴,则应用底部和顶部文本基线。如果此属性是数字,它还指示用于偏移第一个和最后一个标签的像素数;例如,值为 2 将齐平对齐第一个和最后一个标签,并将其向轴中心外推 2 像素。额外的调整有时有助于标签更好地与其相应的轴刻度在视觉上分组。
默认值: 对于连续 X 轴比例尺的轴,为
true`。否则为
false`。
- labelFlushOffsetdict, float,
ExprRef
指示用于偏移齐平调整的标签的像素数。例如,值为
2
会将齐平调整的标签向轴中心外推 2 像素。偏移量有助于标签更好地与其相应的轴刻度在视觉上分组。默认值:
0`。
- labelFontstr, dict,
ExprRef
,ConditionalAxisString
刻度标签的字体。
- labelFontSizedict, float,
ExprRef
,ConditionalAxisNumber
标签的字体大小,以像素为单位。
- labelFontStylestr, dict,
ExprRef
,FontStyle
,ConditionalAxisLabelFontStyle
标签的字体样式。
- labelFontWeightdict,
ExprRef
,FontWeight
,ConditionalAxisLabelFontWeight
, Literal[‘normal’, ‘bold’, ‘lighter’, ‘bolder’, 100, 200, 300, 400, 500, 600, 700, 800, 900] 轴刻度标签的字体粗细。
- labelLimitdict, float,
ExprRef
轴刻度标签允许的最大像素宽度。
默认值:
180
- labelLineHeightdict, float,
ExprRef
多行标签文本或带有
"line-top" 或
"line-bottom"
基线的标签文本的行高,以像素为单位。- labelOffsetdict, float,
ExprRef
,ConditionalAxisNumber
应用于标签的像素位置偏移量,除了 tickOffset 之外。
默认值:
0
- labelOpacitydict, float,
ExprRef
,ConditionalAxisNumber
标签的透明度。
- labelOverlapbool, dict,
ExprRef
,LabelOverlap
, Literal[‘greedy’, ‘parity’] 用于解决轴标签重叠的策略。如果为
false
(默认值),则不尝试减少重叠。如果设置为true
或"parity"
,则使用移除每隔一个标签的策略(这适用于标准线性轴)。如果设置为"greedy"
,则对标签执行线性扫描,移除与最后一个可见标签重叠的任何标签(这通常更适用于对数比例尺轴)。默认值: 对于非对数比例尺的非名义字段,为
true`;对于对数比例尺,为
"greedy"`;否则为
false`。
- labelPaddingdict, float,
ExprRef
,ConditionalAxisNumber
标签和刻度之间的像素填充。
默认值:
2
- labelSeparationdict, float,
ExprRef
标签边界框之间必须存在的最小间隔,以便它们被视为不重叠(默认值为
0
)。如果未启用 labelOverlap 解决方法,则此属性将被忽略。- labelsbool
布尔标志,指示标签是否应作为轴的一部分包含在内。
默认值:
true
。- maxExtentdict, float,
ExprRef
轴刻度和标签应使用的最大像素范围。这决定了轴标题的最大偏移值。
默认值:
undefined
。- minExtentdict, float,
ExprRef
轴刻度和标签应使用的最小像素范围。这决定了轴标题的最小偏移值。
默认值: 对于 Y 轴,为
30`;对于 X 轴,为
undefined`。
- offsetdict, float,
ExprRef
将轴从 enclosing group 或数据矩形边缘位移的像素偏移量。
默认值: 派生自轴配置的
offset
(默认为0
)。- orientdict,
ExprRef
,AxisOrient
, Literal[‘top’, ‘bottom’, ‘left’, ‘right’] 轴的方向。可以是
"top"`、
"bottom"`、
"left"
或"right"` 中的一个。该方向可用于进一步细化轴类型(例如,朝向图表右边缘的 Y 轴)。
默认值: 对于 X 轴,为
"bottom"`;对于 Y 轴,为
"left"`。
- positiondict, float,
ExprRef
轴的锚点位置,以像素为单位。对于顶部或底部方向的 X 轴,这设置了轴组的 X 坐标。对于左侧或右侧方向的 Y 轴,这设置了轴组的 Y 坐标。
默认值:
0`
- stylestr, Sequence[str]
一个字符串或字符串数组,指示要应用于轴的自定义样式名称。样式是样式配置中定义的轴属性的命名集合。如果 style 是数组,则后面的样式将覆盖前面的样式。
默认值: (无) 注意: 任何指定的样式都将增强默认样式。例如,带有
"style": "foo"
的 X 轴标记将使用config.axisX
和config.style.foo
(指定的样式"foo"
具有更高的优先级)。- tickBanddict,
ExprRef
, Literal[‘center’, ‘extent’] 对于带状比例尺,指示刻度和网格线应放置在带状区域的
"center"
(默认值)还是带状区域的"extent"` 处以指示间隔。
- tickCapdict,
ExprRef
,StrokeCap
, Literal[‘butt’, ‘round’, ‘square’] 刻度线末端的笔划帽样式。可以是
"butt"
、"round"
或"square"` 中的一个。
默认值:
"butt"
- tickColorstr, dict,
Color
,ExprRef
,HexColor
,ColorName
,ConditionalAxisColor
, Literal[‘black’, ‘silver’, ‘gray’, ‘white’, ‘maroon’, ‘red’, ‘purple’, ‘fuchsia’, ‘green’, ‘lime’, ‘olive’, ‘yellow’, ‘navy’, ‘blue’, ‘teal’, ‘aqua’, ‘orange’, ‘aliceblue’, ‘antiquewhite’, ‘aquamarine’, ‘azure’, ‘beige’, ‘bisque’, ‘blanchedalmond’, ‘blueviolet’, ‘brown’, ‘burlywood’, ‘cadetblue’, ‘chartreuse’, ‘chocolate’, ‘coral’, ‘cornflowerblue’, ‘cornsilk’, ‘crimson’, ‘cyan’, ‘darkblue’, ‘darkcyan’, ‘darkgoldenrod’, ‘darkgray’, ‘darkgreen’, ‘darkgrey’, ‘darkkhaki’, ‘darkmagenta’, ‘darkolivegreen’, ‘darkorange’, ‘darkorchid’, ‘darkred’, ‘darksalmon’, ‘darkseagreen’, ‘darkslateblue’, ‘darkslategray’, ‘darkslategrey’, ‘darkturquoise’, ‘darkviolet’, ‘deeppink’, ‘deepskyblue’, ‘dimgray’, ‘dimgrey’, ‘dodgerblue’, ‘firebrick’, ‘floralwhite’, ‘forestgreen’, ‘gainsboro’, ‘ghostwhite’, ‘gold’, ‘goldenrod’, ‘greenyellow’, ‘grey’, ‘honeydew’, ‘hotpink’, ‘indianred’, ‘indigo’, ‘ivory’, ‘khaki’, ‘lavender’, ‘lavenderblush’, ‘lawngreen’, ‘lemonchiffon’, ‘lightblue’, ‘lightcoral’, ‘lightcyan’, ‘lightgoldenrodyellow’, ‘lightgray’, ‘lightgreen’, ‘lightgrey’, ‘lightpink’, ‘lightsalmon’, ‘lightseagreen’, ‘lightskyblue’, ‘lightslategray’, ‘lightslategrey’, ‘lightsteelblue’, ‘lightyellow’, ‘limegreen’, ‘linen’, ‘magenta’, ‘mediumaquamarine’, ‘mediumblue’, ‘mediumorchid’, ‘mediumpurple’, ‘mediumseagreen’, ‘mediumslateblue’, ‘mediumspringgreen’, ‘mediumturquoise’, ‘mediumvioletred’, ‘midnightblue’, ‘mintcream’, ‘mistyrose’, ‘moccasin’, ‘navajowhite’, ‘oldlace’, ‘olivedrab’, ‘orangered’, ‘orchid’, ‘palegoldenrod’, ‘palegreen’, ‘paleturquoise’, ‘palevioletred’, ‘papayawhip’, ‘peachpuff’, ‘peru’, ‘pink’, ‘plum’, ‘powderblue’, ‘rosybrown’, ‘royalblue’, ‘saddlebrown’, ‘salmon’, ‘sandybrown’, ‘seagreen’, ‘seashell’, ‘sienna’, ‘skyblue’, ‘slateblue’, ‘slategray’, ‘slategrey’, ‘snow’, ‘springgreen’, ‘steelblue’, ‘tan’, ‘thistle’, ‘tomato’, ‘turquoise’, ‘violet’, ‘wheat’, ‘whitesmoke’, ‘yellowgreen’, ‘rebeccapurple’], None 轴刻度的颜色。
默认值:
"gray"
- tickCountdict, float,
ExprRef
,TimeInterval
,TimeIntervalStep
, Literal[‘millisecond’, ‘second’, ‘minute’, ‘hour’, ‘day’, ‘week’, ‘month’, ‘year’] 对于显示定量刻度的轴,这是所需的刻度线数量。最终的数量可能会有所不同,以便值更“美观”(2、5、10 的倍数)并位于底层刻度的范围内。
对于类型为
"time"
或"utc"
的刻度,刻度计数可以是一个时间间隔说明符。合法的字符串值有"millisecond"
(毫秒)、"second"
(秒)、"minute"
(分钟)、"hour"
(小时)、"day"
(天)、"week"
(周)、"month"
(月)和"year"
(年)。或者,也可以使用对象形式的间隔说明符,格式为{"interval": "month", "step": 3}
,包含所需的间隔步数。在这里,刻度线会生成在每个季度的边界(一月、四月、七月、十月)。默认值:对于 x 使用公式
ceil(width/40)
确定,对于 y 使用公式ceil(height/40)
确定。- tickDashdict, Sequence[float],
ExprRef
,ConditionalAxisNumberArray
虚线刻度线的交替 [笔画长度, 空格长度] 数组。
- tickDashOffsetdict, float,
ExprRef
,ConditionalAxisNumber
像素偏移量,用于指定从何处开始绘制刻度线虚线数组。
- tickExtrabool
布尔标志,指示是否应为轴的初始位置添加额外的轴刻度。此标志对于为
band
刻度样式化轴很有用,以便将刻度线放置在 band 的边界而不是 band 的中间。与"bandPosition": 1
和轴"padding"
值0
结合使用。- tickMinStepdict, float,
ExprRef
轴刻度之间的最小期望步长,以刻度域值表示。例如,值为
1
表示刻度线之间不应小于 1 个单位的距离。如果指定了tickMinStep
,必要时会调整tickCount
的值以强制执行最小步长值。- tickOffsetdict, float,
ExprRef
应用于刻度线、标签和网格线的像素位置偏移量。
- tickOpacitydict, float,
ExprRef
,ConditionalAxisNumber
刻度线的透明度。
- tickRoundbool
布尔标志,指示像素位置值是否应四舍五入到最接近的整数。
默认值:
true
- tickSizedict, float,
ExprRef
,ConditionalAxisNumber
轴刻度线的像素大小。
默认值:
5
- tickWidthdict, float,
ExprRef
,ConditionalAxisNumber
刻度线的像素宽度。
默认值:
1
- ticksbool
布尔值,确定轴是否应包含刻度线。
默认值:
true
- titlestr,
Text
, Sequence[str], None 字段的标题。如果为
null
,则移除标题。默认值: 由字段名称和转换函数(
aggregate
、bin
和timeUnit
)派生。如果字段有聚合函数,则函数会显示为标题的一部分(例如,"Sum of Profit"
)。如果字段已分箱或应用了时间单位,则应用的函数会显示在括号中(例如,"Profit (binned)"
、"Transaction Date (year-month)"
)。否则,标题仅为字段名称。注意:
1) 您可以通过在 config 中提供 fieldTitle 属性或通过编译函数的选项提供 fieldTitle 函数来自定义默认字段标题格式。
2) 如果同时定义了字段定义的
title
和轴、头部或图例的title
,则将使用轴/头部/图例的标题。- titleAligndict,
Align
,ExprRef
, Literal[‘left’, ‘center’, ‘right’] 轴标题的水平文本对齐方式。
- titleAnchordict,
ExprRef
,TitleAnchor
, Literal[None, ‘start’, ‘middle’, ‘end’] 用于放置轴标题的文本锚点位置。
- titleAngledict, float,
ExprRef
轴标题的角度(以度为单位)。
- titleBaselinedict,
ExprRef
,Baseline
,TextBaseline
, Literal[‘alphabetic’, ‘line-bottom’, ‘line-top’, ‘top’, ‘middle’, ‘bottom’] 轴标题的垂直文本基线。可以是
"alphabetic"
(默认)、"top"
、"middle"
、"bottom"
、"line-top"
或"line-bottom"
之一。"line-top"
和"line-bottom"
的作用类似于"top"
和"bottom"
,但它们是相对于 *lineHeight* 计算的,而不仅仅是 *fontSize*。- titleColorstr, dict,
Color
,ExprRef
,HexColor
,ColorName
, Literal[‘black’, ‘silver’, ‘gray’, ‘white’, ‘maroon’, ‘red’, ‘purple’, ‘fuchsia’, ‘green’, ‘lime’, ‘olive’, ‘yellow’, ‘navy’, ‘blue’, ‘teal’, ‘aqua’, ‘orange’, ‘aliceblue’, ‘antiquewhite’, ‘aquamarine’, ‘azure’, ‘beige’, ‘bisque’, ‘blanchedalmond’, ‘blueviolet’, ‘brown’, ‘burlywood’, ‘cadetblue’, ‘chartreuse’, ‘chocolate’, ‘coral’, ‘cornflowerblue’, ‘cornsilk’, ‘crimson’, ‘cyan’, ‘darkblue’, ‘darkcyan’, ‘darkgoldenrod’, ‘darkgray’, ‘darkgreen’, ‘darkgrey’, ‘darkkhaki’, ‘darkmagenta’, ‘darkolivegreen’, ‘darkorange’, ‘darkorchid’, ‘darkred’, ‘darksalmon’, ‘darkseagreen’, ‘darkslateblue’, ‘darkslategray’, ‘darkslategrey’, ‘darkturquoise’, ‘darkviolet’, ‘deeppink’, ‘deepskyblue’, ‘dimgray’, ‘dimgrey’, ‘dodgerblue’, ‘firebrick’, ‘floralwhite’, ‘forestgreen’, ‘gainsboro’, ‘ghostwhite’, ‘gold’, ‘goldenrod’, ‘greenyellow’, ‘grey’, ‘honeydew’, ‘hotpink’, ‘indianred’, ‘indigo’, ‘ivory’, ‘khaki’, ‘lavender’, ‘lavenderblush’, ‘lawngreen’, ‘lemonchiffon’, ‘lightblue’, ‘lightcoral’, ‘lightcyan’, ‘lightgoldenrodyellow’, ‘lightgray’, ‘lightgreen’, ‘lightgrey’, ‘lightpink’, ‘lightsalmon’, ‘lightseagreen’, ‘lightskyblue’, ‘lightslategray’, ‘lightslategrey’, ‘lightsteelblue’, ‘lightyellow’, ‘limegreen’, ‘linen’, ‘magenta’, ‘mediumaquamarine’, ‘mediumblue’, ‘mediumorchid’, ‘mediumpurple’, ‘mediumseagreen’, ‘mediumslateblue’, ‘mediumspringgreen’, ‘mediumturquoise’, ‘mediumvioletred’, ‘midnightblue’, ‘mintcream’, ‘mistyrose’, ‘moccasin’, ‘navajowhite’, ‘oldlace’, ‘olivedrab’, ‘orangered’, ‘orchid’, ‘palegoldenrod’, ‘palegreen’, ‘paleturquoise’, ‘palevioletred’, ‘papayawhip’, ‘peachpuff’, ‘peru’, ‘pink’, ‘plum’, ‘powderblue’, ‘rosybrown’, ‘royalblue’, ‘saddlebrown’, ‘salmon’, ‘sandybrown’, ‘seagreen’, ‘seashell’, ‘sienna’, ‘skyblue’, ‘slateblue’, ‘slategray’, ‘slategrey’, ‘snow’, ‘springgreen’, ‘steelblue’, ‘tan’, ‘thistle’, ‘tomato’, ‘turquoise’, ‘violet’, ‘wheat’, ‘whitesmoke’, ‘yellowgreen’, ‘rebeccapurple’], None 标题的颜色,可以是十六进制颜色码或常规颜色名称。
- titleFontstr, dict,
ExprRef
标题的字体。(例如,
"Helvetica Neue"
)。- titleFontSizedict, float,
ExprRef
标题的字体大小。
- titleFontStylestr, dict,
ExprRef
,FontStyle
标签的字体样式。
- titleFontWeightdict,
ExprRef
,FontWeight
, Literal[‘normal’, ‘bold’, ‘lighter’, ‘bolder’, 100, 200, 300, 400, 500, 600, 700, 800, 900] 标题的字体粗细。可以是字符串(例如
"bold"
、"normal"
)或数字(100
、200
、300
、...、900
,其中"normal"
=400
,"bold"
=700
)。- titleLimitdict, float,
ExprRef
轴标题的最大允许像素宽度。
- titleLineHeightdict, float,
ExprRef
多行标题文本或基线为
"line-top"
或"line-bottom"
的标题文本的像素行高。- titleOpacitydict, float,
ExprRef
轴标题的透明度。
- titlePaddingdict, float,
ExprRef
标题与轴之间的像素填充。
- titleXdict, float,
ExprRef
轴标题相对于轴组的 X 坐标。
- titleYdict, float,
ExprRef
轴标题相对于轴组的 Y 坐标。
- translatedict, float,
ExprRef
轴布局的坐标空间平移偏移量。默认情况下,轴在 x 和 y 坐标上都会平移 0.5 像素,以便描边线与像素网格对齐。然而,对于矢量图形输出,这些特定于像素的调整可能不需要,在这种情况下,可以更改 translate(例如,设为零)。
默认值:
0.5
- valuesdict, Sequence[str], Sequence[bool], Sequence[float],
ExprRef
, Sequence[dict,DateTime
] 显式设置可见的轴刻度值。
- zindexfloat
一个非负整数,表示轴的 z-index。如果 zindex 为 0,则轴应绘制在所有图表元素后面。要将它们放在前面,请将
zindex
设置为1
或更大。默认值:
0
(在标记后面)。
- ariabool, dict,
- __init__(aria=Undefined, bandPosition=Undefined, description=Undefined, domain=Undefined, domainCap=Undefined, domainColor=Undefined, domainDash=Undefined, domainDashOffset=Undefined, domainOpacity=Undefined, domainWidth=Undefined, format=Undefined, formatType=Undefined, grid=Undefined, gridCap=Undefined, gridColor=Undefined, gridDash=Undefined, gridDashOffset=Undefined, gridOpacity=Undefined, gridWidth=Undefined, labelAlign=Undefined, labelAngle=Undefined, labelBaseline=Undefined, labelBound=Undefined, labelColor=Undefined, labelExpr=Undefined, labelFlush=Undefined, labelFlushOffset=Undefined, labelFont=Undefined, labelFontSize=Undefined, labelFontStyle=Undefined, labelFontWeight=Undefined, labelLimit=Undefined, labelLineHeight=Undefined, labelOffset=Undefined, labelOpacity=Undefined, labelOverlap=Undefined, labelPadding=Undefined, labelSeparation=Undefined, labels=Undefined, maxExtent=Undefined, minExtent=Undefined, offset=Undefined, orient=Undefined, position=Undefined, style=Undefined, tickBand=Undefined, tickCap=Undefined, tickColor=Undefined, tickCount=Undefined, tickDash=Undefined, tickDashOffset=Undefined, tickExtra=Undefined, tickMinStep=Undefined, tickOffset=Undefined, tickOpacity=Undefined, tickRound=Undefined, tickSize=Undefined, tickWidth=Undefined, ticks=Undefined, title=Undefined, titleAlign=Undefined, titleAnchor=Undefined, titleAngle=Undefined, titleBaseline=Undefined, titleColor=Undefined, titleFont=Undefined, titleFontSize=Undefined, titleFontStyle=Undefined, titleFontWeight=Undefined, titleLimit=Undefined, titleLineHeight=Undefined, titleOpacity=Undefined, titlePadding=Undefined, titleX=Undefined, titleY=Undefined, translate=Undefined, values=Undefined, zindex=Undefined, **kwds)#
方法
__init__
([aria, bandPosition, description, ...])copy
([deep, ignore])返回对象的副本。
from_dict
(dct[, validate])从字典表示构造类。
from_json
(json_string[, validate])从有效的 JSON 字符串实例化对象。
resolve_references
([schema])在此对象的 schema 或根 schema 上下文中解析引用。
to_dict
([validate, ignore, context])返回对象的字典表示。
to_json
([validate, indent, sort_keys, ...])将此对象的 JSON 表示作为字符串发出。
validate
(instance[, schema])在 rootschema 上下文中根据类 schema 验证实例。
validate_property
(name, value[, schema])在 rootschema 上下文中根据属性 schema 验证属性。