跳到主要内容
版本：5.1

Imagelist 表单字段

imagelist 表单字段类型提供指定目录中图像文件的下拉列表。仅列出扩展名为 .png、.gif、.jpg、.bmp、.ico 的文件。如果字段具有保存的值，则在页面首次加载时会选择此值。如果没有，则选择默认值（如果有）。

默认情况下，列表中的第一项是“- 未选择 -”（可翻译），其值是“-1”，其后是“- 使用默认 -”（也可翻译），其值是“0”。

  • type（必填）必须是imagelist。
  • name（必填）是字段的唯一名称。
  • label（必填）（可翻译）是字段 HTML 标签。
  • description（可选）（可翻译）是字段描述。
  • directory（可选）是包含要列出的图像文件的目录的文件系统路径。如果省略，则假定为 JPATH_ROOT 给定的目录。
  • default（可选）是默认图像文件名。
  • filter（Joomla 3.x）或fileFilter（Joomla 4.0 及更高版本）（可选）是一个正则表达式字符串，用于筛选选择包含在下拉列表中的文件列表。如果省略，则包含目录中的所有文件。过滤器参数表达式在排除参数表达式之前应用。有关构建正则表达式的更多信息，请参阅参数参数中的正则表达式。
  • exclude（可选）是一个正则表达式字符串，用于从列表中排除文件。排除参数表达式在过滤器参数表达式之后应用。有关构建正则表达式的更多信息，请参阅参数参数中的正则表达式。
  • stripext（可选）是一个布尔参数。如果为真，则将从列出的文件名中删除文件名扩展名。还要注意，文件名也将保存为没有扩展名的文件名。
  • hide_none（可选）是一个布尔参数。如果为真，则会从下拉列表中省略“- 未选择 -”项。
  • hide_default（可选）是一个布尔参数。如果为真，则会从下拉列表中省略“- 使用默认 -”项。

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

示例 XML 参数定义​

<field
        name="myimage" 
        type="imagelist" 
        default="" 
        label="Select an image" 
        description="" 
        directory="" 
        exclude="" 
        stripext=""
/>

另请参阅​