华玥组件库

中文

English

中文

English

Appearance

FormGroup 表单组件 ​

此组件一般用于快速搭建表单场景，可以配置Input输入框，Select弹出框，进行表单验证等。

温馨提示

本项目参考了 uView-Plus 开源项目的组件开发方式，基于 Vue 3 和 TypeScript 实现了自定义组件。目前该组件仍处于测试阶段。
感谢 uView-Plus 开源项目及其团队成员的贡献，他们的组件开发思路为本项目提供了宝贵地参考。如果需要了解更多组件开发细节，可以参考uView-Plus的 form组件 的代码实现。

平台差异说明 ​

APP(vue)H5微信小程序
✔✔✔

使用示例 ​

html
<!-- 全局使用 -->
<hy-form-group :columns="columns" :formData="formData"></hy-form-group>
<!-- 单个组件引入 -->
<HyFormGroup :columns="columns" :formData="formData"></HyFormGroup>
ts
import { reactive, ref } from "vue";
import { HyWarn, FormTypeEnum, HyForm, HyInput, HyButton } from "hy-app";
import type { FormColumnsType } from "hy-app";

const formData: AnyObject = reactive({
    custom: "自定义值",
    isShow: true,
    sex: "1"
});
const formRef = ref<InstanceType<typeof HyForm>>(null);

const columns: FormColumnsType[] = reactive([
    {
        field: "name",
        label: "名字",
        type: FormTypeEnum.TEXT,
        rules: {
            required: true,
            message: "没有填内容",
            trigger: ["blur"]
        }
    },
    {
        field: "sex",
        label: "性别",
        type: FormTypeEnum.RADIO,
        actions: [
            { label: "女", value: "0" },
            { label: "男", value: "1" }
        ],
        rules: {
            required: true,
            message: "没有填内容",
            trigger: ["blur", "change"]
        }
    },
    {
        field: "phone",
        label: "手机号",
        type: FormTypeEnum.TEXT,
        rules: [
            {
                required: true,
                message: "请输入您的手机号",
                trigger: ["blur", "change"]
            },
            {
                type: "phone",
                trigger: ["blur", "change"]
            }
        ]
    },
    {
        field: "password",
        label: "密码",
        type: FormTypeEnum.PASSWORD,
        rules: {
            type: "password",
            trigger: ["blur", "change"]
        }
    },
    {
        field: "isShow",
        label: "是否禁用",
        type: FormTypeEnum.SWITCH
    },
    {
        field: "time",
        label: "日期",
        type: FormTypeEnum.DATE,
        border: "bottom",
        rules: {
            required: true,
            message: "请输入您的日期",
            trigger: ["blur", "change"]
        }
    },
    {
        field: "address",
        label: "地址",
        type: FormTypeEnum.ADDRESS,
        rules: {
            required: true,
            message: "请输入您的地址",
            trigger: ["blur", "change"]
        }
    },
    {
        field: "select",
        label: "选择学历",
        type: FormTypeEnum.SELECT,
        select: [
            [
                { text: "小学", id: "1" },
                { text: "初中", id: "2" },
                { text: "高中", id: "3" },
                { text: "大学", id: "4" }
            ]
        ],
        rules: {
            required: true,
            message: "请输入您的学历",
            trigger: ["blur", "change"]
        }
    },
    {
        field: "age",
        label: "年龄",
        type: FormTypeEnum.NUMBER,
        rules: [
            {
                required: true,
                message: "请输入您的年龄",
                trigger: ["blur", "change"]
            },
            {
                required: true,
                message: "不能小于最小值",
                min: 10,
                trigger: ["blur", "change"]
            },
            {
                message: "不能大于最大值",
                max: 20,
                trigger: ["change"]
            }
        ]
    },
    {
        field: "remark",
        label: "备注",
        type: FormTypeEnum.TEXTAREA,
        rules: {
            required: true,
            message: "请输入您的地址",
            trigger: ["blur", "change"]
        }
    }
]);

