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
  {
      type: 'popover',
      //html 按 HTML 渲染,text 按纯文本渲染
      render: 'html',
      trigger: 'hover',
      placement: 'top-start',
      icon: true
  }

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

  • type:提示组件,默认 popover,可改为 tooltip

  • render:提示内容的渲染方式。html(默认)按 HTML 渲染,text 按纯文本渲染。字段的 info 对象可以单独覆盖

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

配置示例 ​

使用 Popover 提示 ​

使用 Tooltip 提示 ​

自定义提示位置 ​

自定义提示图标 ​

按纯文本渲染 ​

禁用提示 ​

配置 FormItem(wrap) ​

  • 类型:Object

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

  • 默认值:

js
  {}

配置示例 ​

全局设置标签和组件布局 ​

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

全局设置字段帮助文本 ​

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

完整配置示例 ​

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