From 80d00ef4100af00196385ee42a50f1cbfa2ab5c7 Mon Sep 17 00:00:00 2001 From: MDN Date: Tue, 12 Oct 2021 00:54:10 +0000 Subject: [CRON] sync translated content --- files/zh-cn/_redirects.txt | 3 + files/zh-cn/_wikihistory.json | 38 ++++----- .../web/api/mutationobserver/observe/index.html | 97 ++++++++++++++++++++++ .../index.html | 61 ++++++++++++++ .../index.html | 51 ++++++++++++ .../attributefilter/index.html | 96 --------------------- .../api/mutationobserverinit/childlist/index.html | 50 ----------- .../zh-cn/web/api/mutationobserverinit/index.html | 60 ------------- 8 files changed, 231 insertions(+), 225 deletions(-) create mode 100644 files/zh-cn/conflicting/web/api/mutationobserver/observe/index.html create mode 100644 files/zh-cn/conflicting/web/api/mutationobserver/observe_2f2addbfa1019c23a6255648d6526387/index.html create mode 100644 files/zh-cn/conflicting/web/api/mutationobserver/observe_7e3ecc5c48e14f4ecfdbe7d3aa534870/index.html delete mode 100644 files/zh-cn/web/api/mutationobserverinit/attributefilter/index.html delete mode 100644 files/zh-cn/web/api/mutationobserverinit/childlist/index.html delete mode 100644 files/zh-cn/web/api/mutationobserverinit/index.html (limited to 'files') diff --git a/files/zh-cn/_redirects.txt b/files/zh-cn/_redirects.txt index 7e1d111a54..ce34e4236f 100644 --- a/files/zh-cn/_redirects.txt +++ b/files/zh-cn/_redirects.txt @@ -1391,6 +1391,9 @@ /zh-CN/docs/Web/API/MediaStream.addTrack /zh-CN/docs/Web/API/MediaStream/addTrack /zh-CN/docs/Web/API/MouseEvent/which /zh-CN/docs/conflicting/Web/API/UIEvent/which /zh-CN/docs/Web/API/MouseWheelEvent /zh-CN/docs/conflicting/Web/API/WheelEvent +/zh-CN/docs/Web/API/MutationObserverInit /zh-CN/docs/conflicting/Web/API/MutationObserver/observe_2f2addbfa1019c23a6255648d6526387 +/zh-CN/docs/Web/API/MutationObserverInit/attributeFilter /zh-CN/docs/conflicting/Web/API/MutationObserver/observe +/zh-CN/docs/Web/API/MutationObserverInit/childList /zh-CN/docs/conflicting/Web/API/MutationObserver/observe_7e3ecc5c48e14f4ecfdbe7d3aa534870 /zh-CN/docs/Web/API/Navigator.battery /zh-CN/docs/Web/API/Navigator/battery /zh-CN/docs/Web/API/Navigator.buildID /zh-CN/docs/Web/API/Navigator/buildID /zh-CN/docs/Web/API/Navigator.cookieEnabled /zh-CN/docs/Web/API/Navigator/cookieEnabled diff --git a/files/zh-cn/_wikihistory.json b/files/zh-cn/_wikihistory.json index c6bbd17c16..e686e78005 100644 --- a/files/zh-cn/_wikihistory.json +++ b/files/zh-cn/_wikihistory.json @@ -17329,25 +17329,6 @@ "Y____C" ] }, - "Web/API/MutationObserverInit": { - "modified": "2020-10-15T22:14:47.970Z", - "contributors": [ - "RainSlide", - "Y____C" - ] - }, - "Web/API/MutationObserverInit/attributeFilter": { - "modified": "2020-10-15T22:30:44.792Z", - "contributors": [ - "hefang" - ] - }, - "Web/API/MutationObserverInit/childList": { - "modified": "2020-10-15T22:16:10.551Z", - "contributors": [ - "kivazqy" - ] - }, "Web/API/MutationRecord": { "modified": "2020-10-15T21:50:28.333Z", "contributors": [ @@ -47222,6 +47203,25 @@ "khalid32" ] }, + "conflicting/Web/API/MutationObserver/observe": { + "modified": "2020-10-15T22:30:44.792Z", + "contributors": [ + "hefang" + ] + }, + "conflicting/Web/API/MutationObserver/observe_2f2addbfa1019c23a6255648d6526387": { + "modified": "2020-10-15T22:14:47.970Z", + "contributors": [ + "RainSlide", + "Y____C" + ] + }, + "conflicting/Web/API/MutationObserver/observe_7e3ecc5c48e14f4ecfdbe7d3aa534870": { + "modified": "2020-10-15T22:16:10.551Z", + "contributors": [ + "kivazqy" + ] + }, "conflicting/Web/API/Node": { "modified": "2019-03-24T00:17:51.751Z", "contributors": [ diff --git a/files/zh-cn/conflicting/web/api/mutationobserver/observe/index.html b/files/zh-cn/conflicting/web/api/mutationobserver/observe/index.html new file mode 100644 index 0000000000..2d0d8966fa --- /dev/null +++ b/files/zh-cn/conflicting/web/api/mutationobserver/observe/index.html @@ -0,0 +1,97 @@ +--- +title: MutationObserverInit.attributeFilter +slug: conflicting/Web/API/MutationObserver/observe +tags: + - API + - DOM + - DOM WHATWG + - Mutation Observers + - MutationObserverInit + - 变化 + - 属性 + - 属性过滤器 + - 监听器 +translation_of: Web/API/MutationObserverInit/attributeFilter +original_slug: Web/API/MutationObserverInit/attributeFilter +--- +
{{APIRef("DOM WHATWG")}}
+ +

{{domxref("MutationObserverInit")}} 字典的可选属性 attributeFilter 是一个字符串数组，用于指定要监听变化的属性名称。 如果指定了该属性，则 {{domxref("MutationObserverInit.attributes", "attributes")}} 无论是否为 true，属性监听都将启用。

+ +

如果属性 {{domxref("MutationObserverInit.attributes", "attributes")}} 设置为 true ，但options对象中未包含 attributeFilter ，则所有属性的变化都会被监听。

+ +

语法

+ +
var options = {
+  attributeFilter: [ "list", "of", "attribute", "names" ]
+}
+
+ +

值

+ +

{{domxref("DOMString")}}数组， 每项指定一个要监听其变化的属性名称，没有默认值。

+ +

当使用构造函数{{domxref("MutationObserver.MutationObserver", "MutationObserver()")}}创建MutationObserver对象时，如果options对象中存在该属性，则无论{{domxref("MutationObserverInit.attributes", "attributes")}}是否为true，都将启用属性监听。

+ +

示例

+ +

在本示例中，设置了一个变化监听器来监听用于显示聊天室用户名的子树中所有元素的status和username属性的变化。这样就可以反应用户昵称或状态的更改， 例如，可以将用户标记为离开或离线。

+ +
function callback(mutationList) {
+  mutationList.forEach(function(mutation) {
+    switch(mutation.type) {
+      case "attributes":
+        switch(mutation.attributeName) {
+          case "status":
+            userStatusChanged(mutation.target.username, mutation.target.status);
+            break;
+          case "username":
+            usernameChanged(mutation.oldValue, mutation.target.username);
+            break;
+        }
+        break;
+    }
+  });
+}
+
+var userListElement = document.querySelector("#userlist");
+
+var observer = new MutationObserver(callback);
+observer.observe(userListElement, {
+  attributeFilter: [ "status", "username" ],
+  attributeOldValue: true,
+  subtree: true
+});
+ +

callback()函数将在监听器启动时传给{{domxref("MutationObserver.observe", "observe()")}}方法，用来检查{{domxref("MutationRecord")}}对象的每一项。对于代表属性更改的任何项（可以通过{{domxref("MutationRecord.type")}}的值为“ attributes”的值来检测），我们使用通过{{domxref("MutationRecord.attributeName")}}获得的属性名称来识别发生的更改的类型，然后将其分派给适当的处理函数。

+ +

请注意，在查找本地用户数组时可以使用{{domxref("MutationRecord.oldValue")}}来获取username的上一个值。

+ +

当observe()被调用时， options对象中指定了attributeFilter和{{domxref("MutationObserverInit.subtree", "subtree")}}，所以id为“userlist”的元素的所有子树的所有节点的属性值都会被监听。{{domxref("MutationObserverInit.attributeOldValue", "attributeOldValue")}}被设置为true，因为我们希望在监听到值变化时可以获取到上一个值。

+ +

规范

+ + + + + + + + + + + + + + + + +
规范状态说明
{{SpecName('DOM WHATWG', '#dom-mutationobserverinit-attributefilter', 'MutationObserverInit: attributeFilter')}}{{ Spec2('DOM WHATWG') }}
+ +

浏览器兼容性

+ +
+ + +

{{Compat("api.MutationObserverInit.attributeFilter")}}

+
diff --git a/files/zh-cn/conflicting/web/api/mutationobserver/observe_2f2addbfa1019c23a6255648d6526387/index.html b/files/zh-cn/conflicting/web/api/mutationobserver/observe_2f2addbfa1019c23a6255648d6526387/index.html new file mode 100644 index 0000000000..953ec5244e --- /dev/null +++ b/files/zh-cn/conflicting/web/api/mutationobserver/observe_2f2addbfa1019c23a6255648d6526387/index.html @@ -0,0 +1,61 @@ +--- +title: MutationObserverInit +slug: conflicting/Web/API/MutationObserver/observe_2f2addbfa1019c23a6255648d6526387 +tags: + - API + - DOM + - MutationObserver +translation_of: Web/API/MutationObserverInit +original_slug: Web/API/MutationObserverInit +--- +
{{APIRef("DOM WHATWG")}}
+ +

MutationObserverInit 字典描述了 MutationObserver 的配置。因此，它主要被用作 {{domxref("MutationObserver.observe()")}} 方法的参数类型。

+ +

属性

+ +

当调用 {{domxref("MutationObserver.observe", "observe()")}} 方法时，childList，attributes 或者 characterData 三个属性之中，至少有一个必须为 true，否则会抛出 TypeError 异常。

+ +
+
{{domxref("MutationObserverInit.attributeFilter", "attributeFilter")}} {{optional_inline}}
+
要监视的特定属性名称的数组。如果未包含此属性，则对所有属性的更改都会触发变动通知。无默认值。
+
{{domxref("MutationObserverInit.attributeOldValue", "attributeOldValue")}} {{optional_inline}}
+
当监视节点的属性改动时，将此属性设为 true 将记录任何有改动的属性的上一个值。有关观察属性更改和值记录的详细信息，详见{{SectionOnPage("/en-US/docs/Web/API/MutationObserver", "Monitoring attribute values")}}。无默认值。
+
{{domxref("MutationObserverInit.attributes", "attributes")}} {{optional_inline}}
+
设为 true 以观察受监视元素的属性值变更。默认值为 false。
+
{{domxref("MutationObserverInit.characterData", "characterData")}} {{optional_inline}}
+
设为 true 以监视指定目标节点或子节点树中节点所包含的字符数据的变化。无默认值。
+
{{domxref("MutationObserverInit.characterDataOldValue", "characterDataOldValue")}} {{optional_inline}}
+
设为 true 以在文本在受监视节点上发生更改时记录节点文本的先前值。详情及例子，请查看 {{SectionOnPage("/zh-CN/docs/Web/API/MutationObserver", "Monitoring text content changes")}}。无默认值。
+
{{domxref("MutationObserverInit.childList", "childList")}} {{optional_inline}}
+
设为 true 以监视目标节点（如果 subtree 为 true，则包含子孙节点）添加或删除新的子节点。默认值为 false。
+
{{domxref("MutationObserverInit.subtree", "subtree")}} {{optional_inline}}
+
设为 true 以将监视范围扩展至目标节点整个节点树中的所有节点。MutationObserverInit 的其他值也会作用于此子树下的所有节点，而不仅仅只作用于目标节点。默认值为 false。
+
+ +

规范

+ + + + + + + + + + + + + + + + +
规范状态批注
{{SpecName('DOM WHATWG', '#dictdef-mutationobserverinit', 'MutationObserverInit')}}{{ Spec2('DOM WHATWG') }}
+ +

浏览器兼容性

+ +
+ + +

{{Compat("api.MutationObserverInit")}}

+
diff --git a/files/zh-cn/conflicting/web/api/mutationobserver/observe_7e3ecc5c48e14f4ecfdbe7d3aa534870/index.html b/files/zh-cn/conflicting/web/api/mutationobserver/observe_7e3ecc5c48e14f4ecfdbe7d3aa534870/index.html new file mode 100644 index 0000000000..178f35ef38 --- /dev/null +++ b/files/zh-cn/conflicting/web/api/mutationobserver/observe_7e3ecc5c48e14f4ecfdbe7d3aa534870/index.html @@ -0,0 +1,51 @@ +--- +title: MutationObserverInit.childList +slug: conflicting/Web/API/MutationObserver/observe_7e3ecc5c48e14f4ecfdbe7d3aa534870 +translation_of: Web/API/MutationObserverInit/childList +original_slug: Web/API/MutationObserverInit/childList +--- +
{{APIRef("DOM WHATWG")}}
+ +

The {{domxref("MutationObserverInit")}} dictionary's optional childList property indicates whether or not to monitor the specified node or nodes for the addition or removal of new child nodes.

+ +

If childList is false (the default), adding or removing new nodes does not trigger mutation callbacks. By setting childList to true, your callback will be invoked any time nodes are added to or removed from the DOM node or nodes being watched.

+ +

Syntax

+ +
var options = {
+  childList: true | false
+}
+
+ +

Value

+ +

A Boolean value indicating whether or not to invoke the callback function when new nodes are added to or removed from the section of the DOM being monitored.. If {{domxref("MutationObserverInit.subtree", "subtree")}} is false, only the node indicated by the observer's target node is monitored for changes. Setting subtree to true causes addition or removal of nodes anywhere within the subtree rooted at target to be reported.

+ +

Example

+ +

Specifications

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('DOM WHATWG', '#dom-mutationobserverinit-childlist', 'MutationObserverInit.childList')}}{{ Spec2('DOM WHATWG') }} 
+ +

