Accessiblemedia 表单字段

accessiblemedia 表单字段类型提供了对媒体管理器的模态访问，用于选择图像（如媒体字段）并允许用户指定关联的替代文本。具有相应权限的用户将能够上传文件。

• type（必填）必须为 accessiblemedia。
• name（必填）是字段的唯一名称。
• label（必填）（可翻译）是字段的 HTML 标签。
• description（可选）（可翻译）是 字段描述。
• directory（可选）（可翻译）是用户可以选择文件的目录。此属性应相对于顶层 /images/ 文件夹。默认情况下，用户将被限制在顶层 /images/ 文件夹中。
• preview（可选）显示或隐藏当前选择的图像的预览。（“true”：始终显示，“tooltip”：以工具提示形式显示，“false”：从不显示）。默认值为“tooltip”。（自 Joomla! 2.5.5 起）
• preview_width（可选）设置预览图像的最大宽度（默认值：“200”）。
• preview_height（可选）设置预览图像的最大高度（默认值：“200”）。

由以下实现：libraries/src/Form/Field/AccessiblemediaField.php

示例 XML 参数定义

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

这将打开媒体管理器，其中已经选择了目录 /images/stories/。它将允许用户选择媒体项并指定关联的替代文本。

右边的是一个 Accessible Media 字段。

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

另请参阅

添加字段的 PR：PR