Radiogroup

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

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