test/amis
1
0
Fork 0
mirror of https://gitee.com/baidu/amis.git synced 2024-12-15 01:11:15 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
0c9356605e
amis/docs/zh-CN/components/form/fieldset.md
吴多益 0ae04ce946
docs：将文档移动 zh-CN 目录下；为以后支持英文版做准备 (#1309) 
* docs：将文档移动 zh-CN 目录下；为以后支持英文版做准备

* 整理 autoFill

* 补充下载最新版本的说明 (#1298)

* fix: 修复在新版 Firefox 下 js sdk 报错 (#1300)

* 删掉可能报错的代码 (#1311)

* fix: 修复 css 变量不支持数字问题 (#1302)

* feat：增加 animation-duration，可以控制所有动画时长，也能用于一次性关闭所有动画效果 (#1303)

* feat：增加 animation-duration，可以控制所有动画时长，也能用于一次性关闭所有动画效果

* 补充文档

* Pageleave (#1310)

* form 添加页面离开提示功能

* 补充文档

Co-authored-by: 2betop <2betop.cn@gmail.com>
Co-authored-by: liaoxuezhi <liaoxuezhi@baidu.com>
2021-01-04 16:59:32 +08:00

5.0 KiB
Executable File
Raw Blame History

title description type group menuName icon order
FieldSet 表单项集合 0 null FieldSet 20

FieldSet 是用于分组展示表单项的一种容器型组件。

基本用法

可以通过配置标题title和表单项数组controls，实现多个表单项分组展示

{
  "type": "form",
  "api": "https://houtai.baidu.com/api/mock2/form/saveForm",
  "controls": [
    {
      "type": "fieldSet",
      "title": "基本配置",
      "controls": [
        {
          "name": "text1",
          "type": "text",
          "label": "文本1"
        },

        {
          "name": "text2",
          "type": "text",
          "label": "文本2"
        }
      ]
    }
  ]
}

展示模式

可以通过设置mode调整展示模式，用法同 Form 展示模式

下面group我们配置了"mode": "horizontal"，观察显示情况

{
  "type": "form",
  "controls": [
    {
        "type": "text",
        "name": "text",
        "label": "文本"
    },
    {
        "type": "divider"
    },
    {
      "type": "fieldSet",
      "title": "基本配置",
      "mode": "horizontal",
      "controls": [
        {
          "name": "text1",
          "type": "text",
          "label": "文本1"
        },

        {
          "name": "text2",
          "type": "text",
          "label": "文本2"
        }
      ]
    }
  ]
}

可折叠

配置"collapsable": true可以实现点击标题折叠显隐表单项。

{
  "type": "form",
  "api": "https://houtai.baidu.com/api/mock2/form/saveForm",
  "controls": [
    {
      "type": "fieldSet",
      "title": "基本配置",
      "collapsable": true,
      "controls": [
        {
          "name": "text1",
          "type": "text",
          "label": "文本1"
        },

        {
          "name": "text2",
          "type": "text",
          "label": "文本2"
        }
      ]
    }
  ]
}

默认是否折叠

默认是展开的，如果想默认折叠，那么配置"collapsed": true默认折叠。

{
  "type": "form",
  "api": "https://houtai.baidu.com/api/mock2/form/saveForm",
  "controls": [
    {
      "type": "fieldSet",
      "title": "基本配置",
      "collapsable": true,
      "collapsed": true,
      "controls": [
        {
          "name": "text1",
          "type": "text",
          "label": "文本1"
        },

        {
          "name": "text2",
          "type": "text",
          "label": "文本2"
        }
      ]
    }
  ]
}

标题放底部

fieldSet 的另一种标题展现样式，不同的是展开的时候收起文本是在下方的，如果组件比较多的时候更容易收起。

设置 "titlePosition": "bottom"。

{
  "type": "form",
  "api": "https://houtai.baidu.com/api/mock2/form/saveForm",
  "controls": [
    {
      "type": "fieldSet",
      "title": "展开更多设置",
      "collapseTitle": "收起设置",
      "titlePosition": "bottom",
      "collapsable": true,
      "collapsed": true,
      "controls": [
        {
          "name": "text1",
          "type": "text",
          "label": "文本1"
        },

        {
          "name": "text2",
          "type": "text",
          "label": "文本2"
        }
      ]
    }
  ]
}

属性表

属性名 类型 默认值 说明
className string CSS 类名
headingClassName string 标题 CSS 类名
bodyClassName string 内容区域 CSS 类名
title SchemaNode 标题
controls Array<表单项> 表单项集合
mode string 展示默认，同 Form 中的模式
collapsable boolean false 是否可折叠
collapsed booelan false 默认是否折叠
collapseTitle SchemaNode 收起 收起的标题