pattern-library checked
Carbon Design System Filtering Pattern
Documents filtering as adding or removing predefined attributes from data sets, including multi-category filters, batch versus instant updates, visible applied-filter indicators, and reset behavior.
Pattern Decisions This Source Supports
| Pattern | Supported decision | Required contract | Claim note |
|---|---|---|---|
| Faceted search | Choose faceted search when users need to progressively narrow a large set by multiple attributes. | Applying or removing a facet updates the result count and preserves visible applied filters. | Carbon filtering guidance supports multi-category filters, batch or instant updates, visible applied-filter indicators, and reset behavior. |
| Filter panel | Choose a filter panel when users need grouped controls for narrowing the current result set by several criteria. | Each filter category has a clear label and contains controls appropriate to the value type, such as checkboxes, radios, ranges, date fields, or text fields. | Carbon filtering guidance documents multiple categories, batch versus instant updates, hidden filter indicators, and reset behavior. |
| Filter reset that clears unrelated search | Flag this anti-pattern when a filter reset clears or changes query text, submitted search, search scope, saved search identity, search history, sort order, page size, view mode, selected rows, or route context that is not visibly part of the filters. | Every reset control names the state it changes. | Documents filtering reset behavior, batch and instant update models, hidden active indicators, and reset scope. |
Evidence Role
This source is treated as pattern-library evidence. Use it to validate the decision rules above, not as a visual style reference.
Publisher: IBM Carbon Design System. Last checked: .