Difference between revisions of "Standard form field types"

From Joomla! Documentation

(Remove until 2.5 part)
(grammar)
 
(26 intermediate revisions by 10 users not shown)
Line 1: Line 1:
Numerous types of [[form field]] are built into Joomla!. The following table lists these standard types and their availability. Use the [[/Single-page reference|single-page reference]] if you want to print all existing form field documentation.
+
<noinclude><languages /></noinclude>
 +
<translate><!--T:1-->
 +
Numerous types of [[S:MyLanguage/form field|form field]] are built into Joomla!. The following table lists these standard types and their availability. Use the [[S:MyLanguage/Standard_form_field_types/Single-page_reference|single-page reference]] if you want to print all existing form field documentation.</translate>
  
{{JVer|1.5}} Please note that many of these fields are available as [[Parameter|parameter types]] in Joomla! 1.5. For a list of parameter types, see [[J1.5:Standard parameter types]]. For a comparison between form field and parameter types, see [[Standard form field and parameter types]].
+
<translate><!--T:2-->
 +
{{JVer|1.5}} Please note that many of these fields are available as [[S:MyLanguage/Parameter|parameter types]] in Joomla! 1.5. For a list of parameter types, see [[S:MyLanguage/J1.5:Standard parameter types|J1.5:Standard parameter types]]. For a comparison between form field and parameter types, see [[S:MyLanguage/Standard form field and parameter types|Standard form field and parameter types]].</translate>
 
