保利威文档中心

幫助中心

商品按鈕

更新時間:2025-09-05 09:41:51

介紹

商品按鈕元件封裝了商品購買的一系列邏輯,包括禁用狀態、各種購買資格校驗等。

商品按鈕提供以下元件:

  • ProductButton - 商品操作按鈕元件
  • ProductIframeLinkPopup 一個包含 iframe 內容的彈層元件

引入

UMD 方式

其中 rc-20250814 為當前版本號,請根據實際版本號進行引入。

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

<script>
const ProductButton = window.PolyvProductUIProductButton;
const ProductIframeLinkPopup = window.PolyvProductUIProductIframeLinkPopup;
</script>

NPM 方式

// 安装依赖
pnpm add @polyv/product-ui

// 引入组件
import { ProductButton, ProductIframeLinkPopup } from '@polyv/product-ui';

程式碼範例

<template>
  <div>
    <!-- 商品按钮 -->
    <ProductButton
      :product-target="productSDK"
      :product-config="productConfig"
      :product-data="productData"
      :disabled="false"
      @direct-buy="onDirectBuy"
    >
      <template #default="{ buttonText, disabled }">
        <button
          class="custom-product-button"
          :disabled="disabled"
        >
          {{ buttonText }}
        </button>
      </template>
    </ProductButton>

    <!-- iframe 链接弹窗 -->
    <ProductIframeLinkPopup />
  </div>
</template>

<script setup>
import { ProductButton, ProductIframeLinkPopup } from '@polyv/product-ui';
import { Product } from '@polyv/product-sdk';

// 初始化商品 SDK
const productSDK = new Product(interactionCore, config);

const productData = ref({
  productId: 1,
  name: '测试商品',
  // ... 其他商品数据
});

const productConfig = {
  // 自定义点击处理函数
  customClickButtonHandler: (product) => {
    console.log('自定义点击处理:', product);
  },
  // 获取链接参数
  getLinkParams: (url) => {
    return { utm_source: 'live' };
  },
  // 自定义禁用逻辑
  customProductDisabled: (product) => {
    return product.stock === 0;
  },
};

// 直接购买处理
const onDirectBuy = (productData) => {
  console.log('直接购买:', productData);
  // 处理购买逻辑
};
</script>

API

ProductButton Props

參數 說明 類型 預設值 必填
productTarget 商品 SDK 實例 Product -
productConfig 商品配置 ProductConfig -
productData 商品資料 ProductData -
disabled 是否禁用按鈕 boolean false

ProductButton Events

事件名 說明 回調參數
direct-buy 直接購買時觸發 (productData: ProductData) => void

ProductButton Slots

插槽名 說明 插槽參數
default 自訂按鈕內容 { buttonText: string, disabled: boolean }

ProductConfig 配置

屬性 說明 類型
customClickButtonHandler 自訂點擊處理函式 (product: ProductData) => void
getLinkParams 取得連結參數函式 (url: string) => Record<string, unknown>
customProductDisabled 自訂禁用邏輯 (product: ProductData) => boolean
isPreviewMode 是否預覽模式 boolean

商品類型

類型 說明 預設按鈕文字
Normal 一般商品 立即購買
Finance 金融商品 立即諮詢
Position 職位商品 立即投遞
联系客服,在线咨询