CSV Editor — Manual

Zurück zur Übersicht: CSV Editor · Tool live öffnen: www.jpkc.com/tools/csv/

Dieses Manual beschreibt den CSV Editor vollständig: jeden Button der Toolbar, jede Einstellung, wie die Trennzeichen-Erkennung und der Parser arbeiten, welche Export-Formate es gibt und welche Grenzen gelten. Die Oberfläche des Tools ist auf Englisch — die Button- und Feld-Bezeichnungen werden hier deshalb in ihrer englischen Original-Schreibweise genannt (mit deutscher Erläuterung), damit du dich im echten Interface zurechtfindest.

Aufbau der Oberfläche

Die Seite besteht aus zwei Karten: dem Editor mit Toolbar, Tabelle und Statusleiste sowie einer aufklappbaren Settings-Karte darunter. Beim ersten Laden versucht das Tool, eine zuvor automatisch gesicherte Tabelle aus dem Browser-Speicher wiederherzustellen; gibt es keine, startet es mit einer leeren Tabelle in der eingestellten Standardgröße.

Daten importieren

Es gibt drei gleichwertige Wege, eine Tabelle zu laden. Alle drei nutzen dieselbe Trennzeichen-Erkennung und denselben Parser, und alle drei respektieren die Header-Einstellung.

Open (Datei öffnen)

Öffnet den Datei-Dialog. Akzeptiert werden Dateien mit den Endungen .csv, .tsv und .txt. Die Datei wird lokal per FileReader als Text eingelesen — es gibt keinen Upload. Nach dem Öffnen meldet eine kurze Einblendung Dateiname, Zeilenzahl und das erkannte Trennzeichen.

Drag-and-drop

Du kannst eine Datei direkt auf die Editor-Karte ziehen. Beim Überfahren wird der Rand hervorgehoben; beim Loslassen wird die Datei wie über Open eingelesen.

Paste (aus der Zwischenablage)

Liest den Textinhalt der Zwischenablage und baut daraus eine neue Tabelle. Damit kannst du eine Markierung aus Excel, Google Sheets oder Numbers direkt einfügen (diese kopieren tab-getrennt, was die Auto-Erkennung als Tabulator erkennt). Der Zugriff auf die Zwischenablage setzt die entsprechende Browser-Berechtigung voraus; verweigert der Browser den Zugriff, erscheint ein Hinweis.

New

Erzeugt eine leere Tabelle in der unter Settings eingestellten Standardgröße (Default Rows × Default Columns). Bereits geladene Daten werden dabei ersetzt.

Store und Restore

Store sichert die aktuelle Tabelle (samt Spaltenüberschriften) ausdrücklich im LocalStorage des Browsers. Restore lädt diese gespeicherte Tabelle wieder; der Button ist deaktiviert, solange nichts gespeichert ist. Unabhängig davon speichert das Tool automatisch (siehe Automatische Speicherung).

Copy

Kopiert die gesamte Tabelle tab-getrennt in die Zwischenablage. Das Trennzeichen ist hier fest der Tabulator — nicht das in den Settings gewählte —, damit sich die Daten direkt in eine Tabellenkalkulation einfügen lassen.

Paste

Siehe Paste (aus der Zwischenablage) oben.

Transpose

Vertauscht Zeilen und Spalten: Aus einer Tabelle mit m Zeilen und n Spalten wird eine mit n Zeilen und m Spalten. Praktisch, wenn ein Export „quer" liegt.

Undo und Redo

Machen die letzte Änderung rückgängig bzw. stellen sie wieder her. Funktioniert auch über die Tastatur mit Strg+Z (Undo) und Strg+Y (Redo).

Fullscreen

Schaltet einen Vollbild-Modus, der Kopf, Fuß und die Settings-Karte ausblendet und den Editor das ganze Fenster füllen lässt. Mit demselben Button oder der Esc-Taste verlässt du ihn wieder.

CSV und JSON (Export)

Laden die Tabelle als Datei herunter — Details unter Export.

Reset

Setzt den Editor zurück: Nach einer Sicherheitsabfrage werden die gespeicherten Daten gelöscht und eine leere Tabelle erstellt.

Suche

Das Suchfeld rechts in der Toolbar filtert die Tabelle live (mit kurzer Verzögerung beim Tippen). Das × daneben oder die Esc-Taste setzt die Suche zurück.

Die Settings

Die Settings-Karte klappst du über ihre Kopfzeile auf. Alle Werte werden bei Änderung automatisch im Browser gespeichert.

CSV Delimiter (Trennzeichen)

Bestimmt, womit Felder getrennt werden — sowohl beim Import als auch beim CSV-Export. Optionen:

Auto-detect (Standard) — automatische Erkennung beim Import (siehe unten). Für den Export fällt „auto" auf das Komma zurück.
Comma (,)
Semicolon (;) — typisch für CSV-Exporte aus deutschsprachigem Excel.
Tab
Pipe (|)

Default Rows und Default Columns

Die Größe einer neu erstellten leeren Tabelle (New). Default Rows steht auf 10 (1–500), Default Columns auf 8 (1–50). Diese Werte betreffen nur die leere Startgröße, nicht den Import — eine geladene Datei behält ihre tatsächliche Größe.

First row is header

Ist die Checkbox aktiv, wird die erste Zeile als Spaltenüberschrift behandelt: Beim Import werden daraus die Spaltentitel (statt einer Datenzeile), und beim Export wirkt sich das auf beide Formate aus (siehe unten). Voraussetzung beim Import ist, dass die Datei mehr als eine Zeile hat.

Trennzeichen-Erkennung (Auto-detect)

