document.loadOverlay

Résumé

Charge un overlay XUL et le fusionne avec le document courant, en notifiant un observateur lorsque la fusion est complète.

Utilisation

document.loadOverlay(url,observer);

url 

Une chaîne contenant l'URL absolue de l'overlay à charger.

observer 

Un objet implémentant nsIObserver qui sera notifié avec un message de type « xul-overlay-merged » lorsque la fusion sera complète, ou null si aucun observateur n'est nécessaire. Le paramètre subject d'observe devra implémenter nsIURI et contiendra l'URI de l'overlay fusionné.

Notes

Cette API n'est pas gelée et peut changer dans l'avenir.

Des appels concurrents à document.loadOverlay ne fonctionneront pas bug 330458. Il vous faudra vous appuyer sur les observateurs pour mettre dans une file différents chargements d'overlay consécutifs.

Le chargement d'un overlay avec la même URI deux fois de suite n'est actuellement pas supporté, même si cela peut parfois fonctionner.There's a comment in nsXULDocument::LoadOverlay to that effect.

Spécification

Méthode spécifique à XUL. Ne fait partie d'aucune spécification. Définie dans nsIDOMXULDocument.idl.