From 27f8f341052b3df3ae579fd1ad9f4f78c4517b61 Mon Sep 17 00:00:00 2001 From: Jason Lee Date: Sat, 28 May 2022 16:17:50 +0800 Subject: [PATCH 1/3] AutoCorrect files/zh-cn/web/api/selection/ --- .../web/api/selection/addrange/index.html | 2 +- .../web/api/selection/anchornode/index.html | 2 +- .../web/api/selection/anchoroffset/index.html | 2 +- .../web/api/selection/collapse/index.html | 4 ++-- .../web/api/selection/containsnode/index.html | 12 +++++----- .../selection/deletefromdocument/index.html | 2 +- .../web/api/selection/focusnode/index.html | 6 ++--- .../web/api/selection/focusoffset/index.html | 4 ++-- files/zh-cn/web/api/selection/index.html | 24 +++++++++---------- .../web/api/selection/iscollapsed/index.html | 2 +- .../zh-cn/web/api/selection/modify/index.html | 8 +++---- .../web/api/selection/rangecount/index.html | 14 +++++------ .../api/selection/removeallranges/index.html | 2 +- .../web/api/selection/removerange/index.html | 6 ++--- .../selection/selectallchildren/index.html | 4 ++-- .../api/selection/setbaseandextent/index.html | 24 +++++++++---------- .../web/api/selection/tostring/index.html | 12 +++++----- files/zh-cn/web/api/selection/type/index.html | 2 +- 18 files changed, 66 insertions(+), 66 deletions(-) diff --git a/files/zh-cn/web/api/selection/addrange/index.html b/files/zh-cn/web/api/selection/addrange/index.html index 3c0f54a082e5be..b0c6b14559567e 100644 --- a/files/zh-cn/web/api/selection/addrange/index.html +++ b/files/zh-cn/web/api/selection/addrange/index.html @@ -22,7 +22,7 @@

参数

例子

-
/* 在一个HTML文档中选中所有加粗的文本。 */
+
/* 在一个 HTML 文档中选中所有加粗的文本。 */
 
 var strongs = document.getElementsByTagName("strong");
 var s = window.getSelection();
diff --git a/files/zh-cn/web/api/selection/anchornode/index.html b/files/zh-cn/web/api/selection/anchornode/index.html
index b3a2211e77397d..3909341b401b8f 100644
--- a/files/zh-cn/web/api/selection/anchornode/index.html
+++ b/files/zh-cn/web/api/selection/anchornode/index.html
@@ -15,7 +15,7 @@ 

用法

注意

-

用户可能从左至右进行框选(沿着文字顺序)或者从右至左框选(沿着文字顺序的反方向)。锚点位于用户开始选择的位置。可以通过按住Shift和方向键来得知锚点所在的位置。选区的锚点是不会移动的,但是选区的焦点、选区其他的结束位置(多个选区,译者注)可以移动。

+

用户可能从左至右进行框选(沿着文字顺序)或者从右至左框选(沿着文字顺序的反方向)。锚点位于用户开始选择的位置。可以通过按住 Shift 和方向键来得知锚点所在的位置。选区的锚点是不会移动的,但是选区的焦点、选区其他的结束位置(多个选区,译者注)可以移动。

说明

diff --git a/files/zh-cn/web/api/selection/anchoroffset/index.html b/files/zh-cn/web/api/selection/anchoroffset/index.html index c590f342f0cf84..d738bcd9d4ee65 100644 --- a/files/zh-cn/web/api/selection/anchoroffset/index.html +++ b/files/zh-cn/web/api/selection/anchoroffset/index.html @@ -7,7 +7,7 @@
{{ ApiRef("DOM") }}{{SeeCompatTable}}
-

只读属性,返回选区的锚节点( {{domxref("Selection.anchorNode")}})起点偏移量的数字。返回值从零开始计数,如果选区从锚节点({{domxref("Selection.anchorNode")}})的第一个字符开始,返回值为0。

+

只读属性,返回选区的锚节点( {{domxref("Selection.anchorNode")}})起点偏移量的数字。返回值从零开始计数,如果选区从锚节点({{domxref("Selection.anchorNode")}})的第一个字符开始,返回值为 0。

语法

diff --git a/files/zh-cn/web/api/selection/collapse/index.html b/files/zh-cn/web/api/selection/collapse/index.html index 80a526f1fb2ee8..39c5a04ef2a0ff 100644 --- a/files/zh-cn/web/api/selection/collapse/index.html +++ b/files/zh-cn/web/api/selection/collapse/index.html @@ -31,7 +31,7 @@

参数

例子

-
/* 将光标收起到文档body的开头 */
+
/* 将光标收起到文档 body 的开头 */
 var body = document.getElementsByTagName("body")[0];
 window.getSelection().collapse(body,0);
 
@@ -67,5 +67,5 @@

浏览器兼容性

相关连接

    -
  • {{domxref("Selection")}}, 本方法所属的接口.
  • +
  • {{domxref("Selection")}}, 本方法所属的接口。
