---
title: Segments
description: Show one select filter as a row of buttons.
---

`segments(binding, options?)` displays a registered select filter. The filter
bar must contain exactly one select filter with `one` cardinality. The value
`all` is reserved for the control that clears the filter.

<BacklitExample path="segments/basic" view="list" />

The options `counts`, `tones`, and `labels` are maps keyed by a select option
value or `all`. Counts come from the resolver. Labels replace the corresponding
option label. Tones describe the meaning of each count.

The binding determines whether a change refreshes the view or one zone.
Read the selected value with `ctx.parse(scope)`. Apply it to the query yourself.
