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 设置为 **文件夹** 来仅允许选择媒体文件夹路径。
media_folder:
label: Media Folder
type: mediafinder
mode: folder与文件上传表单部件不同,媒体查找器表单部件将其数据存储为表示在媒体库中选择的媒体文件路径的字符串。它应该与您的模型上的一个普通属性相关联。
媒体查找器将尝试猜测是否可以选择多个项目,具体取决于模型中的jsonable 属性,这是存储多个项目的要求。
您可以使用 maxItems 属性来限制可选择的项目数量。
media_gallery:
label: Image
type: mediafinder
mode: image
maxItems: 10