altair.theme.LineConfigKwds#

class altair.theme.LineConfigKwds#

altair.LineConfig TypedDict 包装器。

参数:
align

文本或范围标记(area, bar, image, rect, rule)的水平对齐方式。可选值包括 "left""right""center"

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

angle

文本的旋转角度,以度为单位。

aria

一个布尔标志,指示是否应包含 ARIA attributes(仅限 SVG 输出)。如果为 false,则会在输出的 SVG 元素上设置“aria-hidden”属性,将标记项从 ARIA 可访问性树中移除。

ariaRole

设置标记项的用户界面元素类型,用于ARIA 可访问性(仅限 SVG 输出)。如果指定,此属性确定“role”属性。警告:此属性是实验性的,将来可能会更改。

ariaRoleDescription

标记项角色的可读、作者本地化描述,用于ARIA 可访问性(仅限 SVG 输出)。如果指定,此属性确定 “aria-label”属性。警告:此属性是实验性的,将来可能会更改。

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 光标类型

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")或数字(100, 200, 300, …, 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" — 从可视化效果的标记比例尺排除所有无效值。对于路径标记(line, area, trail),此选项将创建连接有效点的路径,就像带有无效值的数据行不存在一样。

  • "break-paths-filter-domains" — 在无效值处断开路径标记(line, area, trail)。对于非路径标记,这等效于 "filter"。所有比例尺域都将排除这些过滤后的数据点。

  • "break-paths-show-domains" — 在无效值处断开路径标记(line, area, trail)。对于非路径标记,隐藏无效值。所有比例尺域都将包含这些过滤后的数据点(对于路径和非路径标记)。

  • "show"null — 在标记和比例尺域中显示所有数据点。每个比例尺将使用在 config.scale.invalid 中定义的无效值输出,如果未指定,默认情况下,无效值将产生与零相同的视觉值(如果比例尺包含零)或最小值(如果比例尺不包含零)。

  • "break-paths-show-path-domains"(默认)— 这等效于用于路径标记(line/area/trail)的 "break-paths-show-domains" 和用于非路径标记的 "filter"

注意:如果任何通道的比例尺在 config.scale.invalid 中定义了无效值的输出,则比例尺的所有值都将被视为“有效”,因为它们可以为比例尺产生合理的输出。因此,此类通道的字段不会被过滤,也不会导致路径断开。

limit

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

默认值: 0 – 表示无限制

lineBreak

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

lineHeight

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

opacity

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

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

order

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

orient

非堆叠 bar、tick、area 和 line 图表的方向。值可以是水平(默认)或垂直。

  • 对于 bar、rule 和 tick,这确定 bar 和 tick 的大小应应用于 x 还是 y 维度。

  • 对于 area,此属性确定 Vega 输出的 orient 属性。

  • 对于 line 和 trail 标记,如果未指定 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,这表示 bar 的带宽(以像素为单位)。

  • 对于 text,这表示字体大小(以像素为单位)。

默认值

  • 对于 point, circle, square 标记为 30;width/height 的 step

  • 对于离散维度的 bar 标记为 2

  • 对于连续维度的 bar 标记为 5

  • 对于 text 标记为 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 则返回 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

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