🪟
webのモーダルダイアログshowModalDialogの代替手段

2025/02/21に公開
JavaScript
IE時代にASP.NETでモーダルダイアログを表示する便利な手段として使われていたWindow.showModalDialog()。

主要なブラウザで使用できなくなって久しいのですが、未だに残っていたコードの移行を手がける機会があったので代替手段の一例について記載します。

 dialogタグを使用したモーダルダイアログの実現dialogタグを利用した、単体で動作するhtml実装例は以下の通りです。
<!DOCTYPE html>
<html lang="ja">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Dialog要素のデモ</title>
    <style>
        /* ダイアログの背景をカスタマイズ */
        dialog::backdrop {
            background: rgba(0, 0, 0, 0.5);
        }

        /* ダイアログ自体のスタイル */
        dialog {
            padding: 2rem;
            max-width: 500px;
            border-radius: 8px;
            border: none;
            box-shadow: 0 2px 10px rgba(0, 0, 0, 0.1);
        }

        /* ボタンのスタイル */
        button {
            padding: 8px 16px;
            margin: 5px;
            border: none;
            border-radius: 4px;
            cursor: pointer;
        }

        .open-button {
            background-color: #4CAF50;
            color: white;
        }

        .close-button {
            background-color: #f44336;
            color: white;
        }

        /* モーダル内のコンテンツレイアウト */
        .modal-content {
            display: flex;
            flex-direction: column;
            gap: 1rem;
        }

        .modal-buttons {
            display: flex;
            justify-content: flex-end;
            gap: 0.5rem;
        }
    </style>
</head>
<body>
    <h1>Dialog要素のデモ</h1>
    
    <!-- モーダルを開くボタン -->
    <button class="open-button" onclick="openModal()">モーダルを開く</button>

    <!-- ダイアログ要素 -->
    <dialog id="myDialog">
        <div class="modal-content">
            <h2>モーダルダイアログ</h2>
            <p>これは<code>&lt;dialog&gt;</code>要素を使用したモーダルダイアログです。</p>
            <p>背景をクリックしても閉じることができます。</p>
            
            <form method="dialog" class="modal-buttons">
                <button class="close-button" value="cancel">閉じる</button>
            </form>
        </div>
    </dialog>

    <script>
        const dialog = document.querySelector('#myDialog');

        // モーダルを開く関数
        function openModal() {
            dialog.showModal();
        }

        // ESCキーでの閉じる操作をハンドリング
        dialog.addEventListener('cancel', (event) => {
            event.preventDefault();
            dialog.close('cancelled');
        });

        // 背景クリックでの閉じる操作
        dialog.addEventListener('click', (event) => {
            const dialogDimensions = dialog.getBoundingClientRect();
            if (
                event.clientX < dialogDimensions.left ||
                event.clientX > dialogDimensions.right ||
                event.clientY < dialogDimensions.top ||
                event.clientY > dialogDimensions.bottom
            ) {
                dialog.close('cancelled');
            }
        });
    </script>
</body>
</html>

 補足情報showModalDialog() メソッドは現代のブラウザでは完全に廃止されています。主要ブラウザでの廃止時期は以下の通りです：
Chrome: バージョン37 (2014年)で削除
Firefox: バージョン56 (2017年)で削除
Edge: 旧EdgeHTML版、新Chromium版ともに利用不可
BootstrapなどのUIフレームワークが提供するモーダルコンポーネントを実装例についても確認したら追記したいと思います。
dialogタグを使用したモーダルダイアログの実現

補足情報

Discussion
