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

Флэнаган Дэвид
Шрифт:

TableSection

раздел верхнего или нижнего колонтитула либо тела таблицы (Node, Element)

Интерфейс

TableSection
представляет раздел
<tbody>, <thead> или <tfoot>
HTML-таблицы. Свойства
tHead и tFoot
объектов
Table
являются объектами
TableSection
, а свойство
tBodies
– коллекцией
HTMLCollection
объектов
TableSection
.

Объект

TableSection
содержит объекты
TableRow
и сам содержится в объекте
Table
.

Свойства

readonly HTMLCollection rows

Объект, подобный массиву, содержащий объекты

TableRow
, представляющие строки в этом разделе таблицы.

Методы

void deleteRow(long index)

Удаляет строку в указанной позиции в данном разделе.

TableRow insertRow([long index])

Создает новый элемент

<tr>,
вставляет в данный раздел таблицы в указанную позицию и возвращает его. Если аргумент index опущен, равен количеству строк в разделе или -1, новая строка добавляется в конец раздела. В противном случае новая строка вставляется непосредственно перед строкой, находящейся в данный момент в позиции, заданной аргументом index. Обратите внимание: для этого метода аргумент index определяет позицию строки внутри одного раздела, а не в таблице в целом.

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
имеет родительский узел, то новый узел вставляется в родительский узел непосредственно после исходного узла.