diff --git a/files/zh-cn/web/api/selection/containsnode/index.html b/files/zh-cn/web/api/selection/containsnode/index.html index 312afde97a6b08..d96b5ac935953b 100644 --- a/files/zh-cn/web/api/selection/containsnode/index.html +++ b/files/zh-cn/web/api/selection/containsnode/index.html @@ -5,7 +5,7 @@ ---
{{ ApiRef("DOM") }}{{SeeCompatTable}}
-

Selection.containsNode() 判断指定的节点是否包含在Selection中(是否被选中).

+

Selection.containsNode() 判断指定的节点是否包含在 Selection 中 (是否被选中).

语法

@@ -16,15 +16,15 @@

参数

aNode
-
用于判断是否包含在Selection中的那个节点
+
用于判断是否包含在 Selection 中的那个节点
aPartlyContained
-
当此参数为true时, 当selection包含节点aNode的一部分或全部时,containsNode()返回true.
- 当此参数为false时, 只有当selection完全包含节点aNode时,containsNode() 才返回true.
+
当此参数为true 时, 当selection 包含节点 aNode 的一部分或全部时,containsNode() 返回 true.
+ 当此参数为false 时, 只有当 selection 完全包含节点 aNode 时,containsNode() 才返回 true.

例子

-
 /* 检查body中是否有节点被选中 */
+
 /* 检查 body 中是否有节点被选中 */
  console.log(window.getSelection().containsNode(document.body, true));

相关规范

@@ -56,5 +56,5 @@

浏览器兼容性

参考

    -
  • {{domxref("Selection")}}, Selection接口规范.
  • +
  • {{domxref("Selection")}}, Selection 接口规范。
diff --git a/files/zh-cn/web/api/selection/deletefromdocument/index.html b/files/zh-cn/web/api/selection/deletefromdocument/index.html index f496bffff356d9..c6a684f5804430 100644 --- a/files/zh-cn/web/api/selection/deletefromdocument/index.html +++ b/files/zh-cn/web/api/selection/deletefromdocument/index.html @@ -2,7 +2,7 @@ title: Selection.deleteFromDocument() slug: Web/API/Selection/deleteFromDocument translation_of: Web/API/Selection/deleteFromDocument -original_slug: Web/API/Selection/从Document中删除 +original_slug: Web/API/Selection/从 Document 中删除 ---
diff --git a/files/zh-cn/web/api/selection/focusnode/index.html b/files/zh-cn/web/api/selection/focusnode/index.html index 2f5d6d18ec9e90..401130da3d746f 100644 --- a/files/zh-cn/web/api/selection/focusnode/index.html +++ b/files/zh-cn/web/api/selection/focusnode/index.html @@ -5,9 +5,9 @@ ---
{{ ApiRef("DOM") }}{{SeeCompatTable}}
-

Selection.focusNode是只读的返回所选内容的结束位置部分所属的节点.

+

Selection.focusNode是只读的返回所选内容的结束位置部分所属的节点。

-

用户可能会从左到右(按文字方向) 或从右到左 (按文字相反方向)进行选择. focusNode就是用户选择时最后停下来所处的元素节点. 当你同时按下shift键和任何一个方向键来改变选择时,你就能看到:选择的结束位置在移动, 但是选择的锚点-起始位置不会改变.

+

用户可能会从左到右 (按文字方向) 或从右到左 (按文字相反方向) 进行选择. focusNode 就是用户选择时最后停下来所处的元素节点。当你同时按下 shift 键和任何一个方向键来改变选择时,你就能看到:选择的结束位置在移动,但是选择的锚点 - 起始位置不会改变。

语法

@@ -43,5 +43,5 @@

浏览器兼容性参考

    -
  • {{domxref("Selection")}}, Selection接口规范.
  • +
  • {{domxref("Selection")}}, Selection 接口规范。
diff --git a/files/zh-cn/web/api/selection/focusoffset/index.html b/files/zh-cn/web/api/selection/focusoffset/index.html index 828c7bcfc5165b..1c67dcf0ca1ab8 100644 --- a/files/zh-cn/web/api/selection/focusoffset/index.html +++ b/files/zh-cn/web/api/selection/focusoffset/index.html @@ -2,7 +2,7 @@ title: Selection.focusOffset slug: Web/API/Selection/focusOffset tags: - - HTML编辑 + - HTML 编辑 - 只读 - 属性 - 选区 @@ -14,7 +14,7 @@
-

只读属性, 返回选区终点(鼠标松开瞬间所记录的那个点)在焦点({{domxref("Selection.focusNode")}})中的偏移量。返回值从零开始计数,如果选区({{domxref("Selection")}})在焦点({{domxref("Selection.focusNode")}})的第一个字符前结束,返回值为0。

+

只读属性, 返回选区终点(鼠标松开瞬间所记录的那个点)在焦点({{domxref("Selection.focusNode")}})中的偏移量。返回值从零开始计数,如果选区({{domxref("Selection")}})在焦点({{domxref("Selection.focusNode")}})的第一个字符前结束,返回值为 0。

语法

diff --git a/files/zh-cn/web/api/selection/index.html b/files/zh-cn/web/api/selection/index.html index c0fee39205bd48..aed3bfc37e70a0 100644 --- a/files/zh-cn/web/api/selection/index.html +++ b/files/zh-cn/web/api/selection/index.html @@ -17,7 +17,7 @@

