Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

window.showModalDialog

Résumé

Crée et affiche un dialogue modal contenant un document HTML spécifié.

Cette fonction est obsolète.

Le support a été arrêté avec la sortie de Chrome 37. Il y possibilité de la laisser active juqu'en Mai 2015 en configurant les paramètres de politique d'entreprise, plus de détails : ici.

Mozilla a annoncé que le support de cette méthode sera supprimé (bug 981796). Ce changement ne sera pas effectif avant Firefox 39, planigié pour les alentours de mi-juin 2015. Pour les entreprises, il est possible d'utiliser le build ESR 38 qui supportera la méthode jusqu'en milieu d'année 2016.

Syntaxe

retour = window.showModalDialog(uri[,arguments][,options]);

  • retour est un variant, indiquant la propriété returnValue telle que définie par la fenêtre du document spécifié par uri.
  • uri est l'URI du document à afficher dans la boîte de dialogue.
  • arguments est un variant optionnel contenant les valeurs à passer à la boîte de dialogue ; celles-ci sont disponibles dans la propriété window.dialogArguments de son objet window.
  • options est une chaîne optionnelle spécifiant les décorations de la fenêtre de dialogue, avec une ou plusieurs valeurs séparées par des points-virgules :
Syntaxe Description
center: {on | off | yes | no | 1 | 0 } Si cette valeur est on, yes ou 1, la fenêtre de dialogue est centrée sur le bureau ; autrement elle est cachée. La valeur par défaut est yes.
dialogheight: height Spécifie la hauteur de la boîte de dialogue ; par défaut, la taille est spécifiée en pixels.
dialogleft: left Spécifie la position horizontale de la boîte de dialogue par rapport au coin supérieur gauche du bureau.
dialogwidth: width Spécifie la largeur de la boîte de dialogue ; par défaut, la taille est spécifiée en pixels.
dialogtop: top Spécifie la position verticale de la boîte de dialogue par rapport au coin supérieur gauche du bureau.
resizable: {on | off | yes | no | 1 | 0 } Si cette valeur est on, yes ou 1, la fenêtre de dialogue peut être redimensionnée par l'utilisateur ; autrement sa taille est fixe. La valeur par défaut est no.
scroll: {on | off | yes | no | 1 | 0 } Si cette valeur est on, yes ou 1, la fenêtre de dialogue a des barres de défilement ; autrement elle n'en a pas. La valeur par défaut est no.

Note : Firefox n'implémente pas les paramètres dialogHide, edge, status ou unadorned.

Compatibilité

Introduit par Microsoft Internet Explorer 4. Support ajouté à Firefox dans Firefox 3.

Exemples

Essayer showModalDialog().

Notes

Spécification

Microsoft MSDN : showModalDialog

 

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : fscholz, teoli, MatthieuHa, khalid32, Mgjbot, BenoitL
 Dernière mise à jour par : MatthieuHa,