地址列表
更新时间: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 |
