Joomla文档中文翻译 - 模板参数详解 - Usergroup参数类型

joomla_documentation_168作为标准的Joomla模板参数,Usergroup参数会在模板的参数设置表单中生成一个包含所有用户组名称的下拉列表如果已经选择了某个用户组并保存过参数设置,那么下拉列表会选中已保存的列表项;否则会显示默认值。

下面是定义Usergroup类型模板参数时会用到的变量:joomla-usergroups-parameter

  • type (必要):必须为“usergroup”。
  • name (必要):列表的名称;该名称必须唯一。
  • label (必要):显示在表单中的标题。
  • default (可选):设置为默认选中的用户组的ID号。
  • multiple (可选):设置该列表是否为多选下拉列表;multiple="yes"表示可以多选,如果忽略,则为单选下拉列表。注意,如果列表设置为可以多选,那么返回的值将是一个数组,并且需要为“size”赋值,以控制多选下拉列表的高度。
  • size (可选):设置下拉列表中列的数量;如果实际的列表项超过指定值,则出现滚动条。如果忽略,那么在没有指定过multiple的情况下,列表为普通的单选下拉列表;在指定过multiple的值情况下,则会按照列表项的实际数目显示完整的多选下拉列表。
  • description (可选):参数的功能说明;会作为提示气泡向用户显示。
  • class (可选):文本框的class名称,默认为“inputbox”。

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

<param name="myusergroups" type="usergroup" default="" label="Select a user group" description="" />

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

译者:Viiiix7210

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


收藏与分享

添加评论


Security code
换一张图