(constructor)(appService, filterHelper, filterStore, domHelper, filterService)

Constructs a new instance of the FilterHandler class

handleCloseQuickAddToCart

(target: any) => void

Handles closing the quick add to cart popup.

Hides the quick add to cart option selection popup and returns focus to the select option button for accessibility. Override this method to customize close behavior or add cleanup logic when the popup closes.

calcPageAction(currentPage, action)

protected

Calculates the new page number based on action.

Determines the target page number from pagination actions like 'prev', 'next', or direct page number strings. Ensures page numbers don't go below 1. Override this method to add custom page calculation logic, such as skipping pages or implementing custom pagination behaviors.

getIndexOfProductItem(targetItem)

protected

Gets the index of a product item within the product list.

Searches through all product items in the boost-sd__product-list container to find the index position of the specified target item. This is used for pagination calculations and analytics tracking. Override this method to customize how product indices are determined (e.g., filtering out specific items).

handleAction(key, action, target)

Routes individual action types to their corresponding event handlers.

Central action dispatcher that emits appropriate EVENT_NAMES events based on the action type. This is called by handleMetadataActions and handleActionMapping to process both legacy metadata actions and action mapping system actions. Override this method to intercept specific action types or add custom action handling logic.

handleActionMapping(target)

protected

Handles action mapping system for legacy filter tree actions.

Maps data-action attributes to their corresponding handler functions stored in the actionMapping state. This legacy system uses attributes in the format "key.id" to look up action handlers. Override this method to customize action mapping lookup logic or add preprocessing for mapped actions.

handleClickOutsideLimitList(target)

Handles clicks outside the limit list dropdown to close it

handleClickOutsideMiniPopup(target)

Handles clicks outside the quick add to cart mini popup to close it.

Closes any open quick cart selection popup when clicking outside of it, except when clicking the select option button itself. This provides a better user experience by allowing easy dismissal of the popup. Override this method to customize popup closing behavior or add additional close triggers.

handleClickOutsideSort(target)

Handles clicks outside the sort dropdown to close it

handleClickProductItem(target)

Handles click events on product items in the product list.

This method processes product item clicks, handling special cases like banner links, embedded bundles, volume bundles, and wishlist buttons. For standard product clicks, it constructs the product detail URL with variant information and navigates to it, while also tracking the selected product page for analytics. Override this method to customize product click behavior or add shop-specific tracking.

handleCoreClick(event)

handleCoreMousedown(event)

Handles mousedown events on product items to update anchor hrefs to canonical URLs.

This ensures that right-click → "Open in new tab" uses the canonical product URL (without collection path) rather than the original href. The mousedown event fires before both left-click and the right-click context menu, so the href is updated in time for the browser to use it.

handleLimitListOptionClick(target)

Handles clicking on a limit list option Updates the limit, saves to local storage, and resets filter to apply new limit

handleMetadataActions(actions, target)

protected

Handles metadata actions from data-metadata attributes.

Routes legacy metadata actions from DOM elements to appropriate event handlers. This supports the legacy filter tree system where elements have data-metadata attributes containing action configuration objects. Each action type triggers a corresponding EVENT_NAMES event. Override this method to add custom action types or modify action routing logic.

handlePagination(target)

Handles pagination click events Determines the new page based on the clicked element and triggers pagination action

handleSort(target, originalEvent)

Handles sort dropdown interaction and state changes.

Manages the sort dropdown UI state and processes sort option selection. Handles opening/closing the dropdown, selecting sort options, and triggering filter resets when sort changes. Override this method to customize sort behavior or add validation logic for specific sort options.

handleToggleShowLimitList(target)

Handles toggling the limit list dropdown Manages show/hide state and triggers UI update

handleViewAsClick(target)

Handles clicking on a view-as icon (grid/list view toggle) Updates the viewAs setting and triggers filter refresh

trackSelectedProductPage(index, productId)

Tracks the selected product page for analytics and session storage.

Calculates and stores the actual page number where a product was selected, accounting for different pagination types (default, load_more, infinite_scroll). This information is used for maintaining user context when returning from product detail pages. Override this method to customize page tracking logic or add additional analytics tracking.

updateLimitListUI()

Updates the limit list dropdown UI based on current state This should be called when LIMIT_LIST_CHANGED event is emitted

updateSortUI()

Updates the sort dropdown UI based on current state This should be called when SORT_CHANGED event is emitted