用户可能从左到右(与文档方向相同)选择文本或从右到左(与文档方向相反)选择文本。anchor 指向用户开始选择的地方,而 focus 指向用户结束选择的地方。如果你使用鼠标选择文本的话,anchor 就指向你按下鼠标键的地方,而 focus 就指向你松开鼠标键的地方。anchor 和 focus 的概念不能与选区的起始位置和终止位置混淆,因为 anchor 指向的位置可能在 focus 指向的位置的前面,也可能在 focus 指向位置的后面,这取决于你选择文本时鼠标移动的方向(也就是按下鼠标键和松开鼠标键的位置)。

-

Selection 对象所对应的是用户所选择的 {{domxref("range","ranges")}} (区域),俗称拖蓝。默认情况下,该函数只针对一个区域,我们可以这样使用这个函数:

+

Selection 对象所对应的是用户所选择的 {{domxref("range","ranges")}}(区域),俗称拖蓝。默认情况下,该函数只针对一个区域,我们可以这样使用这个函数:

var selObj = window.getSelection();
@@ -25,7 +25,7 @@
 
    -
  • selObj 被赋予一个 Selection对象
  • +
  • selObj 被赋予一个 Selection 对象
  • range 被赋予一个 Range 对象

  • @@ -42,13 +42,13 @@

    术语表

    锚点 (anchor)
    -
    锚指的是一个选区的起始点(不同于HTML中的锚点链接,译者注)。当我们使用鼠标框选一个区域的时候,锚点就是我们鼠标按下瞬间的那个点。在用户拖动鼠标时,锚点是不会变的。
    +
    锚指的是一个选区的起始点(不同于 HTML 中的锚点链接,译者注)。当我们使用鼠标框选一个区域的时候,锚点就是我们鼠标按下瞬间的那个点。在用户拖动鼠标时,锚点是不会变的。
    焦点 (focus)
    选区的焦点是该选区的终点,当您用鼠标框选一个选区的时候,焦点是你的鼠标松开瞬间所记录的那个点。随着用户拖动鼠标,焦点的位置会随着改变。
    范围 (range)
    -
    范围指的是文档中连续的一部分。一个范围包括整个节点,也可以包含节点的一部分,例如文本节点的一部分。用户通常下只能选择一个范围,但是有的时候用户也有可能选择多个范围(例如当用户按下Control按键并框选多个区域时,Chrome中禁止了这个操作,译者注)。“范围”会被作为 {{domxref("Range")}} 对象返回。Range对象也能通过DOM创建、增加、删减。
    +
    范围指的是文档中连续的一部分。一个范围包括整个节点,也可以包含节点的一部分,例如文本节点的一部分。用户通常下只能选择一个范围,但是有的时候用户也有可能选择多个范围(例如当用户按下 Control 按键并框选多个区域时,Chrome 中禁止了这个操作,译者注)。“范围”会被作为 {{domxref("Range")}} 对象返回。Range 对象也能通过 DOM 创建、增加、删减。
    可编辑元素 (editing host)
    -
    一个用户可编辑的元素(例如一个使用 {{htmlattrxref("contenteditable")}} 的HTML元素,或是在启用了 {{domxref("Document.designMode", "designMode")}} 的 {{domxref("Document")}} 的子元素)。详见 开发者笔记
    +
    一个用户可编辑的元素(例如一个使用 {{htmlattrxref("contenteditable")}} 的 HTML 元素,或是在启用了 {{domxref("Document.designMode", "designMode")}} 的 {{domxref("Document")}} 的子元素)。详见 开发者笔记

    属性

    @@ -68,7 +68,7 @@

    属性

    {{domxref("Selection/focusOffset","focusOffset")}}{{ReadOnlyInline}}
    返回一个数字,其表示的是选区终点在 {{domxref("Selection/focusNode","focusNode")}} 中的位置偏移量。
      -
    1. 如果 focusNode 是文本节点,那么选区末尾未被选中的第一个字,在该文字节点中是第几个字(从0开始计),就返回它。
    2. +
    3. 如果 focusNode 是文本节点,那么选区末尾未被选中的第一个字,在该文字节点中是第几个字(从 0 开始计),就返回它。
    4. 如果 focusNode 是一个元素,那么返回的就是在选区末尾之后第一个节点之前的同级节点总数。
    @@ -104,7 +104,7 @@

    方法

    {{domxref("Selection/deleteFromDocument","deleteFromDocument")}}
    从页面中删除选区中的内容。
    {{domxref("Selection/selectionLanguageChange","selectionLanguageChange")}}
    -
    当键盘的朝向发生改变后修改指针的Bidi优先级。
    +
    当键盘的朝向发生改变后修改指针的 Bidi 优先级。
    {{domxref("Selection/toString","toString")}}
    返回当前选区的纯文本内容。
    {{domxref("Selection/containsNode","containsNode")}}
    @@ -143,7 +143,7 @@

    Selection 及输入焦点

    选择和输入焦点(由 {{domxref("Document.activeElement")}} 表示)有一个复杂的关系,该关系因浏览器而异。在跨浏览器兼容的代码中,最好分别处理它们。

    -

    Safari和Chrome(与Firefox不同)目前在以编程方式修改 Selection 时会将包含选区的元素作为焦点;这可能在将来会发生变化(请参见 W3C Bug 14383 和 {{WebKitBug("3869")}})。

    +

    Safari 和 Chrome(与 Firefox 不同)目前在以编程方式修改 Selection 时会将包含选区的元素作为焦点;这可能在将来会发生变化(请参见 W3C Bug 14383 和 {{WebKitBug("3869")}})。

    (目前在 WebKit 中,按钮等元素被直接点击不会修改选区,但会将焦点传递,译者注)

    @@ -159,7 +159,7 @@

    Selection A
  • 然后焦点(此处应指显示的,译者注)移到可编辑元素。
  • -

    注意:Selection API方法只能将焦点移动到可编辑元素,而不能移动到其他可焦点元素(例如{{HTMLElement("a")}})。

    +

    注意:Selection API 方法只能将焦点移动到可编辑元素,而不能移动到其他可焦点元素(例如{{HTMLElement("a")}})。

    上述行为适用于使用以下方法产生的选区:

    @@ -194,9 +194,9 @@

    浏览器兼容性

    Gecko 备注

      -
    • Gecko/Firefox 提供了其他功能,仅适用于Chrome(内置及插件)代码。 这些定义在 nsISelectionPrivate 中。
    • +
    • Gecko/Firefox 提供了其他功能,仅适用于 Chrome(内置及插件)代码。 这些定义在 nsISelectionPrivate 中。
    • Mozilla 实现源代码:{{Source("dom/webidl/Selection.webidl")}}
    • -
    • 在Firefox 29之前,{{domxref("Selection.selectionLanguageChange()")}}{{Obsolete_Inline("gecko29")}} 都会暴露在Web内容中。
    • +
    • 在 Firefox 29 之前,{{domxref("Selection.selectionLanguageChange()")}}{{Obsolete_Inline("gecko29")}} 都会暴露在 Web 内容中。

    扩展

    @@ -205,5 +205,5 @@

    扩展

  • {{domxref("window.getSelection")}},{{domxref("document.getSelection")}}及{{domxref("Range")}}
  • HTML5 DOM Range Interface Selection
  • IDL definition in Mozilla cross-reference
  • -
  • 目前 CSS 实现竖排文本较为通用的方式是什么?(页内搜索"Bidi"可了解Bidi优先顺序)
  • +
  • 目前 CSS 实现竖排文本较为通用的方式是什么?(页内搜索"Bidi"可了解 Bidi 优先顺序)
