地址编辑
更新时间:2025-09-05 09:41:51
介绍
地址编辑组件用于收货地址的新增和编辑功能,支持姓名、手机号、地区选择、详细地址等信息的录入和验证。组件内置表单验证功能,支持自定义验证规则。
引入
UMD 方式
其中 rc-20250814 为当前版本号,请根据实际版本号进行引入。
<script src="https://websdk.videocc.net/product-ui/rc-20250814/address-edit.umd.js"></script>
<script>
const AddressEdit = window.PolyvProductUIAddressEdit;
</script>
NPM 方式
// 安装依赖
pnpm add @polyv/product-ui
// 引入组件
import { AddressEdit } from '@polyv/product-ui';
代码示例
<template>
<div>
<AddressEdit
:form-list="formList"
:disabled-submit="loading"
:submit-action="handleSubmit"
/>
</div>
</template>
<script setup>
import { AddressEdit } from '@polyv/product-ui';
import { AddressEditFormType } from '@polyv/product-ui';
// 表单配置
const formList = [
{
formType: AddressEditFormType.Input,
title: '姓名',
placeholder: '请输入姓名',
isRequired: true,
value: '',
},
{
formType: AddressEditFormType.Phone,
title: '手机号',
placeholder: '请输入手机号',
isRequired: true,
value: '',
},
{
formType: AddressEditFormType.Area,
title: '',
placeholder: '请选择地区',
isRequired: true,
value: '',
},
{
formType: AddressEditFormType.Address,
title: '',
placeholder: '请输入详细地址',
isRequired: true,
value: '',
},
];
const loading = ref(false);
// 提交处理
const handleSubmit = async (formData) => {
loading.value = true;
try {
// 处理提交逻辑
console.log('表单数据:', formData);
} finally {
loading.value = false;
}
};
</script>
API
Props
| 参数 | 说明 | 类型 | 默认值 | 必填 |
|---|---|---|---|---|
| formList | 表单配置列表 | AddressEditFormItem[] |
- | 是 |
| disabledSubmit | 是否禁用提交按钮 | boolean |
false |
否 |
| submitAction | 提交操作函数 | (formValue: Record<number, any>) => Promise<void> |
- | 是 |
表单类型 AddressEditFormType
| 值 | 说明 |
|---|---|
| Input | 普通输入框 |
| Phone | 手机号输入框 |
| Area | 地区选择器 |
| Address | 详细地址输入框 |
AddressEditFormItem
| 属性 | 说明 | 类型 | 必填 |
|---|---|---|---|
| formType | 表单类型 | AddressEditFormType |
是 |
| title | 表单标题 | string |
是 |
| placeholder | 占位符 | string |
是 |
| isRequired | 是否必填 | boolean |
是 |
| value | 已填写的值 | string | null |
是 |
