CodeGym /コース /Frontend SELF JA /ダイアログのマークアップ要素

ダイアログのマークアップ要素

Frontend SELF JA
レベル 10, レッスン 4
使用可能

4.1 <dialog> 要素

HTML5 では、Web ページにダイアログボックスやモーダルウィンドウを作るための <dialog> 要素も登場しました。この要素を使えば、通知、確認、入力フォームなど、さまざまな用途のポップアップウィンドウを簡単に、しかもセマンティックに正しく作れます。ここからは、<dialog> の使い方、属性とメソッド、そして使用例を見ていきましょう。

<dialog> 要素は、ダイアログボックスやその他のインタラクティブなウィンドウを表します。モーダルにも非モーダルにもできます。<dialog> 要素の中には、テキスト、フォーム、ボタンなど、どんな HTML コンテンツでも配置できます。

構文:

HTML
    
      <dialog>
        <!-- ダイアログボックスの内容 -->
      </dialog>
    
  
HTML
    
      <div style="min-height: 200px;">
        <dialog id="favSuperHeroDialog">
          <form method="dialog">
            <div>
              <label for="favSuperHero">好きなスーパーヒーロー:</label>
              <select id="favSuperHero" name="favSuperHero">
                <option></option>
                <option>キャプテン・アメリカ</option>
                <option>アイアンマン</option>
                <option>ハルク</option>
              </select>
            </div>
            <div>
              <button type="reset" id="cancel">リセット</button>
              <button type="submit">確定</button>
            </div>
          </form>
        </dialog>
        <button id="updateDetails">ダイアログを開く</button>
      </div>
    
  
HTML
    
      <dialog id="favSuperHeroDialog">
        <form method="dialog">
          <div>
            <label for="favSuperHero">好きなスーパーヒーロー:</label>
            <select id="favSuperHero" name="favSuperHero">
              <option></option>
              <option>キャプテン・アメリカ</option>
              <option>アイアンマン</option>
              <option>ハルク</option>
            </select>
          </div>
          <div>
            <button type="reset" id="cancel">リセット</button>
            <button type="submit">確定</button>
          </div>
        </form>
      </dialog>
      <button id="updateDetails">ダイアログを開く</button>
    
  
JavaScript
    
// DOM からボタンとダイアログを取得する
const updateButton = document.getElementById("updateDetails");
const cancelButton = document.getElementById("cancel");
const dialog = document.getElementById("favSuperHeroDialog");

// ダイアログの状態(開いている/閉じている)をチェックする関数
function openCheck(dialog) {
 if (dialog.open) {
   console.log("ダイアログが開始されました");
 } else {
   console.log("ダイアログが終了しました");
 }
}

// Update ボタンがクリックされたらダイアログを開く
updateButton.addEventListener("click", () => {
 dialog.showModal();
 openCheck(dialog);
});

// Cancel ボタンがクリックされたらダイアログを閉じる
cancelButton.addEventListener("click", () => {
 dialog.close();
 openCheck(dialog);
});
    
  

4.2 <dialog> の属性とメソッド

open 属性は、ダイアログボックスが開いているかどうかを決めます。この属性があれば、ダイアログはページに表示されます。

open 属性の使用例:

HTML
    
      <dialog open>
        <p>これは開いているダイアログボックスです。</p>
      </dialog>
    
  

open 属性で表示したウィンドウは、常に非モーダルです。モーダルウィンドウは showModal() メソッドで開きます(詳しくは後述)。

returnValue プロパティには、結果を表す文字列、つまりウィンドウがどの値で閉じられたかが入ります。これはダイアログの JavaScript オブジェクトのプロパティで、HTML 属性ではありません。なので、マークアップには書きません。値を設定するのは close('値') メソッドか、method="dialog" を指定したフォームのボタンです。ボタンの場合は、押されたボタンの value が returnValue に入ります。Esc キーでウィンドウを閉じたときは、returnValue は変わりません。

JavaScript
    
dialog.close('confirm');
console.log(dialog.returnValue); // "confirm"
    
  

show() メソッド:

ダイアログボックスを非モーダルで開きます。

JavaScript
    
      dialog.show();
    
  

showModal() メソッド:

ダイアログボックスをモーダルで開き、ページのほかの部分を操作できないようにします。

JavaScript
    
      dialog.showModal();
    
  

close() メソッド:

ダイアログボックスを閉じます。

JavaScript
    
      dialog.close();
    
  

メソッドをボタンに「結びつける」方法:最小限の JavaScript

