Listbox

Attributs de la balise

Herités de ElementXul

disableKeyNavigation

Type: booleen

Si cet attribut n'est pas précisé, l'utilisateur peut parcourir la liste des items en tapant les premières lettres des labels. Cette fonctionnalité peut être désactivée en mettant la valeur true pour cet attribut.

disabled

Type: boolean

Indique si la listebox est active ou pas. Si la valeur de cet attribut est true, la listbox est de-activé. Ceci est normalement visualisé avec des textes grisés. Si la liste box n'est pas active, elle ne répond pas aux actions de l'utilisateur. l'élément ne peut obtenir le focus et les évènements liés aux commande ne sont jamais déclenchés. Par contre les évènement souris sont transmis.

preference

Mozilla 1.8

Type: element id

rows

Type: integer

Nombre de lignes visible de la listbox. Si la listbox contient plus de lignes que cette valeur, une barre de scrolling apparait et permet à l'utilisateur d'atteindre les autres lignes. Pour connaitre le nombre total de lignes de la listbox, utiliser la méthode getRowCount.

seltype

Type: singe|multiple

Utilisé pour préciser si la multisélection est permise.

1. single: seulement une ligne peut être sélectionnée à la fois.
2. multiple: plusieurs lignes peuvent être sélectionnée simultanément.

suppressonselect

Type: boolean

Si cet attribut n'est pas précisé, un évènement est déclenché quand une ligne est sélectionnée par l'utilisateur ou par une des méthodes de sélection.

tabindex

Type: integer

Ordre de tabulation de l'élément. L'ordre de tabulation est l'ordre par lequel les éléments prennent le focus quand l'utilisateur presse la touche Tab. L'élément avec la plus haute valeur arrive après dans la séquence.

value

Type: string

Il est posssible d'associer une valeur à chaque ligne de la listbox. Cela n'est pas nécessaire pour aucune fonctionnalité mais peut être utile pour votre propre usage.