Campo de Formulario, Tipo groupedlist
From Joomla! Documentation
El campo de formulario tipo groupedlist proporciona una lista desplegable o un cuadro de lista personalizado de las entradas definidas con la capacidad de mostrar los datos agrupados. Si el campo tiene un valor guardado este es seleccionado cuando la página se carga por primera vez. Si no, el valor predeterminado (si existe) está seleccionado.
- type (obligatorio) debe ser groupedlist.
- name (obligatorio) es el nombre único del campo.
- label (obligatorio) (traducible) es el título descriptivo del campo.
- default (opcional) es el valor predeterminado del ítem de la lista.
- description (opcional) (traducible) es el texto que será mostrado como un texto de ayuda cuando el usuario mueve el ratón sobre el cuadro de lista desplegable.
- class (opcional) es un nombre de clase CSS para el campo de formulario HTML. Si se omite, el valor predeterminado será 'inputbox'.
- multiple (opcional) si varios elementos se pueden seleccionar al mismo tiempo (verdadero o falso).
El elemento XML <field> debe incluir uno o más elementos <option> que definen los elementos de la lista. El texto entre las etiquetas <option> y </option> es lo que se mostrará en la lista desplegable y es una cadena traducible. La etiqueta <option> lleva el siguiente argumento:
- value (obligatorio) es el valor que se guarda para el campo si este elemento está seleccionado.
Sugerencia: no olvides cerrar la definición del campo con </field>.
Para agrupar los datos simplemente poner <group> antes de que los elementos <option> que desea agrupar y un </group> después de ellos. La etiqueta <group> lleva el siguiente argumento:
- label (traducible) es el texto que se muestra en la lista.
Ejemplo de Definición XML del campo:
<field name="mylistvalue" type="groupedlist" default="" label="Select an option" description="">
<group label="Group 1">
<option value="0">Option 1</option>
<option value="1">Option 2</option>
</group>
<group label="Group 2">
<option value="3">Option 3</option>
<option value="4">Option 4</option>
</group>
<option value="5">Option 5</option>
<option value="6">Option 6</option>
</field>