open 属性は、ページを読み込んだ時点ですぐにウィンドウを表示します。ボタンでウィンドウを開いたり閉じたりできるように、このレッスンでは JavaScript から show()、showModal()、close() メソッドを呼び出します。課題で必要になるのも、まさにこれらのメソッドです。言語そのものは後で詳しく学びます。今は次のテンプレートで十分です:

HTML
    
<button id="btn-open">ヒントを表示</button>
<dialog id="info-dialog">
  <p>ウィンドウのテキスト</p>
  <button id="btn-close">わかりました</button>
</dialog>

<script>
  // 1. id を使ってページの要素を見つける
  const openBtn = document.getElementById('btn-open');
  const closeBtn = document.getElementById('btn-close');
  const infoDialog = document.getElementById('info-dialog');

  // 2. 「ボタンがクリックされたら、波かっこ内のコードを実行して」
  openBtn.addEventListener('click', () => {
    infoDialog.showModal();   // モーダルで開く
  });

  closeBtn.addEventListener('click', () => {
    infoDialog.close();       // 閉じる
  });
</script>
    
  
  • <script> は <body> の最後に置きます。ブラウザーはスクリプトまで読み進めた時点ですぐにそれを実行するので、スクリプトより下の要素はまだ存在しません。そのため、getElementById が null を返してしまいます。
  • document.getElementById('…') は「この id を持つ要素をちょうだい」という意味です。
  • element.addEventListener('click', () => { … }) は「要素がクリックされたら、かっこ内のコードを実行して」という意味です。() => { … } という書き方は短い関数で、あとでクリックされたときに実行されるコードです。
  • 非モーダルのウィンドウにしたいときは、showModal() の代わりに show() を呼び出してください。

4.3 <dialog> のイベント

close イベント:

ダイアログボックスが閉じられたときに発生するイベントです。

HTML
    
      <div style="min-height: 200px">
        <dialog id="myDialog">
          <form method="dialog">
            <p>「キャンセル」または「OK」ボタンを押して値を返してください</p>
            <div class="dialog-buttons">
              <button value="cancel">キャンセル</button>
              <button value="confirm">OK</button>
            </div>
          </form>
        </dialog>
        <button id="showDialog">ダイアログを表示</button>
      </div>
    
  
HTML
    
      <dialog id="myDialog">
        <form method="dialog">
          <p>「キャンセル」または「OK」ボタンを押して値を返してください</p>
          <div class="dialog-buttons">
            <button value="cancel">キャンセル</button>
            <button value="confirm">OK</button>
          </div>
        </form>
      </dialog>
      <button id="showDialog">ダイアログを表示</button>
    
  
JavaScript
    
// DOM 要素を取得する
const dialog = document.getElementById('myDialog');
const showDialogButton = document.getElementById('showDialog');

// モーダルウィンドウを開く
showDialogButton.addEventListener('click', () => {
 dialog.showModal();
});

// 閉じたときに returnValue を表示する
dialog.addEventListener('close', () => {
 alert(`ダイアログが閉じられました。戻り値:${dialog.returnValue}`);
});
    
  

cancel イベント:

ダイアログボックスがキャンセルされたとき(たとえば Esc キーを押したとき)に発生するイベントです。

HTML
    
      <div style="min-height: 200px">
        <dialog id="myDialog">
          <form method="dialog">
            <p>「Esc」キーを押して結果を確認してください</p>
          </form>
        </dialog>
        <button id="showDialog">ダイアログを開く</button>
      </div>
    
  
HTML
    
      <dialog id="myDialog">
        <form method="dialog">
          <p>「Esc」キーを押して結果を確認してください</p>
        </form>
      </dialog>
      <button id="showDialog">ダイアログを開く</button>
    
  
JavaScript
    
// DOM 要素を取得する
const dialog = document.getElementById('myDialog');
const showDialogButton = document.getElementById('showDialog');

// ダイアログを開く
showDialogButton.addEventListener("click", () => {
 dialog.showModal();
});

// ダイアログのキャンセルを処理する(Esc キー)
dialog.addEventListener('cancel', () => {
 alert('Dialog was cancelled');
});
    
  
1
タスク
Frontend SELF JA, レベル 10, レッスン 4
ロック未解除
シンプルなダイアログウィンドウ
シンプルなダイアログウィンドウ
1
タスク
Frontend SELF JA, レベル 10, レッスン 4
ロック未解除
の属性
の属性
コメント
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION