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 id. Par exemple, si in élément dans un overlay a un id de filemenu, l'élément correspondant avec un 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 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.
Exemples
(exemple nécessaire)
Attributs
-
class - Type : chaîne de caractères
- La classe de style de l'élément. Plusieurs classes peuvent être spécifiées en les séparant par des espaces.
-
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.
Sujets liés
Référence de XUL overlay sur XULfr