Reference/Xul/radiogroup

BalisesDescriptifIncomplet

ragiogroup

Un groupe de boutons radio. Plusieurs boutons du groupes ne peuvent pas être sélectionnés simultanément. Les bouton radio peuvent être soit des fils directs du groupe, soit des descendants. Pour entourer le groupe d'une bordure ou avoir un titre, il faut le placer dans un élément groupbox.

Par défaut, les boutons du groupe seront positionnés verticalement (les uns en dessous des autres).

Pour sélectionner un bouton par défaut, il faut utiliser l'attribut selected d'un des boutons du groupe.

Attributs de la balise

disabled

booléen indiquant si les boutons sont désactivés.

focused

booléen à vrai si le groupe a le focus.

tabindex

entier précisant l'ordre dans lequel le focus se déplace quand on presse sur la touche Tab. Le focus suit l'ordre croissant des index.

value

chaîne retournant la propriété value du bouton sélectionné. Pour changer la sélection, utiliser les propriétés selectedIndex ou selectedItem

Herités de ElementXul

Propriétés Javascript

accessible

appendItem ( label , value )

Crée un nouveau bouton radio et l'ajoute en dernière position dans le groupe. La fonction retourne l'élément ajouté

checkAdjacentElement ( dir )

Désélectionne le bouton sélectionné et sélectionne le suivant. Si dir est à true, sélectionne le bouton suivant, s'il est à false, sélectionne le précédent.

disabled

Récupère ou modifie la valeur de l'attribut disabled (booléen)

focusedItem

Cette propriété permet de donner le focus à un bouton ou de récupérer le bouton qui a le focus. Le bouton qui a le focus n'est pas forcément celui qui est sélectionné.

insertItemAt ( index, label , value )

Crée un nouveau bouton radio et l'insère à la position spécifiée. La fonction retourne l'élément ajouté.

removeItemAt ( index )

Supprime un bouton du groupe à la position donnée. La fonction retourne l'élément supprimé.

selectedIndex

Cette propriété permet de sélectionner un bouton ou de récupérer l'index du bouton sélectionné. Si aucun bouton n'est sélectionné, la fonction renvoie -1.

selectedItem

Cette propriété permet de sélectionner un bouton ou de récupérer le bouton sélectionné. Si aucun bouton n'est sélectionné, la fonction renvoie null.

value

Permet de positionner ou de récupérer la valeur (chaîne) du bouton sélectionné.

Heritées de ElementXul

Méthodes Javascript

Heritées de ElementXul

Balises filles

Astuces, Notes, bogues

Quand un bouton est sélectionné, soit par l'interface, soit en modifiant l'une de ses propriétés, l'évènement ?RadioStateChange.

Références

Voir aussi