Résumé
Puisque ouvrir une nouvelle fenêtre sur une plateforme mobile n'est pas vraiment approprié, l'équipe de Firefox Mobile a créé la méthode importDialog()
pour remplacer window.openDialog()
. Au lieu d'ouvrir une nouvelle fenêtre, elle fusionne l'élément XUL dialog
spécifié avec la fenêtre principale.
Syntaxe
newDialog = importDialog(aParent, aSrc, aArguments)
-
newDialog
- La fenêtre ouverte.
-
aParent
-
L'élément parent de la boîte de dialogue. Peut être
null
. -
aSrc
- L'URL chrome vers la boîte de dialogue XUL.
-
aArguments
- Un objet JavaScript contenant les données à passer à la boîte de dialogue.
Exemple
newDialog = importDialog(aParent, aSrc, aArguments)
-
newDialog
- La fenêtre ouverte
-
aParent
-
La parent de la fenêtre, éventuellement
null
. -
aSrc
- L'URL chrome de la boîte de dialogue XUL.
-
aArguments
- Un objet JavaScript contenant les données à transférer à la boîte de dialogue.
Notes
Le XUL passé à la méthode importDialog()
est très similaire à celui passé à la méthode window.openDialog()
, avec cependant quelques limitations et mises en garde :
- La racine doit être un élément
<dialog>
. - Les scripts ne doivent pas être chargés via la balise
<script>
, mais depuis un attribut de l'élément<dialog>
.
Le XUL est fusionné avec la fenêtre spécifiée, un peu à la manière d'un overlay. En conséquence, des conflits entre les identifiants (attributs id
) et les scripts JavaScript sont possibles, comme avec les overlays. Prenez cela en considération.
Spécification
DOM Level 0. Ne fait partie d'aucune spécification.