Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

AutoCorrect files/zh-cn/web/api/selection/ #5898

Merged
merged 3 commits into from
Jun 3, 2022
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/selection/addrange/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ <h3 id="Parameters" name="Parameters">参数</h3>

<h2 id="Examples" name="Examples">例子</h2>

<pre class="brush:js">/* 在一个HTML文档中选中所有<strong>加粗</strong>的文本。 */
<pre class="brush:js">/* 在一个 HTML 文档中选中所有<strong>加粗</strong>的文本。 */

var strongs = document.getElementsByTagName("strong");
var s = window.getSelection();
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/selection/anchornode/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ <h2 id="Syntax" name="Syntax">用法</h2>

<h2 id="Notes" name="Notes">注意</h2>

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

<h2 id="说明">说明</h2>

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/selection/anchoroffset/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
<div>{{ ApiRef("DOM") }}{{SeeCompatTable}}</div>
</div>

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

<h2 id="Syntax" name="Syntax">语法</h2>

Expand Down
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/selection/collapse/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ <h3 id="参数">参数</h3>

<h2 id="例子">例子</h2>

<pre class="brush: js">/* 将光标收起到文档body的开头 */
<pre class="brush: js">/* 将光标收起到文档 body 的开头 */
var body = document.getElementsByTagName("body")[0];
window.getSelection().collapse(body,0);
</pre>
Expand Down Expand Up @@ -67,5 +67,5 @@ <h2 id="浏览器兼容性">浏览器兼容性</h2>
<h2 id="相关连接">相关连接</h2>

<ul>
<li>{{domxref("Selection")}}, 本方法所属的接口.</li>
<li>{{domxref("Selection")}}, 本方法所属的接口</li>
</ul>
12 changes: 6 additions & 6 deletions files/zh-cn/web/api/selection/containsnode/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
---
<div>{{ ApiRef("DOM") }}{{SeeCompatTable}}</div>

<p><strong><code>Selection.containsNode()</code></strong> 判断指定的节点是否包含在Selection中(是否被选中).</p>
<p><strong><code>Selection.containsNode()</code></strong> 判断指定的节点是否包含在 Selection 中 (是否被选中).</p>

<h2 id="语法">语法</h2>

Expand All @@ -16,15 +16,15 @@ <h3 id="参数">参数</h3>

<dl>
<dt><em><code>aNode</code></em></dt>
<dd>用于判断是否包含在Selection中的那个节点</dd>
<dd>用于判断是否包含在 Selection 中的那个节点</dd>
<dt><em><code>aPartlyContained</code></em></dt>
<dd>当此参数为<code>true时</code>, 当<code>selection包含节点aNode的一部分或全部时,containsNode()返回true</code>.<br>
当此参数为<code>false时</code>, 只有当selection完全包含节点aNode时,<code>containsNode()</code> 才返回true.</dd>
<dd>当此参数为<code>true 时</code>, 当<code>selection 包含节点 aNode 的一部分或全部时,containsNode() 返回 true</code>.<br>
当此参数为<code>false 时</code>, 只有当 selection 完全包含节点 aNode 时,<code>containsNode()</code> 才返回 true.</dd>
</dl>

<h2 id="例子">例子</h2>

<pre class="eval"> /* 检查body中是否有节点被选中 */
<pre class="eval"> /* 检查 body 中是否有节点被选中 */
console.log(window.getSelection().containsNode(document.body, true));</pre>

<h2 id="相关规范">相关规范</h2>
Expand Down Expand Up @@ -56,5 +56,5 @@ <h2 id="浏览器兼容性">浏览器兼容性</h2>
<h2 id="参考">参考</h2>

<ul>
<li>{{domxref("Selection")}}, Selection接口规范.</li>
<li>{{domxref("Selection")}}, Selection 接口规范。</li>
</ul>
Original file line number Diff line number Diff line change
Expand Up @@ -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 中删除
yin1999 marked this conversation as resolved.
Show resolved Hide resolved
---
<div>
<div>
Expand Down
6 changes: 3 additions & 3 deletions files/zh-cn/web/api/selection/focusnode/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@
---
<div>{{ ApiRef("DOM") }}{{SeeCompatTable}}</div>

