Media 表单字段

媒体表单字段类型提供对媒体管理器的模态访问，以选择图像或其他类型的媒体（例如视频）。 具有适当权限的用户将能够上传文件。

• type (必填) 必须为 media。
• name (必填) 是字段的唯一名称。
• label (必填) (可翻译) 是字段的 HTML 标签。
• description (可选) (可翻译) 是字段描述。
• directory (可选) (可翻译) 是用户可以从中选择文件的目录。 此属性应相对于顶级 /images/ 文件夹。 默认情况下，用户将被限制在顶级 /images/ 文件夹中。
• preview (可选) 显示或隐藏当前所选图像的预览。 ("true": 始终显示，"tooltip": 以工具提示形式显示，"false": 从不显示)。 默认值为 "tooltip"。
• preview_width (可选) 设置预览图像的最大宽度 (默认值： "200")。
• preview_height (可选) 设置预览图像的最大高度 (默认值： "200")。
• types (可选) 是文件类型的逗号分隔列表 ("images", "audios", "videos" 和 "documents")。 默认值为 "images"。 此列表决定使用来自媒体管理器配置的哪些允许的文件扩展名。 例如，"images,documents" 表示仅允许扩展名为图像或文档的文件可供选择。 (自 Joomla 4.0.0 起)

由以下文件实现：libraries/src/Form/Field/MediaField.php

示例 XML 参数定义

<field
  name="myimage"
  type="accessiblemedia"
  directory="stories"
/>

这将打开媒体管理器，并已选择 /images/stories/ 目录。

请注意，如果您在前端使用此字段，则可能会强制实施权限限制。 如果用户无权查看或添加媒体，他们将在模态弹出窗口中看到错误页面 ("403 您无权查看此资源。")。

另请参见

• 文件表单字段类型
• Imagelist 表单字段类型
• 可访问媒体字段类型