overlay

  • Raccourci de la révision : XUL/overlay
  • Titre de la révision : overlay
  • ID de la révision : 234587
  • Créé :
  • Créateur : lmorchard
  • Version actuelle ? Oui
  • Commentaire 1 words added, 1 words removed

Contenu de la révision

{{ XULRefElem() }}

Un élément overlay s'utilise lorsque l'on désire qu'un bloc de contenu soit partagé entre différentes fenêtres. Il peut également être utilisé pour ajouter ou modifier le contenu d'une fenêtre existante. Un overlay se définit dans un fichier XUL séparé. Les overlays s'appliquent au cours du chargement du XUL.

Chaque élément au sein de l'overlay est inséré en place dans la fenêtre principale, selon la correspondance entre les attributs {{ XULAttr("id") }}. Par exemple, si in élément dans un overlay a un {{ XULAttr("id") }} de filemenu, l'élément correspondant avec un {{ XULAttr("id") }} filemenu dans la fenêtre principale qui utilise l'overlay sera modifié. Les attributs déclarés dans l'overlay sont ajoutés à cet élément et les éléments enfants sont insérés dans la fenêtre dans cet élément. Les éléments directement enfants de l'élément overlay qui n'ont pas d'attribut {{ XULAttr("id") }} sont ajoutés à la fenêtre principale. Ceci permet d'ajouter des scripts dans la fenêtre principale depuis l'overlay.

Les overlays n'ont pas d'évènement onload. Pour avoir un code d'initialisation dans un overlay, celui-ci doit être placé dans un script en dehors d'une fonction. C'est ce qu'on fait souvent pour appeler la méthode addEventListener afin d'écouter l'évènement load de la fenêtre qui ne se déclenchera que lorsque la fenêtre principale sera chargée et tout ses overlays appliqués.

Des overlays peuvent s'appliquer à des fenêtres dans d'autres packages. Les fichiers, comme les scripts, qui sont référencés depuis l'overlay doivent être spécifiés avec des URL absolues. Si vous utilisez une URL relative, elle sera relative à la fenêtre à laquelle l'overlay s'applique, pas au fichier de l'overlay.

Vous trouverez plus d'informations dans le Tutoriel XUL.

Attributs
{{ PrefAnch("a-", "class") }}, {{ PrefAnch("a-", "id") }}

Exemples

(exemple nécessaire)

Attributs

{{ XULAttrInc("class") }} {{ XULAttrInc("id") }}

Sujets liés

Référence de XUL overlay sur XULfr

{{ languages( { "en": "en/XUL/overlay", "ja": "ja/XUL/overlay", "pl": "pl/XUL/overlay" } ) }}

Source de la révision

<div class="noinclude">{{ XULRefElem() }}</div>
<p>Un élément overlay s'utilise lorsque l'on désire qu'un bloc de contenu soit partagé entre différentes fenêtres. Il peut également être utilisé pour ajouter ou modifier le contenu d'une fenêtre existante. Un <code>overlay</code> se définit dans un fichier XUL séparé. Les overlays s'appliquent au cours du chargement du XUL.</p>
<p>Chaque élément au sein de l'overlay est inséré en place dans la fenêtre principale, selon la correspondance entre les attributs {{ XULAttr("id") }}. Par exemple, si in élément dans un overlay a un {{ XULAttr("id") }} de <code>filemenu</code>, l'élément correspondant avec un {{ XULAttr("id") }} <code>filemenu</code> dans la fenêtre principale qui utilise l'overlay sera modifié. Les attributs déclarés dans l'overlay sont ajoutés à cet élément et les éléments enfants sont insérés dans la fenêtre dans cet élément. Les éléments directement enfants de l'élément <code>overlay</code> qui n'ont pas d'attribut {{ XULAttr("id") }} sont ajoutés à la fenêtre principale. Ceci permet d'ajouter des scripts dans la fenêtre principale depuis l'overlay.</p>
<p>Les overlays n'ont pas d'évènement <code>onload</code>. Pour avoir un code d'initialisation dans un overlay, celui-ci doit être placé dans un script en dehors d'une fonction. C'est ce qu'on fait souvent pour appeler la méthode <a href="/fr/DOM/element.addEventListener" title="fr/DOM/element.addEventListener">addEventListener</a> afin d'écouter l'évènement <code>load</code> de la fenêtre qui ne se déclenchera que lorsque la fenêtre principale sera chargée et tout ses overlays appliqués.</p>
<p>Des overlays peuvent s'appliquer à des fenêtres dans d'autres packages. Les fichiers, comme les scripts, qui sont référencés depuis l'overlay doivent être spécifiés avec des URL absolues. Si vous utilisez une URL relative, elle sera relative à la fenêtre à laquelle l'overlay s'applique, pas au fichier de l'overlay.</p>
<p>Vous trouverez plus d'informations dans le <a href="/fr/Tutoriel_XUL/Overlays" title="fr/Tutoriel_XUL/Overlays">Tutoriel XUL</a>.</p>
<dl> <dt>Attributs</dt> <dd>{{ PrefAnch("a-", "class") }}, {{ PrefAnch("a-", "id") }}</dd>
</dl>
<h3 id="Exemples" name="Exemples">Exemples</h3>
<p>(exemple nécessaire)</p>
<h3 id="Attributs" name="Attributs">Attributs</h3>
<p>{{ XULAttrInc("class") }} {{ XULAttrInc("id") }}</p>
<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s">Sujets liés</h3>
<p><a class="external" href="http://xulfr.org/wiki/Reference/Xul/overlay">Référence de XUL overlay</a> sur XULfr</p>

<p>{{ languages( { "en": "en/XUL/overlay", "ja": "ja/XUL/overlay", "pl": "pl/XUL/overlay" } ) }}</p>
Revenir à cette révision