amis2/docs-old/renderers/Form/Image.md
2020-07-28 10:03:53 +08:00

2.1 KiB

Image

用于上传图片的控件。

  • type 请设置成 image
  • reciever 默认 /api/upload 如果想自己存储,请设置此选项。
  • multiple 是否多选。
  • maxLength 默认没有限制,当设置后,一次只允许上传指定数量文件。
  • joinValues 多选时是否将多个值用 delimiter 连接起来。
  • extractValue 默认为 false, joinValues设置为false时生效, 开启后将选中的选项 value 的值封装为数组,作为当前表单项的值。
  • delimiter 连接符,默认是 ,, 多选时且 joinValuestrue 时用来连接值。
  • autoUpload 是否选择完就自动开始上传?默认为 true
  • maxSize 默认没有限制,当设置后,文件大小大于此值将不允许上传。
  • crop 用来设置是否支持裁剪。
    • aspectRatio 浮点型,默认 11:1,如果要设置 16:9 请设置 1.777777777777777716 / 9
  • accept 默认是 png/jpg/gif 图片,可以通过修改这个来扩充或缩小支持的图片格式,比如 .png, .gif 就只支持 png 和 gif。
  • limit 限制图片大小,超出不让上传。
    • width 限制图片宽度。
    • height 限制图片高度。
    • minWidth 限制图片最小宽度。
    • minHeight 限制图片最小高度。
    • maxWidth 限制图片最大宽度。
    • maxHeight 限制图片最大高度。
    • aspectRatio 限制图片宽高比,格式为浮点型数字,默认 11:1,如果要设置 16:9 请设置 1.777777777777777716 / 9。 如果不想限制比率,请设置空字符串。
  • autoFill 将上传成功后接口返回值的某个字段,自动填充到表单中某个表单项中,只在单选时有效
    • 配置"autoFill": {"filename": "${filename}"},表示将选中项中的filename的值,自动填充到当前namefilename的表单项中
  • 还有更多通用配置请参考 FormItem

由于 github pages 只能是静态页面,下面的示例暂未实现上传功能

{
  "type": "image",
  "name": "image",
  "label": "Images"
}