Checkbox form field type
From Joomla! Documentation
(Difference between revisions)
(Created page with "The '''checkbox''' form field type provides a single checkbox. If the parameter has a saved value this is selected when the page is first loaded. If not, the default value (if ...") |
Waveywhite (Talk | contribs) |
||
| (7 intermediate revisions by 4 users not shown) | |||
| Line 4: | Line 4: | ||
* '''name''' (mandatory) is the unique name of the parameter. | * '''name''' (mandatory) is the unique name of the parameter. | ||
* '''label''' (mandatory) (translatable) is the descriptive title of the field. | * '''label''' (mandatory) (translatable) is the descriptive title of the field. | ||
| − | * ''' | + | * '''value''' (optional) is the value of the parameter if this checkbox is set (usually 1). |
| − | * '''description''' (optional) (translatable) is text that will be shown as a tooltip when the user moves the mouse over the | + | * '''default''' (optional) is the default value (usually 0 or 1). |
| + | * '''description''' (optional) (translatable) is text that will be shown as a tooltip when the user moves the mouse over the label. | ||
* '''class''' (optional) is a CSS class name for the HTML form field. If omitted this will default to 'inputbox'. | * '''class''' (optional) is a CSS class name for the HTML form field. If omitted this will default to 'inputbox'. | ||
| − | |||
| − | |||
| − | |||
<noinclude> | <noinclude> | ||
| + | Example XML field definition: | ||
| + | |||
| + | <source lang="xml"><field name="show_title" type="checkbox" label="Show title" description="Show the title of the item" value="1" /></source> | ||
| + | |||
| + | Example XML field definition (unchecked): | ||
| + | |||
| + | <source lang="xml"><field name="show_title" type="checkbox" label="Show title" description="Show the title of the item" value="1" default="0" /></source> | ||
| + | |||
=== See also === | === See also === | ||
* [[Standard form field types|List of standard form field types]] | * [[Standard form field types|List of standard form field types]] | ||
[[Category:Standard form field types]]</noinclude> | [[Category:Standard form field types]]</noinclude> | ||
Revision as of 14:34, 12 October 2012
The checkbox form field type provides a single checkbox. If the parameter has a saved value this is selected when the page is first loaded. If not, the default value (if any) is selected.
- type (mandatory) must be checkbox
- name (mandatory) is the unique name of the parameter.
- label (mandatory) (translatable) is the descriptive title of the field.
- value (optional) is the value of the parameter if this checkbox is set (usually 1).
- default (optional) is the default value (usually 0 or 1).
- description (optional) (translatable) is text that will be shown as a tooltip when the user moves the mouse over the label.
- class (optional) is a CSS class name for the HTML form field. If omitted this will default to 'inputbox'.
Example XML field definition:
<field name="show_title" type="checkbox" label="Show title" description="Show the title of the item" value="1" />Example XML field definition (unchecked):
<field name="show_title" type="checkbox" label="Show title" description="Show the title of the item" value="1" default="0" />
