@coveo/headless-react
    Preparing search index...

    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.

    Example: category-suggestions.fn.tsx

    interface CategoryFieldSuggestions {
        state: CategoryFieldSuggestionsState;
        clear(): void;
        search(): void;
        select(value: CategoryFieldSuggestionsValue): void;
        showMoreResults(): void;
        subscribe(listener: () => void): Unsubscribe;
        updateCaptions(captions: Record<string, string>): void;
        updateText(text: string): void;
    }

    Hierarchy (View Summary)

    Index

    Methods

    • Resets the query and empties the suggestions.

      Returns void

    • Requests field suggestions based on a query.

      Returns void

    • Filters the search using the specified value.

      If a facet exists with the configured facetId, selects the corresponding facet value.

      Parameters

      Returns void

    • Shows more field suggestions for the current query.

      Returns void

    • 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.

    • Updates the captions of field suggestions.

      Parameters

      • captions: Record<string, string>

        A dictionary that maps field values to field suggestion display names.

      Returns void

    • Requests field suggestions based on a query.

      Parameters

      • text: string

        The query with which to request field suggestions.

      Returns void

    Properties