altair.theme.MarkConfigKwds#

class altair.theme.MarkConfigKwds#

altair.MarkConfig TypedDict 的包装器。

参数:
align

文本或范围标记(area、bar、image、rect、rule)的水平对齐方式。以下之一:"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"

注意:范围标记不支持表达式引用。

blend

在当前背景上绘制项目时的颜色混合模式。任何有效的CSS mix-blend-mode 值都可以使用。

__默认值:__ "source-over"

color

默认颜色。

默认值: "#4682b4"

注意

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

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

标记的颜色是应该用作填充颜色还是描边颜色。

默认值: 对于所有 pointlinerule 标记以及用于graticule数据源的 geoshape 标记为 false;否则为 true

注意:此属性不能用于样式配置

font

设置文本的字体(例如,"Helvetica Neue")。

fontSize

字体大小,单位为像素。

默认值: 11

fontStyle

字体样式(例如,"italic")。

fontWeight

字体粗细。可以是字符串(例如 "bold""normal")或数字(100200300,…,900,其中 "normal" = 400"bold" = 700)。

height

标记的高度。

href

鼠标点击时加载的 URL。如果定义,标记将作为超链接。

innerRadius

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

默认值: 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,但使用张力参数使样条变直。

  • "monotone":保持 y 单调性的三次插值。

invalid

无效数据模式,它定义了标记和相应的比例尺应如何表示无效值(连续比例尺中没有定义无效值输出时的 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 中定义了无效值的输出,则比例尺的所有值都将被视为“有效”,因为它们可以为比例尺产生合理的输出。因此,这些通道的字段不会被过滤,也不会导致路径中断。

limit

文本标记的最大长度,单位为像素。如果渲染大小超出限制,文本值将自动截断。

默认值: 0 – 表示无限制

lineBreak

一个分隔符,例如换行符,用于将文本字符串分成多行。如果文本是数组值,则忽略此属性。

lineHeight

多行文本标记的行高,单位为像素(后续文本行之间的间距)。

opacity

整体不透明度(值在 [0,1] 之间)。

默认值: 对于使用 pointtickcirclesquare 标记的非聚合图表或分层 bar 图表,为 0.7;否则为 1

order

对于线和轨迹标记,可以将 order 属性设置为 nullfalse,使线条使用数据源中的原始顺序。

orient

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

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

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

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

outerRadius

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

默认值: 0

padAngle

应用于弧形两侧的角填充,单位为弧度。

radius

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

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

默认值: 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 路径字符串(为了正确的大小调整,自定义形状路径应在沿 x 和 y 维度坐标范围从 -1 到 1 的方形边界框内定义。)

默认值: "circle"

size

标记的默认大小。

  • 对于 point/circle/square,这代表标记的像素区域。请注意,此值设置符号的面积;边长将随此值的平方根增加。

  • 对于 bar,这代表柱状图的带宽大小,单位为像素。

  • 对于 text,这代表字体大小,单位为像素。

默认值

  • 对于点、圆、方形标记为 30;width/height 的 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

根据插值类型,设置张力参数(用于线和面积标记)。

text

如果未指定 text 通道,则为占位符文本

theta
  • 对于弧形标记,如果未指定 theta2,则为弧长,单位为弧度;否则为起始弧形角度。(值为 0 表示向上或“北方”,值增加时顺时针方向进行。)

  • 对于文本标记,极坐标角度,单位为弧度。

theta2

弧形标记的结束角度,单位为弧度。值为 0 表示向上或“北方”,值增加时顺时针方向进行。

timeUnitBandPosition

时间单位的默认相对带宽位置。如果设置为 0,标记将位于时间单位带宽步长的开头。如果设置为 0.5,标记将位于时间单位带宽步长的中间。

timeUnitBandSize

时间单位的默认相对带宽大小。如果设置为 1,标记的带宽将等于时间单位带宽步长。如果设置为 0.5,标记的带宽将是时间单位带宽步长的一半。

tooltip

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

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

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

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

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

默认值: null

url

图像标记的图像文件的 URL。

width

标记的宽度。

x

标记的 X 坐标,或未指定 x2width 的水平 "bar""area" 的宽度。

此通道的 value 可以是数字或字符串 "width",表示图表的宽度。

x2

范围 "area""bar""rect""rule" 的 X2 坐标。

此通道的 value 可以是数字或字符串 "width",表示图表的宽度。

y

标记的 Y 坐标,或未指定 y2height 的垂直 "bar""area" 的高度。

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

y2

范围 "area""bar""rect""rule" 的 Y2 坐标。

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

__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(如果给定);否则引发 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

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

timeUnitBandPosition

timeUnitBandSize

tooltip

url

width

x

x2

y

y2