mediafinder - 渲染一个字段,用于从媒体管理器库中选择一个项目。展开该字段会显示媒体管理器以定位文件。最终的选择结果是文件的相对路径字符串。
whitepaper_file:
label: Whitepaper PDF
type: mediafinder以下字段属性受支持且常用。
| Property | Description |
|---|---|
| label | a name when displaying the form field to the user. |
| default | specifies a default string value, optional. |
| comment | places a descriptive comment below the field. |
| mode | the expected file type, either file, folder or image. Default: file. |
| imageWidth | if using image type, the preview image will be displayed to this width, optional. |
| imageHeight | if using image type, the preview image will be displayed to this height, optional. |
| maxItems | maximum number of items that can be selected. |
| thumbOptions | additional resize options for generating the thumbnail, or pass false to disable thumb generation. |
将 mode 设置为 image 以显示所选图像的预览。
background_image:
label: Background Image
type: mediafinder
mode: image您可以将 mode 设置为 folder,以仅允许选择媒体文件夹路径。
media_folder:
label: Media Folder
type: mediafinder
mode: folder不同于文件上传表单部件,媒体查找器表单部件将其数据存储为一个字符串,该字符串表示在媒体库中选择的媒体文件的路径。它应该与您的模型上的一个普通属性相关联。
媒体查找器将尝试猜测是否可以选择多个项目,这基于模型中的可JSON化属性,这是存储多个项目的要求。
您可以使用 maxItems 属性限制可选择的项目数量。
media_gallery:
label: Image
type: mediafinder
mode: image
maxItems: 10