const handleSubmit = () => {
    formRef.value.handleSubmit().then((res) => {
        console.log(res);
    });
};

自定义插槽 ​

微信小程序差异

微信小程序不能动态设置插槽，所以不支持自定义插槽，后续有其他方法会更新文档

vue
<template>
    <HyForm
            ref="formRef"
            :columns="columns"
            :form-data="formData"
            labelWidth="90"
    >
        <template #custom="{ record, errorStyle }">
            <HyInput
                v-model="formData[record.field]"
                :custom-style="errorStyle"
            ></HyInput>
        </template>
    </HyForm>
</template>
ts
import { reactive } from "vue";
import { FormTypeEnum, HyForm, HyInput } from "hy-app";
import type { FormColumnsType } from "hy-app";

const columns: FormColumnsType[] = reactive([
    {
        field: "custom",
        label: "自定义内容",
        type: FormTypeEnum.CUSTOM,
        rules: {
            required: true,
            message: "请输入您的自定义内容",
            trigger: ["blur", "change"]
        }
    }
]);

API ​

参数说明类型默认值
labelPosition表单域提示文字的位置left | topleft
labelWidthlabel 宽度string | numberauto
right输入值是否右对齐booleanfalse
labelAlignlabel 字体的对齐方式stringleft
symbol显示label后冒号符号booleanfalse
borderBottom显示表单单行底部下划线booleanfalse
disabled是否全部禁用[1]booleanleft
shape输入框形状circle | squaresquare
border输入框边框surround|bottom|nonesurround
columns表单字段配置array-
formData表单值object-

columns ​

参数说明类型默认值
label文字描述string-
field字段名string-
required是否需要校验，只显示红星，需要和 formRules 搭配boolean-
right内容右固定boolean-
type表单类型(见下面枚举出来字段)。enum-
maxCount文件上传最大数（type 为 upload 时候）number-
disabled是否禁用boolean-
placeholder输入框为空时的占位符string-
clearable显示清除输入框 iconboolean-
readonly是否只读boolean-
select选择器配置数据集合[2]string[][]|{text:string;id:string}[][]-
actions单选框配置数据集合[3]string-
shape输入框形状circle|square-
border边框类型surround|bottom|none-
mode日期展示的格式（type 等于 date 选填）enum-
rules校验规则object|array-

actions ​

参数说明类型默认值
label显示文本内容string-
value获取的值string|number-
checked是否选中boolean-
disabled是否禁用boolean-

rules ​

参数说明类型默认值
required是否必填boolean-
message校验不通过时的提示信息string-
trigger表单事件校验(blur|change)[]-
min最小输入内容个数number-
max最大输入内容个数number-
type手机号校验、邮箱校验、复杂密码校验phone|email|password-
validator自定义校验规则Function-

type 类型 ​

  • UPLOAD 上传文件
  • TEXT 普通输入框
  • NUMBER 数字输入框
  • PASSWORD 密码输入框
  • ID_CARD 身份证 id 输入框
  • RADIO 单选
  • DATE 时间选择器
  • SELECT 选择器
  • ADDRESS 地址选择器
  • SWITCH 开关
  • DETAIL 详情
  • TEXTAREA 文本域
  • CUSTOM 自定义插槽

mode 类型 ​

  • DATETIME yyyy-MM-dd HH:mm:SS
  • DATE yyyy-MM-dd
  • TIME hh:MM:ss
  • YEAR_MONTH yyyy-MM
  • MONTH_DAY MM-dd
  • HOUR_MINUTE HH:mm
  • MINUTE_SECOND mm:SS
03:13

  1. 这个禁用优先级高于columns里面的disabled ↩︎

  2. type = select 时候必填(参考 HyPicker 组件) ↩︎

  3. type = radio 时候必填(参考 HyRadio 组件) ↩︎

华玥组件库 © 2025-present