Steht das Trennzeichen auf Auto-detect, untersucht der Editor die erste Zeile der Datei und zählt darin das Vorkommen der vier Kandidaten Komma, Semikolon, Tabulator und Pipe — Zeichen innerhalb von Anführungszeichen werden korrekt übersprungen. Das häufigste Zeichen gewinnt; kommt keines vor, fällt die Erkennung auf das Komma zurück. Weil nur die erste Zeile betrachtet wird, ist die Erkennung schnell, aber von einer typischen Kopfzeile abhängig — bei untypischem Dateiaufbau stellst du das Trennzeichen besser von Hand ein.

Der Parser (RFC 4180)

Das Einlesen erledigt ein eigener, RFC-4180-konformer Parser (keine externe Bibliothek). Er beherrscht:

Anführungszeichen: Felder in "…" dürfen das Trennzeichen, Zeilenumbrüche und Anführungszeichen enthalten.
Verdoppelte Anführungszeichen: "" innerhalb eines Felds wird zu einem einzelnen ".
Verschiedene Zeilenenden: \r\n, \n und \r werden alle als Zeilenwechsel erkannt.
Leere Schlusszeilen werden am Ende abgeschnitten.

Export

CSV exportieren

Lädt die Tabelle als Datei data.csv herunter. Das Trennzeichen ist das in den Settings gewählte (bei „auto" das Komma). Die Ausgabe ist RFC-4180-konform: Felder, die das Trennzeichen, ein Anführungszeichen oder einen Zeilenumbruch enthalten, werden in "…" gesetzt, enthaltene Anführungszeichen verdoppelt; Zeilen werden mit \r\n getrennt. Ist First row is header aktiv, werden die Spaltenüberschriften als erste Zeile vorangestellt.

JSON exportieren

Lädt die Tabelle als Datei data.json herunter (eingerückt mit zwei Leerzeichen). Die Struktur hängt vom Header-Modus ab:

Header-Modus aus — ein Array von Arrays: jede Zeile ist ein Array ihrer Zellwerte.

[
  ["Alice", "30", "Berlin"],
  ["Bob", "25", "Hamburg"]
]

Header-Modus an (und Überschriften vorhanden) — ein Array von Objekten: jede Zeile wird ein Objekt, dessen Schlüssel die Spaltenüberschriften sind.

[
  { "name": "Alice", "age": "30", "city": "Berlin" },
  { "name": "Bob", "age": "25", "city": "Hamburg" }
]

Alle Werte sind Strings — der Editor interpretiert Zahlen beim Export nicht eigenständig als numerische JSON-Typen.

Copy (Zwischenablage)

Der Copy-Button ist die dritte Ausgabe: die gesamte Tabelle tab-getrennt in der Zwischenablage. Siehe Copy.

Statusleiste

Unter der Tabelle zeigt eine Leiste vier Informationen:

die Größe der Tabelle (Zeilen × Spalten),
die aktive Zelle in Spreadsheet-Notation (z. B. B3) samt — gekürzter — Vorschau ihres Inhalts,
bei einer Mehrfach-Auswahl den markierten Bereich (z. B. A1:C5) und, falls Zahlen markiert sind, automatisch SUM, AVG und COUNT,
den Speicher-Status (Zeitpunkt und Zeilenzahl der zuletzt gesicherten Tabelle).

Automatische Speicherung

Jede Änderung an Zellen oder an der Struktur löst nach kurzer Verzögerung (rund zwei Sekunden) eine automatische Sicherung in den LocalStorage des Browsers aus. So übersteht deine Arbeit einen versehentlichen Reload. Gespeichert werden Tabelle und Spaltenüberschriften, alles ausschließlich lokal. Schlägt das Speichern fehl (etwa weil der Browser-Speicher voll ist), erscheint ein Hinweis.

Architektur und Datenschutz

Der CSV Editor ist eine rein clientseitige Anwendung ohne Server-Komponente: Dateien werden lokal per FileReader eingelesen, im Browser bearbeitet und über einen erzeugten Download wieder ausgegeben. Es gibt keinen Upload, keinen Account und keine Datenübertragung. Die Tabellen-Engine ist Jspreadsheet CE (mit jSuites). Weil CSV-Dateien oft sensible Daten enthalten, ist das ein bewusster Vorteil: Die Daten verlassen deinen Rechner nicht.

Grenzen

Auto-Erkennung nur über die erste Zeile. Ist die Kopfzeile untypisch, kann das falsche Trennzeichen gewählt werden — dann manuell in den Settings festlegen.
Vier Trennzeichen. Erkannt und auswählbar sind nur Komma, Semikolon, Tabulator und Pipe; exotische Trennzeichen werden nicht unterstützt.
Feste Export-Dateinamen. Die Downloads heißen immer data.csv bzw. data.json; einen eigenen Namen vergibst du erst beim Speichern.
Werte sind Strings. Beim JSON-Export werden Zahlen nicht in JSON-Number-Typen umgewandelt, sondern als Strings ausgegeben.
Copy ist immer tab-getrennt — unabhängig vom eingestellten Trennzeichen.
Header-Import braucht mehr als eine Zeile, damit aus der ersten Zeile Überschriften werden.
LocalStorage-Grenzen. Sehr große Tabellen können den Browser-Speicher sprengen; dann scheitert die automatische Sicherung (mit Hinweis), die Bearbeitung selbst läuft weiter.
Zwischenablage braucht eine Berechtigung. Paste funktioniert nur, wenn der Browser den Lese-Zugriff auf die Zwischenablage erlaubt.

Für den Einstieg und das große Bild siehe die Übersichtsseite, für konkrete Abläufe die Beispiele und für Kniffe die Tipps & Tricks. Ausprobieren kannst du alles direkt im Tool.