From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/zh-cn/web/html/element/dialog/index.html | 179 +++++++++++++++++++++++++ 1 file changed, 179 insertions(+) create mode 100644 files/zh-cn/web/html/element/dialog/index.html (limited to 'files/zh-cn/web/html/element/dialog') diff --git a/files/zh-cn/web/html/element/dialog/index.html b/files/zh-cn/web/html/element/dialog/index.html new file mode 100644 index 0000000000..0b9ffdfd91 --- /dev/null +++ b/files/zh-cn/web/html/element/dialog/index.html @@ -0,0 +1,179 @@ +--- +title: +slug: Web/HTML/Element/dialog +tags: + - Dialog + - HTML + - 元素 + - 参考 + - 可交互 +translation_of: Web/HTML/Element/dialog +--- +
{{HTMLRef}}
+ +

HTML <dialog> 元素表示一个对话框或其他交互式组件，例如一个检查器或者窗口。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Content categoriesFlow content, sectioning root
Permitted contentFlow content
Tag omission{{no_tag_omission}}
Permitted parentsAny element that accepts flow content
Permitted ARIA roles{{ARIARole("alertdialog")}}
DOM interface{{domxref("HTMLDialogElement")}}
+ +

属性

+ +

这个元素包含了全局属性。但是 tabindex 特性不能被使用在 <dialog> 元素上。

+ +
+
{{htmlattrdef("open")}}
+
指示这个对话框是激活的和能互动的。当这个 open 特性没有被设置，对话框不应该显示给用户。
+
+ +

使用备注

+ + + +

Examples

+ +

简单的例子

+ +
<dialog open>
+  <p>Greetings, one and all!</p>
+</dialog>
+
+ +

高级示例

+ +

当单击“更新详细信息”按钮时，此示例打开一个包含一个表单的弹出对话框。

+ +

HTML

+ +
<!-- Simple pop-up dialog box containing a form -->
+<dialog id="favDialog">
+  <form method="dialog">
+    <p><label>Favorite animal:
+      <select>
+        <option></option>
+        <option>Brine shrimp</option>
+        <option>Red panda</option>
+        <option>Spider monkey</option>
+      </select>
+    </label></p>
+    <menu>
+      <button value="cancel">Cancel</button>
+      <button id="confirmBtn" value="default">Confirm</button>
+    </menu>
+  </form>
+</dialog>
+
+<menu>
+  <button id="updateDetails">Update details</button>
+</menu>
+
+<output aria-live="polite"></output>
+
+ +

JavaScript

+ +
(function() {
+  var updateButton = document.getElementById('updateDetails');
+  var favDialog = document.getElementById('favDialog');
+  var outputBox = document.getElementsByTagName('output')[0];
+  var selectEl = document.getElementsByTagName('select')[0];
+  var confirmBtn = document.getElementById('confirmBtn');
+
+  // “Update details” button opens the <dialog> modally
+  updateButton.addEventListener('click', function onOpen() {
+    if (typeof favDialog.showModal === "function") {
+      favDialog.showModal();
+    } else {
+      alert("The dialog API is not supported by this browser");
+    }
+  });
+  // "Favorite animal" input sets the value of the submit button
+  selectEl.addEventListener('change', function onSelect(e) {
+    confirmBtn.value = selectEl.value;
+  });
+  // "Confirm" button of form triggers "close" on dialog because of [method="dialog"]
+  favDialog.addEventListener('close', function onClose() {
+    outputBox.value = favDialog.returnValue + " button clicked - " + (new Date()).toString();
+  });
+})();
+
+
+ +

结果

+ +

{{EmbedLiveSample("Advanced_example", "100%", 300)}}

+ +

Which button was clicked can be determined from favDialog’s {{domxref("HTMLDialogElement.returnValue", "returnValue")}}.

+ +

规范

+ + + + + + + + + + + + + + + + + + + + + +
规范状态备注
{{SpecName('HTML WHATWG', 'forms.html#the-dialog-element', '<dialog>')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5.2', 'interactive-elements.html#the-dialog-element', '<dialog>')}}{{Spec2('HTML5.2')}}Initial definition
+ +

浏览器兼容性

+ + + +

{{Compat("html.elements.dialog")}}

+ +

Polyfill

+ +

Include this polyfill to provide support for older browsers.

+ +

dialog-polyfill

+ +

参见

+ + -- cgit v1.2.3-54-g00ecf