collapseToEnd

Summary

Collapses or sets the insertion point or caret at the end of a selection object.

If the content the selection is in is focused and editable, the caret will blink there.

Syntax

var result = selObj.collapseToEnd();

Return Value

Returns an object of type NumberNumber

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Examples

The following code example puts the caret or insertion point at the end of the selected text.

<!DOCTYPE html>
<html>
<head>
   <title>Collapse to Start Example</title>
    <script>
        function SelectAtEnd () {
            if (window.getSelection) {
                var selection = window.getSelection ();
                selection.collapseToEnd ();
            }
        }
    </script>
</head>
<body>
<p>
    <div contenteditable="true" style="width:300px;">
        Select some text from this paragraph, and then click the following button.
        When you click the button, the caret, or insertion point, is set to the end of your selection.
    </div>
 </p>
 <p><input type="button" name="test" value="Set caret" onclick="SelectAtEnd ()" /> </p>
</body>
</html>

Notes

Remarks

Raises an INVALID_STATE DOMException if there are no Ranges in the selection.

Syntax

selObj.collapseToEnd()

Standards information

HTML5 A vocabulary and associated APIs for HTML and XHTML, Section 7.6.1

Attributions

Mozilla Developer Network : [Selection.collapseToEnd Article]
Microsoft Developer Network: [collapseToEnd Method Article]