专题：Joomla模板标准参数类型
之前一段日子的Joomla文档翻译都是有关Joomla标准参数类型在定义模板参数过程中的应用。针对每一种参数类型，我们都通过一篇对应的文档了解了它的作用、定义方法及可用变量等方面的知识。到今天为止这些标准参数类型已经介绍完毕，现在把这些文档集中在这篇专题中，以方便浏览阅读；欢迎各位朋友交流指教。
作为标准的Joomla模板参数，Usergroup参数会在模板的参数设置表单中生成一个包含所有用户组名称的下拉列表。如果已经选择了某个用户组并保存过参数设置，那么下拉列表会选中已保存的列表项；否则会显示默认值。
下面是定义Usergroup类型模板参数时会用到的变量：
- 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
作为标准的Joomla模板参数，Timezones参数会在模板的参数设置表单中生成一个包含所有时区名称的下拉列表。如果已经选择了某个时区并保存过参数设置，那么下拉列表会选中已保存的列表项；否则会显示默认设置的时区。
下面是定义Timezones类型模板参数时会用到的变量：
- type (必要)：必须为“timezones”。
- name (必要)：列表的名称；该名称必须唯一。
- label (必要)：显示在表单中的标题。
- default (可选)：设置为默认选中的时区代码；例如“-10”代表“(UTC -10:00) Hawaii”。
- description (可选)：参数的功能说明；会作为提示气泡向用户显示。
下面是一个在templateDetails.xml文件中定义Timezones类型参数的代码范例：
<param name="mytimezone" type="timezones" default="-10" label="Select a timezone" description="" />
templateDetails.xml文件是什么？请参见“Joomla文档中文翻译 - templateDetails.xml文件详解”。
译者：Viiiix7210
如需转载，请注明官方英文文档及本人译文的出处，谢谢。查看官方英文文档: Tutorial:Template parameters
作为标准的Joomla模板参数，Textarea参数会在模板的参数设置表单中生成一个文本域。如果已经输入过字符并保存过参数设置，那么该文本域会显示已保存的值；否则会显示默认值。
下面是定义Textarea类型模板参数时会用到的变量：
- type (必要)：必须为“textarea”。
- name (必要)：文本域的名称；该名称必须唯一。
- label (必要)：显示在表单中的标题。
- rows (必要)：文本域的高度；如果留空则由浏览器来判断；设定的高度不会限制文本域内文字的实际行数。
- cols (必要)：文本域的宽度；如果留空则由浏览器来判断。
- default (可选)：作为默认值的字符。
- description (可选)：参数的功能说明；会作为提示气泡向用户显示。
- class (可选)：文本框的class名称，默认为“text_area”。
作为标准的Joomla模板参数，Text参数会在模板的参数设置表单中生成一个文本框。如果已经输入过字符并保存过参数设置，那么该文本框会显示已保存的值；否则会显示默认值。
下面是定义Text类型模板参数时会用到的变量：
- type (必要)：必须为“text”。
- name (必要)：文本框的名称；该名称必须唯一。
- label (必要)：显示在表单中的标题。
- size (可选)：文本框的宽度。如果留空，则由浏览器根据实际容器宽度自行判断；该宽度不会限制输入字符本身的长度。
- default (可选)：作为默认值的字符。
- description (可选)：参数的功能说明；会作为提示气泡向用户显示。
- class (可选)：文本框的class名称，默认为“text_area”。
下面是一个在templateDetails.xml文件中定义Text类型参数的代码范例：
<param name="mytextvalue" type="text" default="Some text" label="Enter some text" description="" size="10" />
templateDetails.xml文件是什么？请参见“Joomla文档中文翻译 - templateDetails.xml文件详解”。
译者：Viiiix7210
如需转载，请注明官方英文文档及本人译文的出处，谢谢。查看官方英文文档: Tutorial:Template parameters
作为标准的Joomla模板参数，Spacer参数会在模板的参数设置表单中生成一个分隔线，用于在视觉上为参数设置表单划分区域。这个参数提供纯粹的视觉元素，没有实际功能。
下面是定义Spacer类型模板参数时会用到的变量：
- type (必要)：必须为“spacer”。
- default (可选)：如果不做指定，默认将输出<hr />作为分隔线；可以指定字符或HTML代码来替代<hr />。
下面是一个在templateDetails.xml文件中定义Spacer类型参数的代码范例：
<param type="spacer" />
我们也可以用一段文字替换掉默认的分隔线，用来作为某个表单区域的标题；只需为default变量赋值，例如：
<param type="spacer" default="Advanced parameters" />
类似的，我们还可以使用HTML代码为default变量赋值；例如，我们希望使用加粗的“Advanced parameters”作为标题，其HTML代码是<b>Advanced parameters</b>，那么在定义Spacer参数时，我们可以使用以下的代码(注意需要转义)：
<param type="spacer" default="<b>Advanced parameters</b>" />
templateDetails.xml文件是什么？请参见“Joomla文档中文翻译 - templateDetails.xml文件详解”。
译者：Viiiix7210
如需转载，请注明官方英文文档及本人译文的出处，谢谢。查看官方英文文档: Tutorial:Template parameters