diff --git a/files/zh-cn/web/api/selection/iscollapsed/index.html b/files/zh-cn/web/api/selection/iscollapsed/index.html index 509b37f6bdb96b..0cd836f0c19916 100644 --- a/files/zh-cn/web/api/selection/iscollapsed/index.html +++ b/files/zh-cn/web/api/selection/iscollapsed/index.html @@ -10,4 +10,4 @@

用法

sel.isCollapsed
 

注意

-

即使是一个被折叠了的选区,其 rangeCount的结果也可能大于0。sel.getRangeAt(0)会在选区被折叠的情况下返回一个值。

+

即使是一个被折叠了的选区,其 rangeCount 的结果也可能大于 0。sel.getRangeAt(0) 会在选区被折叠的情况下返回一个值。

diff --git a/files/zh-cn/web/api/selection/modify/index.html b/files/zh-cn/web/api/selection/modify/index.html index 45896df7906b44..d9d0cf95acba2a 100644 --- a/files/zh-cn/web/api/selection/modify/index.html +++ b/files/zh-cn/web/api/selection/modify/index.html @@ -25,17 +25,17 @@

参数

alter
-
改变类型. 传入"move"来移动光标位置,或者"extend"来扩展当前选区。
+
改变类型。传入"move"来移动光标位置,或者"extend"来扩展当前选区。
direction
调整选区的方向。你可以传入"forward"或"backward"来根据选区内容的语言书写方向来调整。或者使用"left"或"right"来指明一个明确的调整方向。
granularity
调整的距离颗粒度。可选值有"character"、"word"、"sentence"、"line"、"paragraph"、"lineboundary"、"sentenceboundary"、"paragraphboundary"、"documentboundary"。
-
注意: Gecko 不支持 "sentence", "paragraph", "sentenceboundary", "paragraphboundary"和"documentboundary". Webkit和Blink 支持。
+
注意: Gecko 不支持 "sentence", "paragraph", "sentenceboundary", "paragraphboundary"和"documentboundary". Webkit 和 Blink 支持。
-

注意: 从{{Gecko("5.0")}}开始,不管是不是浏览器的默认行为,"word"颗粒度不再包括单词后面的空格。这让这个行为变得更加稳定,这也和之前的Webkit保持一致,然而不幸的是他们最近修改了这个默认行为。

+

注意: 从{{Gecko("5.0")}}开始,不管是不是浏览器的默认行为,"word"颗粒度不再包括单词后面的空格。这让这个行为变得更加稳定,这也和之前的 Webkit 保持一致,然而不幸的是他们最近修改了这个默认行为。

例子

@@ -57,5 +57,5 @@

