Joomla-开源天空

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

以下是一个Joomla! 表单xml 的示例：Joomla! 1.5中form表单的实现方式

<?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等