Skip to content

doc-fix #21350

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hsm-lv merged 1 commit into from
Mar 18, 2026
+67 −65
Merged

doc-fix #21350

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/zh-CN/components/action.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -825,7 +825,7 @@ Access-Control-Expose-Headers: Content-Disposition

> 1.3.0 版本新增功能

如果上面的的行为不满足需求，还可以通过字符串形式的 `onClick` 来定义点击事件，这个字符串会转成 JavaScript 函数，并支持异步（如果是用 sdk 需要自己编译一个 es2017 版本）。
如果上面的行为不满足需求，还可以通过字符串形式的 `onClick` 来定义点击事件，这个字符串会转成 JavaScript 函数，并支持异步（如果是用 sdk 需要自己编译一个 es2017 版本）。

```schema: scope="body"
{
Expand Down
8 changes: 4 additions & 4 deletions docs/zh-CN/components/form/formitem.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -365,7 +365,7 @@ order: 1

##### 通过条件配置静态/输入态

也可以通过[表达式](../../../docs/concepts/expression)配置`staticOn`，来实现在某个条件下将当前表单项状态的的自动切换.
也可以通过[表达式](../../../docs/concepts/expression)配置`staticOn`，来实现在某个条件下将当前表单项状态的自动切换.

```schema: scope="body"
{
Expand Down Expand Up @@ -1593,7 +1593,7 @@ Table 类型的表单项，要实现服务端校验，可以使用 `路径key`

### 配置自动填充

通过配置 "autoFill.api" 为自动填充数据源接口地址；amis 可以将返回数据自动填充到表单中，例如如下配置；
通过配置 "autoFill.api" 为自动填充数据源接口地址；amis 可以将返回数据自动填充到表单中，如下配置；

```schema:scope="body"
{
Expand Down Expand Up @@ -1636,7 +1636,7 @@ Table 类型的表单项，要实现服务端校验，可以使用 `路径key`
```

自动填充接口返回格式如下：
注意：amis 仅处理接口返回结果仅有一项的数据，默认自动填充相关字段
注意：amis 仅处理接口返回结果只有一项的数据，默认自动填充相关字段

```json
{
Expand Down Expand Up @@ -1666,7 +1666,7 @@ Table 类型的表单项，要实现服务端校验，可以使用 `路径key`

### 配置参照录入

设置 autoFill.showSuggestion 为 true；同时在 autoFill 中配置如下示例参数，可以进行数据的参照录入「当前表单项聚焦或者值变化时弹出 dialog/drawer/popOver 供用户操作」例如如下配置
设置 autoFill.showSuggestion 为 true；同时在 autoFill 中配置如下示例参数，可以进行数据的参照录入「当前表单项聚焦或者值变化时弹出 dialog/drawer/popOver 供用户操作」如下配置

fillMapping 配置 支持变量取值和表达式；
如下配置中，如果想一次选中多条数据并映射可如下配置表达式，其中 items 默认为选中的 1 至 N 条数据：
Expand Down
10 changes: 5 additions & 5 deletions docs/zh-CN/components/form/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -902,7 +902,7 @@ Form 支持轮询初始化接口，步骤如下：
}
```

发送请求默认为 `POST` 方式，会将所有表单项整理成一个对象发送过过去。除此之外你可以主动获取以下信息。
发送请求默认为 `POST` 方式，会将所有表单项整理成一个对象发送过去。除此之外你可以主动获取以下信息。

- `diff` 只会包含 `diff` 结果
- `prinstine` 原始数据
Expand Down Expand Up @@ -963,7 +963,7 @@ Form 支持轮询初始化接口，步骤如下：

### 轮询提交请求

通过设置`asyncApi`，当表单提交发送保存接口后，还会继续轮询请求该接口，默认间隔为`3秒`，直到返回 `finished` 属性为 `true` 才 结束。
通过设置`asyncApi`，当表单提交发送保存接口后，还会继续轮询请求该接口，默认间隔为`3秒`，直到返回 `finished` 属性为 `true` 才结束。

```schema: scope="body"
{
Expand Down Expand Up @@ -1398,12 +1398,12 @@ Form 支持轮询初始化接口，步骤如下：
| interval | `number` | `3000` | 刷新时间(最低 3000) |
| silentPolling | `boolean` | `false` | 配置刷新时是否显示加载动画 |
| stopAutoRefreshWhen | `string` | `""` | 通过[表达式](./Types.md#表达式) 来配置停止刷新的条件 |
| initAsyncApi | [API](../../../docs/types/api) | | Form 用来获取初始数据的 api,与 initApi 不同的是，会一直轮询请求该接口，直到返回 finished 属性为 true 才 结束。 |
| initFetch | `boolean` | `true` | 设置了 initApi 或者 initAsyncApi 后，默认会开始就发请求，设置为 false 后就不会起始就请求接口 |
| initAsyncApi | [API](../../../docs/types/api) | | Form 用来获取初始数据的 api,与 initApi 不同的是，会一直轮询请求该接口，直到返回 finished 属性为 true 才结束。 |
| initFetch | `boolean` | `true` | 设置了 initApi 或者 initAsyncApi 后，默认会开始就发请求，设置为 false 后就不会一开始就请求接口 |
| initFetchOn | `string` | | 用表达式来配置 |
| initFinishedField | `string` | `finished` | 设置了 initAsyncApi 后，默认会从返回数据的 data.finished 来判断是否完成，也可以设置成其他的 xxx，就会从 data.xxx 中获取 |
| initCheckInterval | `number` | `3000` | 设置了 initAsyncApi 以后，默认拉取的时间间隔 |
| asyncApi | [API](../../../docs/types/api) | | 设置此属性后，表单提交发送保存接口后，还会继续轮询请求该接口，直到返回 `finished` 属性为 `true` 才 结束。 |
| asyncApi | [API](../../../docs/types/api) | | 设置此属性后，表单提交发送保存接口后，还会继续轮询请求该接口，直到返回 `finished` 属性为 `true` 才结束。 |
| checkInterval | `number` | 3000 | 轮询请求的时间间隔，默认为 3 秒。设置 `asyncApi` 才有效 |
| finishedField | `string` | `"finished"` | 如果决定结束的字段名不是 `finished` 请设置此属性，比如 `is_success` |
| submitOnChange | `boolean` | `false` | 表单修改即提交 |
Expand Down
2 changes: 1 addition & 1 deletion docs/zh-CN/components/form/input-date-range.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -350,7 +350,7 @@ function transform(value, config, props, data) {
| embed | `boolean` | `false` | 是否内联模式 |
| animation | `boolean` | `true` | 是否启用游标动画 | `2.2.0` |
| extraName | `string` | | 是否存成两个字段 | `3.3.0` |
| transform | `string` | | 日期数据处理函数，用来处理选择日期之后的的值，返回值为 `Moment`对象 | `3.5.0` |
| transform | `string` | | 日期数据处理函数，用来处理选择日期之后的值，返回值为 `Moment`对象 | `3.5.0` |
| popOverContainerSelector | `string` | | 弹层挂载位置选择器，会通过`querySelector`获取 | `6.4.0` |

## 事件表
Expand Down
22 changes: 12 additions & 10 deletions docs/zh-CN/components/form/input-excel.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ order: 14
|百度|https://www.baidu.com|
```

解析后的的数据格式将会是
解析后的数据格式将会是

```json
[
Expand Down Expand Up @@ -162,7 +162,9 @@ order: 14
}
]
```

## 解析多个文件

可以配置"multiple": true，来开启多文件解析功能，通过"maxLength": 5，来限制最多上传5个文件。

```schema: scope="body"
Expand Down Expand Up @@ -297,16 +299,16 @@ interface InputExcelData {

## 属性表

| 属性名 | 类型 | 默认值 | 说明 | 版本 |
|--------------|--------------------------|-----------------------|--------------|----------|
| allSheets | `boolean` | false | 是否解析所有 sheet |
| parseMode | `'array'` 或 `'object'` | 'object' | 解析模式 |
| includeEmpty | `boolean` | true | 是否包含空值 |
| plainText | `boolean` | true | 是否解析为纯文本 |
| 属性名 | 类型 | 默认值 | 说明 | 版本 |
| ------------ | ------------------------ | ------------------------------- | ------------------ | -------- |
| allSheets | `boolean` | false | 是否解析所有 sheet |
| parseMode | `'array'` 或 `'object'` | 'object' | 解析模式 |
| includeEmpty | `boolean` | true | 是否包含空值 |
| plainText | `boolean` | true | 是否解析为纯文本 |
| placeholder | `string` | `"拖拽 Excel 到这，或点击上传"` | 占位文本提示 | `2.8.1` |
| autoFill | `Record<string, string>` | | 自动填充 | `3.5.0` |
| multiple | `boolean` | | 解析多个文件 | `6.13.0` |
| maxLength | `number` | | 解析文件最大数 | `6.13.0` |
| autoFill | `Record<string, string>` | | 自动填充 | `3.5.0` |
| multiple | `boolean` | | 解析多个文件 | `6.13.0` |
| maxLength | `number` | | 解析文件最大数 | `6.13.0` |

## 事件表

Expand Down
2 changes: 1 addition & 1 deletion docs/zh-CN/components/form/input-file.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -323,7 +323,7 @@ order: 21
}
```

上例中，file 组件上传后，接口返回格式例如如下：
上例中，file 组件上传后，接口返回格式如下：

```json
{
Expand Down
Loading
Loading