Interface CoreFacetOptions

interface CoreFacetOptions {
    facetId?: string;
    facetSearch?: FacetSearchOptions;
    field: string;
    filterFacetCount?: boolean;
    injectionDepth?: number;
    numberOfValues?: number;
    resultsMustMatch?: FacetResultsMustMatch;
    sortCriteria?: FacetSortCriterion;
    tabs?: { excluded?: string[]; included?: string[] };
}

Hierarchy (View Summary)

Properties

facetId? facetSearch? field filterFacetCount? injectionDepth? numberOfValues? resultsMustMatch? sortCriteria? tabs?

Properties

OptionalfacetId

facetId?: string

A unique identifier for the controller. By default, a random unique identifier is generated.

OptionalfacetSearch

facetSearch?: FacetSearchOptions

Facet search options.

field

field: string

The field whose values you want to display in the facet.

OptionalfilterFacetCount

filterFacetCount?: boolean

Whether to exclude the parents of folded results when estimating the result count for each facet value.

Default Value

true

OptionalinjectionDepth

injectionDepth?: number

The maximum number of results to scan in the index to ensure that the facet lists all potential facet values.

Note: A high injectionDepth may negatively impact the facet request performance.

Minimum: 0

Default Value

1000

OptionalnumberOfValues

numberOfValues?: number

The number of values to request for this facet. Also determines the number of additional values to request each time this facet is expanded, and the number of values to display when this facet is collapsed.

Minimum: 1

Default Value

8

OptionalresultsMustMatch

resultsMustMatch?: FacetResultsMustMatch

The criterion to use for specifying how results must match the selected facet values.

Default Value

atLeastOneValue

OptionalsortCriteria

sortCriteria?: FacetSortCriterion

The criterion to use for sorting returned facet values.

The sortCriteria option does not apply when making a facet search request. It is only used for sorting returned facet values during a regular Coveo search request.

Learn more about sortCriteria values and the default behavior of specific facets in the Search API documentation.

Default Value

automatic

Optionaltabs

tabs?: { excluded?: string[]; included?: string[] }

The tabs on which the facet should be enabled or disabled.

Settings

Member Visibility

On This Page

Properties