Joomla! Documentation™

Le type de champ de formulaire groupedlist (liste groupée) propose une liste déroulante ou une liste en zone d'entrées définies et personnalisées qui permet d'afficher des données groupées. Si le champ a une valeur définie, cette option sera sélectionnée lors du premier chargement de la page. Si non définie, la valeur par défaut (si elle existe) est sélectionnée.

• type (obligatoire) doit être "groupedlist".
• name (nom) (obligatoire) est le nom unique du champ.
• label (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
• default (par défaut) (facultatif) est la valeur de la liste d'éléments par défaut.
• description (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
• class (classe) (facultatif) est le nom de classe CSS pour le champ de formulaire HTML. Si non défini, 'inputbox' sera la valeur par défaut.
• multiple (facultatif) si la valeur est définie sur multiple, cela autorise la possibilité de sélectionner plus d'un groupe d'utilisateurs à la fois (true ou false).

L'élément XML <field> doit inclure un ou plusieurs éléments <option> qui définissent les éléments de la liste. Le texte compris entre les balises <option> et </option> sera affiché dans la liste déroulante et la chaîne est traduisible. La balise <option> prend l'argument suivant :

• value (valeur) (obligatoire) est la valeur qui sera enregistrée pour le champ si cet élément est sélectionné.

Astuce : n'oubliez pas de fermer la définition d'un champ avec </field>.

Pour regrouper les données, il suffit d'ajouter <group> avant l'élément <option> que vous voulez grouper et </group> après. La balise <group> prend l'argument suivant :

• label (étiquette) (traduisible) est le texte affiché dans la liste.

Exemple de définition de champ XML :

<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>

Voir également

• Type de champ de formulaire List
• Type de champ de formulaire Filelist
• Type de champ de formulaire Folderlist
• Type de champ de formulaire Imagelist
• Type de champ de formulaire List standards