UnreviewedfacetsOptional UnreviewedplacementPreferred placement of the root filter menu relative to its trigger. The menu auto-flips vertically and clamps horizontally when needed.
Optional UnreviewedoffsetGap in pixels between the trigger and the filter menu.
Optional UnreviewedvalueControlled value record, keyed by facet. When provided, update it through
onValueChange. Leave it undefined for uncontrolled use.
Optional UnrevieweddefaultInitial value for uncontrolled use.
Optional UnreviewedonFires after any facet changes. value is the whole new record (a facet key →
that facet's value; a cleared facet is absent). attrs says what changed:
{ facet, kind, value } for a single facet edit, or { all: true } for the
"Clear all" row — narrow on 'all' in attrs before reading facet.
Optional UnreviewedlabelDefault trigger's button label.
Optional UnreviewediconDefault trigger's leading icon.
Optional UnreviewedsizeDefault trigger's button size.
Optional UnreviewedpriorityDefault trigger's button priority.
Optional UnrevieweddisabledDisable the whole control.
Optional UnreviewedtoneDefault option-row tone in facet flyouts. An option's own tone wins.
Optional UnreviewedtoneApply the default row tone in every state, or only to selected rows. An
option's own toneScope wins.
Optional UnreviewedsearchableAdds a search field at the top of the root menu. It searches the options of
every single and multiple facet in one list. For example, "alice" can
appear under application-defined Assignee and Owner facets. text and
custom facets remain available when the search is empty. Each facet uses
its filter function when supplied, or the built-in substring match.
Optional UnreviewedsearchPlaceholder for the global search field.
Optional UnreviewedclearableShow the per-facet "Clear" row and the "Clear all" row.
Optional UnreviewedclearLabel for the "Clear all" row.
Optional UnreviewedrenderReplaces the default Button with a trigger returned from this function.
Receives a SelectFacetedTriggerState. Return exactly one focusable element:
the menu is positioned relative to that element and opens when it is clicked.
Add aria-haspopup={searchable ? 'dialog' : 'menu'} and
aria-expanded={state.open} to the returned element, on a role that
supports them (an Anta Button already carries role="button"; otherwise
add role="combobox"). className, style, and other trigger props apply
only to the default Button, so add styling and attributes to the returned
element.
Optional UnreviewedclassCSS class on the component's root element (merged with the component's own
classes). Use it directly for layout and positioning — grid/flex placement,
margins, alignment — rather than wrapping the component in a <div>/<span>.
Optional UnreviewedstyleInline styles on the component's root element. Set layout/positioning here
(or via className) directly on the component instead of adding a wrapper.
Optional UnreviewedidHTML id attribute.
Optional UnreviewedtitleHTML title attribute — native browser tooltip on hover.
Optional UnreviewedslotAssigns the element to a named <slot> of a parent web component (e.g.
slot="header" inside a <Card>, slot="footer" inside a <Dialog>).
Optional UnreviewedtabTab order. Set to -1 to skip the element when tabbing.
Optional UnreviewedkeyReact/Preact reconciliation key when rendered inside a list. Consumed by the JSX runtime (not forwarded as a DOM attribute).
Categories to filter by. Each facet has a
kindthat determines its editor.