PowerSearch is a structured filter bar where each token represents a field, operator, and value. Use it for complex multi-dimensional filtering when users need to combine multiple search criteria. For simple single-field search, use a text input instead.
ts
| Guidance | Practices |
|---|---|
| Do | Define clear, descriptive field names and aliases so users can quickly find the filter they need. |
| Do | Provide a result count to give users feedback on how their filters affect the data set. |
| Don't | Use PowerSearch for simple keyword searches; a standard text input is more appropriate for single-field lookups. |
Power search with contentSearchFieldKey so free-text input maps to a title field automatically.
Power search with multiple field types: enum, multi-select, entity, and text filters.
Power search initialized with pre-set filter tokens for status and priority.
Composition of PowerSearch with Table using usePowerSearchConfig to auto-generate config and filter data.