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.

Treeitem

Un élément treeitem correspond à un noeud dans un arbre tree. Un noeud peut avoir deux comportements différents :

  • soit il contient une seule ligne (1 élément treerow)
  • soit il contient plusieurs lignes imbriquées qui sont alors contenues dans un autre élément treechildren.

Exemple 1 : on créé une liste de tâches contenant 4 lignes.

 <tree id="treeTasks" flex="1">
     <treecols>
         <treecol id="colPriority" label="Priorité" flex="1" />
         <treecol id="colDesc" label="Description" flex="4"/>
         <treecol id="colDone" label="Effectué" flex="1" />
     </treecols>
     <treechildren id="dataList">
         <treeitem>
             <treerow>
                 <treecell label="3"/>
                 <treecell label="Remplir le questionnaire"/>
                 <treecell label="oui"/>
             </treerow>
         </treeitem>
         <treeitem>
             <treerow>
                 <treecell label="1"/>
                 <treecell label="Rédiger note de synthèse pour le patron"/>
                 <treecell label="non"/>
             </treerow>
         </treeitem>
         <treeitem>
             <treerow>
                 <treecell label="2"/>
                 <treecell label="Repeindre les volets en violet"/>
                 <treecell label="non"/>
             </treerow>
         </treeitem>
         <treeitem>
             <treerow>
                 <treecell label="1"/>
                 <treecell label="Aller chercher les enfants à l'école"/>
                 <treecell label="non"/>
             </treerow>
         </treeitem>
     </treechildren>
 </tree>

Exemple 2 : on créé la même liste de tâches en regroupant les tâches similaires.

 <tree id="treeTasks" flex="1">
     <treecols>
         <treecol id="colPriority" label="Priorité" flex="1" primary="true"/>
         <treecol id="colDesc" label="Description" flex="4"/>
         <treecol id="colDone" label="Effectué" flex="1"/>
     </treecols>
     <treechildren id="dataList">
         <treeitem container="true">
             <treerow>
                 <treecell label="Tâches administratives"/>
                 <treecell/>
                 <treecell/>
             </treerow>
             <treechildren>
                 <treeitem>
                     <treerow>
                         <treecell label="3"/>
                         <treecell label="Remplir le questionnaire"/>
                         <treecell label="oui"/>
                     </treerow>
                 </treeitem>
                 <treeitem>
                     <treerow>
                         <treecell label="1"/>
                         <treecell label="Rédiger note de synthèse pour le patron"/>
                         <treecell label="non"/>
                     </treerow>
                 </treeitem>
             </treechildren>
         </treeitem>
         <treeitem container="true">
             <treerow>
                 <treecell label="Tâches personnelles"/>
                 <treecell/>
                 <treecell/>
             </treerow>
             <treechildren>
                 <treeitem>
                     <treerow>
                         <treecell label="2"/>
                         <treecell label="Repeindre les volets en violet"/>
                         <treecell label="non"/>
                     </treerow>
                 </treeitem>
                 <treeitem>
                     <treerow>
                         <treecell label="1"/>
                         <treecell label="Aller chercher les enfants à l'école"/>
                         <treecell label="non"/>
                     </treerow>
                 </treeitem>
             </treechildren>
         </treeitem>
     </treechildren>
 </tree>

Attributs de la balise

Attributs hérités de Reference/Xul/ElementXul.

container

Booléen

Si à true, indique que l'élément contient des éléments fils imbriqués. L'utilisateur peut alors déployer ou refermer l'élément à sa guise. Penser à rajouter l'attribut primary="true" sur l'un des éléments treecol pour faire aparaître un petit symbole indiquant à l'utilisateur les lignes pouvant être déployées.

Dans le cas d'utilisation d'un template, cet attribut est définit automatiquement.

empty

Booléen.

Si à true, indique que l'élément ne contient aucun élément fils, pas même un élément treerow.

label

Pour les arbres ne comportant qu'une seule colonne, il est possible d'appliquer l'attribut label directement à l'élément treeitem qui peut alors éventuellement être dépourvu d'éléments fils treerow et treecell.

open

Booléen.

Si à true, indique que les éventuels éléments imbriqués sont déployés. A utiliser conjointement avec l'attribut "container=true".

uri

Pour peupler un arbre à partir d'une source de données RDF en utilisant un template, écrire uri="rdf:*" suffit.

ToDo Expliquer plus précisément le rôle de cet attribut

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

Balises parentes

Références

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


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.