Объект TextRange представляет текст из 0 или большего количества символов в документе (текстовый диапазон). Когда текстовый диапазон состоит из нулевых символов, онэто представляет собой курсор (точку ввода) между двумя символами (или перед первым символом, или после последнего символа).

Объект TextRange создаётся через метод createTextRange(), связанный с объектами BODY, BUTTON, text или TEXTAREA. Как только текстовый диапазон создан, используйте его методы корректировки начала и конечного пункта, чтобы охватить желательную долю текста (типа текста, который соответствует строке для поиска). Как только диапазон сужен к нужному тексту, назначьте значения на его свойства htmlText и text, чтобы изменять, удалять или вставлять текст. Библиотека прямых команд, которые исполняют определенные текстовые модификации, также может быть вызвана, чтобы воздействовать на данный текстовый диапазон.

Обратите внимание, что объект TextRange и все связанные с ним средства доступны только в Win32 версии Internet Explorer 4.

Возвращает размер в пикселах воображаемого пространства, занятого объектом TextRange. Хотя Вы не видите объект TextRange в документе (если сценарий не устанавливает это), область объекта TextRange идентична области, которую заняла бы подсветка выбора. Эти значения обеспечивают только такую ширину или высоту, как самая широкая и самая высокая часть диапазона.

var rangeWidth = document.forms[0].myTextArea.createTextRange( ).boundingWidth

Возвращает расстояние в пикселах между верхней или левой гранью окна браузера или фрейма и верхней или левой гранью воображаемого пространства, занятого объектом TextRange. Хотя Вы не видите объект TextRange в документе (если это не определяет сценарий), область объекта TextRange идентична области, которую заняла бы подсветка выбора. Значения для этих свойств измеряются от граней окна или фрейма, а не документа, который может прокручиваться. Поэтому, поскольку документ прокручивается, эти значения изменяются.

var rangeOffH = document.forms[0].myTextArea.createTextRange( ).boundingLeft

Весь HTML документа для данного элемента, который используется как основание для объекта TextRange. Например, если Вы создаете TextRange для элемента BODY (document.BODY.createTextRange()), свойство htmlText содержит все содержание HTML между тэгами (но не, включая их) элемента BODY.

var rangeHTML = document.body.createTextRange( ).htmlText

Текст, содержащийся в текстовом диапазоне. В случае объекта TextRange элемента BODY, свойство состоит только из текста, который представлен, но ни один из HTML тэгов не включён.

var rangeText = document.body.createTextRange( ).text

collapse([start])

Уменьшает длину объекта TextRange до нуля (создание курсора (точки ввода)) в начале или в конце текстового диапазона.

compareEndPoints(type, comparisonRange)

Сравнивает относительную позицию границы (начало и конец) точек двух диапазонов (текущий диапазон и тот, который был предварительно сохранен в переменной). Первый параметр определяет, какие граничные точки в каждом диапазоне Вы желаете сравнить. Если результат сравнения - то, что первая точка появляется ранее, чем другая точка, возвращается значение -1; если результат показывает обе точки в одном и том же местоположении, возвращается значение 0; если результат показывает первую точку позже в диапазоне, чем другую точку, возвращается значение 1. Например, если Вы сохранили первый диапазон в переменной r1 и создали новый диапазон r2, Вы можете увидеть физические отношения между концом r2 и началом r1:

r1.compareEndPoints("EndToStart", r2)

Если r1 заканчивается там, где начинается r2 (курсор между двумя символами), то возвращенное значение - 0.

Создает новый объект TextRange с теми же самыми значениями, как и текущий диапазон. Новый объект - независимый объект (старый и новый не равняются друг другу), но их значения изначально идентичны (пока Вы не начинаете изменять один диапазон или другой).

execCommand("commandName"[, UIFlag[, value]])

Выполняет названную команду с текущим объектом TextRange. Много команд работают лучше всего, когда объект TextRange - курсор (точка ввода).

expand(unit)

Разворачивает текущий текстовый диапазон, чтобы охватить текстовый модуль, прошедший как параметр. Например, если кто-то выбирает некоторые символы из документа, Вы можете создать диапазон и разворачивать его, чтобы охватить полное предложение, в котором имеет место выбор:

var rng = document.selection.createRange( ) rng.expand("sentence")

Если стартовый диапазон простирается поперек многих модулей, метод expand( ) разворачивает диапазон наружу до следующего самого близкого аналогичного модуля.

