SegmentSelector
Use the SegmentSelector as a top-level filter to narrow data by segment,
setting the scope for any additional filters applied alongside it.
When to use
- To filter data by predefined segment and set the scope for additional filters applied alongside it.
- When users need to switch between distinct data views, such as different environments or applications.
When not to use
- For open-ended filtering by attribute or value. Use
FilterBarorFilterFieldinstead.
Position
If SegmentSelector is part of a larger filter composition, for example,
combined with a FilterField or FilterBar, place it as the first element so
users select a segment before applying other filters.
Variants
SegmentSelector comes in two variants that control how much information the
trigger shows.
Default
Use the default variant if the trigger has enough space to grow without breaking the layout. It provides context when one segment is selected and keeps a consistent width when multiple segments are selected.
Compact
Use the compact variant if the trigger needs to keep a predictable width and space is limited.
When to apply changes
With external apply button
If SegmentSelector is part of a filter composition, changes are applied to the
dataset immediately each time data is fetched — no additional action is needed.
Without external apply button
If SegmentSelector is standalone or part of a filter composition without an
apply button, apply changes when the apply button in the SegmentSelector
overlay is pressed.