保利威文档中心

幫助中心

地址列表

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

介紹

地址列表元件用於展示和管理收貨地址,支援地址選擇、編輯、刪除等操作。元件支援分頁載入,提供地址卡片展示和操作按鈕。

引入

UMD 方式

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

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

<script>
const AddressList = window.PolyvProductUIAddressList;
</script>

NPM 方式

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

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

程式碼範例

<template>
  <div>
    <AddressList
      :address-target="addressSDK"
      :address-id="selectedAddressId"
      @add-address="onAddAddress"
      @choose-address="onChooseAddress"
      @edit-address="onEditAddress"
      @clear-address="onClearAddress"
    />
  </div>
</template>

<script setup>
import { AddressList } from '@polyv/product-ui';
import { Address } from '@polyv/product-sdk';

// 初始化地址 SDK
const addressSDK = new Address(interactionCore, config);
const selectedAddressId = ref();

// 事件处理
const onAddAddress = () => {
  console.log('添加地址');
};

const onChooseAddress = (address) => {
  console.log('选择地址:', address);
  selectedAddressId.value = address?.id;
};

const onEditAddress = (address) => {
  console.log('编辑地址:', address);
};

const onClearAddress = () => {
  console.log('清空地址');
  selectedAddressId.value = undefined;
};
</script>

API

AddressList Props

參數 說明 型別 預設值 必填
addressTarget 地址 SDK 實例 Address -
addressId 選中的地址ID number undefined

AddressList Events

事件名 說明 回呼參數
add-address 新增地址時觸發 () => void
choose-address 選擇地址時觸發 (address: AddressData | undefined) => void
edit-address 編輯地址時觸發 (address: AddressData) => void
clear-address 清空地址時觸發 () => void
联系客服,在线咨询