1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
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>
|
