Your Search Results

    range.surroundContents Redirect 1

    « DOM Reference « Range

    The Range.surroundContents() method moves content of the Range into a new node, placing the new node at the start of the specified range.

    This method is nearly equivalent to newNode.appendChild(range.extractContents()); range.insertNode(newNode). After surrounding, the boundary points of the range include newNode.

    An exception will be thrown, however, if the Range splits a non-Text node with only one of its boundary points. That is, unlike the alternative above, if there are partially selected nodes, they will not be cloned and instead the operation will fail.

    Syntax

    range.surroundContents(newNode);
    

    Parameters

    newNode
    A Node to split based on the range.

    Example

    var range = document.createRange();
    var newNode = document.createElement("p");
    
    range.selectNode(document.getElementsByTagName("div").item(0));
    range.surroundContents(newNode);
    

    Specifications

    Specification Status Comment
    DOM
    The definition of 'Range.surroundContents()' in that specification.
    Living Standard No change.
    Document Object Model (DOM) Level 2 Traversal and Range Specification
    The definition of 'Range.surroundContents()' in that specification.
    Recommendation Initial specification.

    Browser compatibility

    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Basic support (Yes) 1.0 (1.7 or earlier) [1] 9.0 9.0 (Yes)
    Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Basic support (Yes) 1.0 (1.0) [1] 9.0 9.0 (Yes)

    [1] Before Firefox 1.5, a bug was preventing Range.surroundContents to work if the start and end of range were in same textnode (bug 135928).

    See also

    Document Tags and Contributors

    Contributors to this page: Sheppy
    Last updated by: Sheppy,