Element Xul

Voici les attributs que tout élement XUL possède.

Attributs

align

Indique la façon dont sont alignés les éléments (éléments enfants) contenus dans l'élément que l'on considère alors comme une boîte (Attention, cela ne permet pas de spécifier l'orientation, voir l'attribut orient).

Valeurs possibles :

start: les éléments sont alignés à partir du coin haut/gauche.
center: les éléments sont placés au centre de la boîte. Ainsi, si l'orientation est horizontale, les éléments seront alignés horizontalement avec un espace équivalent au dessus et en dessous, les placant au centre de la boite.
end: les éléments sont alignés à partir du coin bas/droite.
baseline: les éléments sont alignés selon leur contenu. Si ce sont par exemple des boutons, ils seront alignés de manière à ce que leur texte soit placé sur une même ligne. Ne fonctionne que si la boite oriente horizontalement ses élements.
stretch: les éléments sont agrandis de façon à être aussi grand ou large que la boîte, selon qu'ils sont alignés horizontalement ou verticalement. Exemple : si ils sont alignés horizontalement, leur hauteur sera celle de la boîte.
left, right: obsolète.

Équivalent CSS : -moz-box-align.

Exemple

 <box align="start">
 ..
 </box>

allowevents

Si vaut true, les événements sont passés aux éléments enfants.

allownegativeassertions

class

Indique la classe CSS qu'il faut appliquer.

coalesceduplicatearcs

collapsed

Si à true, l'élément est "écrasé" et n'apparait donc pas. Equivalent CSS : visibility:collapsed;

container

Indique si l'élement peut contenir d'autres éléments.

containment

context

contextmenu

datasources

Contient la liste des ressources RDF. Cela peut être des liens ou des signets RDF. ces ressources RDF serviront à remplir de données l'élément XUL. Cela peut être par exemple le cas des listes, des menus etc..

debug

Si positionné à vrai, cela affiche des bordures sur l'élément. Dans le cas d'une boite, d'un conteneur, les bordures sont bleues lorsque les éléments fils sont orientés horizontalement, rouge quand c'est verticalement.

dir

Indique la direction dans laquelle sont placés les éléments

ltr: les éléments sont placés de gauche à droite ou haut en bas
rtl: les éléments sont placés de droite à gauche ou de bas en haut

empty

A true : l'élément ne contient pas d'élement fils.

equalsize

Permet d'indiquer que tous les éléments fils auront la même taille.

always: quand les éléments sont orientés horizontalement, ils ont la largeur du plus large d'entre eux. quand ils sont orientés verticalement, ils ont la hauteur du plus grand d'entre eux.
never: les éléments ne sont pas redimensionnés pour avoir la même taille.

flags

flex

Indique la flexibilité de l'élément. voir Tutoriel /ModeleDeBoite.

flexgroup

height

Hauteur de l'élément en pixels

hidden

L'élément n'est pas affiché si la valeur est à true. (équivalent de display:none; en CSS).

id

Identifiant de l'élément. Permet de récupérer facilement l'objet javascript correspondant à l'élement, grâce au DOM.

insertafter

insertbefore

left

Pour les élements placés dans une pile (stack), indique la position du coté gauche de l'élement.

maxheight

Indique la hauteur maximum en pixels

maxwidth

Indique la largeur maximum en pixels

minheight

Indique la hauteur minimum en pixels

minwidth

Indique la largeur minimum en pixels

observes

ordinal

orient

Indique l'orientation de l'élément

horizontal: les éléments fils seront disposés les uns à la suite des autres horizontalement
vertical: les éléments fils seront disposés les uns à la suite des autres verticalement

pack

persist

Liste l'ensemble des attributs de l'élément courant qui doivent persister d'une session à une autre.

Exemple : pour conserver les informations de largeur, de visibilité et d'ordre de tri d'une colonne d'arbre

  <treecol id="col1" persist="width hidden sortDirection" />

Cela permet de conserver les dernières valeurs des attributs width, hidden et sortDirection d'un élément treecol. Au prochain affichage de cet élément, ces valeurs d'attributs seront restaurées si elles existent.

NB : L'élément doit également comporter un attribut id. Les données sont enregistrées au format XML/RDF dans le fichier localstore.rdf dans le dossier du profil utilisateur.

popup

position

ref

removeelement

sortDirection

Indique le sens de tri des données générées à la volée par un template.

ascending: les données sont affichées dans l'ordre croissant
descending: les données sont affichées dans l'ordre décroissant
natural: les données sont affichées dans l'ordre où elles arrivent, typiquement c'est l'ordre dans lequel elles sont stokées dans le document XML/RDF d'où elles proviennent

A utiliser conjointement avec sortResource pour spécifier le critère de tri.

sortResource

Spécifie le critère de tri pour des données générées à la volée par un template. Le critère de tri est défini par l'URI de la ressource à trier, par exemple "http://home.netscape.com/NC-rdf#Name". L'attribut sortResource doit être placé sur l'élément qui comporte l'attribut datasources. Il est possible de spécifier un second critère de tri avec sortResource2.

sortResource2

Spécifie un second critère de tri pour des données générées par un template.