In order to access this site you need to enable JavaScript!

You are here: Reference > JavaScript > client-side > selection and ranges > methods > moveEnd (TextRange)

moveEnd method (TextRange)

Browser support:


		10.5

Moves the end position of the current TextRange object by the specified number of units.

Use the moveStart method to move the start position.

Syntax:

object.moveEnd (unitToMove [, numberOfUnits]);

You can find the related objects in the Supported by objects section below.

Parameters:

unitToMove

Required. String that specifies the type of unit to move by.

One of the following values:

character

Moves the end position by characters.

sentence

Moves the end position by sentences.

textedit

Moves the end position to the end of the editable region.

word

Moves the end position by words. Word characters mean alphanumeric characters.

numberOfUnits

Optional. Integer that specifies the number of units to move by. Default is 1. Negative and positive values are also allowed.

Return value:

Integer. Returns the number of units moved.

Example HTML code 1:

This example illustrates the use of the moveEnd method:

<head>
    <script type="text/javascript">
        function ExtendSelection () {
            if (document.selection) {        // Internet Explorer
                var myRange = document.selection.createRange ();
                myRange.moveEnd ("character", 1);                                        
                myRange.select ();
            }
            else {
                alert ("Your browser does not support this example!");
            }
        }
    </script>
</head>
<body>
    <div contenteditable="true">Some text for selection.</div>
    <br /><br />
    <button onclick="ExtendSelection ()">Extend the selection by one character at the end!</button>
</body>