HOWTO · JavaScript

Tabelle mit JavaScript erstellen

In diesem Artikel erfahren Sie, wie Sie mit Hilfe von JavaScript eine Tabelle erstellen.

Auf dieser Seite

Erstellen Sie aus JavaScript-Daten eine HTML-Tabelle, indem Sie die Elemente mit document.createElement() aufbauen, Zelltexte mit textContent setzen und die fertige Tabelle mit appendChild() in einen Seitencontainer einfügen. Das ist besonders nützlich, wenn die Zeilen aus Daten stammen, die sich während der Laufzeit der Seite ändern.

HTML-Tabellenstruktur und die benötigten Elemente

Eine Tabelle beschreibt ihren Inhalt mit verschachtelten Elementen. Das Element table enthält Zeilen (tr); jede Zeile enthält Kopfzellen (th) oder Datenzellen (td). Verwenden Sie th für eine Zelle, die eine Zeile oder Spalte bezeichnet, und td für gewöhnliche Daten. Kopfzellen sind nicht auf thead beschränkt: Sie können auch Zeilen im Tabellenkörper beschriften.

Die Elemente thead und tbody gruppieren Kopf- beziehungsweise Datenzeilen. Bei größeren Tabellen erleichtern sie die Organisation, sind aber nicht für jede Tabelle erforderlich. Eine Gruppe tfoot kann Zusammenfassungen oder Fußzeilen aufnehmen, wenn die Tabelle sie benötigt. Für eine kleine Tabelle genügt als Grundstruktur ein table mit seinen Zeilen und Zellen; ergänzen Sie Gruppierungselemente, wenn sie die Struktur verständlicher machen.

Tabelle mit JavaScript erstellen und befüllen

Das folgende Beispiel erstellt eine Kopfzeile und zwei Datenzeilen. Die Tabelle hat drei Spalten – Nummer, Name und Unternehmen – und fügt gewöhnlichen Text mit textContent in jede Zelle ein. Dadurch werden Werte als Text behandelt und nicht als HTML interpretiert. Das ist die sicherere Standardeinstellung für Daten, die möglicherweise Benutzereingaben enthalten.

Das Browserbeispiel verwendet das native DOM und fügt die fertige Tabelle in einen bereits vorhandenen Container mit der ID #table-container ein. Die anschließende separate Node.js-Demonstration verwendet ein kleines, DOM-ähnliches Modell, um den Aufbau der Zeilen und deren Anzahl zu veranschaulichen; sie erstellt keine sichtbare Tabelle im Browser.

Browserseitenbeispiel (als HTML-Seite speichern und im Browser öffnen):

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

<!doctype html>
<html lang="en">
  <body>
    <div id="table-container"></div>
    <script>
      const container = document.getElementById("table-container");
      const table = document.createElement("table");
      const thead = document.createElement("thead");
      const tbody = document.createElement("tbody");
      const headings = ["No.", "Name", "Company"];
      const records = [
        ["1", "James Clerk", "Netflix"],
        ["2", "Adam White", "Microsoft"]
      ];

      const headerRow = document.createElement("tr");
      for (const heading of headings) {
        const cell = document.createElement("th");
        cell.textContent = heading;
        headerRow.appendChild(cell);
      }
      thead.appendChild(headerRow);

      for (const record of records) {
        const row = document.createElement("tr");
        for (const value of record) {
          const cell = document.createElement("td");
          cell.textContent = value;
          row.appendChild(cell);
        }
        tbody.appendChild(row);
      }

      table.appendChild(thead);
      table.appendChild(tbody);
      container.appendChild(table);
    </script>
  </body>
</html>

Führen Sie dieses eigenständige JavaScript-Beispiel aus:

class Element {
  constructor(name) {
    this.name = name;
    this.children = [];
    this.textContent = "";
  }

  appendChild(child) {
    this.children.push(child);
    return child;
  }
}

const document = {
  createElement(name) {
    return new Element(name);
  },
  body: new Element("body")
};

const container = document.createElement("div");
container.id = "table-container";
document.body.appendChild(container);

const table = document.createElement("table");
const thead = document.createElement("thead");
const tbody = document.createElement("tbody");
const headings = ["No.", "Name", "Company"];
const records = [
  ["1", "James Clerk", "Netflix"],
  ["2", "Adam White", "Microsoft"]
];

const headerRow = document.createElement("tr");
for (const heading of headings) {
  const cell = document.createElement("th");
  cell.textContent = heading;
  headerRow.appendChild(cell);
}
thead.appendChild(headerRow);

for (const record of records) {
  const row = document.createElement("tr");
  for (const value of record) {
    const cell = document.createElement("td");
    cell.textContent = value;
    row.appendChild(cell);
  }
  tbody.appendChild(row);
}

table.appendChild(thead);
table.appendChild(tbody);
container.appendChild(table);

const tableElement = container.children[0];
const headerCells = tableElement.children[0].children[0].children;
const bodyRows = tableElement.children[1].children;
console.log(`${headerCells.length} headings, ${bodyRows.length} data rows`);
3 headings, 2 data rows

document.createElement() erhält einen Elementnamen als Zeichenfolge und gibt ein neues Element zurück. Der Code erstellt für jede Zeile ein tr und fügt anschließend th- oder td-Zellen hinzu. Jede Zelle wird befüllt, bevor ihre Zeile in thead oder tbody eingefügt wird. Zum Schluss kommen die Gruppen in die Tabelle, und die Tabelle wird an den zu Beginn des Beispiels erstellten Container angehängt.

Für eine Seite, die Sie kontrollieren, kann der Container so einfach sein wie <div id="table-container"></div>. Wählen Sie dieses vorhandene Element im Browsercode mit document.getElementById("table-container") aus und hängen Sie die fertige Tabelle daran an. Platzieren Sie das Skript nach dem Container auf der Seite oder führen Sie es erst aus, wenn das Dokument geladen ist, damit das Zielelement bereits vorhanden ist. Ergänzen Sie die Darstellung separat mit CSS, etwa durch Rahmen und Abstände für table, th und td. JavaScript erstellt die Struktur und den Inhalt; CSS bestimmt das Aussehen.

Tabelle ins DOM einfügen und überprüfen

Fügen Sie die fertige Tabelle mit container.appendChild(table) in den ausgewählten Container ein. Dadurch wird die Tabelle innerhalb dieses Containers hinzugefügt, während der übrige Seiteninhalt bestehen bleibt. Soll die Tabelle vorhandenen Inhalt ersetzen, löschen Sie diesen Inhalt bewusst, bevor Sie die Tabelle einfügen. Andernfalls wird bei jedem Durchlauf eine weitere Tabelle hinzugefügt.

Öffnen Sie zur Überprüfung die Entwicklertools des Browsers und untersuchen Sie den Container im Bereich „Elements“. Er sollte ein table enthalten: ein thead mit einer Zeile aus drei th-Zellen sowie ein tbody mit zwei Zeilen aus jeweils drei td-Zellen. Die gerenderte Tabelle sollte die Überschriften „No.“, „Name“ und „Company“ sowie die Einträge James Clerk / Netflix und Adam White / Microsoft anzeigen. Diese Bezeichnungen bleiben im unveränderten Beispielcode auf Englisch. Falls die Tabelle nicht erscheint, prüfen Sie die Container-ID und den Ausführungszeitpunkt des Skripts. Verwenden Sie für einfache Textwerte weiterhin textContent, statt Daten innerHTML zuzuweisen.