保利威文档中心

帮助中心

ProductList - 商品列表组件

更新时间:2025-09-05 09:41:51

简介

商品列表组件用于展示商品橱窗的核心列表功能,支持商品搜索、分类筛选、分页加载、订单入口等完整的商品展示和管理功能。

包含三个导出组件:

  • ProductList - 商品列表页面组件
  • ProductItem - 商品卡片组件
  • ProductListPopup - 商品列表弹窗组件

引入方式

UMD 引入

product-list-popup 组件为例,其中 rc-20250814 为当前版本号,请根据实际版本号进行引入。

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

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

NPM 引入

pnpm add @polyv/product-ui

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

使用示例

基础用法

<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

参数 说明 类型 默认值
productTarget 商品模块实例 Product -
productConfig 商品配置 ProductConfig -
showClose 是否显示关闭按钮(PC端) boolean false

ProductList Events

事件名 说明 回调参数
open-position-detail 打开职位详情 (product: ProductData)

ProductList Methods

方法名 说明 参数 返回值
refreshProductList 刷新商品列表 - void
scrollToTop 滚动到顶部 - void

ProductListPopup Props

参数 说明 类型 默认值
modelValue 弹窗显示状态 boolean false
productTarget 商品模块实例 Product -
productConfig 商品配置 ProductConfig -

ProductListPopup Events

事件名 说明 回调参数
update:modelValue 更新弹窗显示状态 (visible: boolean)
open-position-detail 打开职位详情 (product: ProductData)

ProductItem Props

参数 说明 类型 默认值
product 商品数据 ProductData -
productTarget 商品模块实例 Product -
productConfig 商品配置 ProductConfig -
isSmallSize 是否小尺寸模式 boolean false

ProductItem Events

事件名 说明 回调参数
direct-buy 直接购买 (product: ProductData)
open-position-detail 打开职位详情 (product: ProductData)
联系客服,在线咨询