altair.theme.AreaConfigKwds#

class altair.theme.AreaConfigKwds#

altair.AreaConfig TypedDict 包装器。

参数:
align

文本或范围标记(面积、条形图、图像、矩形、规则线)的水平对齐方式。可选值包括 "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 标记以及经纬网数据源的 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,但使用 tension 参数来拉直样条。

  • "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 – 表示无限制

line

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

  • 如果此值是空对象 ({}) 或 true,将使用具有默认属性的线条。

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

默认值: false

lineBreak

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

lineHeight

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

opacity

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

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

order

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

orient

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

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

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

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

outerRadius

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

默认值: 0

padAngle

应用于圆弧侧面的角度填充,单位为弧度。

point

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

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

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

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

默认值: false

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;宽度/高度的 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

根据插值类型,设置 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])

如果键在字典中,则返回键的值;否则返回默认值。

items()

keys()

pop(key[, default])

如果未找到键,则返回给定的默认值;否则引发 KeyError。

popitem(/)

移除并返回一个 (key, value) 对作为 2 元组。

setdefault(key[, default])

如果键不在字典中,则插入键并将其值设置为 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

line

lineBreak

lineHeight

opacity

order

orient

outerRadius

padAngle

point

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