保利威文档中心

帮助中心

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