Selector

Selectors enable you to toggle between multiple different traces in your chart.

Tip

Selectors can also be used to add interactivity between charts different tables. You can read more about using selectors to add interactivity here.

You can configure selectors to be single select or multi-select. Single select is great if you only want to show a single trace at a time on the chart while the multi-select can be really useful for providing filtering capabilities.

Example

Here's how you might use selectors to create interactivity between two different charts.

charts:
    - name: Chart One
      selector:
          name: Common Selector
          type: single
          ...
    - name: Chart Two
      selector: ref(Common Selector)
      ...

Attributes

Field	Type	Default	Description
path	string	None	A unique path to this object
name	string	None	The unique name of the object across the entire project.
type		multiple	Single or multiple selector
options	array	[]	Optional set of traces, items, or rows to create the choices list