{| class="wikitable" style="vertical-align:top; border:1px solid Sienna; background-color:Cornsilk;"
 
{| class="wikitable" style="vertical-align:top; border:1px solid Sienna; background-color:Cornsilk;"
 
|- style="background-color:Wheat; font-weight:bold; text-align: left;"
 
|- style="background-color:Wheat; font-weight:bold; text-align: left;"
!width=15%|Type
+
!width=15%|<translate><!--T:3-->
!width=65%|Description
+
Type</translate>
!width=20%|Availability
+
!width=65%|<translate><!--T:4-->
 +
Description</translate>
 +
!width=20%|<translate><!--T:5-->
 +
Availability</translate>
 +
 
 +
|-
 +
|[[S:MyLanguage/Accessiblemedia form field type|<translate>
 +
<!--T:192-->
 +
accessiblemedia</translate>]]
 +
|<translate>
 +
<!--T:193-->
 +
provides modal access to the media manager for insertion of images with upload for users with appropriate permissions and a text field for adding a alternative text.</translate>
 +
|{{JVer|4.0}} <translate>
 +
<!--T:194-->
 +
and newer</translate>
 +
 
 +
|-
 +
|[[S:MyLanguage/Accesslevel form field type|<translate><!--T:6-->
 +
accesslevel</translate>]]
 +
|<translate><!--T:7-->
 +
provides a drop down list of viewing access levels.</translate>
 +
|{{JVer|2.5}} <translate><!--T:8-->
 +
and newer</translate>
 +
|-
 +
|[[S:MyLanguage/Cachehandler form field type|<translate><!--T:9-->
 +
cachehandler</translate>]]
 +
|<translate><!--T:10-->
 +
provides a list of available cache handling options.</translate>
 +
|{{JVer|2.5}} <translate><!--T:11-->
 +
and newer</translate>
 +
|-
 +
|[[S:MyLanguage/Calendar form field type|<translate><!--T:12-->
 +
calendar</translate>]]
 +
|<translate><!--T:13-->
 +
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.</translate>
 +
|{{JVer|2.5}} <translate><!--T:14-->
 +
and newer</translate>
 +
|-
 +
|[[S:MyLanguage/Captcha form field type|<translate><!--T:15-->
 +
captcha</translate>]]
 +
|<translate><!--T:16-->
 +
provides the use of a captcha plugin.</translate>
 +
|{{JVer|2.5}} <translate><!--T:17-->
 +
and newer</translate>
 +
|-
 +
|[[S:MyLanguage/Category form field type|<translate><!--T:18-->
 +
category</translate>]]
 +
|<translate><!--T:19-->
 +
provides a drop down list of categories for an extension.</translate>
 +
|{{JVer|2.5}} <translate><!--T:20-->
 +
and newer</translate>
 +
|-
 +
|[[S:MyLanguage/Checkbox form field type|<translate><!--T:21-->
 +
checkbox</translate>]]
 +
|<translate><!--T:22-->
 +
provides a single checkbox to be checked or unchecked</translate>
 +
|{{JVer|2.5}} <translate><!--T:23-->
 +
and newer</translate>
 +
|-
 +
|[[S:MyLanguage/Checkboxes form field type|<translate><!--T:24-->
 +
checkboxes</translate>]]
 +
|<translate><!--T:25-->
 +
provides unlimited checkboxes that can be used for multi-select.</translate>
 +
|{{JVer|2.5}} <translate><!--T:26-->
 +
and newer</translate>
 
|-
 
|-
|[[Accesslevel form field type|accesslevel]]
+
|[[S:MyLanguage/ChromeStyle form field type|<translate><!--T:27-->
|provides a drop down list of viewing access levels.
+
Chrome Style</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:28-->
 +
provides a list of template chrome style options grouped by template.</translate>
 +
|{{JVer|3.0}} <translate><!--T:29-->
 +
and newer</translate>
 
|-
 
|-
|[[Cachehandler form field type|cachehandler]]
+
|[[S:MyLanguage/Color form field type|<translate><!--T:30-->
|provides a list of available cache handling options.
+
color</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:31-->
 +
provides a color picker when clicking the input box.</translate>
 +
|{{JVer|2.5}} <translate><!--T:32-->
 +
and newer</translate>
 
|-
 
|-
|[[Calendar form field type|calendar]]
+
|[[S:MyLanguage/ContentLanguage form field type|<translate><!--T:33-->
|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.
+
Content Language</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:34-->
 +
Provides a list of content languages.</translate>
 +
|{{JVer|2.5}} <translate><!--T:35-->
 +
and newer</translate>
 
|-
 
|-
|[[Captcha form field type|captcha]]
+
|[[S:MyLanguage/Contenttype form field type|<translate><!--T:36-->
|provides a drop down list of the captcha plugins.
+
Content Type</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:37-->
 +
Provides a list of content types.</translate>
 +
|{{JVer|3.1}} <translate><!--T:38-->
 +
and newer</translate>
 
|-
 
|-
|[[Category form field type|category]]
+
|[[S:MyLanguage/Combo form field type|<translate><!--T:39-->
|provides a drop down list of categories for an extension.
+
combo</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:40-->
 +
provides a combo box field.</translate>
 +
|{{JVer|2.5}} <translate><!--T:41-->
 +
and newer</translate>
 
|-
 
|-
|[[Checkbox form field type|checkbox]]
+
|[[S:MyLanguage/Componentlayout form field type|<translate><!--T:42-->
|provides a single checkbox to be checked or unchecked
+
componentlayout</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:43-->
 +
provides a grouped list of core and template alternative layouts for a component item.</translate>
 +
|{{JVer|2.5}} <translate><!--T:44-->
 +
and newer</translate>
 
|-
 
|-
|[[Checkboxes form field type|checkboxes]]
+
|[[S:MyLanguage/Contentlanguage form field type|<translate><!--T:45-->
|provides unlimited checkboxes that can be used for multi-select.
+
contentlanguage</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:46-->
 +
provides a list of installed content languages for use in conjunction with the language switcher plugin.</translate>
 +
|{{JVer|2.5}} <translate><!--T:47-->
 +
and newer</translate>
 
|-
 
|-
|[[ChromeStyle form field type|Chrome Style]]
+
|[[S:MyLanguage/DatabaseConnection form field type|<translate><!--T:48-->
|provides a list of template chrome style options grouped by template.
+
Database Connection</translate>]]
|{{JVer|3.0}} and newer
+
|<translate><!--T:49-->
 +
Provides a list of available database connections, optionally limiting to a given list.</translate>
 +
|{{JVer|2.5}} <translate><!--T:50-->
 +
and newer</translate>
 
|-
 
|-
|[[ContentLanguage form field type|Content Language]]
+
|[[S:MyLanguage/Editor form field type|<translate><!--T:51-->
|Provides a list of content languages.
+
editor</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:52-->
 +
provides an editor area field.</translate>
 +
|{{JVer|1.6}} <translate><!--T:53-->
 +
and newer</translate>
 
|-
 
|-
|[[Contenttype form field type|Content Type]]
+
|[[S:MyLanguage/Editors form field type|<translate><!--T:54-->
|Provides a list of content types.
+
editors</translate>]]
|{{JVer|3.1}} and newer
+
|<translate><!--T:55-->
 +
Provides a drop down list of the available WYSIWYG editors. Since {{JVer|2.5}} use [[S:MyLanguage/Plugins form field type|plugins form field]] instead.</translate>
 +
|{{JVer|1.6}}
 
|-
 
|-
|[[Combo form field type|combo]]
+
|[[S:MyLanguage/Email form field type|<translate><!--T:56-->
|provides a combo box field.
+
email</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:57-->
 +
provides an email field.</translate>
 +
|{{JVer|2.5}} <translate><!--T:58-->
 +
and newer</translate>
 
|-
 
|-
|[[Componentlayout form field type|componentlayout]]
+
|[[S:MyLanguage/File form field type|<translate><!--T:59-->
|provides a grouped list of core and template alternate layouts for a component item.
+
file</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:60-->
 +
Provides an input field for files</translate>
 +
|{{JVer|2.5}} <translate><!--T:61-->
 +
and newer</translate>
 
|-
 
|-
|[[Contentlanguage form field type|contentlanguage]]
+
|[[S:MyLanguage/Filelist form field type|<translate><!--T:62-->
|provides a list of installed content languages for use in conjunction with the language switcher plugin.
+
filelist</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:63-->
 +
provides a drop down list of files from a specified directory.</translate>
 +
|{{JVer|2.5}} <translate><!--T:64-->
 +
and newer</translate>
 
|-
 
|-
|[[DatabaseConnection form field type|Database Connection]]
+
|[[S:MyLanguage/Folderlist form field type|<translate><!--T:65-->
|Provides a list of available database connections, optionally limiting to a given list.
+
folderlist</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:66-->
 +
provides a drop down list of folders from a specified directory.</translate>
 +
|{{JVer|2.5}} <translate><!--T:67-->
 +
and newer</translate>
 
|-
 
|-
|[[Editor form field type|editor]]
+
|[[S:MyLanguage/Groupedlist form field type|<translate><!--T:68-->
|provides an editor area field.
+
groupedlist</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:69-->
 +
provides a drop down list of items organized into groups.</translate>
 +
|{{JVer|2.5}} <translate><!--T:70-->
 +
and newer</translate>
 
|-
 
|-
|[[Editors form field type|editors]]
+
|[[S:MyLanguage/HeaderTag form field type|<translate><!--T:71-->
|Provides a drop down list of the available WYSIWYG editors. Since {{JVer|2.5}} use [[Plugins form field type|plugins form field]] instead.
+
header tag</translate>]]
|{{JVer|2.5}}
+
|<translate><!--T:72-->
 +
provides a drop down list of the header tags (h1-h6)</translate>.
 +
|{{JVer|3.0}} <translate><!--T:73-->
 +
and newer</translate>
 
|-
 
|-
|[[Email form field type|email]]
+
|[[S:MyLanguage/Helpsite form field type|<translate><!--T:74-->
|provides an email field.
+
helpsite</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:75-->
 +
provides a drop down list of the help sites for your Joomla installation.</translate>
 +
|{{JVer|2.5}} <translate><!--T:76-->
 +
and newer</translate>
 
|-
 
|-
|[[File form field type|file]]
+
|[[S:MyLanguage/Hidden form field type|<translate><!--T:77-->
|
+
hidden</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:78-->
 +
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).</translate>
 +
|{{JVer|2.5}} <translate><!--T:79-->
 +
and newer</translate>
 
|-
 
|-
|[[Filelist form field type|filelist]]
+
|[[S:MyLanguage/Imagelist form field type|<translate><!--T:80-->
|provides a drop down list of files from a specified directory.
+
imagelist</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:81-->
 +
provides a drop down list of image files in a specified directory.</translate>
 +
|{{JVer|2.5}} <translate><!--T:82-->
 +
and newer</translate>
 
|-
 
|-
|[[Folderlist form field type|folderlist]]
 
|provides a drop down list of folders from a specified directory.
 
|{{JVer|2.5}} and newer
 
 
|-
 
|-
|[[Groupedlist form field type|groupedlist]]
+
|[[S:MyLanguage/Integer form field type|<translate><!--T:83-->
|provides a drop down list of items organized into groups.
+
integer</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:84-->
 +
provides a drop down list of integers between a minimum and maximum.</translate>
 +
|{{JVer|2.5}} <translate><!--T:85-->
 +
and newer</translate>
 
|-
 
|-
|[[HeaderTag form field type|header tag]]
+
|[[S:MyLanguage/Language form field type|<translate><!--T:86-->
|provides a drop down list of the header tags (h1-h6).
+
language</translate>]]
|{{JVer|3.0}} and newer
+
|<translate><!--T:87-->
 +
provides a drop down list of the installed languages for the Front-end or Back-end.</translate>
 +
|{{JVer|2.5}} <translate><!--T:88-->
 +
and newer</translate>
 
|-
 
|-
|[[Helpsite form field type|helpsite]]
+
|[[S:MyLanguage/List form field type|<translate><!--T:89-->
|provides a drop down list of the help sites for your Joomla installation.
+
list</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:90-->
 +
provides a drop down list of custom-defined entries.</translate>
 +
|{{JVer|2.5}} <translate><!--T:91-->
 +
and newer</translate>
 
|-
 
|-
|[[Hidden form field type|hidden]]
+
|[[S:MyLanguage/Media form field type|<translate><!--T:92-->
|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).
+
media</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:93-->
 +
provides modal access to the media manager for insertion of images with upload for users with appropriate permissions.</translate>
 +
|{{JVer|2.5}} <translate><!--T:94-->
 +
and newer</translate>
 
|-
 
|-
|[[Imagelist form field type|imagelist]]
+
|[[S:MyLanguage/Menu form field type|<translate><!--T:95-->
|provides a drop down list of image files in a specified directory.
+
menu</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:96-->
 +
provides a drop down list of the available menus from your Joomla site.</translate>
 +
|{{JVer|2.5}} <translate><!--T:97-->
 +
and newer</translate>
 
|-
 
|-
 +
|[[S:MyLanguage/Menuitem form field type|<translate><!--T:98-->
 +
Menu Item</translate>]]
 +
|<translate><!--T:99-->
 +
provides a drop down list of the available menu items from your Joomla site.</translate>
 +
|{{JVer|2.5}} <translate><!--T:100-->
 +
and newer</translate>
 
|-
 
|-
|[[Integer form field type|integer]]
+
|[[Meter form field type|<translate><!--T:101-->
|provides a drop down list of integers between a minimum and maximum.
+
meter</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:102-->
 +
Provides a meter to show value in a range.</translate>
 +
|{{JVer|3.2}} <translate><!--T:103-->
 +
and newer</translate>
 
|-
 
|-
|[[Language form field type|language]]
+
|[[S:MyLanguage/Modulelayout form field type|<translate><!--T:104-->
|provides a drop down list of the installed languages for the Front-end or Back-end.
+
Module Layout</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:105-->
 +
provides a list of alternative layout for a module grouped by core and template.</translate>
 +
|{{JVer|2.5}} <translate><!--T:106-->
 +
and newer</translate>
 
|-
 
|-
|[[List form field type|list]]
+
|[[S:MyLanguage/ModuleOrder form field type|<translate><!--T:107-->
|provides a drop down list of custom-defined entries.
+
Module Order</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:108-->
 +
Provides a drop down to set the ordering of module in a given position</translate>
 +
|{{JVer|2.5}} <translate><!--T:109-->
 +
and newer</translate>
 
|-
 
|-
|[[Media form field type|media]]
+
|[[S:MyLanguage/ModulePosition form field type|<translate><!--T:110-->
|provides modal access to the media manager for insertion of images with upload for users with appropriate permissions.
+
Module Position</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:111-->
 +
provides a text input to set the position of a module.</translate>
 +
|{{JVer|2.5}} <translate><!--T:112-->
 +
and newer</translate>
 
|-
 
|-
|[[Menu form field type|menu]]
+
|[[S:MyLanguage/ModuleTag form field type|<translate><!--T:113-->
|provides a drop down list of the available menus from your Joomla site.
+
Module Tag</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:114-->
 +
provides a list of html5 elements (used to wrap a module in).</translate>
 +
|{{JVer|3.0}} <translate><!--T:115-->
 +
and newer</translate>
 
|-
 
|-
|[[Menuitem form field type|Menu Item]]
+
|[[S:MyLanguage/Note form field type|<translate><!--T:116-->
|provides a drop down list of the available menu items from your Joomla site.
+
note</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:117-->
 +
supports a one line text field.</translate>
 +
|{{JVer|3.1}} <translate><!--T:118-->
 +
and newer</translate>
 
|-
 
|-
|[[Modulelayout form field type|Module Layout]]
+
|[[S:MyLanguage/Number form field type|<translate><!--T:119-->
|provides a list of alternative layout for a module grouped by core and template.
+
number</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:120-->
 +
Provides a one line text box with up-down handles to set a number in the field.</translate>
 +
|{{JVer|3.2}} <translate><!--T:121-->
 +
and newer</translate>
 
|-
 
|-
|[[ModuleOrder form field type|Module Order]]
+
|[[S:MyLanguage/Password form field type|<translate><!--T:122-->
|Provides a drop down to set the ordering of module in a given position
+
password</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:123-->
 +
provides a text box for entry of a password.  The password characters will be obscured as they are entered.</translate>
 +
|{{JVer|2.5}} <translate><!--T:124-->
 +
and newer</translate>
 
|-
 
|-
|[[ModulePosition form field type|Module Position]]
+
|[[S:MyLanguage/Plugins form field type|<translate><!--T:125-->
|provides a text input to set the position of a module.
+
plugins</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:126-->
 +
provides a list of plugins from a given folder.</translate>
 +
|{{JVer|2.5}} <translate><!--T:127-->
 +
and newer</translate>
 
|-
 
|-
|[[ModuleTag form field type|Module Tag]]
+
|[[S:MyLanguage/Predefined List form field type|<translate><!--T:128-->
|provides a list of html5 elements (used to wrap a module in).
+
predefinedlist</translate>]]
|{{JVer|3.0}} and newer
+
|<translate><!--T:129-->
 +
Form Field to load a list of predefined values.</translate>
 +
|{{JVer|3.2}} <translate><!--T:130-->
 +
and newer</translate>
 
|-
 
|-
|[[Note form field type|note]]
+
|[[S:MyLanguage/Radio form field type|<translate><!--T:131-->
|supports a one line text field.
+
radio</translate>]]
|{{JVer|3.1}} and newer
+
|<translate><!--T:132-->
 +
provides radio buttons to select different options.</translate>
 +
|{{JVer|2.5}} <translate><!--T:133-->
 +
and newer</translate>
 
|-
 
|-
|[[Password form field type|password]]
+
|[[S:MyLanguage/Range form field type|<translate><!--T:134-->
|provides a text box for entry of a password.  The password characters will be obscured as they are entered.
+
range</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:135-->
 +
Provides a horizontal scroll bar to specify a value in a range.</translate>
 +
|{{JVer|3.2}} <translate><!--T:136-->
 +
and newer</translate>
 
|-
 
|-
|[[Plugins form field type|plugins]]
+
|[[S:MyLanguage/Repeatable form field type|<translate><!--T:137-->
|provides a list of plugins from a given folder.
+
repeatable</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:138-->
 +
Allows form fields which can have as many options as the user desires.</translate>
 +
|{{JVer|3.2}} <translate><!--T:139-->
 +
and newer</translate>
 
|-
 
|-
|[[Radio form field type|radio]]
+
|[[S:MyLanguage/Rules form field type|<translate><!--T:140-->
|provides radio buttons to select different options.
+
rules</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:141-->
 +
provides a matrix of group by action options for managing access control. Display depends on context.</translate>
 +
|{{JVer|2.5}} <translate><!--T:142-->
 +
and newer</translate>
 
|-
 
|-
|[[Rules form field type|rules]]
+
|[[S:MyLanguage/Sessionhandler form field type|<translate><!--T:143-->
|provides a matrix of group by action options for managing access control. Display depends on context.
+
sessionhandler</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:144-->
 +
provides a drop down list of session handler options.</translate>
 +
|{{JVer|2.5}} <translate><!--T:145-->
 +
and newer</translate>
 
|-
 
|-
|[[Sessionhandler form field type|sessionhandler]]
+
|[[S:MyLanguage/Spacer form field type|<translate><!--T:146-->
|provides a drop down list of session handler options.
+
spacer</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:147-->
 +
provides a visual separator between form fields. It is purely a visual aid and no value is stored.</translate>
 +
|{{JVer|2.5}} <translate><!--T:148-->
 +
and newer</translate>
 
|-
 
|-
|[[Spacer form field type|spacer]]
+
|[[S:MyLanguage/SQL form field type|<translate><!--T:149-->
|provides a visual separator between form fieldsIt is purely a visual aid and no value is stored.
+
sql</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:150-->
 +
provides a drop down list of entries obtained by running a query on the Joomla DatabaseThe first results column returned by the query provides the values for the drop down box.</translate>
 +
|{{JVer|2.5}} <translate><!--T:151-->
 +
and newer</translate>
 
|-
 
|-
|[[SQL form field type|sql]]
+
|[[S:MyLanguage/subform form field type|<translate><!--T:189-->
|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.
+
subform</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:190-->
 +
provides a way to use XML forms inside each other or reuse your existing forms inside your current form.</translate>
 +
|{{JVer|3.6}} <translate><!--T:191-->
 +
and newer</translate>
 
|-
 
|-
|[[Tag form field type|tag]]
+
|[[S:MyLanguage/Tag form field type|<translate><!--T:152-->
|provides an entry point for tags (either AJAX or Nested).
+
tag</translate>]]
|{{JVer|3.1}} and newer
+
|<translate><!--T:153-->
 +
provides an entry point for tags (either AJAX or Nested).</translate>
 +
|{{JVer|3.1}} <translate><!--T:154-->
 +
and newer</translate>
 
|-
 
|-
|[[Tel form field type|tel]]
+
|[[S:MyLanguage/Tel form field type|<translate><!--T:155-->
|provides an input field for a telephone number.
+
tel</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:156-->
 +
provides an input field for a telephone number.</translate>
 +
|{{JVer|2.5}} <translate><!--T:157-->
 +
and newer</translate>
 
|-
 
|-
|[[Templatestyle form field type|templatestyle]]
+
|[[S:MyLanguage/Templatestyle form field type|<translate><!--T:158-->
|provides a drop down list of template styles.
+
templatestyle</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:159-->
 +
provides a drop down list of template styles.</translate>
 +
|{{JVer|2.5}} <translate><!--T:160-->
 +
and newer</translate>
 
|-
 
|-
|[[Text form field type|text]]
+
|[[S:MyLanguage/Text form field type|<translate><!--T:161-->
|provides a text box for data entry.
+
text</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:162-->
 +
provides a text box for data entry.</translate>
 +
|{{JVer|2.5}} <translate><!--T:163-->
 +
and newer</translate>
 
|-
 
|-
|[[Textarea form field type|textarea]]
+
|[[S:MyLanguage/Textarea form field type|<translate><!--T:164-->
|provides a text area for entry of multi-line text.
+
textarea</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:165-->
 +
provides a text area for entry of multi-line text.</translate>
 +
|{{JVer|2.5}} <translate><!--T:166-->
 +
and newer</translate>
 
|-
 
|-
|[[Timezone form field type|timezone]]
+
|[[S:MyLanguage/Timezone form field type|<translate><!--T:167-->
|provides a drop down list of time zones.
+
timezone</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:168-->
 +
provides a drop down list of time zones.</translate>
 +
|{{JVer|2.5}} <translate><!--T:169-->
 +
and newer</translate>
 
|-
 
|-
|[[URL form field type|URL]]
+
|[[S:MyLanguage/URL form field type|<translate><!--T:170-->
|provides a URL text input field.
+
URL</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:171-->
 +
provides a URL text input field.</translate>
 +
|{{JVer|2.5}} <translate><!--T:172-->
 +
and newer</translate>
 
|-
 
|-
|[[User form field type|user]]
+
|[[S:MyLanguage/User form field type|<translate><!--T:173-->
|provides a modal list of users.
+
user</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:174-->
 +
Field to select a user from a modal list. Displays User Name and stores User ID</translate>
 +
|{{JVer|1.6}} <translate><!--T:175-->
 +
and newer</translate>
 
|-
 
|-
|[[Usergroup form field type|usergroup]]
+
|[[S:MyLanguage/UserActive form field type|<translate><!--T:176-->
|provides a drop down list of user groups.  
+
useractive</translate>]]
|{{JVer|2.5}} and newer
+
|<translate><!--T:177-->
 +
Field to show a list of available user active statuses.</translate>
 +
|{{JVer|3.2}} <translate><!--T:178-->
 +
and newer</translate>
 +
|
 +
|-
 +
|[[S:MyLanguage/Usergroup form field type|<translate><!--T:179-->
 +
usergroup</translate>]]
 +
|<translate><!--T:180-->
 +
provides a drop down list of user groups. Since {{JVer|3.2}} use [[S:MyLanguage/User Group List form field type|usergrouplist]] instead.</translate>
 +
|{{JVer|2.5}} <translate><!--T:181-->
 +
and newer</translate>
 +
|
 +
|-
 +
|[[S:MyLanguage/User Group List form field type|<translate><!--T:182-->
 +
usergrouplist</translate>]]
 +
|<translate><!--T:183-->
 +
Field to load a drop down list of available user groups. Replaces usergroup form field type.</translate>
 +
|{{JVer|3.2}} <translate><!--T:184-->
 +
and newer</translate>
 +
|
 +
|-
 +
|[[S:MyLanguage/User State form field type|<translate><!--T:185-->
 +
userstate</translate>]]
 +
|<translate><!--T:186-->
 +
Field to load a list of available users statuses.</translate>
 +
|{{JVer|3.2}} <translate><!--T:187-->
 +
and newer</translate>
 
|}
 
|}
 +
 +
<noinclude>
 +
<translate>
 +
<!--T:188-->
 +
[[Category:Form fields]]
 +
[[Category:Development Reference]]
 +
</translate>
 +
</noinclude>

Latest revision as of 12:27, 3 December 2021

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Nederlands • ‎eesti • ‎español • ‎français • ‎italiano • ‎العربية

Numerous types of form field are built into Joomla!. The following table lists these standard types and their availability. Use the single-page reference if you want to print all existing form field documentation.

Joomla 1.5 Please note that many of these fields are available as parameter types in Joomla! 1.5. For a list of parameter types, see J1.5:Standard parameter types. For a comparison between form field and parameter types, see Standard form field and parameter types.

Type Description Availability
accessiblemedia provides modal access to the media manager for insertion of images with upload for users with appropriate permissions and a text field for adding a alternative text. Joomla 4.0 and newer
accesslevel provides a drop down list of viewing access levels. Joomla 2.5 and newer
cachehandler provides a list of available cache handling options. Joomla 2.5 and newer
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. Joomla 2.5 and newer
captcha provides the use of a captcha plugin. Joomla 2.5 and newer
category provides a drop down list of categories for an extension. Joomla 2.5 and newer
checkbox provides a single checkbox to be checked or unchecked Joomla 2.5 and newer
checkboxes provides unlimited checkboxes that can be used for multi-select. Joomla 2.5 and newer
Chrome Style provides a list of template chrome style options grouped by template. Joomla 3.0 and newer
color provides a color picker when clicking the input box. Joomla 2.5 and newer
Content Language Provides a list of content languages. Joomla 2.5 and newer
Content Type Provides a list of content types. Joomla 3.1 and newer
combo provides a combo box field. Joomla 2.5 and newer
componentlayout provides a grouped list of core and template alternative layouts for a component item. Joomla 2.5 and newer
contentlanguage provides a list of installed content languages for use in conjunction with the language switcher plugin. Joomla 2.5 and newer
Database Connection Provides a list of available database connections, optionally limiting to a given list. Joomla 2.5 and newer
editor provides an editor area field. Joomla 1.6 and newer
editors Provides a drop down list of the available WYSIWYG editors. Since Joomla 2.5 use plugins form field instead. Joomla 1.6
email provides an email field. Joomla 2.5 and newer
file Provides an input field for files Joomla 2.5 and newer
filelist provides a drop down list of files from a specified directory. Joomla 2.5 and newer
folderlist provides a drop down list of folders from a specified directory. Joomla 2.5 and newer
groupedlist provides a drop down list of items organized into groups. Joomla 2.5 and newer
header tag provides a drop down list of the header tags (h1-h6). Joomla 3.0 and newer
helpsite provides a drop down list of the help sites for your Joomla installation. Joomla 2.5 and newer
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). Joomla 2.5 and newer
imagelist provides a drop down list of image files in a specified directory. Joomla 2.5 and newer
integer provides a drop down list of integers between a minimum and maximum. Joomla 2.5 and newer
language provides a drop down list of the installed languages for the Front-end or Back-end. Joomla 2.5 and newer
list provides a drop down list of custom-defined entries. Joomla 2.5 and newer
media provides modal access to the media manager for insertion of images with upload for users with appropriate permissions. Joomla 2.5 and newer
menu provides a drop down list of the available menus from your Joomla site. Joomla 2.5 and newer
Menu Item provides a drop down list of the available menu items from your Joomla site. Joomla 2.5 and newer
meter Provides a meter to show value in a range. Joomla 3.2 and newer
Module Layout provides a list of alternative layout for a module grouped by core and template. Joomla 2.5 and newer
Module Order Provides a drop down to set the ordering of module in a given position Joomla 2.5 and newer
Module Position provides a text input to set the position of a module. Joomla 2.5 and newer
Module Tag provides a list of html5 elements (used to wrap a module in). Joomla 3.0 and newer
note supports a one line text field. Joomla 3.1 and newer
number Provides a one line text box with up-down handles to set a number in the field. Joomla 3.2 and newer
password provides a text box for entry of a password. The password characters will be obscured as they are entered. Joomla 2.5 and newer
plugins provides a list of plugins from a given folder. Joomla 2.5 and newer
predefinedlist Form Field to load a list of predefined values. Joomla 3.2 and newer
radio provides radio buttons to select different options. Joomla 2.5 and newer
range Provides a horizontal scroll bar to specify a value in a range. Joomla 3.2 and newer
repeatable Allows form fields which can have as many options as the user desires. Joomla 3.2 and newer
rules provides a matrix of group by action options for managing access control. Display depends on context. Joomla 2.5 and newer
sessionhandler provides a drop down list of session handler options. Joomla 2.5 and newer
spacer provides a visual separator between form fields. It is purely a visual aid and no value is stored. Joomla 2.5 and newer
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. Joomla 2.5 and newer
subform provides a way to use XML forms inside each other or reuse your existing forms inside your current form. Joomla 3.6 and newer
tag provides an entry point for tags (either AJAX or Nested). Joomla 3.1 and newer
tel provides an input field for a telephone number. Joomla 2.5 and newer
templatestyle provides a drop down list of template styles. Joomla 2.5 and newer
text provides a text box for data entry. Joomla 2.5 and newer
textarea provides a text area for entry of multi-line text. Joomla 2.5 and newer
timezone provides a drop down list of time zones. Joomla 2.5 and newer
URL provides a URL text input field. Joomla 2.5 and newer
user Field to select a user from a modal list. Displays User Name and stores User ID Joomla 1.6 and newer
useractive Field to show a list of available user active statuses. Joomla 3.2 and newer
usergroup provides a drop down list of user groups. Since Joomla 3.2 use usergrouplist instead. Joomla 2.5 and newer
usergrouplist Field to load a drop down list of available user groups. Replaces usergroup form field type. Joomla 3.2 and newer
userstate Field to load a list of available users statuses. Joomla 3.2 and newer