Interface ProductListing

The ProductListing controller exposes a method for retrieving product listing content in a commerce interface.

Example: product-listing.fn.tsx

interface ProductListing {
    state: ProductListState;
    breadcrumbManager(): BreadcrumbManager;
    executeFirstRequest(): void;
    facetGenerator(): FacetGenerator;
    interactiveProduct(props: InteractiveProductProps): InteractiveProduct;
    pagination(props?: PaginationProps): Pagination;
    parameterManager(
        props?: ParameterManagerProps<Parameters>,
    ): ParameterManager<Parameters>;
    promoteChildToParent(child: ChildProduct): void;
    refresh(): void;
    sort(props?: SortProps): Sort;
    subscribe(listener: () => void): Unsubscribe;
    summary(): Summary<ProductListingSummaryState>;
    urlManager(props: UrlManagerProps): UrlManager;
}

Hierarchy (View Summary)

Methods

breadcrumbManager executeFirstRequest facetGenerator interactiveProduct pagination parameterManager promoteChildToParent refresh sort subscribe summary urlManager

Properties

state

Methods

breadcrumbManager

  • breadcrumbManager(): BreadcrumbManager

  • Creates a BreadcrumbManager sub-controller.

    Returns BreadcrumbManager

    A BreadcrumbManager sub-controller.

executeFirstRequest

  • executeFirstRequest(): void

  • Executes the first request if it has not been executed yet.

    Returns void

facetGenerator

  • facetGenerator(): FacetGenerator

  • Creates a FacetGenerator sub-controller.

    Returns FacetGenerator

    A FacetGenerator sub-controller.

interactiveProduct

  • interactiveProduct(props: InteractiveProductProps): InteractiveProduct

  • Creates an InteractiveProduct sub-controller.

    Parameters

    Returns InteractiveProduct

    An InteractiveProduct sub-controller.

pagination

  • pagination(props?: PaginationProps): Pagination

  • Creates a Pagination sub-controller.

    Parameters

    • Optionalprops: PaginationProps

      The optional properties for the Pagination sub-controller.

    Returns Pagination

    A Pagination sub-controller.

parameterManager

promoteChildToParent

  • promoteChildToParent(child: ChildProduct): void

  • Finds the specified parent product and the specified child product of that parent, and makes that child the new parent. The children and totalNumberOfChildren properties of the original parent are preserved in the new parent.

    This method is useful when leveraging the product grouping feature to allow users to select nested products.

    E.g., if a product has children (such as color variations), you can call this method when the user selects a child to make that child the new parent product, and re-render the product as such in the storefront.

    Note: In the controller state, a product that has children will always include itself as its own child so that it can be rendered as a nested product, and restored as the parent product through this method as needed.

    Parameters

    • child: ChildProduct

      The child product that will become the new parent.

    Returns void

refresh

  • refresh(): void

  • Fetches the product listing.

    Returns void

sort

  • sort(props?: SortProps): Sort

  • Creates a Sort sub-controller.

    Parameters

    • Optionalprops: SortProps

      Optional properties for the Sort sub-controller.

    Returns Sort

    A Sort sub-controller.

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.

summary

urlManager

  • urlManager(props: UrlManagerProps): UrlManager

  • Creates a UrlManager sub-controller with the specified properties.

    Parameters

    • props: UrlManagerProps

      Properties for the UrlManager sub-controller.

    Returns UrlManager

    A UrlManager sub-controller.

Properties

state

state: ProductListState

A scoped and simplified part of the headless state that is relevant to the ProductListing controller.

Settings

Member Visibility

On This Page

Methods
Properties