{{ ApiRef() }}
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, planifié 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.
retour = window.showModalDialog(uri[,arguments][,options]);
où
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.") }}
Introduit par Microsoft Internet Explorer 4. Support ajouté à Firefox dans Firefox 3.
Microsoft MSDN : showModalDialog
{{ languages( { "en": "en/DOM/window.showModalDialog", "ja": "ja/DOM/window.showModalDialog" } ) }}