CodeGym /课程 /Frontend SELF ZH /对话标记元素

对话标记元素

Frontend SELF ZH
第 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 ZH, 第 10 级, 课程 4
已锁定
简单的对话框
简单的对话框
1
任务
Frontend SELF ZH, 第 10 级, 课程 4
已锁定
属性
属性
评论
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION