Window.getSelection()

在此页

句法
范例
注意事项
规范
浏览器兼容性
另请参阅
相关话题

Window.getSelection() 方法返回 Selection object representing the range of text selected by the user or the current position of the caret.

句法

selection = window.getSelection();

返回值

A Selection 对象。

When cast to string, either by appending an empty string ( "" ) or using Selection.toString() , this object returns the text selected.

When called on an <iframe> that is not displayed (eg. where display: none is set) Firefox will return null , whereas other browsers will return a Selection 对象采用 Selection.type 设为 None .

范例

function foo() {
    var selObj = window.getSelection();
    alert(selObj);
    var selRange = selObj.getRangeAt(0);
    // do stuff with the range
}

注意事项

String representation of the Selection object

In JavaScript, when an object is passed to a function expecting a string (like window.alert() or document.write() ), the object's toString() method is called and the returned value is passed to the function. This can make the object appear to be a string when used with other functions when it is really an object with properties and methods.

In the above example, selObj.toString() is automatically called when it is passed to window.alert() . However, attempting to use a JavaScript 字符串 property or method such as length or substr directly on a Selection object will result in an error if it does not have that property or method and may return unexpected results if it does. To use a Selection object as a string, call its toString() method directly:

var selectedText = selObj.toString();

selObj 是 Selection 对象。
selectedText is a string (Selected text).

Related objects

可以调用 Document.getSelection() , which works identically to Window.getSelection() .

It is worth noting that currently getSelection() doesn't work on the content of <textarea> and <input> elements in Firefox, Edge (Legacy) and Internet Explorer. HTMLInputElement.setSelectionRange() 或 selectionStart and selectionEnd properties could be used to work around this.

Notice also the difference between selection and focus . Document.activeElement returns the focused element.

规范

规范	状态	注释
选定 API The definition of 'Window.getSelection()' in that specification.	工作草案	New spec.

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`getSelection`	Chrome 1	Edge 12	Firefox 1	IE 9	Opera 9	Safari 1	WebView Android 1	Chrome Android 18	Firefox Android 4	Opera Android 10.1	Safari iOS 1	Samsung Internet Android 1.0

在此页

句法

返回值

范例

注意事项

String representation of the Selection object

Related objects

规范

浏览器兼容性

图例

另请参阅

元数据

相关话题