浏览器兼容性相关链接

    -
  • {{domxref("Selection")}},本方法所属的接口.
  • +
  • {{domxref("Selection")}},本方法所属的接口。
diff --git a/files/zh-cn/web/api/selection/rangecount/index.html b/files/zh-cn/web/api/selection/rangecount/index.html index f45d6ae53fb985..92529134225e6f 100644 --- a/files/zh-cn/web/api/selection/rangecount/index.html +++ b/files/zh-cn/web/api/selection/rangecount/index.html @@ -12,13 +12,13 @@ -

The Selection.rangeCount是一个返回选区(selection)中range对象数量的只读属性。

+

The Selection.rangeCount是一个返回选区 (selection) 中 range 对象数量的只读属性。

-

在网页使用者点击一个加载完毕的新打开的页面之前,rangeCount的值是0。在使用者点击页面之后,rangeCount的值变为1,即使并没有可视的选区(selection)。

+

在网页使用者点击一个加载完毕的新打开的页面之前,rangeCount的值是 0。在使用者点击页面之后,rangeCount 的值变为 1,即使并没有可视的选区 (selection)。

-

使用者一般情况下在一次只能选择一个range ,所以通常情况下rangeCount属性的值总为1。脚本(如javascript)可以使选区包含多个range。

+

使用者一般情况下在一次只能选择一个 range ,所以通常情况下rangeCount 属性的值总为 1。脚本 (如 javascript) 可以使选区包含多个 range。

-

Gecko 浏览器允许跨表格单元格获得多个选区(此处可能翻译不准). Firefox allows to select multiple ranges in the document by using Ctrl+click (unless the click within an element with display: table-cell).

+

Gecko 浏览器允许跨表格单元格获得多个选区 (此处可能翻译不准). Firefox allows to select multiple ranges in the document by using Ctrl+click (unless the click within an element with display: table-cell).

用法

@@ -27,12 +27,12 @@

用法

例子

-

下面这个例子会每隔一秒显示一次rangeCount的值。在浏览器中选择文本,然后看看他的改变。

+

下面这个例子会每隔一秒显示一次 rangeCount 的值。在浏览器中选择文本,然后看看他的改变。

HTML Content

-
//打开控制台看看selection中有多少range对象。
-//在Gecko浏览器,当你用鼠标在表格单元格中拖动的同时按住Ctrl,你可以选择多个range。
+
//打开控制台看看 selection 中有多少 range 对象。
+//在 Gecko 浏览器,当你用鼠标在表格单元格中拖动的同时按住 Ctrl,你可以选择多个 range。
 
 <table>
 <tr><td>a.1<td>a.2
diff --git a/files/zh-cn/web/api/selection/removeallranges/index.html b/files/zh-cn/web/api/selection/removeallranges/index.html
index 656793f37b10d9..122b0e12315b19 100644
--- a/files/zh-cn/web/api/selection/removeallranges/index.html
+++ b/files/zh-cn/web/api/selection/removeallranges/index.html
@@ -9,7 +9,7 @@
 
 
 
-

Selection.removeAllRanges()方法会从当前selection对象中移除所有的range对象,取消所有的选择只 留下{{domxref("Selection.anchorNode", "anchorNode")}} 和{{domxref("Selection.focusNode","focusNode")}}属性并将其设置为null。

+

Selection.removeAllRanges() 方法会从当前 selection 对象中移除所有的 range 对象,取消所有的选择只 留下{{domxref("Selection.anchorNode", "anchorNode")}} 和{{domxref("Selection.focusNode","focusNode")}}属性并将其设置为 null。

语法

diff --git a/files/zh-cn/web/api/selection/removerange/index.html b/files/zh-cn/web/api/selection/removerange/index.html index 29b2c893d4152e..2de089b2847d05 100644 --- a/files/zh-cn/web/api/selection/removerange/index.html +++ b/files/zh-cn/web/api/selection/removerange/index.html @@ -16,12 +16,12 @@

参数

range
- Range对象将从选区当中移除。
+ Range 对象将从选区当中移除。

Examples

-
/* 通过设计一段js代码,我们可以获得多个区域,
+
/* 通过设计一段 js 代码,我们可以获得多个区域,
  * 这段代码可以移除除了第一个区域之外的所有区域。
- * (此代码在Chrome中不生效,因为Chrome当中只能
+ *(此代码在 Chrome 中不生效,因为 Chrome 当中只能
  * 选择一个选区,哎我为什么要在 Mozilla 的网站上
  * 说这个?译者注)*/
 
diff --git a/files/zh-cn/web/api/selection/selectallchildren/index.html b/files/zh-cn/web/api/selection/selectallchildren/index.html
index eae930d887c9b0..082f306c36e8bb 100644
--- a/files/zh-cn/web/api/selection/selectallchildren/index.html
+++ b/files/zh-cn/web/api/selection/selectallchildren/index.html
@@ -9,7 +9,7 @@
 
 
 
-

Selection.selectAllChildren()把指定元素的所有子元素设为选中区域,并取消之前的选中区域。

+

Selection.selectAllChildren() 把指定元素的所有子元素设为选中区域,并取消之前的选中区域。

用法

@@ -20,7 +20,7 @@

参数

