Interface AutomaticFacet

The AutomaticFacet controller allows you to create a search interface component that the end user can interact with to refine a query by selecting filters based on item metadata (i.e., field values). Unlike regular facets that need to be explicitly defined and requested in the query, automatic facets are dynamically generated by the index in response to the query.

To learn more about the automatic facet generator feature, see: About the Facet Generator.

interface AutomaticFacet {
    state: AutomaticFacetState;
    deselectAll(): void;
    subscribe(listener: () => void): Unsubscribe;
    toggleSelect(selection: FacetValue): void;
}

Hierarchy (View Summary)

Controller
- AutomaticFacet

Index

Methods

deselectAll subscribe toggleSelect

Properties

state

Methods

deselectAll

deselectAll(): void
Deselects all automatic facet values.

Returns void
- Defined in packages/headless/src/controllers/facets/automatic-facet-generator/headless-automatic-facet-generator.ts:109

subscribe(listener: () => void): Unsubscribe
Adds a callback that's invoked on state change.
Parameters
- listener: () => void
  A callback that's invoked on state change.
Returns Unsubscribe
A function to remove the listener.
Inherited from Controller.subscribe
- Defined in packages/headless/src/controllers/controller/headless-controller.ts:11

toggleSelect

toggleSelect(selection: FacetValue): void
Toggles the specified automatic facet value.
Parameters
- selection: FacetValue
  The facet value to toggle.
Returns void
- Defined in packages/headless/src/controllers/facets/automatic-facet-generator/headless-automatic-facet-generator.ts:105

Properties

state

state: AutomaticFacetState

The state of the AutomaticFacet controller.

Interface AutomaticFacet

Hierarchy (View Summary)

Index

Methods

Properties

Methods

deselectAll

Returns void

Parameters

Returns Unsubscribe

toggleSelect

Parameters

Returns void

Properties

state

Settings

On This Page