商品详情
更新时间:2025-09-05 09:41:51
介绍
商品详情组件用于展示商品的详细信息,包括商品封面(图片/视频)、商品信息、购买按钮等功能。组件支持素材库视频播放、图片轮播、商品信息展示等功能。
商品详情提供以下组件:
ProductDetail- 商品详情页面组件ProductDetailPopup- 商品详情弹窗组件
引入
UMD 方式
其中 rc-20250814 为当前版本号,请根据实际版本号进行引入。
<script src="https://websdk.videocc.net/product-ui/rc-20250814/product-detail-popup.umd.js"></script>
<script>
const ProductDetailPopup = window.PolyvProductUIProductDetailPopup;
</script>
NPM 方式
// 安装依赖
pnpm add @polyv/product-ui
// 引入组件
import { ProductDetail, ProductDetailPopup } from '@polyv/product-ui';
代码示例
<template>
<div>
<ProductDetailPopup
ref="productDetailRef"
:product-target="productSDK"
:product-config="productConfig"
@direct-buy="onDirectBuy"
@not-support-direct-buy="onNotSupportDirectBuy"
/>
</div>
</template>
<script setup>
import { ProductDetailPopup } from '@polyv/product-ui';
import { Product } from '@polyv/product-sdk';
// 初始化商品 SDK
const productSDK = new Product(interactionCore, config);
const productDetailRef = ref();
const productConfig = {
// 商品配置
};
// 直接购买处理
const onDirectBuy = (productData) => {
console.log('直接购买:', productData);
};
// 不支持直接购买处理
const onNotSupportDirectBuy = (productData) => {
console.log('不支持直接购买:', productData);
};
// 打开商品详情
const openProductDetail = (productId) => {
productDetailRef.value?.open(productId);
};
// 关闭商品详情
const closeProductDetail = () => {
productDetailRef.value?.close();
};
</script>
API
ProductDetailPopup Props
| 参数 | 说明 | 类型 | 默认值 | 必填 |
|---|---|---|---|---|
| productTarget | 商品 SDK 实例 | Product |
- | 是 |
| productConfig | 商品配置 | ProductConfig |
- | 否 |
ProductDetailPopup Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| direct-buy | 直接购买时触发 | (productData: ProductData) => void |
| not-support-direct-buy | 不支持直接购买时触发 | (productData: ProductData) => void |
ProductDetailPopup 方法
通过 ref 可以调用组件的方法:
| 方法名 | 说明 | 参数 | 返回值 |
|---|---|---|---|
| open | 打开商品详情 | (productId: number) => void |
- |
| close | 关闭商品详情 | - | - |
ProductDetail Props
| 参数 | 说明 | 类型 | 默认值 | 必填 |
|---|---|---|---|---|
| productTarget | 商品 SDK 实例 | Product |
- | 是 |
| productConfig | 商品配置 | ProductConfig |
- | 否 |
| productId | 商品ID | number |
- | 是 |
ProductDetail Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| direct-buy | 直接购买时触发 | (productData: ProductData) => void |
| not-support-direct-buy | 不支持直接购买时触发 | (productData: ProductData) => void |
ProductDetail 方法
通过 ref 可以调用组件的方法:
| 方法名 | 说明 | 参数 | 返回值 |
|---|---|---|---|
| init | 初始化商品详情 | (productId: number) => Promise<void> |
- |