parentNode
-
所有parentNode元素的子元素会被设为选中区域,parentNode本身除外。
+
所有 parentNode 元素的子元素会被设为选中区域,parentNode 本身除外。

举例

diff --git a/files/zh-cn/web/api/selection/setbaseandextent/index.html b/files/zh-cn/web/api/selection/setbaseandextent/index.html index 28af4e38d3192b..90025c855c7c62 100644 --- a/files/zh-cn/web/api/selection/setbaseandextent/index.html +++ b/files/zh-cn/web/api/selection/setbaseandextent/index.html @@ -5,7 +5,7 @@ ---
{{ ApiRef("DOM") }}{{SeeCompatTable}}
-

setBaseAndExtent()方法是{{domxref("Selection")}}接口用来选中并设置在两个特定的DOM节点中文本选中的范围, 并且选中的任何内容都位于两个节点之间.

+

setBaseAndExtent() 方法是{{domxref("Selection")}}接口用来选中并设置在两个特定的 DOM 节点中文本选中的范围,并且选中的任何内容都位于两个节点之间。

语法

@@ -16,17 +16,17 @@

参数

anchorNode
-
锚节点-选中内容的开始节点
+
锚节点 - 选中内容的开始节点
anchorOffset
-
选中范围内起点位置在锚节点下第几个子节点的位置.例如,如果是值为0的话,整个节点都是被选中的. 如果值为1的话,那么至少整个节点至少有一个子节点被选中. 以此类推.
+
选中范围内起点位置在锚节点下第几个子节点的位置。例如,如果是值为 0 的话,整个节点都是被选中的。如果值为 1 的话,那么至少整个节点至少有一个子节点被选中。以此类推。
focusNode
-
焦点节点-选中内容的结尾节点
+
焦点节点 - 选中内容的结尾节点
focusOffset
-
选中范围内结束位置在焦点节点下第几个子节点的位置.例如,如果是值为0的话,整个节点都是被选中的. 如果值为1的话,那么至少整个节点至少有一个子节点被选中. 以此类推.
+
选中范围内结束位置在焦点节点下第几个子节点的位置。例如,如果是值为 0 的话,整个节点都是被选中的。如果值为 1 的话,那么至少整个节点至少有一个子节点被选中。以此类推。
-

Note: 如果源代码中焦点节点出现在锚节点之前的话, 这两个将在参数中互换位置, 也就是锚节点变为了焦点节点、焦点节点变为了锚节点. 另外, 这些参数的用法会颠倒 — 插入符是放置在文本的开头而不是结尾,这对于任何可能遵循这规则的键盘命令都是很重要的.例如, Shift + ➡︎ 会使选中状态范围的从开始缩小,而不是在结尾增加.

+

Note: 如果源代码中焦点节点出现在锚节点之前的话,这两个将在参数中互换位置,也就是锚节点变为了焦点节点、焦点节点变为了锚节点。另外,这些参数的用法会颠倒 — 插入符是放置在文本的开头而不是结尾,这对于任何可能遵循这规则的键盘命令都是很重要的。例如,Shift + ➡︎ 会使选中状态范围的从开始缩小,而不是在结尾增加。

返回值

@@ -35,15 +35,15 @@

返回值

说明

-

如果锚偏移值超过了锚节点内部的子节点个数, 或则如果焦点偏移值超过了焦点节点内部的子节点个数, 这个{{domxref("IndexSizeError")}} 选中会被丢弃.

+

如果锚偏移值超过了锚节点内部的子节点个数,或则如果焦点偏移值超过了焦点节点内部的子节点个数,这个{{domxref("IndexSizeError")}} 选中会被丢弃。

示例

-

一个例子, 我们有两个包含多个span的段落, 每一个span包含一个单词. 然后第一个段落作为锚节点并且第二个作为焦点节点.我们还有一个额外的段落插入在两个节点之间.

+

一个例子,我们有两个包含多个 span 的段落,每一个 span 包含一个单词。然后第一个段落作为锚节点并且第二个作为焦点节点.我们还有一个额外的段落插入在两个节点之间。

-

然后, 这里有两个允许你去设置锚节点和焦点节点的表单输入框 — 它们都有一个默认值为0.

+

然后,这里有两个允许你去设置锚节点和焦点节点的表单输入框 — 它们都有一个默认值为 0.

-

这里还有一个按钮用来点击调用运行包含setBaseAndExtent()方法的函数, 最后输出选中内容到HTML的最底部.

+

这里还有一个按钮用来点击调用运行包含setBaseAndExtent()方法的函数,最后输出选中内容到 HTML 的最底部。

<h1>setBaseAndExtent example</h1>
 <div>
@@ -66,7 +66,7 @@ 

示例

<p><strong>Output</strong>: <span class="output"></span></p>
-

JavaScript像这样:

+

JavaScript 像这样:

var one = document.querySelector('.one');
 var two = document.querySelector('.two');
@@ -91,7 +91,7 @@ 

示例

} }
-

在下面在线运行实例, 设置不同的偏移值去观察它怎么去影响选中内容的.

+

在下面在线运行实例,设置不同的偏移值去观察它怎么去影响选中内容的。

{{ EmbedLiveSample('Examples', '100%', 370) }}

