window

par 2 contributeurs :

Décrit la structure d'une fenêtre de premier niveau. Il s'agit du nœud racine d'un document XUL. Forme par défaut une boîte orientée horizontalement. Comme il s'agit d'une boîte, tous les attributs de boîte peuvent être utilisés. Par défaut, la fenêtre aura un cadre spécifique à la plateforme pour l'entourer.

Pour assigner une icône à la fenêtre, créez un fichier d'icône spécifique à la plateforme <var><windowid></var>.ico et/ou <var><windowid></var>.xpm et placez ou installez ces fichiers dans le répertoire <var><répertoire-de-mozilla></var>/chrome/icons/default/. La valeur <var><windowid></var> est celle de l'attribut id de la fenêtre. Ceci permet d'avoir une icône différente pour chaque fenêtre.

Pour les propriétés et méthodes, consultez l'objet XUL Window sur XULPlanet ou sur XULfr .

D'autres informations sont disponibles dans le tutoriel XUL.

Attributs
height, hidechrome, id, screenX, screenY, sizemode, title, width, windowtype

Exemples

<?xml version="1.0"?>
<?xml-stylesheet href="chrome://global/skin/" type="text/css"?>
<window id="rootWnd" title="Enregistrement en ligne"
        xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
  <vbox>
    <hbox>
      <image src="formulaire_enregistrement.png"/>
      <description>Enregistrement en ligne</description>
    </hbox>
    <groupbox align="start">
      <caption label="Vos informations"/>
      <radiogroup>
        <vbox>
          <hbox>
            <label control="your-fname" value="Entrez le prénom :"/>
            <textbox id="your-fname" value="Johan"/>
          </hbox>
          <hbox>
            <label control="your-lname" value="Entrez le nom de famille :"/>
            <textbox id="your-lname" value="Hernandez"/>
          </hbox>
          <hbox>
            <button oncommand="alert('enregistrement')">
              <description>Enregistrer</description>
            </button>
          </hbox>
        </vbox>
      </radiogroup>
    </groupbox>
  </vbox>
</window>

Attributs

height
Type : chaîne de caractères (représentant un entier)
La hauteur préférée de l'élément en pixels. La hauteur réellement affichée peut être différentes si l'élément ou son contenu ont une hauteur minimum ou maximum. La propriété CSS height peut également être utilisée.
hidechrome
Type : booléen
Définissez cet attribut à true pour que le chrome, en ce compris la barre de titre, soit caché.
id
Type : id d'élément, doit être unique dans la fenêtre
Un identifiant unique permettant d'identifier l'élément. Celui-ci peut être utilisé comme paramètre pour getElementById() et d'autres fonctions DOM et pour référencer l'élément dans des feuilles de style.
screenX
Type : entier
La position horizontale à laquelle la fenêtre apparaît à l'écran.
screenY
Type : entier
La position verticale à laquelle la fenêtre apparaît à l'écran.


sizemode
Type : une des valeurs ci-dessous
L'état de la fenêtre (window). Les valeurs suivantes peuvent être utilisées :
  • maximized : La fenêtre est maximisée, et occupe la totalité de l'écran.
  • minimized : La fenêtre est minimisée, ou masquée.
  • normal : La fenêtre apparaît dans un état normal à la taille désirée.


title
Type : chaîne de caractères
Le texte qui doit apparaître dans la barre de titre de la fenêtre ou boîte de dialogue.


width
Type : chaîne de caractères (représentant un entier)
La largeur préférée de l'élément. La valeur ne doit pas préciser d'unité car elle est toujours exprimée en pixels. La largeur réellement affichée peut être différente si l'élément ou son contenu ont une largeur minimum ou maximum, ou que la taille est ajustée selon la flexibilité ou l'alignement de son parent. La propriété CSS width peut également être utilisée.
windowtype
Type : chaîne de caractères
Définit une chaîne pouvant être utilisée pour identifier le type de fenêtre. Celle-ci peut être utilisée, par exemple, pour faire la distinction entre une fenêtre de navigation et une fenêtre d'édition. Certaines des fonctions de gestion de fenêtres de Mozilla utilisent cet attribut pour grouper les fenêtres du même type.


Propriétés

Héritées de XUL element
align, attributes, allowEvents, baseURI, boxObject, builder, childElementCount, childNodes, children, className, clientHeight, clientLeft, clientTop, clientWidth, collapsed, contextMenu, controllers, database, datasources, dir, firstChild, firstElementChild, flex, height, hidden, id, lastChild, lastElementChild, left, localName, maxHeight, maxWidth, menu, minHeight, minWidth, namespaceURI, nextElementSibling, nextSibling, nodeName, nodeType, nodeValue, observes, ordinal, orient, ownerDocument, pack, parentNode, persist, prefix, previousElementSibling, previousSibling, ref, resource, scrollHeight, scrollLeft, scrollTop, scrollWidth, statusText, style, tagName,textContent, tooltip, tooltipText, top, width

Méthodes

Héritées de XUL element
blur, click, doCommand, focus, getElementsByAttribute

Héritées de DOM element
addEventListener(), appendChild(), dispatchEvent(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getElementsByTagName(), getElementsByTagNameNS(), hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isSupported(), normalize(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS()

Note

Le message d'erreur « XML Parsing Error: undefined entity...<window » peut être provoqué par l'indisponibilité ou l'absence d'un fichier DTD référencé dans le fichier XUL. Le chargement d'un fichier dont le nom suit le mot-clé SYSTEM dans une déclaration DOCTYPE peut échouer silencieusement et le seul message d'erreur sera une erreur d'entité non définie sur l'élément XUL suivant.

Sujets liés

Éléments
dialog, dialogheader

Notes des utilisateurs

Pour changer l'icône affichée dans la barre de titre d'une fenêtre, consultez la page Icônes de fenêtre.

Pour ajouter une icône de site (favicon) à la barre d'adresse et aux onglets de navigation (si le dialogue n'est pas un popup), utilisez l'extrait de code suivant pour utiliser l'espace de noms HTML et l'élément link.

<window xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
	xmlns:html="http://www.w3.org/1999/xhtml">

<!-- Icône du chrome -->
<html:link rel="icon" href="chrome://monExtension/content/chemin/vers/favicon.png"/>

<!-- Depuis un site distant -->
<html:link rel="icon" href="http://www.mozilla.org/favicon.ico"/>

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : lmorchard, BenoitL
Dernière mise à jour par : lmorchard,