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 模式包装器。

参数:
typeMark, 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"

注意

  • 此属性不能用于样式配置

  • fillstroke 属性的优先级高于 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

标记的颜色是否应作为填充颜色而不是描边颜色使用。

默认值:对于所有 pointlinerule 标记以及用于 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

弧形标记的内半径,以像素为单位。innerRadiusradius2 的别名。

默认值: 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 单调性的三次插值。

invalidMarkInvalidDataMode, Literal[‘filter’, ‘break-paths-filter-domains’, ‘break-paths-show-domains’, ‘break-paths-show-path-domains’, ‘show’], None

无效数据模式,定义标记和相应的比例尺应如何表示无效值(连续比例尺中没有定义无效值输出的 nullNaN 值)。

  • "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 属性设置为 nullfalse,以使线条使用数据源中的原始顺序。

orientOrientation, Literal[‘horizontal’, ‘vertical’]

非堆叠条形图、刻度图、面积图和折线图的方向。值为 horizontal(水平)(默认)或 vertical(垂直)。

  • 对于条形、规则线和刻度,这决定了条形和刻度的大小应该应用于 x 维度还是 y 维度。

  • 对于面积图,此属性决定了 Vega 输出的 orient 属性。

  • 对于线条和轨迹标记,如果未指定 config.sortLineBy,则此属性决定了线条中点的排序顺序。对于堆叠图表,这始终由堆叠的方向决定;因此,显式指定的值将被忽略。

outerRadiusdict, float, ExprRef

弧形标记的外半径(以像素为单位)。outerRadiusradius 的别名。

默认值: 0

padAngledict, float, ExprRef

应用于弧形侧边的角度填充(以弧度为单位)。

pointbool, dict, Literal[‘transparent’], OverlayMarkDef

用于在线条或面积标记顶部叠加点的标志,或者一个定义叠加点属性的对象。

  • 如果此属性为 "transparent",将使用透明点(用于增强工具提示和选择)。

  • 如果此属性为空对象 ({}) 或 true,将使用具有默认属性的实心点。

  • 如果此属性为 false,则不会自动向线条或面积标记添加点。

默认值: false

radiusdict, float, ExprRef

对于弧形标记,主(外)半径(以像素为单位)。

对于文本标记,文本相对于由 xy 属性确定的原点的极坐标径向偏移(以像素为单位)。

默认值: 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.barconfig.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

鼠标悬停时显示的工具提示文本字符串,或者一个定义工具提示应从哪些字段派生的对象。

  • 如果 tooltiptrue{"content": "encoding"},则将使用来自 encoding 的所有字段。

  • 如果 tooltip{"content": "data"},则将使用高亮数据显示点中出现的所有字段。

  • 如果设置为 nullfalse,则不会使用工具提示。

有关 Vega-Lite 中工具提示的详细讨论,请参阅 工具提示 文档。

默认值: null

urlstr, dict, URI, ExprRef

图像标记的图像文件 URL。

widthdict, float, ExprRef, RelativeBandSize

标记的宽度。可以是以下之一:

  • 一个表示固定像素宽度的数字。

  • 一个相对带宽定义。例如,{band: 0.5} 表示带宽的一半。

xdict, float, ExprRef, Literal[‘width’]

标记的 X 坐标,或者未指定 x2width 的水平 "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 坐标,或者未指定 y2height 的垂直 "bar"(条形)和 "area"(面积图)的高度。

此通道的 value 可以是一个数字,也可以是一个字符串 "height",表示图表的高度。

y2dict, float, ExprRef, Literal[‘height’]

范围型 "area"(面积图)、"bar"(条形)、"rect"(矩形)和 "rule"(规则线)的 Y2 坐标。

此通道的 value 可以是一个数字,也可以是一个字符串 "height",表示图表的高度。

y2Offsetdict, float, ExprRef

y2 位置的偏移量。

yOffsetdict, float, ExprRef

y 位置的偏移量。

__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])

在根模式的上下文中,根据属性模式验证属性。