Manuel de référence du programmeur XUL
|
||||||||||||||||||||||||||||||||||
<box>
<titledbox>
Le widget <box> fournit un usage universel et un mécanisme flexible de disposition. En utilisant des cadres, vous pouvez indiquer la position et le rapport de presque n'importe quelle combinaison de widgets dans l'IU. Beaucoup de widgets XUL héritent des cadres, incluant: Les cadres utilisent des "câbles" (flex) pour étirer leurs positions dans une IU. Les ressorts (springs) avec câble poussent les cadres, les contraignant à aller dans le conteneur parent. L'exemple suivant montre une disposition de cadre simple et de ressort en utilisant tous les attributs de base du cadre:
Cadre titreLe cadre titre est dérivé du cadre de base, mais supporte un élément enfant spécial pour fixer un titre comme label dans le conteneur du cadre, comme dans l'exemple suivant:
En outre, l'élément <titledbox> est identique au cadre.
|
||||||||||||||||||||||||||||||||||
align | ||||||||||||||||||||||||||||||||||
Description
align est un attribut facultatif qui indique le cadrage des enfants de l'élément actuel.Syntaxe <element align="left | right | center | vertical | horizontal">Exemple Notes La valeur par défaut pour align est left. En plus des valeurs left, center et right align supporte également "horizontal" et "vertical", bien que ces derniers soient tous deux désapprouvés. Rappelez-vous que l'attribut se réfère au cadrage des enfants et pas à l'élément parent.
|
||||||||||||||||||||||||||||||||||
valign | ||||||||||||||||||||||||||||||||||
Description
valign est un attribut facultatif qui indique le cadrage vertical des enfants de l'élément actuel.Syntaxe <element valign="top | middle | baseline | bottom ">Exemple Notes La valeur par défaut pour valign est middle. Rappelez-vous que l'attribut se réfère au cadrage vertical des enfants et pas à l'élément parent.
|
||||||||||||||||||||||||||||||||||
flex | ||||||||||||||||||||||||||||||||||
Description
flex est employé pour placer des widgets et pour établir leur flexibilité relative les uns par rapport aux autres.
<element flex="integer">Exemples Notes flex est une des principales manière de classer et arranger des widgets dans l'IU. En utilisant box, spring, flex et les widgets XUL fonctionnels dont vous avez besoin, vous pouvez disposer l'interface de la manière que vous voulez.
|
||||||||||||||||||||||||||||||||||
width | ||||||||||||||||||||||||||||||||||
Description
width est un attribut facultatif qui indique la largeur du cadre en pixel ou en pourcentage de l'espace disponible.Syntaxe <element width="largeur en pixels">Exemple Notes<menubar width="100px" style="background-color:lightblue;"> Quand vous n'indiquez pas une largeur ou hauteur, les cadres et les autres éléments compteront sur flex pour regarder comment occuper l'espace. Sans flex et aucun attribut de taille, un cadre prendra seulement l'espace nécessaire pour afficher les attributs de valeur ou de nom qui ont été indiqués.
|
||||||||||||||||||||||||||||||||||
height | ||||||||||||||||||||||||||||||||||
Description
height est un attribut facultatif qui indique la hauteur du cadre en pixel ou en pourcentage de l'espace disponible.Syntaxe <element height="height in pixels">Exemple Notes<menubar height="100" style="background-color:lightblue;"> Quand vous n'indiquez pas une largeur ou hauteur, les cadres et autres éléments compteront sur flex pour regarder comment occuper l'espace. Sans flex et aucun attribut de taille, un cadre prendra seulement l'espace nécessaire pour afficher les attributs de valeur ou de nom qui ont été indiqués.
|
||||||||||||||||||||||||||||||||||
autostretch | ||||||||||||||||||||||||||||||||||
Description
autostretch est un attribut facultatif d'un cadre auto-étiré (on ou off).Syntaxe <element autostretch="never | always">Exemple Notes<box autostretch="never" style="background-color:lightblue;"> L'attribut autostretch vous donne la possibilité d'étirer les éléments enfants d'un cadre pour les ajuster dans la direction opposée du cadre. Quand un cadre est aligné verticalement, par exemple, il étirera ses enfants horizontalement automatiquement à moins que vous ne l'indiquiez autrement. La figure ci-dessous montre comment l'autostretch empêche l'étirement des enfants du cadre bouton. |
||||||||||||||||||||||||||||||||||
orient | ||||||||||||||||||||||||||||||||||
Description
orient est un attribut facultatif qui indique le cadrage des enfants de l'élément actuel.Syntaxe <element orient="vertical | horizontal">Exemple Notes L'attribut orient prend la place de align pour orienter les éléments de l'enfant d'un élément mis bout à bout ou de manière longitudinale. Cependant, align accepte toujours "verticale" et "horizontal" comme valeurs, bien que celles-ci soient maintenant désapprouvées.
|
||||||||||||||||||||||||||||||||||
oncommand | ||||||||||||||||||||||||||||||||||
Description
oncommand est un attribut général auditeur d'événement qui est appelé quand l'utilisateur applique une action à l'élément.Syntaxe <element oncommand="code javascript dérouleur d'évènement">Exemple Notes<box oncommand="alert('Parent box got the event')"> <menulist ... ... </box> L'attribut oncommand est accessible à tous les éléments qui héritent d'un cadre (box est omniprésent dans le toolkit). Utilisez oncommand toutes les fois que vous voulez écrire un dérouleur d'événement pour un élément qui n'a pas encore d'attribut spécifique auditeur d'événement.
|
||||||||||||||||||||||||||||||||||