保利威文档中心

幫助中心

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)
联系客服,在线咨询