保利威文档中心

帮助中心

地址列表

更新时间: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
联系客服,在线咨询