<p><strong><code>Selection.focusNode</code></strong><code>是只读的</code><strong><code>,</code></strong>返回所选内容的结束位置部分所属的节点.</p>
<p><strong><code>Selection.focusNode</code></strong><code>是只读的</code><strong><code>,</code></strong>返回所选内容的结束位置部分所属的节点</p>
yin1999 marked this conversation as resolved.
Show resolved Hide resolved

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

<h2 id="Syntax" name="Syntax">语法</h2>

Expand Down Expand Up @@ -43,5 +43,5 @@ <h2 id="Browser_compatibility" name="Browser_compatibility">浏览器兼容性</
<h2 id="See_also" name="See_also">参考</h2>

<ul>
<li>{{domxref("Selection")}}, Selection接口规范.</li>
<li>{{domxref("Selection")}}, Selection 接口规范。</li>
</ul>
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/selection/focusoffset/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Selection.focusOffset
slug: Web/API/Selection/focusOffset
tags:
- HTML编辑
- HTML 编辑
- 只读
- 属性
- 选区
Expand All @@ -14,7 +14,7 @@
</div>
</div>

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

<h2 id="Syntax" name="Syntax">语法</h2>

Expand Down
24 changes: 12 additions & 12 deletions files/zh-cn/web/api/selection/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -17,15 +17,15 @@

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

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

<div style="overflow: hidden;">
<pre class="brush:js">var selObj = window.getSelection();
var range = selObj.getRangeAt(0);</pre>
</div>

<ul>
<li><code>selObj</code> 被赋予一个 Selection对象</li>
<li><code>selObj</code> 被赋予一个 Selection 对象</li>
<li>
<p><code>range</code> 被赋予一个 <a href="/en-US/docs/DOM/range" title="DOM/Range">Range</a> 对象</p>
</li>
Expand All @@ -42,13 +42,13 @@ <h2 id="Glossary" name="Glossary">术语表</h2>

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

<h2 id="Properties" name="Properties">属性</h2>
Expand All @@ -68,7 +68,7 @@ <h2 id="Properties" name="Properties">属性</h2>
<dt>{{domxref("Selection/focusOffset","focusOffset")}}{{ReadOnlyInline}}</dt>
<dd>返回一个数字,其表示的是选区终点在 {{domxref("Selection/focusNode","focusNode")}} 中的位置偏移量。
<ol>
<li>如果 <code>focusNode</code> 是文本节点,那么选区末尾未被选中的第一个字,在该文字节点中是第几个字(从0开始计),就返回它。</li>
<li>如果 <code>focusNode</code> 是文本节点,那么选区末尾未被选中的第一个字,在该文字节点中是第几个字(从 0 开始计),就返回它。</li>
<li>如果 <code>focusNode</code> 是一个元素,那么返回的就是在选区末尾之后第一个节点之前的同级节点总数。</li>
</ol>
</dd>
Expand Down Expand Up @@ -104,7 +104,7 @@ <h2 id="Methods" name="Methods">方法</h2>
<dt>{{domxref("Selection/deleteFromDocument","deleteFromDocument")}}</dt>
<dd>从页面中删除选区中的内容。</dd>
<dt>{{domxref("Selection/selectionLanguageChange","selectionLanguageChange")}}</dt>
<dd>当键盘的朝向发生改变后修改指针的Bidi优先级。</dd>
<dd>当键盘的朝向发生改变后修改指针的 Bidi 优先级。</dd>
<dt>{{domxref("Selection/toString","toString")}}</dt>
<dd>返回当前选区的纯文本内容。</dd>
<dt>{{domxref("Selection/containsNode","containsNode")}}</dt>
Expand Down Expand Up @@ -143,7 +143,7 @@ <h3 id="Selection_及输入焦点">Selection 及输入焦点</h3>

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

