Skip to content

表单配置

本文将介绍如何设置表单配置中的UI相关配置,并详细说明各个配置项的作用。

表单全局配置

设置表单配置

以下是设置表单配置的方法:

  • 组件模式

在模板中设置表单配置:

html
<form-create :option="option"></form-create>
  • 全局方法

你还可以通过全局方法创建表单并设置表单配置:

js
window.formCreate.create(rule, option)

构成

全局配置中额外支持一下配置项

  • form:表单整体显示规则配置
  • row:表单组件布局配置
  • submitBtn:提交按钮样式配置
  • resetBtn:重置按钮样式配置
  • info:组件提示消息配置
  • wrap: 配置FormItem

配置表单(form)

  • 类型Object

  • 说明:配置表单的整体显示规则,比如标签对齐方式和输入框对齐方式。

  • 默认值:

js
  {
      inline: false,
      labelPosition: 'right',
      labelWidth: '125px',
      disabled: false,
      size: undefined,
      validateType: 'text'
  }

配置示例

基础配置

标签在上方

内联布局

表单禁用

配置布局(row)

  • 类型Object

  • 说明:配置表单组件的布局,比如组件之间的间距。

  • 默认值:

js
  {
      show: true,
      gutter: 0
  }

配置示例

设置栅格间隔

响应式间隔

使用 Flex 布局

配置提交按钮(submitBtn)

  • 类型Object

  • 说明:配置提交按钮的样式和布局。

  • 默认值:

js
  {
      disabled: false,
      loading: false,
      type: 'primary',
      innerText: '',
      show: true,
      click: undefined
  }

提交按钮配置,设置submitBtn=false或submitBtn.show=false时不显示按钮

配置示例

基础配置

自定义按钮文字和样式

隐藏提交按钮

自定义提交事件

设置按钮加载状态

配置重置按钮(resetBtn)

  • 类型Object

  • 说明:配置重置按钮的样式和布局。

  • 默认值:

js
  {
      disabled: false,
      loading: false,
      type: 'default',
      innerText: '',
      show: false,
      click: undefined
  }

重置按钮默认配置,设置resetBtn=true或resetBtn.show=true时显示

配置示例

显示重置按钮

自定义重置按钮样式

自定义重置事件

悬浮提示框(info)

  • 类型Object

  • 说明:组件提示消息配置

  • 默认值:

js
  {
      trigger: 'hover',
      placement: 'top-start',
      icon: true
  }

可以在info配置项中设置提示组件的属性

  • 提示组件: Popover、Tooltip 支持的属性

配置示例

使用 Popover 提示

使用 Tooltip 提示

自定义提示位置

自定义提示图标

禁用提示

配置 FormItem(wrap)

  • 类型Object

  • 说明:配置 FormItem 组件的显示规则,例如字段的样式和布局。

  • 默认值:

js
  {}

配置示例

全局设置标签和组件布局

全局设置字段验证提示位置

全局设置字段帮助文本

全局设置字段标签对齐方式

完整配置示例

FormCreate 是一个开源项目,基于 MIT 许可证发布,欢迎个人和企业用户免费使用