mirror of
https://gitee.com/baidu/amis.git
synced 2024-12-15 17:31:18 +08:00
158 lines
4.1 KiB
Markdown
Executable File
158 lines
4.1 KiB
Markdown
Executable File
---
|
|
title: FieldSet 表单项集合
|
|
description:
|
|
type: 0
|
|
group: null
|
|
menuName: FieldSet
|
|
icon:
|
|
order: 20
|
|
---
|
|
|
|
FieldSet 是用于分组展示表单项的一种容器型组件。
|
|
|
|
## 基本用法
|
|
|
|
可以通过配置标题`title`和表单项数组`controls`，实现多个表单项分组展示
|
|
|
|
```schema:height="400" scope="body"
|
|
{
|
|
"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 展示模式](./index#%E8%A1%A8%E5%8D%95%E5%B1%95%E7%A4%BA)
|
|
|
|
下面`group`我们配置了`"mode": "horizontal"`，观察显示情况
|
|
|
|
```schema:height="450" scope="body"
|
|
{
|
|
"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`可以实现点击标题折叠显隐表单项。
|
|
|
|
```schema:height="400" scope="body"
|
|
{
|
|
"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": false`默认折叠。
|
|
|
|
```schema:height="400" scope="body"
|
|
{
|
|
"type": "form",
|
|
"api": "https://houtai.baidu.com/api/mock2/form/saveForm",
|
|
"controls": [
|
|
{
|
|
"type": "fieldSet",
|
|
"title": "基本配置",
|
|
"collapsable": true,
|
|
"collapsed": false,
|
|
"controls": [
|
|
{
|
|
"name": "text1",
|
|
"type": "text",
|
|
"label": "文本1"
|
|
},
|
|
|
|
{
|
|
"name": "text2",
|
|
"type": "text",
|
|
"label": "文本2"
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
## 属性表
|
|
|
|
| 属性名 | 类型 | 默认值 | 说明 |
|
|
| ---------------- | ------------------------------------ | ------- | -------------------------------------------------------------------------- |
|
|
| className | `string` | | CSS 类名 |
|
|
| headingClassName | `string` | | 标题 CSS 类名 |
|
|
| bodyClassName | `string` | | 内容区域 CSS 类名 |
|
|
| title | [SchemaNode](../../types/schemanode) | | 标题 |
|
|
| controls | Array<[表单项](./formitem)> | | 表单项集合 |
|
|
| mode | `string` | | 展示默认，同 [Form](./index#%E8%A1%A8%E5%8D%95%E5%B1%95%E7%A4%BA) 中的模式 |
|
|
| collapsable | `boolean` | `false` | 是否可折叠 |
|
|
| collapsed | `booelan` | `false` | 默认是否折叠 |
|