Browser compatibility

+ +
+ + +

{{Compat("api.MutationObserverInit.childList")}}

+
diff --git a/files/zh-cn/web/api/mutationobserverinit/attributefilter/index.html b/files/zh-cn/web/api/mutationobserverinit/attributefilter/index.html deleted file mode 100644 index 2855c3ee78..0000000000 --- a/files/zh-cn/web/api/mutationobserverinit/attributefilter/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: MutationObserverInit.attributeFilter -slug: Web/API/MutationObserverInit/attributeFilter -tags: - - API - - DOM - - DOM WHATWG - - Mutation Observers - - MutationObserverInit - - 变化 - - 属性 - - 属性过滤器 - - 监听器 -translation_of: Web/API/MutationObserverInit/attributeFilter ---- -
{{APIRef("DOM WHATWG")}}
- -

{{domxref("MutationObserverInit")}} 字典的可选属性 attributeFilter 是一个字符串数组，用于指定要监听变化的属性名称。 如果指定了该属性，则 {{domxref("MutationObserverInit.attributes", "attributes")}} 无论是否为 true，属性监听都将启用。

- -

如果属性 {{domxref("MutationObserverInit.attributes", "attributes")}} 设置为 true ，但options对象中未包含 attributeFilter ，则所有属性的变化都会被监听。

