A site for Joomla! documentation

Joomla! Programmers Documentation

Manual Index

Standard Form Fields

Standard Form Fields

Introduction

Joomla provides an extensive range of type of fields which you can use in your forms. The source code for these field types is found in the libraries/src/Form/Field directory, and are described in this section of the Joomla Manual.

To try out a standard form field you can download the com_exampleform component from Exampleform component, and edit the /site/forms/example_form.xml to include the field you want to investigate.

List of Standard Form Fields

The following is a full list of all supplied form fields available in this release.

Type Description
Accessible Media 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.
Access Level Provides a drop down list of viewing access levels.
Alias Tag Provides a list box containing specific language definitions.
Author Provides a list box containing authors (users) that have created content.
Cache Handler 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.
Captcha Provides the use of a captcha plugin.
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.
Chrome Style Provides a list of template chrome style options grouped by template.
Color Provides a color picker when clicking the input box.
Combo Provides a combo box field.
Component Layout Provides a grouped list of core and template alternative layouts for a component item.
Components Provides a list box containing enabled extensions of type component.
Content History Provides a model popup showing the modification history of an article.
Content Language Provides a list of content languages.
Content Type Provides a list of content types.
Database Connection Provides a list of available database connections, optionally limiting to a given list.
Editor Provides an editor area field.
Email Provides an email field.
File Provides an input field for files
File List Provides a drop down list of files from a specified directory.
Folder List Provides a drop down list of folders from a specified directory.
Frontend Language Provides a list of published content languages with home pages.
Grouped List Provides a drop down list of items organized into groups.
Header Tag Provides a drop down list of the header tags (h1-h6).
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).
Image List 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.
Last Visit Date Range Provides a list box of available date ranges to filter on last visit date.
Limit Box Provides a list of item count limits.
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.
Menu Item Provides a drop down list of the available menu items from your Joomla site.
Meter Provides a meter to show value in a range.
ModalSelect Provides a field to allow the user to select an item within a modal.
Module Layout Provides a list of alternative layout for a module grouped by core and template.
Module Order Provides a drop down to set the ordering of module in a given position
Module Position Provides a text input to set the position of a module.
Module Tag Provides a list of html5 elements (used to wrap a module in).
Note Provides a one line text field.
Number Provides a one line text box with up-down handles to set a number in the field.
Order Provides a dropdown list of entries within a specified table along with -First- and -Last-.
Password Provides a text box for entry of a password. The password characters will be obscured as they are entered.
Plugins Provides a list of plugins from a given folder.
Plugin Status Provides a list box of statuses.
Predefined List Provides a list of predefined values.
Radio Basic Provides radio button inputs using default styling (due to be removed).
Radio Provides radio buttons to select different options.
Range Provides a horizontal scroll bar to specify a value in a range.
Redirect Status Provides a list box of statuses.
Registration Date Range Provides a list box of statuses.
Rules Provides a matrix of group by action options for managing access control. Display depends on context.
Schema Org Component Sections Provides a list box containing enabled extensions of type component.
Session Handler 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.
Status Provides a list box of statuses.
Subform Provides a way to use XML forms inside each other or reuse your existing forms inside your current form.
Tag Provides an entry point for tags (either AJAX or Nested).
Telephone Provides an input field for a telephone number.
Template Style Provides a drop down list of template styles.
Text Area Provides a text area for entry of multi-line text.
Text Provides a text box for data entry.
Time Provides a select list of integers with specified first, last and step values.
Timezone Provides a drop down list of time zones.
Transition Provides a grouped list of all work flow transitions from one stage to the next grouped by stage title
Url Provides a URL text input field.
User Active Provides a list of available user active statuses.
User Provides a modal field to select a user from a list. Displays User Name and stores User ID
Usergroup List Provides a drop down list of available user groups.
User State Provides a list of available users statuses.
Workflow Component Sections Provides a list box containing enabled extensions of type component.
Workflow Condition Provides a drop down list or a list box of workflow conditions.
Workflow Stage Provides a grouped list of all work flow stages grouped by workflow.