Polyv Help Center

Help Center

ProductList - Product List Component

Updated: 2025-09-05 09:41:51

Introduction

The Product List component is used to display the core list functionality of a product showcase. It supports product search, category filtering, pagination loading, order entry, and other complete product display and management features.

It includes three exported components:

  • ProductList - Product list page component
  • ProductItem - Product card component
  • ProductListPopup - Product list popup component

Import Methods

UMD Import

Using the product-list-popup component as an example, where rc-20250814 is the current version number. Please import according to the actual version number.

<script src="https://websdk.videocc.net/product-ui/rc-20250814/product-list-popup.umd.js"></script>

<script>
const ProductListPopup = window.PolyvProductUIProductListPopup;
</script>

NPM Import

pnpm add @polyv/product-ui

import { ProductList, ProductItem, ProductListPopup } from '@polyv/product-ui';

Usage Examples

Basic Usage

<template>
  <ProductListPopup
    ref="productListInnerPopupRef"
    :product-target="productTarget"
    :payment-target="paymentTarget"
    :product-config="productUIConfig"
    @not-support-direct-buy="handleNotSupportDirectBuy"
  />
</template>

<script setup lang="ts">
import { ProductListPopup } from '@polyv/product-ui';

const productListInnerPopupRef = ref();

const productTarget = ref<Product>();
const paymentTarget = ref<Payment>();

const productUIConfig = ref({
  productPayOrderEnabled: true,
  directBuyEnabled: true,
});

function handleNotSupportDirectBuy() {
  // 不支持直接购买时的处理,例如弹出一个提示框
}
</script>

API

ProductList Props

Parameter Description Type Default
productTarget Product module instance Product -
productConfig Product configuration ProductConfig -
showClose Whether to show the close button (PC) boolean false

ProductList Events

Event Name Description Callback Parameters
open-position-detail Open position details (product: ProductData)

ProductList Methods

Method Name Description Parameters Return Value
refreshProductList Refresh the product list - void
scrollToTop Scroll to the top - void

ProductListPopup Props

Parameter Description Type Default
modelValue Popup display state boolean false
productTarget Product module instance Product -
productConfig Product configuration ProductConfig -

ProductListPopup Events

Event Name Description Callback Parameters
update:modelValue Update popup display state (visible: boolean)
open-position-detail Open position details (product: ProductData)

ProductItem Props

Parameter Description Type Default
product Product data ProductData -
productTarget Product module instance Product -
productConfig Product configuration ProductConfig -
isSmallSize Whether in small size mode boolean false

ProductItem Events

Event Name Description Callback Parameters
direct-buy Direct purchase (product: ProductData)
open-position-detail Open position details (product: ProductData)
联系客服,在线咨询
在线咨询