CodeGym /課程 /Frontend SELF TW /對話標記元素

對話標記元素

Frontend SELF TW
等級 10, 課堂 4
開放

4.1 <dialog> 元素

HTML5 還引入了 <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 物件的屬性(property),而不是 HTML 屬性(attribute),所以不會寫在標記裡。這個值由 close('值') 方法設定,或由 method="dialog" 表單中的按鈕設定——這時 returnValue 裡存放的是被按下按鈕的 value。如果用 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', () => { … })——「當元素被點擊時,執行括號裡的程式碼」。() => { … } 這種寫法是一個簡短的函式:稍後點擊時才會執行的程式碼。
  • 如果需要非模態視窗,請呼叫 show() 而不是 showModal()。

4.3 <dialog> 的事件

close 事件:

對話方塊關閉時觸發的事件。

HTML
    
      <div style="min-height: 200px">
        <dialog id="myDialog">
          <form method="dialog">
            <p>按下「取消」或「確定」按鈕來回傳值</p>
            <div class="dialog-buttons">
              <button value="cancel">取消</button>
              <button value="confirm">確定</button>
            </div>
          </form>
        </dialog>
        <button id="showDialog">顯示對話方塊</button>
      </div>
    
  
HTML
    
      <dialog id="myDialog">
        <form method="dialog">
          <p>按下「取消」或「確定」按鈕來回傳值</p>
          <div class="dialog-buttons">
            <button value="cancel">取消</button>
            <button value="confirm">確定</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 TW, 等級 10, 課堂 4
上鎖
簡單對話框
簡單對話框
1
任務
Frontend SELF TW, 等級 10, 課堂 4
上鎖
屬性
屬性
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION