Книга: JavaScript. Подробное руководство, 6-е издание

Text

Text

текстовая последовательность в документе (Node)

Узел Text представляет обычный текст в документе и обычно располагается в дереве документа в виде дочернего узла по отношению к узлу Element. Текстовое содержимое узла Text доступно через свойство data или через свойства nodeValue и textContent, унаследованные от Node. Создать новый узел Text можно с помощью Document.createText-Node(). Текстовые узлы никогда не имеют дочерних узлов.

Свойства

string data

Текст, содержащийся в данном узле.

readonly unsigned long length

Длина текста в символах.

readonly string wholeText

Текстовое содержимое данного узла и любых смежных с ним текстовых узлов, предшествующих ему и следующих за ним. После вызова метода normalize() родительского элемента Node это свойство будет иметь то же значение, что и свойство data.

Методы

Эти методы вам не придется использовать на практике, если только вы не соберетесь написать текстовый редактор с веб-интерфейсом.

void appendData(string text)

Добавляет текст text в конец данного текстового узла.

void deleteData(unsigned long offset, unsigned long count)

Удаляет count символов из данного текстового узла, начиная с символа в позиции offset. Если сумма значений offset и count превысит количество символов в текстовом узле, будут удалены все символы до конца строки, начиная с символа в позиции offset.

void insertData(unsigned long offset, string text)

Вставляет текст text в текстовый узел в позицию offset.

void replaceData(unsigned long offset, unsigned long count, string text)

Замещает count символов, начиная с позиции offset, содержимым строки text. Если сумма значений offset и count превысит значение свойства length текстового узла, будут замещены все символы, начиная с позиции offset.

Text replaceWholeText(string text)

Создает новый узел Text, содержащий текст text, а затем замещает данный и смежные с ним текстовые узлы новым узлом и возвращает новый узел. См. также описание свойства wholeText выше и метода normalize() интерфейса Node.

Text splitText(unsigned long offset)

Разбивает узел Text на два по смещению offset. Исходный узел Text модифицируется так, чтобы он содержал весь текст до символа в позиции offset, но не включая его. Создается новый узел, который содержит все символы от позиции offset (включая ее) до конца строки. Этот новый узел Text является возвращаемым значением метода. Кроме того, если исходный узел Text имеет родительский узел, то новый узел вставляется в родительский узел непосредственно после исходного узла.

string substringData(unsigned long offset, unsigned long count)

Извлекает и возвращает подстроку длиной count символов, начинающуюся с символа в позиции offset в тексте узла Text. Если узел Text содержит слишком большой объем текста, этот метод может оказаться более эффективным, чем метод String.substring().

Оглавление книги