Form field/ja
出典: Joomla! ドキュメンテーション
Form fields are fields in a HTML <form>. Joomla! 1.6
and newer supply the JForm class to conveniently and flexibly create forms with a large amount of form fields. Each form field type is a subclass of JFormField.
In addition to being a flexible page creation tool, JFormFields are used by Joomla! to allow administrators to configure Joomla! or its extensions without changing the underlying code. In Joomla! 1.5, this was handled by the now deprecated JParameter and JElement classes.
To define form fields in the configuration of an extension, you must include them into the <fields name="params"> section of the <config> element in your XML manifest file.
Standard form field types
Numerous types of form field are built into Joomla!. The following table lists these standard types and their availability.
Please note that many of these fields are available as parameter types in Joomla! 1.5. For a list of parameter types, see Standard parameter types. For a comparison between form field and parameter types, see Standard form field and parameter types.
| Type | Description | Availability |
|---|---|---|
| accesslevel | provides a drop down list of viewing access levels. |
|
| cachehandler | provides a list of available cache handling options. |
|
| calendar | provides a text box for entry of a date. An icon next to the text box provides a link to a pop-up calendar, which can also be used to enter the date value. |
|
| category | provides a drop down list of categories for an extension. |
|
| checkbox | provides a single checkbox to be checked or unchecked |
|
| checkboxes | provides unlimited checkboxes that can be used for multi-select. |
|
| combo | provides a combo box field. |
|
| componentlayout | provides a grouped list of core and template alternate layouts for a component item. |
|
| contentlanguage | provides a list of installed content languages for use in conjunction with the language switcher plugin. |
|
| editor | provides an editor area field. |
|
| editors | provides a drop down list of the available WYSIWYG editors. |
|
| file |
| |
| filelist | provides a drop down list of files from a specified directory. |
|
| folderlist | provides a drop down list of folders from a specified directory. |
|
| groupedlist | provides a drop down list of items organized into groups. |
|
| helpsite | provides a drop down list of the help sites for your Joomla installation. |
|
| hidden | provides a hidden field for saving a form field whose value cannot be altered directly by a user in the Administrator (it can be altered in code or by editing the params.ini file). |
|
| imagelist | provides a drop down list of image files in a specified directory. |
|
| integer | provides a drop down list of integers between a minimum and maximum. |
|
| language | provides a drop down list of the installed languages for the Front-end or Back-end. |
|
| list | provides a drop down list of custom-defined entries. |
|
| media | provides modal access to the media manager for insertion of images with upload for users with appropriate permissions. |
|
| menu | provides a drop down list of the available menus from your Joomla site. |
|
| menuitem | provides a drop down list of the available menu items from your Joomla site. |
|
| modulelayout | provides a list of alternative layout for a module grouped by core and template. |
|
| password | provides a text box for entry of a password. The password characters will be obscured as they are entered. |
|
| radio | provides radio buttons to select different options. |
|
| rules | provides a matrix of group by action options for managing access control. Display depends on context. |
|
| sessionhandler | provides a drop down list of session handler options. |
|
| spacer | provides a visual separator between form fields. It is purely a visual aid and no value is stored. |
|
| sql | provides a drop down list of entries obtained by running a query on the Joomla Database. The first results column returned by the query provides the values for the drop down box. |
|
| templatestyle | provides a drop down list of template styles. |
|
| text | provides a text box for data entry. |
|
| textarea | provides a text area for entry of multi-line text. |
|
| timezone | provides a drop down list of time zones. |
|
| user | provides a modal list of users. |
|
| usergroup | provides a drop down list of user groups. |
|
