Attention : Le contenu de ces pages n'a pas été mis à jour depuis longtemps. Il est probablement obsolète pour Firefox 4.0/Gecko 4.0 et supérieur. Pour du contenu plus récent, allez consulter developer.mozilla.org.

Treecell

Un élément treecell correspond à une cellule dans un arbre (élément tree).

Pour chaque ligne (treerow) de l'arbre, il doit y avoir autant de cellules (treecell) qu'il y a de colonnes (treecol) déclarées dans l'élément treecols.

exemple :

 <tree id="liste-taches" flex="1">
     <treecols>
            <treecol id="col1" label="Priorité" flex="1" />
            <treecol id="col2" label="Déscription" flex="4"/>
            <treecol id="col3" label="Effectué" flex="1" />
     </treecols>
     <treechildren id="liste-donnees">
        <treeitem>
            <treerow>
                <treecell label="aaaaa"/>
                <treecell label="bbbbb"/>
                <treecell label="ccccc"/>
            </treerow>
         </treeitem>
        <treeitem>
            <treerow>
                <treecell label="aaaaa"/>
                <treecell label="bbbbb"/>
                <treecell label="ccccc"/>
            </treerow>
         </treeitem>
     </treechildren>
 </tree>

Attributs de la balise

Attributs hérités de Reference/Xul/ElementXul ainsi que les suivants :

label

Le libellé de la cellule.

mode

A utiliser conjointement avec l'attribut value ainsi que l'attribut type de l'élément treecol correspondant à la cellule.

Dans le cas où l'élément de la colonne est de type progressmeter, l'attribut mode définit le comportement de la barre de progression :

;none:la barre de progression n'est pas affichée. ;normal:la barre de progression est affichée en mode normal et son remplissage est défini par l'attribut value. ;undetermined:la barre de progression est affichée et son remplissage est indéfini.

properties

Liste des propriétés de la cellule permettant de modifier le style de la cellule. Les propriétés sont séparées entre elles par des espaces.

ref

Contient l'id de la colonne à laquelle appartient la cellule. Il est rarement utile de renseigner cet attribut puisque cela est fait automatiquement lors de la construction de l'arbre en fonction de la position de la cellule.

src

L'URL de l'image à faire apparaître dans la cellule. Si l'attribut n'est pas renseigné, aucune image n'apparaîtra.

value

Une valeur entre '0' et '100'.

A utiliser conjointement avec l'attribut mode ainsi que l'attribut type de l'élément treecol correspondant à la cellule.

Définit le taux de remplissage de la barre de progression si la cellule appartient à une colonne de type="progressmeter".

Propriétés Javascript

Pas d'autres propriétés que celles héritées de Reference/Xul/ElementXul.

Méthodes Javascript

Pas d'autres méthodes que celles héritées de Reference/Xul/ElementXul.

Balises filles

Pas de balises filles.

Balise parente

Références

http://www.xulplanet.com/references/elem(..)

Commentaires

Il est fortement recommandé de définir systématiquement l'attribut id d'un élément treecol. Sans cela, certaines fonctionnalités telles que le déplacement de colonnes, l'inversion du tri, etc... pourraient avoir un comportement inattendu.

Pour l'attribut value, il est possible de spécifier des valeurs en pourcentage (ex: value="40%") mais cela n'est pas recommandé.


Copyright © 2003-2013 association xulfr, 2013-2016 Laurent Jouanneau - Informations légales.

Mozilla® est une marque déposée de la fondation Mozilla.
Mozilla.org™, Firefox™, Thunderbird™, Mozilla Suite™ et XUL™ sont des marques de la fondation Mozilla.