aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/selection/modify/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'files/zh-cn/web/api/selection/modify/index.html')
-rw-r--r--files/zh-cn/web/api/selection/modify/index.html109
1 files changed, 109 insertions, 0 deletions
diff --git a/files/zh-cn/web/api/selection/modify/index.html b/files/zh-cn/web/api/selection/modify/index.html
new file mode 100644
index 0000000000..db41ec4708
--- /dev/null
+++ b/files/zh-cn/web/api/selection/modify/index.html
@@ -0,0 +1,109 @@
+---
+title: Selection.modify()
+slug: Web/API/Selection/modify
+tags:
+ - HTML 编辑
+ - 参考
+ - 方法
+ - 选区
+translation_of: Web/API/Selection/modify
+---
+<div>
+<div>
+<div>{{ ApiRef("DOM") }}{{non-standard_header}}</div>
+</div>
+</div>
+
+<p><strong><code>Selection.modify()</code></strong> 方法可以通过简单的文本命令来改变当前选区或光标位置。</p>
+
+<h2 id="Syntax" name="Syntax">语法</h2>
+
+<pre class="syntaxbox"><em>sel</em>.modify(<em>alter</em>, <em>direction</em>, <em>granularity</em>)
+</pre>
+
+<h3 id="Parameters" name="Parameters">参数</h3>
+
+<dl>
+ <dt><em>alter</em></dt>
+ <dd>改变类型. 传入<code>"move"来移动光标位置,或者</code><code>"extend"来扩展当前选区。</code></dd>
+ <dt><em>direction</em></dt>
+ <dd>调整选区的方向。你可以传入<code>"forward"<font face="Open Sans, Arial, sans-serif">或</font></code><code>"backward"来根据选区内容的语言书写方向来调整。或者使用"left"或"right"来指明一个明确的调整方向。</code></dd>
+ <dt><em>granularity</em></dt>
+ <dd>调整的距离颗粒度。可选值有<code>"character"<font face="Open Sans, Arial, sans-serif">、</font></code><code>"word"<font face="Open Sans, Arial, sans-serif">、</font></code><code>"sentence"<font face="Open Sans, Arial, sans-serif">、</font></code><code>"line"<font face="Open Sans, Arial, sans-serif">、</font></code><code>"paragraph"<font face="Open Sans, Arial, sans-serif">、</font></code><code>"lineboundary"<font face="Open Sans, Arial, sans-serif">、</font></code><code>"sentenceboundary"<font face="Open Sans, Arial, sans-serif">、</font></code><code>"paragraphboundary"<font face="Open Sans, Arial, sans-serif">、</font></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">
+<p><strong>注意:</strong> 从{{Gecko("5.0")}}开始,不管是不是浏览器的默认行为,<code>"word"颗粒度不再包括</code>单词后面的空格。这让这个行为变得更加稳定,这也和之前的Webkit保持一致,然而不幸的是他们最近修改了这个默认行为。</p>
+</div>
+
+<h2 id="例子">例子</h2>
+
+<p>使当前选区往语言书写方向扩大一个单词(word)的选择范围</p>
+
+<pre>var selection = window.getSelection();
+selection.modify("extend", "forward", "word");
+</pre>
+
+<h2 id="规范">规范</h2>
+
+<p><em>无</em></p>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">浏览器兼容性</h2>
+
+<div>{{CompatibilityTable}}</div>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>平台</th>
+ <th>Chrome</th>
+ <th>Firefox (Gecko)</th>
+ <th>Internet Explorer</th>
+ <th>Opera</th>
+ <th>Safari (WebKit)</th>
+ </tr>
+ <tr>
+ <td>支持最低版本</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatGeckoDesktop(2)}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}§</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>平台</th>
+ <th>Android</th>
+ <th>Firefox Mobile (Gecko)</th>
+ <th>Firefox OS</th>
+ <th>IE Phone</th>
+ <th>Opera Mobile</th>
+ <th>Safari Mobile</th>
+ </tr>
+ <tr>
+ <td>支持最低版本</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatGeckoMobile(2)}}</td>
+ <td>1.0</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<h2 id="See_also" name="See_also">相关链接</h2>
+
+<ul>
+ <li>{{domxref("Selection")}},本方法所属的接口.</li>
+</ul>