diff --git a/files/zh-cn/web/api/selection/tostring/index.html b/files/zh-cn/web/api/selection/tostring/index.html index b4747dceadf857..fdcc57be5b8910 100644 --- a/files/zh-cn/web/api/selection/tostring/index.html +++ b/files/zh-cn/web/api/selection/tostring/index.html @@ -9,7 +9,7 @@ -

Selection.toString()返回代表当前selection对象的字符串,例如当前选择的文本文字.

+

Selection.toString()返回代表当前 selection 对象的字符串,例如当前选择的文本文字。

语法

@@ -19,18 +19,18 @@

语法

返回值

    -
  • str 代表selection的字符串.
  • +
  • str 代表 selection 的字符串。

参数

-

无.

+

无。

描述

-

此方法返回当前被选中的文本文字.

+

此方法返回当前被选中的文本文字。

-

JavaScript中, 当selection对象作为字符串类型使用时,此方法会被自动调用:

+

JavaScript中,当 selection 对象作为字符串类型使用时,此方法会被自动调用:

alert(window.getSelection()) // 被调用时
 alert(window.getSelection().toString())  // 真实情况
@@ -60,5 +60,5 @@ 

浏览器兼容性参考

    -
  • {{domxref("Selection")}}, Selection接口规范.
  • +
  • {{domxref("Selection")}}, Selection 接口规范。
diff --git a/files/zh-cn/web/api/selection/type/index.html b/files/zh-cn/web/api/selection/type/index.html index bcf3f7b35d8675..6844c88dfa0aa7 100644 --- a/files/zh-cn/web/api/selection/type/index.html +++ b/files/zh-cn/web/api/selection/type/index.html @@ -18,7 +18,7 @@

语法

Value

-

{{domxref("DOMString")}} 描述的是当前选择的类型。可能的值为:

+

