HTMLTableElement.insertRow()

Sintaxis

var row = HTMLTableElement.insertRow(optional index = -1);

• HTMLTableElement es una referencia a un elemento table HTML.
• index es el ndice de fila de la nueva fila.
• row queda asignada a una referencia a la nueva fila. Una referencia a un HTMLTableRowElement. Si index es -1 o igual al nmero de filas, la nueva fila es aadida detrs de la ltima. Si index es mayor que el nmeros defilas, es lanzada una excepcin IndexSizeError. Si index se omite, se asume por defecto -1.
• Si una tabla tiene mltiples elementos tbody, por defecto la nueva fila es insertada en el ltimo tbody. Para insertar una fila dentro de un tbody especifico pued hacer: var specific_tbody=document.getElementById(tbody_id); var row=specific_tbody.insertRow(index)

Ejemplo

<table id="TableA">
  <tr>
    <td>Antigua fila superior</td>
  </tr>
</table>
<script type="text/javascript">
  function addRow(tableID) {
    // Obtiene una referencia a la tabla
    var tableRef = document.getElementById(tableID);

    // Inserta una fila en la tabla, en el ndice 0
    var newRow = tableRef.insertRow(0);

    // Inserta una celda en la fila, en el ndice 0
    var newCell = newRow.insertCell(0);

    // Aade un nodo de texto a la celda
    var newText = document.createTextNode("Nueva fila superior");
    newCell.appendChild(newText);
  }

  // Llama a addRow() con el ID de la tabla
  addRow("TableA");
</script>

Para ser vlida en un documento HTML, una TR debe contener al menos un elemento TD.

Observese que insertRow inserta la fila dirctamente en la tabla y retorna una referencia a la nueva fila. La fila no necesita ser aadida separadamente (p.e. con document.appendChild()) tal sera el caso si se usase document.createElement() para crear el nuevo elemento TR.

Especificaciones

Compatibilidad con navegadores

Ver tambin

• HTMLTableRowElement.insertCell()