保利威文档中心

幫助中心

地址編輯

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