{{domxref("DOMString")}} 描述的是当前选择的类型。可能的值为:

  • None: 当前没有选择。
  • From a770125a78a151e6f14856e073759b5c5f50008d Mon Sep 17 00:00:00 2001 From: Jason Lee Date: Fri, 3 Jun 2022 11:38:28 +0800 Subject: [PATCH 2/3] Fix again --- files/zh-cn/web/api/selection/focusnode/index.html | 2 +- files/zh-cn/web/api/selection/index.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/files/zh-cn/web/api/selection/focusnode/index.html b/files/zh-cn/web/api/selection/focusnode/index.html index 401130da3d746f..bac92930652247 100644 --- a/files/zh-cn/web/api/selection/focusnode/index.html +++ b/files/zh-cn/web/api/selection/focusnode/index.html @@ -7,7 +7,7 @@

    Selection.focusNode是只读的返回所选内容的结束位置部分所属的节点。

    -

    用户可能会从左到右 (按文字方向) 或从右到左 (按文字相反方向) 进行选择. focusNode 就是用户选择时最后停下来所处的元素节点。当你同时按下 shift 键和任何一个方向键来改变选择时,你就能看到:选择的结束位置在移动,但是选择的锚点 - 起始位置不会改变。

    +

    用户可能会从左到右 (按文字方向) 或从右到左 (按文字相反方向) 进行选择。focusNode 就是用户选择时最后停下来所处的元素节点。当你同时按下 shift 键和任何一个方向键来改变选择时,你就能看到:选择的结束位置在移动,但是选择的锚点 - 起始位置不会改变。

    语法

    diff --git a/files/zh-cn/web/api/selection/index.html b/files/zh-cn/web/api/selection/index.html index aed3bfc37e70a0..3054387424310e 100644 --- a/files/zh-cn/web/api/selection/index.html +++ b/files/zh-cn/web/api/selection/index.html @@ -194,7 +194,7 @@

    浏览器兼容性

    Gecko 备注

      -
    • Gecko/Firefox 提供了其他功能,仅适用于 Chrome(内置及插件)代码。 这些定义在 nsISelectionPrivate 中。
    • +
    • Gecko/Firefox 提供了其他功能,仅适用于 Chrome(内置及插件)代码。这些定义在 nsISelectionPrivate 中。
    • Mozilla 实现源代码:{{Source("dom/webidl/Selection.webidl")}}
    • 在 Firefox 29 之前,{{domxref("Selection.selectionLanguageChange()")}}{{Obsolete_Inline("gecko29")}} 都会暴露在 Web 内容中。
    From b34992b0d8fd79ec659813391bdba6bd9e1add8e Mon Sep 17 00:00:00 2001 From: A1lo Date: Fri, 3 Jun 2022 12:34:10 +0800 Subject: [PATCH 3/3] Apply suggestions from code review --- files/zh-cn/web/api/selection/deletefromdocument/index.html | 2 +- files/zh-cn/web/api/selection/focusnode/index.html | 2 +- files/zh-cn/web/api/selection/focusoffset/index.html | 2 +- files/zh-cn/web/api/selection/removeallranges/index.html | 2 +- files/zh-cn/web/api/selection/setbaseandextent/index.html | 2 +- files/zh-cn/web/api/selection/tostring/index.html | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/files/zh-cn/web/api/selection/deletefromdocument/index.html b/files/zh-cn/web/api/selection/deletefromdocument/index.html index c6a684f5804430..f496bffff356d9 100644 --- a/files/zh-cn/web/api/selection/deletefromdocument/index.html +++ b/files/zh-cn/web/api/selection/deletefromdocument/index.html @@ -2,7 +2,7 @@ title: Selection.deleteFromDocument() slug: Web/API/Selection/deleteFromDocument translation_of: Web/API/Selection/deleteFromDocument -original_slug: Web/API/Selection/从 Document 中删除 +original_slug: Web/API/Selection/从Document中删除 ---
    diff --git a/files/zh-cn/web/api/selection/focusnode/index.html b/files/zh-cn/web/api/selection/focusnode/index.html index bac92930652247..5d67f4a1336093 100644 --- a/files/zh-cn/web/api/selection/focusnode/index.html +++ b/files/zh-cn/web/api/selection/focusnode/index.html @@ -5,7 +5,7 @@ ---
    {{ ApiRef("DOM") }}{{SeeCompatTable}}
    -

    Selection.focusNode是只读的返回所选内容的结束位置部分所属的节点。

    +

    Selection.focusNode 是只读的,返回所选内容的结束位置部分所属的节点。

    用户可能会从左到右 (按文字方向) 或从右到左 (按文字相反方向) 进行选择。focusNode 就是用户选择时最后停下来所处的元素节点。当你同时按下 shift 键和任何一个方向键来改变选择时,你就能看到:选择的结束位置在移动,但是选择的锚点 - 起始位置不会改变。

    diff --git a/files/zh-cn/web/api/selection/focusoffset/index.html b/files/zh-cn/web/api/selection/focusoffset/index.html index 1c67dcf0ca1ab8..12c2431c2ed4e0 100644 --- a/files/zh-cn/web/api/selection/focusoffset/index.html +++ b/files/zh-cn/web/api/selection/focusoffset/index.html @@ -14,7 +14,7 @@
    -

    只读属性, 返回选区终点(鼠标松开瞬间所记录的那个点)在焦点({{domxref("Selection.focusNode")}})中的偏移量。返回值从零开始计数,如果选区({{domxref("Selection")}})在焦点({{domxref("Selection.focusNode")}})的第一个字符前结束,返回值为 0。

    +

    只读属性 Selection.focusOffset 返回选区终点(鼠标松开瞬间所记录的那个点)在焦点({{domxref("Selection.focusNode")}})中的偏移量。返回值从零开始计数,如果选区({{domxref("Selection")}})在焦点({{domxref("Selection.focusNode")}})的第一个字符前结束,返回值为 0。

    语法

    diff --git a/files/zh-cn/web/api/selection/removeallranges/index.html b/files/zh-cn/web/api/selection/removeallranges/index.html index 122b0e12315b19..db8913f33bcfcf 100644 --- a/files/zh-cn/web/api/selection/removeallranges/index.html +++ b/files/zh-cn/web/api/selection/removeallranges/index.html @@ -9,7 +9,7 @@ -

    Selection.removeAllRanges() 方法会从当前 selection 对象中移除所有的 range 对象,取消所有的选择只 留下{{domxref("Selection.anchorNode", "anchorNode")}} 和{{domxref("Selection.focusNode","focusNode")}}属性并将其设置为 null。

    +

    Selection.removeAllRanges() 方法会从当前 selection 对象中移除所有的 range 对象,取消所有的选择只 留下{{domxref("Selection.anchorNode", "anchorNode")}} 和{{domxref("Selection.focusNode","focusNode")}}属性并将其设置为 null。

    语法

    diff --git a/files/zh-cn/web/api/selection/setbaseandextent/index.html b/files/zh-cn/web/api/selection/setbaseandextent/index.html index 90025c855c7c62..a86c6c29f67a72 100644 --- a/files/zh-cn/web/api/selection/setbaseandextent/index.html +++ b/files/zh-cn/web/api/selection/setbaseandextent/index.html @@ -5,7 +5,7 @@ ---
    {{ ApiRef("DOM") }}{{SeeCompatTable}}
    -

    setBaseAndExtent() 方法是{{domxref("Selection")}}接口用来选中并设置在两个特定的 DOM 节点中文本选中的范围,并且选中的任何内容都位于两个节点之间。

    +

    setBaseAndExtent() 方法是 {{domxref("Selection")}} 接口用来选中并设置在两个特定的 DOM 节点中文本选中的范围,并且选中的任何内容都位于两个节点之间。

    语法

    diff --git a/files/zh-cn/web/api/selection/tostring/index.html b/files/zh-cn/web/api/selection/tostring/index.html index fdcc57be5b8910..7ea0d5bfba5da0 100644 --- a/files/zh-cn/web/api/selection/tostring/index.html +++ b/files/zh-cn/web/api/selection/tostring/index.html @@ -30,7 +30,7 @@

    描述

    此方法返回当前被选中的文本文字。

    -

    JavaScript中,当 selection 对象作为字符串类型使用时,此方法会被自动调用:

    +

    JavaScript中,当 selection 对象作为字符串类型使用时,此方法会被自动调用:

    alert(window.getSelection()) // 被调用时
     alert(window.getSelection().toString())  // 真实情况