Selection.containsNode()
This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the spec changes.
The Selection.containsNode()
method indicates if the node is part of the selection.
Syntax
JavaScript
Copy Code
sel.containsNode(aNode,aPartlyContained)
Parameters
aNode
- The node that is being looked for whether it is part of the selection
aPartlyContained
- When
true
,containsNode()
returnstrue
when a part of the node is part of the selection.
Whenfalse
,containsNode()
only returnstrue
when the entire node is part of the selection.
Examples
JavaScript
Copy Code
/* Check to see if anything inside the body element is selected */ console.log(window.getSelection().containsNode(document.body, true));
Specifications
Specification | Status | Comment |
---|---|---|
HTML Editing APIs The definition of 'Selection.containsNode' in that specification. |
Editor's Draft | Initial definition |
Selection API The definition of 'Selection.containsNode()' in that specification. |
Working Draft | Current |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | ? | 4.0 (2)[1] | ? | ? | ? |
Feature | Android | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | ? | 4.0 (2)[1] | 1.0 | ? | ? | ? |
[1] Before Firefox 35, the method didn't throw if aNode
was null
.
See also
Selection
, the interface it belongs to.
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/selection/containsnode