Manuel de référence du programmeur XUL
|
<window>
Attributs
|
L'élément racine d'un
fichier XUL et le premier niveau de l'interface est le widget
<window>. Tous les fichiers XUL
doivent contenir un et un seul élément window. L'interface entière de
XUL est définie dans cet élément racine.
|
title |
Description
L'attribut title indique le nom qui
apparaît dans la barre de titre de la fenêtre. Il est employé en
même temps que les autres d'attributs de titre pour
manipuler l'affichage d'information dans la barre
de titre à divers moments.
Syntaxe
title="window title"
où window title est une chaîne de caractère contenant le nom de
la fenêtre
Exemple
<window
id="sample"
title="Sample Window"
titlemodifier=" Sample">
Notes
Quand aucun contenu n'apparaît dans le browser,
l'attribut title est utilisé pour le titre. A partir du
moment où le contenu est chargé, la barre de titre affiche
le nom le contenu et puis le titlemodifier à
la place. Par exemple, quand Netcenter de Netscape
est chargé dans le browser Mozilla, la barre
de titre affiche "Netcenter - Mozilla".
Si vous intitulez vos fenêtres, assurez-vous que vous
employez tous les attributs de titre pour éviter
d'indiquer des incohérences dans la barre de titre.
|
titlemodifier |
Description
L'attribut titlemodifier indique la partie
du titre qui apparaît après que le contenu soit appelé.
Syntaxe
titlemodifier="window title"
où window title est une chaîne de caractères contenant le nom de
l'exemple.
Exemple
<window id="sample"
title="Sample Window"
titlemodifier=" Sample">
Notes
A partir du moment où le contenu est chargé, la barre de titre affiche
le nom du contenu et puis le titlemodifier à
la place. Par exemple, quand Netcenter de Netscape
est chargé dans le browser Mozilla, la barre
de titre affiche "Netcenter - Mozilla".
Si vous intitulez vos fenêtres, assurez-vous que vous
employez tous les attributs de titre pour éviter
d'indiquer des incohérences dans la barre de titre.
Si aucun contenu n'est chargé, le browser utilise
l'attribut régulier title.
|
titlemenuseparator |
Description
L'attribut titlemenuseparator indique la
chaîne de caractères qui sépare le nom et le titlemodifier.
Syntaxe
titlemenuseparator="characters"
où characters est une chaîne de caractères représentant le séparateur
Exemple
<window id="sample"
title="Sample Window"
titlemodifier=" Sample"
titlemenuseparator=" - ">
Notes
A partir du moment où le contenu est chargé dans le browser,
la barre de titre affiche le nom du contenu et le
titlemodifier séparé par le titlemenuseparator.
L'exemple XUL ci-dessus, quand il parcourt le site
de Netcenter, aurait comme conséquence l'affichage d'une barre de titre
"Netcenter - Sample".
Si vous intitulez vos fenêtres, assurez-vous que vous
employez tous les attributs de titre pour éviter
d'indiquer des incohérences dans la barre de titre.
Si aucun contenu n'est chargé, le browser utilise
l'attribut régulier title.
|
xmlns |
Description
L'attribut fenêtre xmlns est employé pour faire
des déclarations de namespace xml pour le fichier XUL.
Syntaxe
Les trois namespaces généralement déclarés dans un fichier XUL sont:
xmlns:html="http://www.w3.org/1999/xhtml"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
Notes
Les trois déclarations namespace listées
ci-dessus changent rarement. La première est la
déclaration namespace standard pour HTML 4.0,
et la seconde est la déclaration namespace
pour RDF, qui est employée pour organiser et afficher
des ressources dans le browser. La dernière,
qui pourrait changer d'ici à ce que XUL soit
entièrement normalisé, est la déclaration
namespace pour XUL lui-même. Gecko exige
cette déclaration afin de distinguer les éléments
XML de votre fichier XUL des widgets XUL.
|
onload |
Description
onload est un attribut dérouleur
d'événement pour l'élément de fenêtre racine.
L'événement de chargement est actionné à chaque fois que la fenêtre définie par
l'élément <window est chargée, ou est ouverte, mais avant que la fenêtre soit affichée.
Syntaxe
<window id="id"
title="title"
onload="javascript ou appel de fonction javascript"
Exemple
<window id="main-window"
title="Mozilla"
onload="StartupConfig()"
Notes
Pour créer un rappel
de l'événement de chargement, placez le Javascript dans l'auditeur
d'événement onload. Le Javascript peut être une série
de fonctions Javascript séparées par des
points-virgule ou un appel à une fonction
Javascript définie ailleurs. Tout changement de
configuration ou de contenu doit être fait
avant que les fenêtres d'affichage soient placées dans ce
rappel.
|
onunload |
Description
onunload est un auditeur d'événement pour
l'élément de fenêtre racine. L'événement de
déchargement est actionné chaque fois que
la fenêtre définie par l'élément <window est fermée ou
quittée, mais avant que la fenêtre ne disparaisse réellement.
Syntaxe
<window id="id"
title="title"
onunload="javascript ou appel de fonction javascript"
Exemple
<window id="main-window"
title="Mozilla"
onunload="WindowCloseExtras()>"
Notes
Aucune.
|
open() |
Description
open est la méthode de l'élément window pour ouvrir
d'autres fenêtres et dialogues XUL.
Syntaxe
window.open(URL[,
windowName[, windowFeatures]])
Exemple
window.open("chrome://help/content/help.xul",
"Help Window", "chrome")
Notes
L'argument windowFeatures vous permet d'indiquer des
dispositifs supplémentaires à la fenêtre ouverte.
titlebar - La fenêtre peut être créée avec ou sans barre de titre.
close - La fenêtre peut être créée avec ou sans widget associé.
chrome - Normalement, l'URL donnée à window.open est
traitée comme une URL de contenu. C'est-à-dire que Mozilla
produit une fenêtre browser et charge l'URL donnée dans sa zone de contenu,
comme window.open s'est toujours
comporté. Cependant, la présence d'un indicateur chrome dans le paramètre
windowFeatures aura pour effet que l'URL donnée sera traitée comme fenêtre chrome,
elle-même. Elle sera traitée comme contenu de fenêtre de haut niveau; elle ne sera pas
enveloppée dans une fenêtre browser. La fenêtre sera également dimensionnée pour envelopper son contenu.
dependent - La nouvelle fenêtre appartient à la fenêtre d'appel,
sur les systèmes d'exploitation qui
supportent ce comportement. C'est le genre de fenêtre
qui est réduite au minimum avec son parent, une fenêtre "popup"
ou "transient" (passagère), ou quelqu'autre mot que votre OS ait choisi d'utiliser.
dialog - Utilisation d'un cadre de fenêtre de type dialogue.
modal - La fenêtre sera exécutée de manière modale.
L'appel à window.open ne sera pas retourné jusqu'à ce que l'utilisateur ait
quitté la fenêtre. Notez que modal implique une dépendance à l'utilisateur.
Quand l'argument windowFeatures n'est pas donné,
l'ouvreur suppose que la ressource indiquée est contenue
par sa propre fenêtre et pas par une nouvelle fenêtre.
Voir openDialog() pour une méthode
bien plus flexible pour ouvrir de nouvelles fenêtres.
Comportement par défaut -
Comme toujours, si aucun paramètre n'est passé, tout le chrome est assumé
fonctionnel. Les exceptions sont les indicateurs de comportement
chrome, dependent, dialog et modal:
ceux-ci ne sont pas actionnés sauf de manière explicite. Si une chaîne de
caractères, même une chaîne de caractères vide, est donnée dans le paramètre de
fonctionnalité, tous les dispositifs non explicitement mentionnés sont assumés
hors service. titlebar et close sont les deux
exceptions: ils ne sont pas considérés hors fonction sauf explicitement
mentionné ("titlebar=no"), puisque toute autre chose briserait le script existant.
|
openDialog() |
Description
openDialog est une extension de la méthode des éléments open()
de fenêtre qui fournit un certain contrôle supplémentaire du processus
d'ouverture de nouvelles fenêtre dans l'IU.
Syntaxe
window.openDialog(URL[,
windowName[, windowFeatures[, args]]])
Exemple
window.openDialog("chrome://help/content/help.xul",
"Help Window", "chrome",
"special")
Notes
L'argument windowFeatures vous permet d'indiquer
les dispositifs supplémentaires de la fenêtre ouverte.
titlebar - La fenêtre peut être créée avec ou sans barre de titre.
close - La fenêtre peut être créée avec ou sans widget associé.
chrome - Normalement, l'URL donnée à window.open est
traitée comme une URL de contenu. C'est-à-dire que Mozilla
produit une fenêtre browser et charge l'URL donnée dans sa zone de contenu,
comme window.open s'est toujours
comporté. Cependant, la présence d'un indicateur chrome dans le paramètre
windowFeatures aura pour effet que l'URL donnée sera traitée comme fenêtre chrome,
elle-même. Elle sera traitée comme contenu de fenêtre de haut niveau; elle ne sera pas
enveloppée dans une fenêtre browser. La fenêtre sera également dimensionnée pour envelopper son contenu.
dependent - La nouvelle fenêtre appartient à la fenêtre d'appel,
sur les systèmes d'exploitation qui
supportent ce comportement. C'est le genre de fenêtre
qui est réduite au minimum avec son parent, une fenêtre "popup"
ou "transient" (passagère), ou quelqu'autre mot que votre OS ait choisi d'utiliser.
dialog - Utilisation d'un cadre de fenêtre de type dialogue.
modal - La fenêtre sera exécutée de manière modale.
L'appel à window.open ne sera pas retourné pas jusqu'à ce que l'utilisateur ait
quitté la fenêtre. Notez que modal implique une dépendance à l'utilisateur.
Quand l'argument windowFeatures n'est pas donné,
l'ouvreur suppose que la ressource indiquée est contenue
par sa propre fenêtre et pas par une nouvelle fenêtre.
Les paramètres supplémentaires que vous pouvez passer dans args sont
empaquetés dans un alignement JavaScript et ajoutés à la fenêtre nouvellement créée
comme propriétés d'arguments nominaux. Ils peuvent être mis en référence dans le JavaScript de
la fenêtre à tout moment, également pendant l'exécution d'un dérouleur onload. Ces paramètres
peuvent être employés pour passer des arguments à partir et vers la fenêtre de dialogue.
Comportement par défaut -
Le chrome et les fonctionnalités de dialogue sont toujours en fonction, à moins
qu'éteint explicitement ("chrome=no"). openDialog traite l'absence du paramètre de
fonctionnalité de la même manière que window.open, (c'est-à-dire, une chaîne de caractères vide place toutes les
fonctionnalités hors fonction) excepté chrome et dialog, qui sont en
fonction par défaut. Si le
paramètre de fonctionnalité est une chaîne de caractères de longueur nulle, ou contient seulement une
ou plusieurs des fonctionnalités de comportement (chrome,
dependent, dialog et modal)
les fonctionnalités du chrome dépendent du choix de l'OS. C'est-à-dire que le code de création
de fenêtre n'est pas donné par des instructions spécifiques mais il est laissé au
chrome le choix des meilleurs ajustements de dialogue en fonction du système.
|
sizeToContent() |
Description
sizeToContent() est la méthode de l'élément window
pour la ré-ouverture d'une fenêtre ouverte.
Syntaxe
window.sizeToContent()
Exemple
window.sizeToContent()
Notes
Ceci recharge le contenu de la fenêtre et enveloppe la fenêtre autour de ce contenu. Il
fonctionne même sur les fenêtres à taille fixe (c'est-à-dire les fenêtres avec
l'indicateur "resizable" invalidé). L'utilisation de cette fonction
est prévue avec les fenêtres à taille intrinsèque
(celles qui sont conçues pour s'envelopper en fonction de leur contenu) après avoir changé ce
contenu, vraisemblablement pendant l'exécution d'un dérouleur onload.
|