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.

Splitter

Splitter permet de placer une séparation entre deux élements, qui peut être déplacée à la souris. Cela permet de redimensionner deux boites contigues. On peut lui ajouter une poignée grâce à la balise grippy.

Dans le navigateur Mozilla, vous avez par exemple un splitter entre la sidebar et la fenètre de navigation.

Attributs de la balise

Hérités de ElementXul.

collapse

Indique l'élement qui sera replié (donc qui aura disparu laissant la place aux autres élements) lorsque l'utilisateur cliquera sur la poignée (grippy) :

none
aucun élement ne sera replié
before
l'élement précédant le splitter sera replié
after
l'élement suivant le splitter sera replié

resizebefore

Indique l'élement avant le splitter dont il faudra modifier les dimensions quand on deplacera le splitter avec la souris.

closest
indique qu'il s'agit l'element qui précède immediatement le splitter (valeur par défaut).
farthest
indique qu'il s'agit du premier élement de la boite (le plus éloigné).

resizeafter

Indique l'élement aprés le splitter dont il faudra modifier les dimensions quand on deplacera le splitter avec la souris.

closest
indique qu'il s'agit l'element qui suit immediatement le splitter (valeur par défaut).
farthest
indique qu'il s'agit du dernier élement de la boite (le plus éloigné).

state

Indique l'état par défaut du splitter.

;open: les elements ne sont pas repliés
collapsed
un des élements (celui indiqué par l'attribut collapse) est replié totalement, laissant la place aux autres élements.

Propriétés et méthodes Javascript

Héritées de ElementXul.

Balises filles

  • grippy, qui permet de rajouter une poignée sur la séparation

Description complète

Un exemple d'utilisation :

 <hbox flex="1">
   <hbox flex="1">
      <description>boite 1</description>
   </hbox>
   <splitter />
   <hbox flex="1">
    <description>boite 2</description>
   </hbox>
 </hbox>

On a ici un splitter séparant deux boites horizontales, ce qui fera une séparation vertical. Si les élements sont alignés verticalement, la séparation sera horizontale.

Pour rajouter une poignée :

 <hbox flex="1">
   <hbox flex="1">
      <description>boite 1</description>
   </hbox>
   <splitter>
     <grippy />
   </splitter>
   <hbox flex="1">
    <description>boite 2</description>
   </hbox>
 </hbox>

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.