altair.selection_interval#

altair.selection_interval(name=None, value=Undefined, bind=Undefined, empty=Undefined, expr=Undefined, encodings=Undefined, on=Undefined, clear=Undefined, resolve=Undefined, mark=Undefined, translate=Undefined, zoom=Undefined, **kwds)#

创建一个区间选择参数。选择参数定义了由用户输入（例如，鼠标点击或拖动）直接操作驱动的数据查询。区间选择参数用于在拖动时选择连续的数据值范围，而点选择参数（selection_point）用于选择多个离散的数据值。

参数:
namestr (可选)

参数的名称。如果未指定，将创建一个唯一的名称。

valueAny (可选)

参数的默认值。如果未指定，参数将被创建时没有默认值。

bindBinding, str (可选)

将参数绑定到外部输入元素，例如滑块、选择列表或单选按钮组。

emptybool (可选)

对于选择参数，默认情况下空选择的谓词返回 True。通过将此属性设置为 'empty=False' 来覆盖此行为。

exprExpr (可选)

用于参数值的表达式。此表达式可以包含其他参数，在这种情况下，参数将自动根据上游参数的变化进行更新。

encodingsSequence[str] (可选)

编码通道列表。相应的数据字段值必须匹配，数据元组才能落在选择范围内。

onstr (可选)

触发选择的 Vega 事件流（对象或选择器）。对于区间选择，事件流必须指定开始和结束。

clearstr, bool (可选)

清除选择，使其清空所有值。此属性可以是事件流或 False 以禁用清除。默认为 'dblclick'。

resolveLiteral['global', 'union', 'intersect'] (可选)

对于分层和多视图显示，一种策略，用于确定选择的数据查询在应用于过滤器转换、条件编码规则或比例域时如何解析。以下之一：

  • 'global': 整个 SPLOM 只存在一个刷子。当用户开始拖动时，任何先前的刷子都会被清除，并构建一个新的。

  • 'union': 每个单元格包含自己的刷子，如果点位于这些单个刷子中的任何一个内，则会被突出显示。

  • 'intersect': 每个单元格包含自己的刷子，只有当点位于所有这些单个刷子内时，才会被突出显示。

默认值为 'global'。

markBrushConfig (可选)

区间选择还会添加一个矩形标记来描绘区间的范围。mark 属性可用于自定义标记的外观。

translatestr, bool (可选)

当为 True 时，允许用户交互式地来回移动区间选择。可以是 True、False（禁用平移），或者是一个 Vega 事件流定义，其中必须包含一个开始和结束事件来触发连续平移。未来的版本将支持离散平移（例如，按下左/右箭头键）。默认值为 True，对应于 [pointerdown, window:pointerup] > window:pointermove! 此默认设置允许用户在区间选择内点击并拖动以重新定位它。

zoomstr, bool (可选)

当为 True 时，允许用户交互式地调整区间选择的大小。可以是 True、False（禁用缩放），或者是一个 Vega 事件流定义。目前，只支持滚轮事件，但仍然可以使用自定义事件流来指定过滤器、去抖和节流。未来的版本将扩展可以触发此转换的事件集。默认值为 True，对应于 wheel! 此默认设置允许用户使用鼠标滚轮调整区间选择的大小。

**kwdsAny

控制选择的附加关键字。

返回:
parameter: Parameter

可用于创建图表的参数对象。

本页内容