Skip to main content

useFilterOptions

This hook provides access to the filter selection state and actions for the product list filter UI. It allows selecting, removing, and clearing filters.

Import

import { useFilterOptions } from '@appmaker-xyz/shopify';

Basic Usage

const {
selectedFilters,
selectFilter,
removeFilter,
clearSelectedFilters,
isFilterSelected,
hasAnyFilterSelected,
priceRange,
} = useFilterOptions();

Return Value

PropertyTypeDescription
selectedFiltersObjectCurrently selected filters keyed by filter key and value ID.
priceRangeObjectCurrent price range filter state.
selectFilterFunctionSelects a filter option. Signature: selectFilter(filterKey, filterValueId, filterValue).
removeFilterFunctionRemoves a filter option. Signature: removeFilter(filterKey, filterValueId).
getSelectedFiltersFunctionReturns the current selected filters object.
isFilterSelectedFunctionChecks if a specific filter is selected.
clearSelectedFiltersFunctionClears all selected filters.
hasAnyFilterSelectedFunctionReturns whether any filter is currently selected.