Manuel de référence du programmeur XUL

<window> Attributs

Attributs Enfants communs
title toolbar
titlemodified html:script 
titlemenuseparator menubar
id box
xmlns keyset
onload  
onunload  
windowtype Méthodes
align open()
width, height openDialog()
persist sizeToContent() 
x, y  
ondraggesture  

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"
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"
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"
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. 

 
 
 

 
 

Last updated: 2/17/00 Ian Oeschger
French version (7/10/00) Matthieu Camus