- -

语法

- -
var options = {
-  attributeFilter: [ "list", "of", "attribute", "names" ]
-}
-
- -

值

- -

{{domxref("DOMString")}}数组， 每项指定一个要监听其变化的属性名称，没有默认值。

- -

当使用构造函数{{domxref("MutationObserver.MutationObserver", "MutationObserver()")}}创建MutationObserver对象时，如果options对象中存在该属性，则无论{{domxref("MutationObserverInit.attributes", "attributes")}}是否为true，都将启用属性监听。

- -

示例

- -

在本示例中，设置了一个变化监听器来监听用于显示聊天室用户名的子树中所有元素的status和username属性的变化。这样就可以反应用户昵称或状态的更改， 例如，可以将用户标记为离开或离线。

- -
function callback(mutationList) {
-  mutationList.forEach(function(mutation) {
-    switch(mutation.type) {
-      case "attributes":
-        switch(mutation.attributeName) {
-          case "status":
-            userStatusChanged(mutation.target.username, mutation.target.status);
-            break;
-          case "username":
-            usernameChanged(mutation.oldValue, mutation.target.username);
-            break;
-        }
-        break;
-    }
-  });
-}
-
-var userListElement = document.querySelector("#userlist");
-
-var observer = new MutationObserver(callback);
-observer.observe(userListElement, {
-  attributeFilter: [ "status", "username" ],
-  attributeOldValue: true,
-  subtree: true
-});
- -

