Section 25.277. TableSection.insertRow( ): insert a new, empty row into this table section

25.277. TableSection.insertRow( ): insert a new, empty row into this table section

DOM Level 2 HTML

25.277.1. Synopsis

 HTMLElement insertRow(long index)     tHRows DOMException; 

25.277.1.1. Arguments

index

The position within the section at which the new row is to be inserted.

25.277.1.2. Returns

A TableRow that represents the newly created and inserted <tr> element.

25.277.1.3. Throws

This method throws a DOMException with a code of INDEX_SIZE_ERR if index is less than zero or is greater than the number of rows in this section.

25.277.2. Description

This method creates a new empty <tr> element and inserts it into this table section at the specified position. If index equals the number of rows currently in the section, the new row is appended to the end of the section. Otherwise, the new row is inserted immediately before the row that is currently at the position specified by index. Note that for this method, index specifies a row position within a single table section, not within the entire table.

25.277.3. See Also

Table.insertRow( )