Difference between revisions of "Standard form field types"
From Joomla! Documentation
(grammar) |
|||
(41 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- | + | <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 [[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= | + | Type</translate> |
− | !width= | + | !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> | ||
+ | |- | ||
+ | |[[S:MyLanguage/ChromeStyle form field type|<translate><!--T:27--> | ||
+ | Chrome Style</translate>]] | ||
+ | |<translate><!--T:28--> | ||
+ | provides a list of template chrome style options grouped by template.</translate> | ||
+ | |{{JVer|3.0}} <translate><!--T:29--> | ||
+ | and newer</translate> | ||
+ | |- | ||
+ | |[[S:MyLanguage/Color form field type|<translate><!--T:30--> | ||
+ | color</translate>]] | ||
+ | |<translate><!--T:31--> | ||
+ | provides a color picker when clicking the input box.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:32--> | ||
+ | and newer</translate> | ||
+ | |- | ||
+ | |[[S:MyLanguage/ContentLanguage form field type|<translate><!--T:33--> | ||
+ | Content Language</translate>]] | ||
+ | |<translate><!--T:34--> | ||
+ | Provides a list of content languages.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:35--> | ||
+ | and newer</translate> | ||
+ | |- | ||
+ | |[[S:MyLanguage/Contenttype form field type|<translate><!--T:36--> | ||
+ | Content Type</translate>]] | ||
+ | |<translate><!--T:37--> | ||
+ | Provides a list of content types.</translate> | ||
+ | |{{JVer|3.1}} <translate><!--T:38--> | ||
+ | and newer</translate> | ||
+ | |- | ||
+ | |[[S:MyLanguage/Combo form field type|<translate><!--T:39--> | ||
+ | combo</translate>]] | ||
+ | |<translate><!--T:40--> | ||
+ | provides a combo box field.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:41--> | ||
+ | and newer</translate> | ||
+ | |- | ||
+ | |[[S:MyLanguage/Componentlayout form field type|<translate><!--T:42--> | ||
+ | componentlayout</translate>]] | ||
+ | |<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> | ||
+ | |- | ||
+ | |[[S:MyLanguage/Contentlanguage form field type|<translate><!--T:45--> | ||
+ | contentlanguage</translate>]] | ||
+ | |<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> | ||
+ | |- | ||
+ | |[[S:MyLanguage/DatabaseConnection form field type|<translate><!--T:48--> | ||
+ | Database Connection</translate>]] | ||
+ | |<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> | ||
+ | |- | ||
+ | |[[S:MyLanguage/Editor form field type|<translate><!--T:51--> | ||
+ | editor</translate>]] | ||
+ | |<translate><!--T:52--> | ||
+ | provides an editor area field.</translate> | ||
+ | |{{JVer|1.6}} <translate><!--T:53--> | ||
+ | and newer</translate> | ||
+ | |- | ||
+ | |[[S:MyLanguage/Editors form field type|<translate><!--T:54--> | ||
+ | editors</translate>]] | ||
+ | |<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}} | ||
+ | |- | ||
+ | |[[S:MyLanguage/Email form field type|<translate><!--T:56--> | ||
+ | email</translate>]] | ||
+ | |<translate><!--T:57--> | ||
+ | provides an email field.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:58--> | ||
+ | and newer</translate> | ||
+ | |- | ||
+ | |[[S:MyLanguage/File form field type|<translate><!--T:59--> | ||
+ | file</translate>]] | ||
+ | |<translate><!--T:60--> | ||
+ | Provides an input field for files</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:61--> | ||
+ | and newer</translate> | ||
+ | |- | ||
+ | |[[S:MyLanguage/Filelist form field type|<translate><!--T:62--> | ||
+ | filelist</translate>]] | ||
+ | |<translate><!--T:63--> | ||
+ | provides a drop down list of files from a specified directory.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:64--> | ||
+ | and newer</translate> | ||
+ | |- | ||
+ | |[[S:MyLanguage/Folderlist form field type|<translate><!--T:65--> | ||
+ | folderlist</translate>]] | ||
+ | |<translate><!--T:66--> | ||
+ | provides a drop down list of folders from a specified directory.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:67--> | ||
+ | and newer</translate> | ||
+ | |- | ||
+ | |[[S:MyLanguage/Groupedlist form field type|<translate><!--T:68--> | ||
+ | groupedlist</translate>]] | ||
+ | |<translate><!--T:69--> | ||
+ | provides a drop down list of items organized into groups.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:70--> | ||
+ | and newer</translate> | ||
+ | |- | ||
+ | |[[S:MyLanguage/HeaderTag form field type|<translate><!--T:71--> | ||
+ | header tag</translate>]] | ||
+ | |<translate><!--T:72--> | ||
+ | provides a drop down list of the header tags (h1-h6)</translate>. | ||
+ | |{{JVer|3.0}} <translate><!--T:73--> | ||
+ | and newer</translate> | ||
+ | |- | ||
+ | |[[S:MyLanguage/Helpsite form field type|<translate><!--T:74--> | ||
+ | helpsite</translate>]] | ||
+ | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Hidden form field type|<translate><!--T:77--> |
− | |provides a | + | hidden</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Imagelist form field type|<translate><!--T:80--> |
− | |provides a list of | + | imagelist</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |||
− | |||
− | |||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Integer form field type|<translate><!--T:83--> |
− | |provides a drop down list of | + | integer</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Language form field type|<translate><!--T:86--> |
− | |provides a | + | language</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/List form field type|<translate><!--T:89--> |
− | |provides | + | list</translate>]] |
− | |{{JVer| | + | |<translate><!--T:90--> |
+ | provides a drop down list of custom-defined entries.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:91--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Media form field type|<translate><!--T:92--> |
− | |provides | + | media</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Menu form field type|<translate><!--T:95--> |
− | |provides a | + | menu</translate>]] |
− | |{{JVer| | + | |<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--> |
− | |provides a list of | + | Menu Item</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[Meter form field type|<translate><!--T:101--> |
− | | | + | meter</translate>]] |
− | |{{JVer| | + | |<translate><!--T:102--> |
+ | Provides a meter to show value in a range.</translate> | ||
+ | |{{JVer|3.2}} <translate><!--T:103--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Modulelayout form field type|<translate><!--T:104--> |
− | |provides a | + | Module Layout</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/ModuleOrder form field type|<translate><!--T:107--> |
− | | | + | Module Order</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/ModulePosition form field type|<translate><!--T:110--> |
− | |provides a | + | Module Position</translate>]] |
− | |{{JVer| | + | |<translate><!--T:111--> |
+ | provides a text input to set the position of a module.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:112--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/ModuleTag form field type|<translate><!--T:113--> |
− | |provides a | + | Module Tag</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Note form field type|<translate><!--T:116--> |
− | | | + | note</translate>]] |
− | |{{JVer|1 | + | |<translate><!--T:117--> |
+ | supports a one line text field.</translate> | ||
+ | |{{JVer|3.1}} <translate><!--T:118--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Number form field type|<translate><!--T:119--> |
− | | | + | number</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Password form field type|<translate><!--T:122--> |
− | |provides a | + | password</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Plugins form field type|<translate><!--T:125--> |
− | |provides a | + | plugins</translate>]] |
− | |{{JVer| | + | |<translate><!--T:126--> |
+ | provides a list of plugins from a given folder.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:127--> | ||
+ | and newer</translate> | ||
|- | |- | ||
+ | |[[S:MyLanguage/Predefined List form field type|<translate><!--T:128--> | ||
+ | predefinedlist</translate>]] | ||
+ | |<translate><!--T:129--> | ||
+ | Form Field to load a list of predefined values.</translate> | ||
+ | |{{JVer|3.2}} <translate><!--T:130--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Radio form field type|<translate><!--T:131--> |
− | |provides | + | radio</translate>]] |
− | |{{JVer| | + | |<translate><!--T:132--> |
+ | provides radio buttons to select different options.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:133--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Range form field type|<translate><!--T:134--> |
− | | | + | range</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Repeatable form field type|<translate><!--T:137--> |
− | | | + | repeatable</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Rules form field type|<translate><!--T:140--> |
− | |provides | + | rules</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Sessionhandler form field type|<translate><!--T:143--> |
− | |provides a drop down list of | + | sessionhandler</translate>]] |
− | |{{JVer| | + | |<translate><!--T:144--> |
+ | provides a drop down list of session handler options.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:145--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Spacer form field type|<translate><!--T:146--> |
− | |provides a | + | spacer</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/SQL form field type|<translate><!--T:149--> |
− | |provides a list of | + | sql</translate>]] |
− | |{{JVer| | + | |<translate><!--T:150--> |
+ | 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.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:151--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/subform form field type|<translate><!--T:189--> |
− | |provides a | + | subform</translate>]] |
− | |{{JVer| | + | |<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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Tag form field type|<translate><!--T:152--> |
− | |provides | + | tag</translate>]] |
− | |{{JVer|1 | + | |<translate><!--T:153--> |
+ | provides an entry point for tags (either AJAX or Nested).</translate> | ||
+ | |{{JVer|3.1}} <translate><!--T:154--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Tel form field type|<translate><!--T:155--> |
− | |provides a | + | tel</translate>]] |
− | |{{JVer| | + | |<translate><!--T:156--> |
+ | provides an input field for a telephone number.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:157--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Templatestyle form field type|<translate><!--T:158--> |
− | |provides a drop down list of | + | templatestyle</translate>]] |
− | |{{JVer| | + | |<translate><!--T:159--> |
+ | provides a drop down list of template styles.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:160--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Text form field type|<translate><!--T:161--> |
− | |provides a | + | text</translate>]] |
− | |{{JVer| | + | |<translate><!--T:162--> |
+ | provides a text box for data entry.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:163--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Textarea form field type|<translate><!--T:164--> |
− | |provides a | + | textarea</translate>]] |
− | |{{JVer| | + | |<translate><!--T:165--> |
+ | provides a text area for entry of multi-line text.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:166--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/Timezone form field type|<translate><!--T:167--> |
− | |provides | + | timezone</translate>]] |
− | |{{JVer| | + | |<translate><!--T:168--> |
+ | provides a drop down list of time zones.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:169--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/URL form field type|<translate><!--T:170--> |
− | |provides a | + | URL</translate>]] |
− | |{{JVer| | + | |<translate><!--T:171--> |
+ | provides a URL text input field.</translate> | ||
+ | |{{JVer|2.5}} <translate><!--T:172--> | ||
+ | and newer</translate> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/User form field type|<translate><!--T:173--> |
− | | | + | user</translate>]] |
− | |{{JVer|1.6}} 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> | ||
|- | |- | ||
− | |[[ | + | |[[S:MyLanguage/UserActive form field type|<translate><!--T:176--> |
− | | | + | useractive</translate>]] |
− | |{{JVer| | + | |<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--> |
− | |provides a drop down list of | + | usergroup</translate>]] |
− | |{{JVer| | + | |<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> | ||
+ | | | ||
|- | |- | ||
− | |[[User form field type| | + | |[[S:MyLanguage/User Group List form field type|<translate><!--T:182--> |
− | | | + | usergrouplist</translate>]] |
− | |{{JVer| | + | |<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>]] |
− | |{{JVer| | + | |<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
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.
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. | and newer | |
accesslevel | provides a drop down list of viewing access levels. | and newer | |
cachehandler | provides a list of available cache handling options. | 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. | and newer | |
captcha | provides the use of a captcha plugin. | and newer | |
category | provides a drop down list of categories for an extension. | and newer | |
checkbox | provides a single checkbox to be checked or unchecked | and newer | |
checkboxes | provides unlimited checkboxes that can be used for multi-select. | and newer | |
Chrome Style | provides a list of template chrome style options grouped by template. | and newer | |
color | provides a color picker when clicking the input box. | and newer | |
Content Language | Provides a list of content languages. | and newer | |
Content Type | Provides a list of content types. | and newer | |
combo | provides a combo box field. | and newer | |
componentlayout | provides a grouped list of core and template alternative layouts for a component item. | and newer | |
contentlanguage | provides a list of installed content languages for use in conjunction with the language switcher plugin. | and newer | |
Database Connection | Provides a list of available database connections, optionally limiting to a given list. | and newer | |
editor | provides an editor area field. | and newer | |
editors | Provides a drop down list of the available WYSIWYG editors. Since use plugins form field instead. | ||
provides an email field. | and newer | ||
file | Provides an input field for files | and newer | |
filelist | provides a drop down list of files from a specified directory. | and newer | |
folderlist | provides a drop down list of folders from a specified directory. | and newer | |
groupedlist | provides a drop down list of items organized into groups. | and newer | |
header tag | provides a drop down list of the header tags (h1-h6). | and newer | |
helpsite | provides a drop down list of the help sites for your Joomla installation. | 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). | and newer | |
imagelist | provides a drop down list of image files in a specified directory. | and newer | |
integer | provides a drop down list of integers between a minimum and maximum. | and newer | |
language | provides a drop down list of the installed languages for the Front-end or Back-end. | and newer | |
list | provides a drop down list of custom-defined entries. | and newer | |
media | provides modal access to the media manager for insertion of images with upload for users with appropriate permissions. | and newer | |
menu | provides a drop down list of the available menus from your Joomla site. | and newer | |
Menu Item | provides a drop down list of the available menu items from your Joomla site. | and newer | |
meter | Provides a meter to show value in a range. | and newer | |
Module Layout | provides a list of alternative layout for a module grouped by core and template. | and newer | |
Module Order | Provides a drop down to set the ordering of module in a given position | and newer | |
Module Position | provides a text input to set the position of a module. | and newer | |
Module Tag | provides a list of html5 elements (used to wrap a module in). | and newer | |
note | supports a one line text field. | and newer | |
number | Provides a one line text box with up-down handles to set a number in the field. | and newer | |
password | provides a text box for entry of a password. The password characters will be obscured as they are entered. | and newer | |
plugins | provides a list of plugins from a given folder. | and newer | |
predefinedlist | Form Field to load a list of predefined values. | and newer | |
radio | provides radio buttons to select different options. | and newer | |
range | Provides a horizontal scroll bar to specify a value in a range. | and newer | |
repeatable | Allows form fields which can have as many options as the user desires. | and newer | |
rules | provides a matrix of group by action options for managing access control. Display depends on context. | and newer | |
sessionhandler | provides a drop down list of session handler options. | and newer | |
spacer | provides a visual separator between form fields. It is purely a visual aid and no value is stored. | 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. | and newer | |
subform | provides a way to use XML forms inside each other or reuse your existing forms inside your current form. | and newer | |
tag | provides an entry point for tags (either AJAX or Nested). | and newer | |
tel | provides an input field for a telephone number. | and newer | |
templatestyle | provides a drop down list of template styles. | and newer | |
text | provides a text box for data entry. | and newer | |
textarea | provides a text area for entry of multi-line text. | and newer | |
timezone | provides a drop down list of time zones. | and newer | |
URL | provides a URL text input field. | and newer | |
user | Field to select a user from a modal list. Displays User Name and stores User ID | and newer | |
useractive | Field to show a list of available user active statuses. | and newer | |
usergroup | provides a drop down list of user groups. Since use usergrouplist instead. | and newer | |
usergrouplist | Field to load a drop down list of available user groups. Replaces usergroup form field type. | and newer | |
userstate | Field to load a list of available users statuses. | and newer |