callback()函数将在监听器启动时传给{{domxref("MutationObserver.observe", "observe()")}}方法，用来检查{{domxref("MutationRecord")}}对象的每一项。对于代表属性更改的任何项（可以通过{{domxref("MutationRecord.type")}}的值为“ attributes”的值来检测），我们使用通过{{domxref("MutationRecord.attributeName")}}获得的属性名称来识别发生的更改的类型，然后将其分派给适当的处理函数。

- -

请注意，在查找本地用户数组时可以使用{{domxref("MutationRecord.oldValue")}}来获取username的上一个值。

- -

当observe()被调用时， options对象中指定了attributeFilter和{{domxref("MutationObserverInit.subtree", "subtree")}}，所以id为“userlist”的元素的所有子树的所有节点的属性值都会被监听。{{domxref("MutationObserverInit.attributeOldValue", "attributeOldValue")}}被设置为true，因为我们希望在监听到值变化时可以获取到上一个值。

- -

规范

- - - - - - - - - - - - - - - - -
规范状态说明
{{SpecName('DOM WHATWG', '#dom-mutationobserverinit-attributefilter', 'MutationObserverInit: attributeFilter')}}{{ Spec2('DOM WHATWG') }}
- -

浏览器兼容性

- -
- - -

{{Compat("api.MutationObserverInit.attributeFilter")}}

