) в HTML-таблице, а также определяет свойства и методы для работы с элементами
TableCell
, содержащимися в строке.
Свойства
readonly HTMLCollection cells
Объект, подобный массиву, содержащий объекты
TableCell
, представляющие элементы
<td> и <th>
в данной
строке.
readonly long rowlndex
Индекс этой строки в таблице.
readonly long sectionRowIndex
Позиция этой строки в данном разделе (т.е. внутри данного элемента
<thead>, <tbody>
или
<tfoot>
).
Методы
void deleteCell(long index)
Удаляет ячейку в позиции index в строке таблицы.
Element insertCell([long index])
Создает новый элемент
<td>
, вставляет в строку в указанную позицию и возвращает его. Новая ячейка вставляется непосредственно перед ячейкой, находящейся в данный момент в позиции, определяемой аргументом index. Если аргумент index отсутствует, равен количеству ячеек в строке или -1, новая ячейка добавляется в конец строки.
Обратите внимание: этот вспомогательный метод позволяет вставлять только ячейки данных
<td>
. Чтобы вставить ячейку в строку верхнего колонтитула, необходимо создать и вставить элемент
<th>
методами
Document.createElement
и
Node. insertBefore
или другими родственными им методами.
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
имеет родительский узел, то новый узел вставляется в родительский узел непосредственно после исходного узла.