altair.selection_point

altair.selection_point(name=None, value=Undefined, bind=Undefined, empty=Undefined, expr=Undefined, encodings=Undefined, fields=Undefined, on=Undefined, clear=Undefined, resolve=Undefined, toggle=Undefined, nearest=Undefined, **kwds)

创建一个点选参数。选择参数定义了由用户输入（例如，鼠标点击或拖动）直接操作驱动的数据查询。点选参数用于选择多个离散数据值；第一次点击选择第一个值，Shift+点击切换选择更多值。要通过拖动选择连续数据值范围，可以使用区间选择参数（selection_interval）。

参数:

namestr（可选）

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

valueAny（可选）

参数的默认值。如果未指定，将创建不带默认值的参数。

bindBinding, str（可选）

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

emptybool（可选）

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

exprExpr（可选）

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

encodingsSequence[str]（可选）

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

fieldsSequence[str]（可选）

字段名称列表，数据元组必须匹配其值才能落在选择范围内。

onstr（可选）

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

clearstr, bool（可选）

清除选择，清空所有值。此属性可以是 Event Stream，或设置为 False 以禁用清除。默认值是 'dblclick'。

resolveLiteral[‘global’, ‘union’, ‘intersect’]（可选）

对于分层和多视图显示，此策略决定了选择在过滤变换、条件编码规则或比例域中应用时，其数据查询的解析方式。可以是以下之一：

• ‘global’（全局）：整个 SPLOM 中只有一个刷子。当用户开始拖动时，清除任何先前的刷子，并构建一个新的。

• ‘union’（联合）：每个单元格包含自己的刷子，如果点落在其中任何一个刷子内，则突出显示。

• ‘intersect’（交集）：每个单元格包含自己的刷子，只有当点落在所有这些刷子内时，才突出显示。

默认值为 'global'。

togglestr, bool（可选）

控制数据值是应该被切换（插入或从点选中移除）还是只插入到点选中。可以是以下之一：

• True（默认）：切换行为，对应于“event.shiftKey”。因此，当用户按下 Shift 键进行交互时，数据值会进行切换。

• False：禁用切换行为；选择将只包含与最近一次交互相对应的单个数据值。

• 一个 Vega 表达式，在用户交互时重新评估。如果表达式评估为 True，则数据值被切换（添加到或从）点选。如果表达式评估为 False，则首先清除点选，然后插入数据值。例如，将值设置为 Vega 表达式 True 将在用户不按 Shift 键的情况下切换数据值。

nearestbool（可选）

当为 True 时，计算一个不可见的 Voronoi 图以加速离散选择。最接近鼠标光标的数据值被添加到选择中。默认值为 False，这意味着必须直接交互（例如，点击）数据值才能将其添加到选择中。

**kwdsAny

控制选择的额外关键字参数。

返回:

parameter: Parameter

可在图表创建中使用的参数对象。