Joomla控，Drupal粉 - 开源CMS建站新闻杂谈、文档教程、案例介绍、扩展相关、个人博客及收藏

作为标准的Joomla模板参数，Imagelist参数会在模板的参数设置表单中生成一个包含指定路径中所有图片文件的下拉列表；所支持的文件类型有.png，.gif，.jpg，.bmp，.ico。如果已经选择过某个图片并保存过参数设置，那么这个下拉列表会显示已保存的值；否则会显示默认值。

在默认状况下，该列表的第一个列表项为“None Selected”,其value为-1，下面一个列表项为“Use Default”，对应的value为0。下面是定义Imagelist类型模板参数时会用到的变量：

• type (必要参数)：必须为“Imagelist”。
• name (必要参数)：Imagelist列表的名称；该名称必须唯一。
• label (必要参数)：显示在表单中的标题。
• directory (可选参数)：用来指定图片文件所处的路径；如果留空，则默认路径为JPATH_ROOT提供的Joomla根路径。
• default (可选参数)：默认选中的图片文件。
• description (可选参数)：参数的功能说明；会作为提示气泡向用户显示。
• filter (可选参数)：使用正则表达式来筛选出特定的图片文件作为列表项，如果留空，则默认将路径中全部图片加载到列表项中。详情可参见官方文档“Regular expressions in parameter arguments”(在参数变量中使用正则表达式)。
• exclude (可选参数)：使用正则表达式来排除掉特定的图片文件；在顺序上，该参数必须置于filter参数之后。详情可参见官方文档“Regular expressions in parameter arguments”。
• stripext (可选参数)：布尔值，如果为“true”，则列表中的图片文件名会忽略掉文件名后缀。
• hide_none (可选参数)：布尔值，如果为“true”，那么默认列表项“None Selected”会被移除。
• hide_default (可选参数)：布尔值，如果为“true”，那么默认列表项“Use Default”会被移除。

下面是一个在templateDetails.xml文件中定义Imagelist类型参数的代码范例：

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

templateDetails.xml文件是什么？请参见“Joomla文档中文翻译 - templateDetails.xml文件详解”。

译者：Viiiix7210

如需转载，请注明官方英文文档及本人译文的出处，谢谢。查看官方英文文档: Tutorial:Template parameters