-
diff --git a/files/zh-cn/web/api/mutationobserverinit/childlist/index.html b/files/zh-cn/web/api/mutationobserverinit/childlist/index.html deleted file mode 100644 index 71574b7cea..0000000000 --- a/files/zh-cn/web/api/mutationobserverinit/childlist/index.html +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: MutationObserverInit.childList -slug: Web/API/MutationObserverInit/childList -translation_of: Web/API/MutationObserverInit/childList ---- -
{{APIRef("DOM WHATWG")}}
- -

The {{domxref("MutationObserverInit")}} dictionary's optional childList property indicates whether or not to monitor the specified node or nodes for the addition or removal of new child nodes.

- -

If childList is false (the default), adding or removing new nodes does not trigger mutation callbacks. By setting childList to true, your callback will be invoked any time nodes are added to or removed from the DOM node or nodes being watched.

- -

Syntax

- -
var options = {
-  childList: true | false
-}
-
- -

Value

- -

A Boolean value indicating whether or not to invoke the callback function when new nodes are added to or removed from the section of the DOM being monitored.. If {{domxref("MutationObserverInit.subtree", "subtree")}} is false, only the node indicated by the observer's target node is monitored for changes. Setting subtree to true causes addition or removal of nodes anywhere within the subtree rooted at target to be reported.

