Class DataTableBuilder

DataTableBuilder

Erstellt DataTable-Objekte. Um eine Datentabelle zu erstellen, müssen Sie zuerst die Spalten angeben und dann die Zeilen nacheinander hinzufügen. Beispiel:

const data = Charts.newDataTable()
                 .addColumn(Charts.ColumnType.STRING, 'Month')
                 .addColumn(Charts.ColumnType.NUMBER, 'In Store')
                 .addColumn(Charts.ColumnType.NUMBER, 'Online')
                 .addRow(['January', 10, 1])
                 .addRow(['February', 12, 1])
                 .addRow(['March', 20, 2])
                 .addRow(['April', 25, 3])
                 .addRow(['May', 30, 4])
                 .build();

Methoden

MethodeRückgabetypKurzbeschreibung
addColumn(type, label)DataTableBuilderFügen Sie der Datentabelle eine Spalte hinzu.
addRow(values)DataTableBuilderFügen Sie der Datentabelle eine Zeile hinzu.
build()DataTableErstellt und gibt eine Datentabelle zurück.
setValue(row, column, value)DataTableBuilderLegt einen bestimmten Wert in der Tabelle fest.

Detaillierte Dokumentation

addColumn(type, label)

Fügen Sie der Datentabelle eine Spalte hinzu. Die Spalten werden von 0 bis n hinzugefügt.

Die erste Spalte wird in Diagrammen häufig für Labels verwendet, z. B. X‑Achsenlabels in Liniendiagrammen oder Segmentlabels in Kreisdiagrammen. Die anderen Spalten werden häufig für Daten verwendet und erfordern daher oft numerische Werte.

Parameter

NameTypBeschreibung
typeColumnTypeDatentyp der Spalte (Zahl, String oder Datum)
labelStringdas Label der Spalte (wird für die Legende des Diagramms verwendet).

Rückflug

DataTableBuilder – dieser Builder zur Verkettung.


addRow(values)

Fügen Sie der Datentabelle eine Zeile hinzu.

Parameter

NameTypBeschreibung
valuesObject[]Werte für die Zeile, die in der Reihenfolge angegeben werden, in der die Spalten eingegeben werden.

Rückflug

DataTableBuilder – dieser Builder zur Verkettung.


build()

Erstellt und gibt eine Datentabelle zurück.

Rückflug

DataTable – die Datentabelle

Löst aus

Error – wenn die Datentabelle leer oder anderweitig fehlerhaft ist


setValue(row, column, value)

Legt einen bestimmten Wert in der Tabelle fest.

Sie können einen Wert festlegen, bevor Sie die Spalte der Datentabelle hinzufügen. Wenn die Spalte jedoch nicht hinzugefügt wird, wird der Wert ignoriert.

Nicht alle Spaltenwerte müssen ausgefüllt werden. Fehlende Werte werden als null betrachtet.

Parameter

NameTypBeschreibung
rowIntegerden Zeilenindex (die erste Zeile hat den Index 0)
columnIntegerden Spaltenindex (die erste Spalte hat den Index 0)
valueObjectden Wert der Tabellenzelle (muss den richtigen Typ für die Spalte haben).

Rückflug

DataTableBuilder – dieser Builder, zur Verkettung