altair.MarkDef#
- class altair.MarkDef(type=Undefined, align=Undefined, angle=Undefined, aria=Undefined, ariaRole=Undefined, ariaRoleDescription=Undefined, aspect=Undefined, bandSize=Undefined, baseline=Undefined, binSpacing=Undefined, blend=Undefined, clip=Undefined, color=Undefined, continuousBandSize=Undefined, cornerRadius=Undefined, cornerRadiusBottomLeft=Undefined, cornerRadiusBottomRight=Undefined, cornerRadiusEnd=Undefined, cornerRadiusTopLeft=Undefined, cornerRadiusTopRight=Undefined, cursor=Undefined, description=Undefined, dir=Undefined, discreteBandSize=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, height=Undefined, href=Undefined, innerRadius=Undefined, interpolate=Undefined, invalid=Undefined, limit=Undefined, line=Undefined, lineBreak=Undefined, lineHeight=Undefined, minBandSize=Undefined, opacity=Undefined, order=Undefined, orient=Undefined, outerRadius=Undefined, padAngle=Undefined, point=Undefined, radius=Undefined, radius2=Undefined, radius2Offset=Undefined, radiusOffset=Undefined, shape=Undefined, size=Undefined, smooth=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOffset=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, theta2=Undefined, theta2Offset=Undefined, thetaOffset=Undefined, thickness=Undefined, timeUnitBandPosition=Undefined, timeUnitBandSize=Undefined, tooltip=Undefined, url=Undefined, width=Undefined, x=Undefined, x2=Undefined, x2Offset=Undefined, xOffset=Undefined, y=Undefined, y2=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)#
MarkDef 模式包装器。
- 参数:
- type
Mark
, Literal[‘arc’, ‘area’, ‘bar’, ‘image’, ‘line’, ‘point’, ‘rect’, ‘rule’, ‘text’, ‘tick’, ‘trail’, ‘circle’, ‘square’, ‘geoshape’] 标记类型。可以是原始标记类型(
"bar"
、"circle"
、"square"
、"tick"
、"line"
、"area"
、"point"
、"geoshape"
、"rule"
和"text"
中的一种)或复合标记类型("boxplot"
、"errorband"
、"errorbar"
)。- aligndict,
Align
,ExprRef
, Literal[‘left’, ‘center’, ‘right’] 文本或范围标记(面积、条形、图像、矩形、规则线)的水平对齐方式。可以是
"left"
、"right"
、"center"
中的一个。注意:范围标记不支持表达式引用。
- angledict, float,
ExprRef
文本的旋转角度,以度为单位。
- ariabool, dict,
ExprRef
一个布尔标志,指示是否应包含 ARIA 属性(仅限 SVG 输出)。如果为
false
,则会在输出 SVG 元素上设置“aria-hidden”属性,从而从 ARIA 可访问性树中移除标记项。- ariaRolestr, dict,
ExprRef
为 ARIA 可访问性设置标记项的用户界面元素类型(仅限 SVG 输出)。如果指定,此属性决定了“role”属性。警告:此属性是实验性的,将来可能会更改。
- ariaRoleDescriptionstr, dict,
ExprRef
为 ARIA 可访问性提供的标记项角色的可读、作者本地化的描述(仅限 SVG 输出)。如果指定,此属性决定了“aria-roledescription”属性。警告:此属性是实验性的,将来可能会更改。
- aspectbool, dict,
ExprRef
是否保留图像标记的纵横比。
- bandSizefloat
刻度的宽度。
默认值:步长的 3/4(水平刻度的宽度步长和垂直刻度的高度步长)。
- baselinedict,
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
计算。对于范围标记,标记的垂直对齐方式。可以是
"top"
、"middle"
、"bottom"
中的一个。注意:范围标记不支持表达式引用。
- binSpacingfloat
分箱字段的条形之间的偏移量。理想值是 0(统计学家偏爱)或 1(Vega-Lite 默认值,D3 示例样式)。
默认值:
1
- blenddict,
Blend
,ExprRef
, Literal[None, ‘multiply’, ‘screen’, ‘overlay’, ‘darken’, ‘lighten’, ‘color-dodge’, ‘color-burn’, ‘hard-light’, ‘soft-light’, ‘difference’, ‘exclusion’, ‘hue’, ‘saturation’, ‘color’, ‘luminosity’] 在当前背景上绘制项目时使用的颜色混合模式。可以使用任何有效的 CSS mix-blend-mode 值。
__默认值:__
"source-over"
- clipbool, dict,
ExprRef
标记是否被裁剪到其封闭组的宽度和高度范围内。
- colorstr, dict,
Color
,ExprRef
,Gradient
,HexColor
,ColorName
,LinearGradient
,RadialGradient
, 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’] 默认颜色。
默认值: ■
"#4682b4"
注意
此属性不能用于样式配置。
fill
和stroke
属性的优先级高于color
,并且会覆盖color
。
- continuousBandSizefloat
连续比例尺上条形图的默认大小。
默认值:
5
- cornerRadiusdict, float,
ExprRef
圆角矩形或弧形拐角的像素半径。
默认值:
0
- cornerRadiusBottomLeftdict, float,
ExprRef
圆角矩形左下角的像素半径。
默认值:
0
- cornerRadiusBottomRightdict, float,
ExprRef
圆角矩形右下角的像素半径。
默认值:
0
- cornerRadiusEnddict, float,
ExprRef
对于垂直条,左上角和右上角半径。
对于水平条,右上角和右下角半径。
- cornerRadiusTopLeftdict, float,
ExprRef
圆角矩形右上角的像素半径。
默认值:
0
- cornerRadiusTopRightdict, float,
ExprRef
圆角矩形左上角的像素半径。
默认值:
0
- cursordict,
Cursor
,ExprRef
, Literal[‘auto’, ‘default’, ‘none’, ‘context-menu’, ‘help’, ‘pointer’, ‘progress’, ‘wait’, ‘cell’, ‘crosshair’, ‘text’, ‘vertical-text’, ‘alias’, ‘copy’, ‘move’, ‘no-drop’, ‘not-allowed’, ‘e-resize’, ‘n-resize’, ‘ne-resize’, ‘nw-resize’, ‘s-resize’, ‘se-resize’, ‘sw-resize’, ‘w-resize’, ‘ew-resize’, ‘ns-resize’, ‘nesw-resize’, ‘nwse-resize’, ‘col-resize’, ‘row-resize’, ‘all-scroll’, ‘zoom-in’, ‘zoom-out’, ‘grab’, ‘grabbing’] 鼠标悬停在标记上时使用的光标。可以使用任何有效的 CSS cursor type 值。
- descriptionstr, dict,
ExprRef
为 ARIA 可访问性提供的标记项的文本描述(仅限 SVG 输出)。如果指定,此属性决定了 “aria-label” 属性。
- dirdict,
ExprRef
,TextDirection
, Literal[‘ltr’, ‘rtl’] 文本的方向。可以是
"ltr"
(从左到右)或"rtl"
(从右到左)。此属性决定了响应 limit 参数时从哪一侧截断文本。默认值:
"ltr"
- discreteBandSizedict, float,
RelativeBandSize
具有离散维度的条形图的默认大小。如果未指定,默认大小为
step-2
,这提供了条形图之间 2 像素的偏移。- dxdict, float,
ExprRef
文本标签与其锚点之间的水平偏移量,以像素为单位。偏移量在按 angle 属性旋转后应用。
- dydict, float,
ExprRef
文本标签与其锚点之间的垂直偏移量,以像素为单位。偏移量在按 angle 属性旋转后应用。
- ellipsisstr, dict,
ExprRef
响应 limit 参数而被截断的文本的省略号字符串。
默认值:
"…"
- fillstr, dict,
Color
,ExprRef
,Gradient
,HexColor
,ColorName
,LinearGradient
,RadialGradient
, 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 默认填充颜色。此属性的优先级高于
config.color
。设置为null
可移除填充。默认值: (无)
- fillOpacitydict, float,
ExprRef
填充不透明度(值在 [0,1] 之间)。
默认值:
1
- filledbool
标记的颜色是否应作为填充颜色而不是描边颜色使用。
默认值:对于所有
point
、line
和rule
标记以及用于 graticule 数据源的geoshape
标记,为false
;否则为true
。注意:此属性不能用于样式配置。
- fontstr, dict,
ExprRef
设置文本的字体(例如,
"Helvetica Neue"
)。- fontSizedict, float,
ExprRef
字体大小,以像素为单位。
默认值:
11
- fontStylestr, dict,
ExprRef
,FontStyle
字体样式(例如,
"italic"
)。- fontWeightdict,
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
)。- heightdict, float,
ExprRef
,RelativeBandSize
标记的高度。以下之一
表示固定像素高度的数字。
相对带宽定义。例如,
{band: 0.5}
表示带宽的一半
- hrefstr, dict,
URI
,ExprRef
鼠标点击时加载的 URL。如果定义,标记将作为超链接。
- innerRadiusdict, float,
ExprRef
弧形标记的内半径,以像素为单位。
innerRadius
是radius2
的别名。默认值:
0
- interpolatedict,
ExprRef
,Interpolate
, Literal[‘basis’, ‘basis-open’, ‘basis-closed’, ‘bundle’, ‘cardinal’, ‘cardinal-open’, ‘cardinal-closed’, ‘catmull-rom’, ‘linear’, ‘linear-closed’, ‘monotone’, ‘natural’, ‘step’, ‘step-before’, ‘step-after’] 线和面积标记使用的线条插值方法。以下之一
"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
MarkInvalidDataMode
, Literal[‘filter’, ‘break-paths-filter-domains’, ‘break-paths-show-domains’, ‘break-paths-show-path-domains’, ‘show’], None 无效数据模式,定义标记和相应的比例尺应如何表示无效值(连续比例尺中没有定义无效值输出的
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
中定义了无效值的输出,那么比例尺的所有值都将被视为“有效”,因为它们可以为比例尺产生合理输出。因此,此类通道的字段不会被过滤,也不会导致路径中断。- limitdict, float,
ExprRef
文本标记的最大长度(以像素为单位)。如果渲染尺寸超出此限制,文本值将自动截断。
默认值:
0
– 表示没有限制- linebool, dict,
OverlayMarkDef
用于在面积标记顶部叠加线条的标志,或者一个定义叠加线条属性的对象。
如果此值为空对象 (
{}
) 或true
,将使用具有默认属性的线条。如果此值为
false
,则不会自动向面积标记添加线条。
默认值:
false
。- lineBreakstr, dict,
ExprRef
一个分隔符,例如换行符,用于将文本字符串拆分成多行。如果文本是数组值,则忽略此属性。
- lineHeightdict, float,
ExprRef
多行文本标记的行高(以像素为单位)(即文本后续行之间的间距)。
- minBandSizedict, float,
ExprRef
条形和矩形标记的最小条带尺寸。默认值:
0.25
- opacitydict, float,
ExprRef
整体不透明度(值介于 [0,1] 之间)。
默认值: 对于使用
point
(点)、tick
(刻度)、circle
(圆形)或square
(方形)标记的非聚合图表或分层bar
(条形)图表,值为0.7
;否则为1
。- orderbool, None
对于线条和轨迹标记,可以将此
order
属性设置为null
或false
,以使线条使用数据源中的原始顺序。- orient
Orientation
, Literal[‘horizontal’, ‘vertical’] 非堆叠条形图、刻度图、面积图和折线图的方向。值为 horizontal(水平)(默认)或 vertical(垂直)。
对于条形、规则线和刻度,这决定了条形和刻度的大小应该应用于 x 维度还是 y 维度。
对于面积图,此属性决定了 Vega 输出的 orient 属性。
对于线条和轨迹标记,如果未指定
config.sortLineBy
,则此属性决定了线条中点的排序顺序。对于堆叠图表,这始终由堆叠的方向决定;因此,显式指定的值将被忽略。
- outerRadiusdict, float,
ExprRef
弧形标记的外半径(以像素为单位)。
outerRadius
是radius
的别名。默认值:
0
- padAngledict, float,
ExprRef
应用于弧形侧边的角度填充(以弧度为单位)。
- pointbool, dict, Literal[‘transparent’],
OverlayMarkDef
用于在线条或面积标记顶部叠加点的标志,或者一个定义叠加点属性的对象。
如果此属性为
"transparent"
,将使用透明点(用于增强工具提示和选择)。如果此属性为空对象 (
{}
) 或true
,将使用具有默认属性的实心点。如果此属性为
false
,则不会自动向线条或面积标记添加点。
默认值:
false
。- radiusdict, float,
ExprRef
对于弧形标记,主(外)半径(以像素为单位)。
对于文本标记,文本相对于由
x
和y
属性确定的原点的极坐标径向偏移(以像素为单位)。默认值:
min(plot_width, plot_height)/2
- radius2dict, float,
ExprRef
弧形标记的次(内)半径(以像素为单位)。
默认值:
0
- radius2Offsetdict, float,
ExprRef
radius2 的偏移量。
- radiusOffsetdict, float,
ExprRef
radius 的偏移量。
- shapestr, dict,
ExprRef
,SymbolShape
点标记的形状。支持的值包括
绘图形状:
"circle"
(圆形)、"square"
(方形)、"cross"
(十字形)、"diamond"
(菱形)、"triangle-up"
(朝上三角形)、"triangle-down"
(朝下三角形)、"triangle-right"
(朝右三角形)或"triangle-left"
(朝左三角形)。线条符号
"stroke"
居中方向形状
"arrow"
(箭头)、"wedge"
(楔形)或"triangle"(三角形)
一个自定义的 SVG 路径字符串(为了正确的尺寸,自定义形状路径应定义在一个方形包围盒内,其 x 和 y 坐标范围从 -1 到 1)。
默认值:
"circle"
- sizedict, float,
ExprRef
标记的默认尺寸。
对于
point
(点)/circle
(圆形)/square
(方形),这表示标记的像素面积。请注意,此值设置的是符号的面积;边长将随着此值的平方根而增加。对于
bar
(条形),这表示条形的带宽,以像素为单位。对于
text
(文本),这表示字体大小,以像素为单位。
默认值
30
用于点、圆形、方形标记;width/height 的step
2
用于离散维度的条形标记;5
用于连续维度的条形标记;11
用于文本标记。
- smoothbool, dict,
ExprRef
一个布尔标志(默认为 true),指示图像在调整大小时是否应平滑。如果为 false,则应直接缩放单个像素,而不是使用平滑插值。对于 SVG 渲染,由于缺乏标准化,此选项在某些浏览器中可能不起作用。
- strokestr, dict,
Color
,ExprRef
,Gradient
,HexColor
,ColorName
,LinearGradient
,RadialGradient
, 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 默认描边颜色。此属性的优先级高于
config.color
。设置为null
以移除描边。默认值: (无)
- strokeCapdict,
ExprRef
,StrokeCap
, Literal[‘butt’, ‘round’, ‘square’] 线条末端样式的描边帽。可以是
"butt"
(平直)、"round"
(圆形)或"square"
(方形)之一。默认值:
"butt"
- strokeDashdict, Sequence[float],
ExprRef
用于创建虚线或点划线的交替描边、间距长度数组。
- strokeDashOffsetdict, float,
ExprRef
开始使用描边虚线数组绘制的偏移量(以像素为单位)。
- strokeJoindict,
ExprRef
,StrokeJoin
, Literal[‘miter’, ‘round’, ‘bevel’] 描边线条连接方法。可以是
"miter"
(斜接)、"round"
(圆形)或"bevel"
(斜角)之一。默认值:
"miter"
- strokeMiterLimitdict, float,
ExprRef
斜接限制,超过该限制时将对线条连接进行斜角处理。
- strokeOffsetdict, float,
ExprRef
绘制组描边和填充的偏移量(以像素为单位)。如果未指定,默认行为是动态偏移带描边的组,使得 1 像素的描边宽度与像素网格对齐。
- strokeOpacitydict, float,
ExprRef
描边不透明度(值介于 [0,1] 之间)。
默认值:
1
- strokeWidthdict, float,
ExprRef
描边宽度,以像素为单位。
- stylestr, Sequence[str]
一个字符串或字符串数组,指示要应用于标记的自定义样式名称。样式是在 style 配置 中定义的标记属性默认值的命名集合。如果 style 是一个数组,后面的样式将覆盖前面的样式。在
encoding
中明确定义的任何标记属性都将覆盖样式默认值。默认值: 标记的名称。例如,条形标记默认样式为
"bar"
。注意: 任何指定的样式都将增强默认样式。例如,样式为"style": "foo"
的条形标记将从config.style.bar
和config.style.foo
中接收样式(指定的样式"foo"
具有更高的优先级)。- tensiondict, float,
ExprRef
根据插值类型,设置张力参数(用于线条和面积标记)。
- textstr, dict,
Text
, Sequence[str],ExprRef
如果未指定
text
通道,则为占位符文本。- thetadict, float,
ExprRef
对于弧形标记,如果未指定 theta2,则表示弧长(以弧度为单位),否则表示起始弧角。(值为 0 表示向上或“北方”,增加的值按顺时针方向进行。)
对于文本标记,极坐标角度(以弧度为单位)。
- theta2dict, float,
ExprRef
弧形标记的结束角度(以弧度为单位)。值为 0 表示向上或“北方”,增加的值按顺时针方向进行。
- theta2Offsetdict, float,
ExprRef
theta2 的偏移量。
- thetaOffsetdict, float,
ExprRef
theta 的偏移量。
- thicknessfloat
刻度标记的厚度。
默认值:
1
- timeUnitBandPositionfloat
时间单位的默认相对条带位置。如果设置为
0
,标记将位于时间单位条带步长的开始处。如果设置为0.5
,标记将位于时间单位条带步长的中间。- timeUnitBandSizefloat
时间单位的默认相对条带大小。如果设置为
1
,标记的带宽将等于时间单位条带步长。如果设置为0.5
,标记的带宽将是时间单位条带步长的一半。- tooltipstr, bool, dict, float,
ExprRef
,TooltipContent
, None 鼠标悬停时显示的工具提示文本字符串,或者一个定义工具提示应从哪些字段派生的对象。
如果
tooltip
为true
或{"content": "encoding"}
,则将使用来自encoding
的所有字段。如果
tooltip
为{"content": "data"}
,则将使用高亮数据显示点中出现的所有字段。如果设置为
null
或false
,则不会使用工具提示。
有关 Vega-Lite 中工具提示的详细讨论,请参阅 工具提示 文档。
默认值:
null
- urlstr, dict,
URI
,ExprRef
图像标记的图像文件 URL。
- widthdict, float,
ExprRef
,RelativeBandSize
标记的宽度。可以是以下之一:
一个表示固定像素宽度的数字。
一个相对带宽定义。例如,
{band: 0.5}
表示带宽的一半。
- xdict, float,
ExprRef
, Literal[‘width’] 标记的 X 坐标,或者未指定
x2
或width
的水平"bar"
(条形)和"area"
(面积图)的宽度。此通道的
value
可以是一个数字,也可以是一个字符串"width"
,表示图表的宽度。- x2dict, float,
ExprRef
, Literal[‘width’] 范围型
"area"
(面积图)、"bar"
(条形)、"rect"
(矩形)和"rule"
(规则线)的 X2 坐标。此通道的
value
可以是一个数字,也可以是一个字符串"width"
,表示图表的宽度。- x2Offsetdict, float,
ExprRef
x2 位置的偏移量。
- xOffsetdict, float,
ExprRef
x 位置的偏移量。
- ydict, float,
ExprRef
, Literal[‘height’] 标记的 Y 坐标,或者未指定
y2
或height
的垂直"bar"
(条形)和"area"
(面积图)的高度。此通道的
value
可以是一个数字,也可以是一个字符串"height"
,表示图表的高度。- y2dict, float,
ExprRef
, Literal[‘height’] 范围型
"area"
(面积图)、"bar"
(条形)、"rect"
(矩形)和"rule"
(规则线)的 Y2 坐标。此通道的
value
可以是一个数字,也可以是一个字符串"height"
,表示图表的高度。- y2Offsetdict, float,
ExprRef
y2 位置的偏移量。
- yOffsetdict, float,
ExprRef
y 位置的偏移量。
- type
- __init__(type=Undefined, align=Undefined, angle=Undefined, aria=Undefined, ariaRole=Undefined, ariaRoleDescription=Undefined, aspect=Undefined, bandSize=Undefined, baseline=Undefined, binSpacing=Undefined, blend=Undefined, clip=Undefined, color=Undefined, continuousBandSize=Undefined, cornerRadius=Undefined, cornerRadiusBottomLeft=Undefined, cornerRadiusBottomRight=Undefined, cornerRadiusEnd=Undefined, cornerRadiusTopLeft=Undefined, cornerRadiusTopRight=Undefined, cursor=Undefined, description=Undefined, dir=Undefined, discreteBandSize=Undefined, dx=Undefined, dy=Undefined, ellipsis=Undefined, fill=Undefined, fillOpacity=Undefined, filled=Undefined, font=Undefined, fontSize=Undefined, fontStyle=Undefined, fontWeight=Undefined, height=Undefined, href=Undefined, innerRadius=Undefined, interpolate=Undefined, invalid=Undefined, limit=Undefined, line=Undefined, lineBreak=Undefined, lineHeight=Undefined, minBandSize=Undefined, opacity=Undefined, order=Undefined, orient=Undefined, outerRadius=Undefined, padAngle=Undefined, point=Undefined, radius=Undefined, radius2=Undefined, radius2Offset=Undefined, radiusOffset=Undefined, shape=Undefined, size=Undefined, smooth=Undefined, stroke=Undefined, strokeCap=Undefined, strokeDash=Undefined, strokeDashOffset=Undefined, strokeJoin=Undefined, strokeMiterLimit=Undefined, strokeOffset=Undefined, strokeOpacity=Undefined, strokeWidth=Undefined, style=Undefined, tension=Undefined, text=Undefined, theta=Undefined, theta2=Undefined, theta2Offset=Undefined, thetaOffset=Undefined, thickness=Undefined, timeUnitBandPosition=Undefined, timeUnitBandSize=Undefined, tooltip=Undefined, url=Undefined, width=Undefined, x=Undefined, x2=Undefined, x2Offset=Undefined, xOffset=Undefined, y=Undefined, y2=Undefined, y2Offset=Undefined, yOffset=Undefined, **kwds)#
方法
__init__
([type, align, angle, aria, ...])copy
([deep, ignore])返回对象的副本。
from_dict
(dct[, validate])从字典表示构建类。
from_json
(json_string[, validate])从有效的 JSON 字符串实例化对象。
resolve_references
([schema])在此对象模式或根模式的上下文中解析引用。
to_dict
([validate, ignore, context])返回对象的字典表示。
to_json
([validate, indent, sort_keys, ...])将此对象的 JSON 表示输出为字符串。
validate
(instance[, schema])在根模式的上下文中,根据类模式验证实例。
validate_property
(name, value[, schema])在根模式的上下文中,根据属性模式验证属性。