findText(string)

Ищет соответствие текущего объекта TextRange прошедшей как параметр строке. Соответствие ищется без учета регистра. Если есть соответствие, объект TextRange снова устанавливает свою начальную и конечную точки, чтобы окружить найденный текст. Чтобы продолжать искать, Вы должны снова установить точку начала текстового диапазона к концу найденной строки (методом collapse( )).

getBookmark( )

moveToBookmark(bookmarkString)

Эти два метода работают вместе как способ временно сохранить текстовую спецификацию диапазона и восстанавливают её, когда необходимо. Метод getBookmark() возвращает непрозрачную строку (содержащую двоичные данные, которые не имеют никакго представления пользователям). Как только это значение сохранено в переменной, диапазон может изменяться, как необходимо для сценария. Некоторое время спустя отмеченный текстовый диапазон может быть восстановлен методом moveToBookmark():

var rangeMark = myRange.getBookmark( ) ... myRange.moveToBookmark(rangeMark)

inRange(comparisonRange)

Определяет, является ли диапазон сравнения равным или приблизительно равным физическому текстовому диапазону.

isEqual(comparisonRange)

Определяет, является ли диапазон сравнения идентичным текущему текстовому диапазону.

move(unit[, count])

Сворачивает текущий текстовый диапазон в курсор (точку ввода) в конце текущего диапазона и продвигает вперёд или назад от текущей позиции на один или более модуль.

moveEnd(unit[, count])

moveStart(unit[, count])

Перемещает только конечную или начальную точку (соответственно) текущего текстового диапазона на один или более модуль. Дополнительный параметр позволяет Вам определять и число модулей, и направление. Чтобы переместить точку начала текстового диапазона к началу первоначального диапазона, убедитесь, что установили отрицательное значение. При перемещении конечной точки направо на слово знайте, что слово заканчивается символом пробела (включая период). Поэтому, если метод findText() устанавливает диапазон на найденную строку, которая не заканчивается пробелом, первый метод moveEnd ("word") перемещает конечную точку в ячейку мимо пробела после найденной строки.

moveToElementText(elementObject)

Перемещает текущие начальную и конечную точки объекта TextRange, чтобы упаковать указанный объект в элемент HTML. Результирующий текстовый диапазон включает также HTML.

moveToPoint(x, y)

Сворачивает текстовый диапазон в указатель вставки и устанавливает его местоположение в ячейке, обозначенной горизонтальными и вертикальными координатами в окне браузера или фрейме. Это - то, как будто пользователь щелкнул на ячейку в окне, чтобы определить курсор (точку ввода).

Возвращает ссылку на родительский элемент, который содержит объект TextRange полностью.

pasteHTML(HTMLText)

Заменяет текущий текстовый диапазон содержанием HTML, определённым как строка параметра. Обычно этот метод используется на объекте диапазона текста нулевой длины, действующем как точка ввода. Все тэги представляются так, как будто они были частью первоначального исходного текста.

queryCommandEnabled("commandName")

Может ли команда быть вызвана в текущем состоянии документа или выбора. Доступно только в IE 4 для Win32 ..

queryCommandIndeterm("commandName")

Находится ли команда в неопределенном состоянии. Доступно только в IE 4 для Win32 ..

queryCommandState("commandName")

Определяет текущее состояние названной команды. Доступно только в IE 4 для Win32 ..

queryCommandSupported("commandName")

Определяет, поддерживается ли названная команда объектом document. Доступно только в IE 4 для Win32 ..

queryCommandText("commandName")

Возвращает текст, связанный с командой. Доступно только в IE 4 для Win32 ..

queryCommandValue("commandName")

Возвращает значение, связанное с командой, типа названия шрифта выбора. Доступно только в IE 4 для Win32 ..

Выбирает весь текст, который включен в текущий объект TextRange. Этот метод приносит некоторое визуальное подтверждение пользователям, что сценарий знает о специфическом блоке текста. Например, если бы Вы писали сценарий поиска с методом findText() , Вы использовали бы тогда на этом диапазоне методы scrollIntoView() и select(), чтобы показать пользователю, где находится текст соответствия.

setEndPoint(type, comparisonRange)

Устанавливает конечную точку текущего объекта TextRange к конечной точке другого диапазона, который предварительно был сохранён как переменная ссылка.