Interface CategoryFieldSuggestions

The CategoryFieldSuggestions controller provides query suggestions based on a particular category facet field.

For example, you could use this controller to provide auto-completion suggestions while the end user is typing an item category.

This controller is a wrapper around the basic category facet controller search functionality, and thus exposes similar options and properties.

interface CategoryFieldSuggestions {
    state: CategoryFieldSuggestionsState;
    type: "hierarchical";
    clear(): void;
    search(): void;
    select(value: CategoryFieldSuggestionsValue): void;
    subscribe(listener: () => void): Unsubscribe;
    updateText(text: string): void;
}

Hierarchy (View Summary)

Controller
FacetControllerType<"hierarchical">
- CategoryFieldSuggestions

Index

Methods

clear search select subscribe updateText

Properties

Methods

clear

clear(): void
Resets the query and empties the suggestions.

Returns void
- Defined in packages/headless/src/controllers/commerce/field-suggestions/headless-category-field-suggestions.ts:79

search

search(): void
Requests field suggestions based on a query.

Returns void
- Defined in packages/headless/src/controllers/commerce/field-suggestions/headless-category-field-suggestions.ts:65

select

select(value: CategoryFieldSuggestionsValue): void
Filters the search using the specified value.

If a facet exists with the configured facetId, selects the corresponding facet value.
Parameters
- value: CategoryFieldSuggestionsValue
  The field suggestion to select.
Returns void
- Defined in packages/headless/src/controllers/commerce/field-suggestions/headless-category-field-suggestions.ts:74

subscribe

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

updateText

updateText(text: string): void
Requests field suggestions based on a query.
Parameters
- text: string
  The query with which to request field suggestions.
Returns void
- Defined in packages/headless/src/controllers/commerce/field-suggestions/headless-category-field-suggestions.ts:60

Properties

state

state: CategoryFieldSuggestionsState

type

type: "hierarchical"