图片字段
一个专用的文件输入,用于存储上传图片的URL或路径。
可以通过拖放操作将图片上传到图片组件,或者使用CMS附带的专用媒体管理器。
要修改可以上传到媒体管理器的文件类型,请查找支持的文件类型列表和如何覆盖默认接受的媒体类型
类型定义
有关所有字段类型的其他通用属性,请查看字段类型定义。
REQUIRED
type
string
将此设置为 "image" 以使用图片字段。
REQUIRED
name
string
字段的内部使用名称。
accept
string | string[]
将字段限制为特定的文件类型。接受扩展名("pdf")、类别("image"、"video"、"audio" 或 "document"),或它们的数组。
All properties marked as REQUIRED must be specified for the field to work properly.
示例
简单字段
带有图片路径格式化的字段
如果需要自定义字段中图片的格式,可以使用 format 和 parse 选项。
限制文件类型
设置 accept 以限制字段为某些文件类型。它接受单个扩展名、类别或它们的数组。
四个类别是扩展名组的简写:
类别 | 扩展名 |
|---|---|
|
|
|
|
|
|
|
|
当字段声明 accept 时:
- 媒体管理器仅列出匹配的文件,其类型过滤器被替换为一个锁定的芯片,标明字段接受的内容。
- 任何其他类型的文件在上传前都会被拒绝,无论是拖放到字段上还是媒体管理器上,因此不会有不需要的文件进入你的库。
- 选择一个不匹配的库中已有文件会引发警报,并保持字段的值不变。
jpg和jpeg意味着相同的东西,所以accept: 'jpeg'仍然接受photo.jpg。- 字段的
accept仅覆盖全局的media.accept。
在添加 accept 之前保存的值保持不变;限制适用于编辑者从现在开始选择的内容。它也适用于 list: true 的图片字段。
缩小库需要一个可以按扩展名过滤的媒体存储。基于仓库的媒体、TinaCloud 媒体和本地开发服务器都可以。不能的存储,如staticMedia,会继续列出所有内容并隐藏过滤控制,但字段仍然会拒绝不在其类型范围内的文件。