Merge pull request #592 from RickCole21/master

file文档
This commit is contained in:
liaoxuezhi 2020-05-13 14:58:15 +08:00 committed by GitHub
commit a0ff24967f

View File

@ -2,24 +2,27 @@
用来负责文件上传,文件上传成功后会返回文件地址,这个文件地址会作为这个表单项的值,整个表单提交的时候,其实提交的是文件地址,文件上传已经在这个控件中完成了。
- `type` 请设置成 `file`
- `reciever` 默认 `/api/upload/file` 如果想自己存储,请设置此选项。(PS: 如果想存自己的 bos, 系统配置中可以直接填写自己的 bos 配置。)
- `accept` 默认 `text/plain` 默认只支持纯文本,要支持其他类型,请配置此属性。
- `maxSize` 默认没有限制,当设置后,文件大小大于此值将不允许上传。
- `multiple` 是否多选。
- `maxLength` 默认没有限制,当设置后,一次只允许上传指定数量文件。
- `joinValues` 多选时是否将多个值用 `delimiter` 连接起来。
- `extractValue` 默认为 `false`, `joinValues`设置为`false`时生效, 开启后将选中的选项 value 的值封装为数组,作为当前表单项的值。
- `delimiter` 链接符
- `autoUpload` 是否选择完就自动开始上传,默认为 `true`
- `fileField` 默认 `file`, 如果你不想自己存储,则可以忽略此属性。
- `downloadUrl` 默认显示文件路径的时候会支持直接下载,可以支持加前缀如:`http://xx.dom/filename=` ,如果不希望这样,可以把当前配置项设置为 `false`
- `useChunk` 默认为 `auto`amis 所在服务器,限制了文件上传大小不得超出 10M所以 amis 在用户选择大文件的时候,自动会改成分块上传模式。
- `chunkSize` 分块大小,默认为 5M.
- `startChunkApi` 默认 `/api/upload/startChunk` 想自己存储时才需要关注。
- `chunkApi` 默认 `/api/upload/chunk` 想自己存储时才需要关注。
- `finishChunkApi` 默认 `/api/upload/finishChunk` 想自己存储时才需要关注。
- **还有更多通用配置请参考** [FormItem](./FormItem.md)
- `type` 请设置成 `file`
- `reciever` 默认 `/api/upload/file` 如果想自己存储,请设置此选项。(PS: 如果想存自己的 bos, 系统配置中可以直接填写自己的 bos 配置。)
- `accept` 默认 `text/plain` 默认只支持纯文本,要支持其他类型,请配置此属性为文件后缀`.xxx`
- 例如:`.png`
- 也可以配置多个,用逗号分隔:`.mp3,.mp4`。
- 允许任意类型:`.*`
- `maxSize` 默认没有限制,当设置后,文件大小大于此值将不允许上传。
- `multiple` 是否多选。
- `maxLength` 默认没有限制,当设置后,一次只允许上传指定数量文件。
- `joinValues` 多选时是否将多个值用 `delimiter` 连接起来。
- `extractValue` 默认为 `false`, `joinValues`设置为`false`时生效, 开启后将选中的选项 value 的值封装为数组,作为当前表单项的值。
- `delimiter` 链接符
- `autoUpload` 是否选择完就自动开始上传,默认为 `true`
- `fileField` 默认 `file`, 如果你不想自己存储,则可以忽略此属性。
- `downloadUrl` 默认显示文件路径的时候会支持直接下载,可以支持加前缀如:`http://xx.dom/filename=` ,如果不希望这样,可以把当前配置项设置为 `false`
- `useChunk` 默认为 `auto`amis 所在服务器,限制了文件上传大小不得超出 10M所以 amis 在用户选择大文件的时候,自动会改成分块上传模式。
- `chunkSize` 分块大小,默认为 5M.
- `startChunkApi` 默认 `/api/upload/startChunk` 想自己存储时才需要关注。
- `chunkApi` 默认 `/api/upload/chunk` 想自己存储时才需要关注。
- `finishChunkApi` 默认 `/api/upload/finishChunk` 想自己存储时才需要关注。
- **还有更多通用配置请参考** [FormItem](./FormItem.md)
```schema:height="250" scope="form-item"
{
@ -30,4 +33,4 @@
}
```
如果不希望 File 控件接管上传,可以配置 `asBlob` 或者 `asBase64` 这两个属性二选一采用这种方式后File 控件不再自己上传了,而是直接把文件数据作为表单项的值,文件内容会在 Form 表单提交的接口里面一起带上。
如果不希望 File 控件接管上传,可以配置 `asBlob` 或者 `asBase64` 这两个属性二选一采用这种方式后File 控件不再自己上传了,而是直接把文件数据作为表单项的值,文件内容会在 Form 表单提交的接口里面一起带上。