Joomla!表单XML文件编写参考手册 【转】

有关Joomla!表单XML的使用方法和功能描述，请参考这篇文章：

 

<?xml version="1.0" encoding="utf-8"?> <form> <name>Showcase Form</name> <params> <param name="catid" type="list" size="20" default="0" label="Category ID" description="Category ID"> <option value="0">Public</option> <option value="1">Registered</option> <option value="2">Special</option> </param> <param name="title" type="text" size="20" default="" label="title" description="title" /> </params> </form> 

 

 

我们看到每个param item都包含以下几项：

name - field 名称
type - field类型, text, a list box, etc
label - form中显示的标签
description - tooltip 显示的文字
default - 默认值

在一个params section可以书写多个 param

<params>
  <param ... />
  <param ... />
</params> 

你可以在params处指定addpath，这个目录下放置自定义的element文件。（关于element的自定义我们另外说明）

<params addpath="/components/com_contact/elements">
  <param ... /> 

Joomla! core中目前已经提供的element 类型包括以下几种：

文章分类选择列表

<param name="catid" type="category" default="0" label="Category" description="An article category" /> 

添加一个section 属性，你也可以选择其他组件的分类数据，比如下面的代码选择 weblinks的分类。

<param name="catid" type="category" section="com_weblinks" default="0" label="Category" description="A weblinks category" /> 

可视化编辑器：选择一个可视化编辑器

<param name="editor" type="editors" default="" label="User Editor" description="WYSYWYG Editor for this User" /> 

文件列表：

<param name="file_name" type="imagelist" directory="/images/stories" filter="" hide_default="1" default="" label="Menu Image" description="PARAMMENUIMAGE" /> 

各参数定义如下：

directory - 文件列表的目录
filter - 过滤器，这是一个正则表达式
exclude - 排除文件，一个正则表达式
stripext - set to 1 to strip the file extension in the list
hide_none - set to 1 to hide the ‘Do not use’ list option
hide_default - set to 1 to hide the ‘Use Default’ list option

 

Helpsites

<param name="helpsite" type="helpsites" default="" label="Help Site" description="Help site for this User" /> 

Imagelist

<param name="menu_image" type="imagelist" directory="/images/stories" hide_default="1" default="" label="Menu Image" description="PARAMMENUIMAGE" /> 

hide_default - set to 1 to hide an automatic Use Default entry in the list

语言选择

<param name="language" type="languages" client="site" default="" label="Front-end Language" description="paramLanguage" /> 

List

<param name="link_titles" type="list" default="" label="Linked Titles" description="Make the Item titles linkable">
 <option value="">Use Global</option>
 <option value="0">No</option>
 <option value="1">Yes</option>
</param> 

Menu
Menu Item

<param name="menu_item" type="menuitem" label="Menu Item" />Radio
<param name="cache" type="radio" default="0" label="Enable Cache" description="PARAMENABLECACHE">
 <option value="0">No</option>
 <option value="1">Yes</option>
</param> 

Section

<param name="sectionid" type="section" default="0" label="Edit posts" description="Set the section to retrieve posts from" /> 

Spacer

<param name="@spacer" type="spacer" default="" label="" description="" /> 

Text

<param name="moduleclass_sfx" type="text" default="" label="Module Class Suffix" description="PARAMMODULECLASSSUFFIX" /> 

Textarea

<param name="description_text" type="textarea" default="" label="Description Text" rows="5" cols="30" description="PARAMDESCTEXT"/> 

rows - the number of rows for the 
cols - the number of columns for the textarea

我们最常使用的是 Text，Textarea，List,radio,hidden等