JHtmlSelect
Utility class for creating HTML select lists
| package |
Joomla.Platform |
|---|---|
| subpackage |
HTML |
| since |
11.1 |
Methods
booleanlist
Generates a yes/no radio list.
booleanlist(string $name, array $attribs = null, string $selected = null, string $yes = 'JYES', string $no = 'JNO', string $id = false) : string
| since |
11.1 |
|---|---|
| see | \JFormFieldRadio |
Arguments
- $name
stringThe value of the HTML name attribute- $attribs
arrayAdditional HTML attributes for the- $selected
stringThe key that is selected- $yes
stringLanguage key for Yes- $no
stringLanguage key for no- $id
stringThe id for the field
Response
stringHTML for the radio list
genericlist
Generates an HTML selection list.
genericlist(array $data, string $name, mixed $attribs = null, string $optKey = 'value', string $optText = 'text', mixed $selected = null, mixed $idtag = false, boolean $translate = false) : string
| since |
11.1 |
|---|
Arguments
- $data
arrayAn array of objects, arrays, or scalars.- $name
stringThe value of the HTML name attribute.- $attribs
mixedAdditional HTML attributes for the- $optKey
stringThe name of the object variable for the option value. If set to null, the index of the value array is used.- $optText
stringThe name of the object variable for the option text.- $selected
mixedThe key that is selected (accepts an array or a string).- $idtag
mixedValue of the field id or null by default- $translate
booleanTrue to translate
Response
stringHTML for the select list.
groupedlist
Generates a grouped HTML selection list from nested arrays.
groupedlist(array $data, string $name, array $options = array()) : string
| since |
11.1 |
|---|---|
| throws |
|
Arguments
- $data
arrayAn array of groups, each of which is an array of options.- $name
stringThe value of the HTML name attribute- $options
arrayOptions, an array of key/value pairs. Valid options are: Format options, {@see JHtml::$formatOptions}. Selection options. See {@see JHtmlSelect::options()}. group.id: The property in each group to use as the group id attribute. Defaults to none. group.label: The property in each group to use as the group label. Defaults to "text". If set to null, the data array index key is used. group.items: The property in each group to use as the array of items in the group. Defaults to "items". If set to null, group.id and group. label are forced to null and the data element is assumed to be a list of selections. id: Value to use as the select element id attribute. Defaults to the same as the name. list.attr: Attributes for the select element. Can be a string or an array of key/value pairs. Defaults to none. list.select: either the value of one selected option or an array of selected options. Default: none. list.translate: Boolean. If set, text and labels are translated via JText::_().
Response
stringHTML for the select list
integerlist
Generates a selection list of integers.
integerlist(integer $start, integer $end, integer $inc, string $name, mixed $attribs = null, mixed $selected = null, string $format = '') : string
| since |
11.1 |
|---|
Arguments
- $start
integerThe start integer- $end
integerThe end integer- $inc
integerThe increment- $name
stringThe value of the HTML name attribute- $attribs
mixedAdditional HTML attributes for the- $selected
mixedThe key that is selected- $format
stringThe printf format to be applied to the number
Response
stringHTML for the select list
optgroup
Create a placeholder for an option group.
optgroup(string $text, string $optKey = 'value', string $optText = 'text') : object
| deprecated |
12.1 Use JHtmlSelect::groupedList() |
|---|---|
| see | \JHtmlSelect::groupedList() |
| since |
11.1 |
Arguments
- $text
stringThe text for the option- $optKey
stringThe returned object property name for the value- $optText
stringThe returned object property name for the text
Response
object
option
Create an object that represents an option in an option list.
option(string $value, string $text = '', mixed $optKey = 'value', string $optText = 'text', boolean $disable = false) : object
| since |
11.1 |
|---|
Arguments
- $value
stringThe value of the option- $text
stringThe text for the option- $optKey
mixedIf a string, the returned object property name for the value. If an array, options. Valid options are: attr: String|array. Additional attributes for this option. Defaults to none. disable: Boolean. If set, this option is disabled. label: String. The value for the option label. option.attr: The property in each option array to use for additional selection attributes. Defaults to none. option.disable: The property that will hold the disabled state. Defaults to "disable". option.key: The property that will hold the selection value. Defaults to "value". option.label: The property in each option array to use as the selection label attribute. If a "label" option is provided, defaults to "label", if no label is given, defaults to null (none). option.text: The property that will hold the the displayed text. Defaults to "text". If set to null, the option array is assumed to be a list of displayable scalars.- $optText
stringThe property that will hold the the displayed text. This parameter is ignored if an options array is passed.- $disable
booleanNot used.
Response
object
options
Generates the option tags for an HTML select list (with no select tag surrounding the options).
options(array $arr, mixed $optKey = 'value', string $optText = 'text', mixed $selected = null, boolean $translate = false) : string
| since |
11.1 |
|---|
Arguments
- $arr
arrayAn array of objects, arrays, or values.- $optKey
mixedIf a string, this is the name of the object variable for the option value. If null, the index of the array of objects is used. If an array, this is a set of options, as key/value pairs. Valid options are: -Format options, {@see JHtml::$formatOptions}. -groups: Boolean. If set, looks for keys with the value "<optgroup>" and synthesizes groups from them. Deprecated. Defaults true for backwards compatibility. -list.select: either the value of one selected option or an array of selected options. Default: none. -list.translate: Boolean. If set, text and labels are translated via JText::_(). Default is false. -option.id: The property in each option array to use as the selection id attribute. Defaults to none. -option.key: The property in each option array to use as the selection value. Defaults to "value". If set to null, the index of the option array is used. -option.label: The property in each option array to use as the selection label attribute. Defaults to null (none). -option.text: The property in each option array to use as the displayed text. Defaults to "text". If set to null, the option array is assumed to be a list of displayable scalars. -option.attr: The property in each option array to use for additional selection attributes. Defaults to none. -option.disable: The property that will hold the disabled state. Defaults to "disable". -option.key: The property that will hold the selection value. Defaults to "value". -option.text: The property that will hold the the displayed text. Defaults to "text". If set to null, the option array is assumed to be a list of displayable scalars.- $optText
stringThe name of the object variable for the option text.- $selected
mixedThe key that is selected (accepts an array or a string)- $translate
booleanTranslate the option values.
Response
stringHTML for the select list
radiolist
Generates an HTML radio list.
radiolist(array $data, string $name, string $attribs = null, mixed $optKey = 'value', string $optText = 'text', string $selected = null, boolean $idtag = false, boolean $translate = false) : string
| since |
11.1 |
|---|
Arguments
- $data
arrayAn array of objects- $name
stringThe value of the HTML name attribute- $attribs
stringAdditional HTML attributes for the- $optKey
mixedThe key that is selected- $optText
stringThe name of the object variable for the option value- $selected
stringThe name of the object variable for the option text- $idtag
booleanValue of the field id or null by default- $translate
booleanTrue if options will be translated
Response
stringHTML for the select list
Properties
_optionDefaults
Default values for options. Organized by option group.
| since |
11.1 |
|---|
Type(s)
array