- -

Example

- -

Specifications

- - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('DOM WHATWG', '#dom-mutationobserverinit-childlist', 'MutationObserverInit.childList')}}{{ Spec2('DOM WHATWG') }} 
- -

Browser compatibility

- -
- - -

{{Compat("api.MutationObserverInit.childList")}}

-
diff --git a/files/zh-cn/web/api/mutationobserverinit/index.html b/files/zh-cn/web/api/mutationobserverinit/index.html deleted file mode 100644 index bdd0ee8178..0000000000 --- a/files/zh-cn/web/api/mutationobserverinit/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: MutationObserverInit -slug: Web/API/MutationObserverInit -tags: - - API - - DOM - - MutationObserver -translation_of: Web/API/MutationObserverInit ---- -
{{APIRef("DOM WHATWG")}}
- -

MutationObserverInit 字典描述了 MutationObserver 的配置。因此，它主要被用作 {{domxref("MutationObserver.observe()")}} 方法的参数类型。

- -

属性

- -

当调用 {{domxref("MutationObserver.observe", "observe()")}} 方法时，childList，attributes 或者 characterData 三个属性之中，至少有一个必须为 true，否则会抛出 TypeError 异常。

- -
-
{{domxref("MutationObserverInit.attributeFilter", "attributeFilter")}} {{optional_inline}}
-
要监视的特定属性名称的数组。如果未包含此属性，则对所有属性的更改都会触发变动通知。无默认值。
-
{{domxref("MutationObserverInit.attributeOldValue", "attributeOldValue")}} {{optional_inline}}
-
当监视节点的属性改动时，将此属性设为 true 将记录任何有改动的属性的上一个值。有关观察属性更改和值记录的详细信息，详见{{SectionOnPage("/en-US/docs/Web/API/MutationObserver", "Monitoring attribute values")}}。无默认值。
-
{{domxref("MutationObserverInit.attributes", "attributes")}} {{optional_inline}}
-
设为 true 以观察受监视元素的属性值变更。默认值为 false。
-
{{domxref("MutationObserverInit.characterData", "characterData")}} {{optional_inline}}
-
设为 true 以监视指定目标节点或子节点树中节点所包含的字符数据的变化。无默认值。
-
{{domxref("MutationObserverInit.characterDataOldValue", "characterDataOldValue")}} {{optional_inline}}
-
设为 true 以在文本在受监视节点上发生更改时记录节点文本的先前值。详情及例子，请查看 {{SectionOnPage("/zh-CN/docs/Web/API/MutationObserver", "Monitoring text content changes")}}。无默认值。
-
{{domxref("MutationObserverInit.childList", "childList")}} {{optional_inline}}
-
设为 true 以监视目标节点（如果 subtree 为 true，则包含子孙节点）添加或删除新的子节点。默认值为 false。
-
{{domxref("MutationObserverInit.subtree", "subtree")}} {{optional_inline}}
-
设为 true 以将监视范围扩展至目标节点整个节点树中的所有节点。MutationObserverInit 的其他值也会作用于此子树下的所有节点，而不仅仅只作用于目标节点。默认值为 false。
-
- -

规范

- - - - - - - - - - - - - - - - -
规范状态批注
{{SpecName('DOM WHATWG', '#dictdef-mutationobserverinit', 'MutationObserverInit')}}{{ Spec2('DOM WHATWG') }}
- -

浏览器兼容性

- -
- - -

{{Compat("api.MutationObserverInit")}}

-
-- cgit v1.2.3-54-g00ecf