这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。
Selection对象表示用户选择的文本范围或插入符号的当前位置。它代表页面中的文本选区,可能横跨多个元素。文本选区由用户拖拽鼠标经过文字而产生。要获取用于检查或修改的Selection对象,请调用 window.getSelection()
。
用户可能从左到右(与文档方向相同)选择文本或从右到左(与文档方向相反)选择文本。anchor指向用户开始选择的地方,而focus指向用户结束选择的地方。如果你使用鼠标选择文本的话,anchor 就指向你按下鼠标键的地方,而focus就指向你松开鼠标键的地方。anchor 和 focus 的概念不能与选择的起始位置和终止位置混淆,因为anchor指向的位置可能在focus指向的位置的前面,也可能在focus指向位置的后面,这取决于你选择文本时鼠标移动的方向(也就是按下鼠标键和松开鼠标键的位置)。
Selection对象所对应的是用户所选择的 ranges
(区域),俗称拖蓝。默认情况下,该函数只针对一个区域,我们可以这样使用这个函数:
selObj 被赋予一个
Selection对象range
被赋予一个 Range 对象
调用 Selection/toString()
方法会返回被选中区域中的纯文本。要求变量为字符串的函数会自动对对象进行该处理,例如:
var selObj = window.getSelection(); window.alert(selObj);
术语表
本页面使用的其他关键词汇:
- 锚点(anchor)
- 锚指的是一个选区的起始点(不同于HTML中的锚点链接,译者注)。当我们使用鼠标框选一个区域的时候,锚点就是我们鼠标按下瞬间的那个点。在用户拖动鼠标时,锚点是不会变的。
- 焦点(focus)
- 选区的焦点是该选区的终点,当您用鼠标框选一个选区的时候,焦点是你的鼠标松开瞬间所记录的那个点。随着用户拖动鼠标,焦点的位置会随着改变。
- 范围(range)
- 范围指的是文档中连续的一部分。一个范围包括整个节点,也可以包含节点的一部分,例如文本节点的一部分。用户通常下只能选择一个范围,但是有的时候用户也有可能选择多个范围(例如当用户按下Control按键并框选多个区域时,Chrome中禁止了这个操作,译者注)。“范围”会被作为
range
对象返回。Range对象也能通过DOM创建、增加、删减。
属性
anchorNode
- 返回该选区起点所在的节点(
Node
)。 anchorOffset
- 返回一个数字,其表示的是选区起点在
anchorNode
中的位置偏移量。- 如果 anchorNode 是文字节点,那么返回的就是从该文字节点的第一个字开始,直到被选中的第一个字之间的字数(如果第一个字就被选中,那么偏移量为零)。
- 如果 anchorNode 是一个元素,那么返回的就是在选区第一个节点之前的同级节点总数。(这些节点都是 anchorNode 的子节点)
focusNode
- 返回该选区终点所在的节点。
focusOffset
- 返回一个数字,其表示的是选区终点在
focusNode
中的位置偏移量。- 如果 focusNode 是文字节点,那么选区末尾未被选中的第一个字,在该文字节点中是第几个字(从0开始计),就返回它。
- 如果 focusNode 是一个元素,那么返回的就是在选区末尾之后第一个节点之前的同级节点总数。
isCollapsed
- 返回一个布尔值,用于判断选区的起始点和终点是否在同一个位置。
rangeCount
- 返回该选区所包含的连续范围的数量。
方法
getRangeAt
- 返回选区开始的节点(
Node
)。 collapse
- 将当前的选区折叠为一个点。
extend
- 将选区的焦点移动到一个特定的位置。
modify
- 修改当前的选区。
collapseToStart
- 将当前的选区折叠到起始点。
collapseToEnd
- 将当前的选区折叠到最末尾的一个点。
selectAllChildren
- 将某一指定节点的子节点框入选区。
addRange
- 一个区域(
Range
)对象将被加入选区。 removeRange
- 从选区中移除一个区域。
removeAllRanges
- 将所有的区域都从选区中移除。
deleteFromDocument
- 从页面中删除选区中的内容。
selectionLanguageChange
- 当键盘的朝向发生改变后修改指针的Bidi优先级。
toString
- 返回当前选区的纯文本内容。
containsNode
- 判断某一个node是否为当前选区的一部分。
扩展
window.getSelection
,document.getSelection
, Range- HTML5 DOM Range Interface Selection
- IDL definition in Mozilla cross-reference
- 目前 CSS 实现竖排文本较为通用的方式是什么?(页内搜索"Bidi"可了解Bidi优先顺序)
<embed height="0" id="xunlei_com_thunder_helper_plugin_d462f475-c18e-46be-bd10-327458d045bd" type="application/thunder_download_plugin" width="0"/>