<p>Safari和Chrome(与Firefox不同)目前在以编程方式修改 <code>Selection</code> 时会将包含选区的元素作为焦点;这可能在将来会发生变化(请参见 <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=14383">W3C Bug 14383</a> 和 {{WebKitBug("3869")}})。</p>
<p>Safari 和 Chrome(与 Firefox 不同)目前在以编程方式修改 <code>Selection</code> 时会将包含选区的元素作为焦点;这可能在将来会发生变化(请参见 <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=14383">W3C Bug 14383</a> 和 {{WebKitBug("3869")}})。</p>

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

Expand All @@ -159,7 +159,7 @@ <h3 id="Selection_API_在可编辑元素焦点更改方面的行为">Selection A
<li>然后焦点(此处应指显示的,译者注)移到可编辑元素。</li>
</ol>

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

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

Expand Down Expand Up @@ -194,9 +194,9 @@ <h2 id="浏览器兼容性">浏览器兼容性</h2>
<h3 id="Gecko_备注">Gecko 备注</h3>

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

<h2 id="See_also" name="See_also">扩展</h2>
Expand All @@ -205,5 +205,5 @@ <h2 id="See_also" name="See_also">扩展</h2>
<li>{{domxref("window.getSelection")}},{{domxref("document.getSelection")}}及{{domxref("Range")}}</li>
<li>HTML5 DOM Range <a class="external" href="http://html5.org/specs/dom-range.html#selection" title="http://html5.org/specs/dom-range.html#selection">Interface Selection</a></li>
<li><a class="external" href="http://lxr.mozilla.org/mozilla/source/content/base/public/nsISelection.idl">IDL definition in Mozilla cross-reference</a></li>
<li><a href="http://www.zhihu.com/question/20874144">目前 CSS 实现竖排文本较为通用的方式是什么?</a>(页内搜索"Bidi"可了解Bidi优先顺序)</li>
<li><a href="http://www.zhihu.com/question/20874144">目前 CSS 实现竖排文本较为通用的方式是什么?</a>(页内搜索"Bidi"可了解 Bidi 优先顺序)</li>
</ul>
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/selection/iscollapsed/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,4 @@ <h3 id="Syntax" name="Syntax">用法</h3>
<pre class="eval"><i>sel</i>.isCollapsed
</pre>
<h3 id="Notes" name="Notes">注意</h3>
<p>即使是一个被折叠了的选区,其 rangeCount的结果也可能大于0。sel.getRangeAt(0)会在选区被折叠的情况下返回一个值。</p>
<p>即使是一个被折叠了的选区,其 rangeCount 的结果也可能大于 0。sel.getRangeAt(0) 会在选区被折叠的情况下返回一个值。</p>
8 changes: 4 additions & 4 deletions files/zh-cn/web/api/selection/modify/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -25,17 +25,17 @@ <h3 id="Parameters" name="Parameters">参数</h3>

<dl>
<dt><em>alter</em></dt>
<dd>改变类型. 传入<code>"move"来移动光标位置,或者</code><code>"extend"来扩展当前选区。</code></dd>
<dd>改变类型传入<code>"move"来移动光标位置,或者</code><code>"extend"来扩展当前选区。</code></dd>
<dt><em>direction</em></dt>
<dd>调整选区的方向。你可以传入<code>"forward"或</code><code>"backward"来根据选区内容的语言书写方向来调整。或者使用"left"或"right"来指明一个明确的调整方向。</code></dd>
<dt><em>granularity</em></dt>
<dd>调整的距离颗粒度。可选值有<code>"character"、</code><code>"word"、</code><code>"sentence"、</code><code>"line"、</code><code>"paragraph"、</code><code>"lineboundary"、</code><code>"sentenceboundary"、</code><code>"paragraphboundary"、</code><code>"documentboundary"。</code></dd>
</dl>

<div class="note"><strong>注意:</strong> Gecko <strong>不支持</strong> <code>"sentence"</code>, <code>"paragraph"</code>, <code>"sentenceboundary"</code>, <code>"paragraphboundary"和</code><code>"documentboundary"</code>. Webkit和Blink 支持。</div>
<div class="note"><strong>注意</strong> Gecko <strong>不支持</strong> <code>"sentence"</code>, <code>"paragraph"</code>, <code>"sentenceboundary"</code>, <code>"paragraphboundary"和</code><code>"documentboundary"</code>. Webkit 和 Blink 支持。</div>

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

<h2 id="例子">例子</h2>
Expand All @@ -57,5 +57,5 @@ <h2 id="Browser_compatibility" name="Browser_compatibility">浏览器兼容性</
<h2 id="See_also" name="See_also">相关链接</h2>

<ul>
<li>{{domxref("Selection")}},本方法所属的接口.</li>
<li>{{domxref("Selection")}},本方法所属的接口</li>
</ul>
Loading