Class TableChartBuilder

TableChartBuilder

Ein Builder für Tabellendiagramme. Weitere Informationen finden Sie in der Google Charts-Dokumentation.

Hier ist ein Beispiel für das Erstellen eines Tabellendiagramms. Die Daten werden aus einer Google-Tabelle importiert. 

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

const chartBuilder = Charts.newTableChart()
                         .setDimensions(600, 500)
                         .enablePaging(20)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

Methoden

MethodeRückgabetypKurzbeschreibung
build()ChartErstellt das Diagramm.
enablePaging(enablePaging)TableChartBuilderLegt fest, ob das Paging durch die Daten aktiviert werden soll.
enablePaging(pageSize)TableChartBuilderAktiviert die Paginierung und legt die Anzahl der Zeilen auf jeder Seite fest.
enablePaging(pageSize, startPage)TableChartBuilderAktiviert die Paginierung, legt die Anzahl der Zeilen auf jeder Seite und die erste anzuzeigende Tabellenseite fest (Seitenzahlen sind nullbasiert).
enableRtlTable(rtlEnabled)TableChartBuilderFügt grundlegende Unterstützung für rechtsläufige Sprachen (z. B. Arabisch oder Hebräisch) hinzu, indem die Spaltenreihenfolge der Tabelle umgekehrt wird. Spalte 0 ist also die Spalte ganz rechts und die letzte Spalte ist die Spalte ganz links.
enableSorting(enableSorting)TableChartBuilderLegt fest, ob Spalten sortiert werden sollen, wenn der Nutzer auf eine Spaltenüberschrift klickt.
setDataSourceUrl(url)TableChartBuilderLegt die Datenquellen-URL fest, die verwendet wird, um Daten aus einer externen Quelle wie Google Sheets abzurufen.
setDataTable(tableBuilder)TableChartBuilderLegt die Datentabelle fest, die für das Diagramm verwendet werden soll. Dazu wird ein DataTableBuilder verwendet.
setDataTable(table)TableChartBuilderLegt die Datentabelle fest, die die Linien für das Diagramm sowie die X-Achsenbeschriftungen enthält.
setDataViewDefinition(dataViewDefinition)TableChartBuilderLegt die Definition der Datenansicht fest, die für das Diagramm verwendet werden soll.
setDimensions(width, height)TableChartBuilderLegt die Abmessungen für das Diagramm fest.
setFirstRowNumber(number)TableChartBuilderLegt die Zeilennummer für die erste Zeile in der Datentabelle fest.
setInitialSortingAscending(column)TableChartBuilderLegt den Index der Spalte fest, nach der die Tabelle anfänglich sortiert werden soll (aufsteigend).
setInitialSortingDescending(column)TableChartBuilderLegt den Index der Spalte fest, nach der die Tabelle anfänglich sortiert werden soll (absteigend).
setOption(option, value)TableChartBuilderLegt erweiterte Optionen für dieses Diagramm fest.
showRowNumberColumn(showRowNumber)TableChartBuilderLegt fest, ob die Zeilennummer als erste Spalte der Tabelle angezeigt werden soll.
useAlternatingRowStyle(alternate)TableChartBuilderLegt fest, ob ungeraden und geraden Zeilen eines Tabellendiagramms ein abwechselnder Farbstil zugewiesen wird.

Detaillierte Dokumentation

build()

Erstellt das Diagramm.

Rückflug

Chart: Ein Diagrammobjekt, das in Dokumente oder UI-Elemente eingebettet oder als statisches Bild verwendet werden kann.

enablePaging(enablePaging)

Legt fest, ob das Paging durch die Daten aktiviert werden soll.

Standardmäßig ist die Paginierung deaktiviert. Wenn die Paginierung aktiviert ist, beträgt die Standardseitengröße 10.

Parameter

NameTypBeschreibung
enablePagingBooleantrue, wenn die Paginierung aktiviert werden soll, andernfalls false.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

enablePaging(pageSize)

Aktiviert die Paginierung und legt die Anzahl der Zeilen auf jeder Seite fest.

Die Standardseitengröße ist 10. 

// Creates a table chart builder and enables paging with page size of 5.
const builder = Charts.newTableChart();
builder.enablePaging(5);

Parameter

NameTypBeschreibung
pageSizeIntegerDie Anzahl der Zeilen auf jeder Seite der Tabelle.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

enablePaging(pageSize, startPage)

Aktiviert die Paginierung, legt die Anzahl der Zeilen auf jeder Seite und die erste anzuzeigende Tabellenseite fest (Seitenzahlen sind nullbasiert).

Die Standardseitengröße ist 10 und die Standardstartseite ist 0. 

// Creates a table chart builder and enables paging with page size of 5 and
// displays page 2 first.
const builder = Charts.newTableChart();
builder.enablePaging(5, 2);

Parameter

NameTypBeschreibung
pageSizeIntegerDie Anzahl der Zeilen auf jeder Seite der Tabelle.
startPageIntegerDie erste Tabellenseite, die angezeigt werden soll (Seitenzahlen sind nullbasiert).

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

enableRtlTable(rtlEnabled)

Fügt grundlegende Unterstützung für rechtsläufige Sprachen (z. B. Arabisch oder Hebräisch) hinzu, indem die Spaltenreihenfolge der Tabelle umgekehrt wird. Spalte 0 ist also die Spalte ganz rechts und die letzte Spalte ist die Spalte ganz links.

Dies hat keine Auswirkungen auf den Spaltenindex in den zugrunde liegenden Daten, sondern nur auf die Reihenfolge der Darstellung. Die vollständige bidirektionale (BiDi) Sprachanzeige wird von der Tabellenvisualisierung auch mit dieser Option nicht unterstützt. Diese Option wird ignoriert, wenn Sie die Paginierung aktivieren (mit der Option „page“) oder wenn die Tabelle Scrollbalken hat, weil Sie Optionen für Höhe und Breite angegeben haben, die kleiner als die erforderliche Tabellengröße sind. Standardmäßig ist die RTL-Unterstützung deaktiviert.

Parameter

NameTypBeschreibung
rtlEnabledBooleantrue, wenn die Unterstützung für die Leserichtung von rechts nach links aktiviert werden soll, andernfalls false.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

enableSorting(enableSorting)

Legt fest, ob Spalten sortiert werden sollen, wenn der Nutzer auf eine Spaltenüberschrift klickt.

Wenn die Sortierung aktiviert ist, werden die Zeilen automatisch sortiert, wenn Nutzer auf die Spaltenüberschrift klicken. Standardmäßig ist die Sortierung aktiviert.

Parameter

NameTypBeschreibung
enableSortingBooleantrue, um das Sortieren durch Klicken auf Spaltenüberschriften zu aktivieren, false andernfalls.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

setDataSourceUrl(url)

Legt die Datenquellen-URL fest, die verwendet wird, um Daten aus einer externen Quelle wie Google Sheets abzurufen. Wenn eine Datenquellen-URL und eine DataTable angegeben werden, wird die Datenquellen-URL ignoriert.

Weitere Informationen zum Abfragen von Datenquellen finden Sie in der Google Charts-Dokumentation.

Parameter

NameTypBeschreibung
urlStringDie Datenquellen-URL, einschließlich aller Suchparameter.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

setDataTable(tableBuilder)

Legt die Datentabelle fest, die für das Diagramm verwendet werden soll. Dazu wird ein DataTableBuilder verwendet. Dies ist eine praktische Methode zum Festlegen der Datentabelle, ohne dass build() aufgerufen werden muss.

Parameter

NameTypBeschreibung
tableBuilderDataTableBuilderEin Tool zum Erstellen von Datentabellen. Im Rahmen dieses Aufrufs wird sofort eine neue Datentabelle erstellt. Alle weiteren Aktualisierungen des Builders werden daher nicht im Diagramm berücksichtigt.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

setDataTable(table)

Legt die Datentabelle fest, die die Linien für das Diagramm sowie die X-Achsenbeschriftungen enthält. Die erste Spalte muss ein String sein und die Labels für die horizontale Achse enthalten. Es können beliebig viele Spalten folgen, die alle numerisch sein müssen. Jede Spalte wird als separate Zeile dargestellt.

Parameter

NameTypBeschreibung
tableDataTableSourceDie Datentabelle, die für das Diagramm verwendet werden soll.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

setDataViewDefinition(dataViewDefinition)

Legt die Definition der Datenansicht fest, die für das Diagramm verwendet werden soll.

Parameter

NameTypBeschreibung
dataViewDefinitionDataViewDefinitionEin Objekt zur Definition der Datenansicht, das die Ansicht definiert, die für das Zeichnen des Diagramms aus der angegebenen Datenquelle abgeleitet werden soll.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

setDimensions(width, height)

Legt die Abmessungen für das Diagramm fest.

Parameter

NameTypBeschreibung
widthIntegerDie Breite des Diagramms in Pixeln.
heightIntegerDie Höhe des Diagramms in Pixeln.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

setFirstRowNumber(number)

Legt die Zeilennummer für die erste Zeile in der Datentabelle fest.

Die Standardzeilennummer der ersten Zeile ist 1. 

// Creates a table chart builder and sets the first row to be 2.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Parameter

NameTypBeschreibung
numberIntegerDie Zeilennummer der ersten Zeile in der Datentabelle.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

setInitialSortingAscending(column)

Legt den Index der Spalte fest, nach der die Tabelle anfänglich sortiert werden soll (aufsteigend).

Die Spalte ist in aufsteigender Reihenfolge sortiert und mit einem kleinen Pfeil gekennzeichnet. 

// Creates a table chart builder and sorts it by the second column (ascending).
const builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

Parameter

NameTypBeschreibung
columnIntegerDie Nummer der Spalte, nach der die Tabelle anfänglich sortiert werden soll.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

setInitialSortingDescending(column)

Legt den Index der Spalte fest, nach der die Tabelle anfänglich sortiert werden soll (absteigend).

Die Spalte ist in absteigender Reihenfolge sortiert und mit einem kleinen Pfeil gekennzeichnet. 

// Creates a table chart builder and sorts it by the second column (descending).
const builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

Parameter

NameTypBeschreibung
columnIntegerDie Nummer der Spalte, nach der die Tabelle anfänglich sortiert werden soll.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

setOption(option, value)

Legt erweiterte Optionen für dieses Diagramm fest. Verfügbare Optionen für dieses Diagramm Diese Methode hat keine Auswirkungen, wenn die angegebene Option ungültig ist. 

// Build a table chart which renders HTML.
const builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
const chart = builder.build();

Parameter

NameTypBeschreibung
optionStringDie festzulegende Option.
valueObjectDer festzulegende Wert.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

showRowNumberColumn(showRowNumber)

Legt fest, ob die Zeilennummer als erste Spalte der Tabelle angezeigt werden soll.

Standardmäßig werden keine Zeilennummern angezeigt.

Parameter

NameTypBeschreibung
showRowNumberBooleantrue, wenn in der ersten Spalte der Tabelle die Zeilennummer angezeigt werden soll, andernfalls false.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.

useAlternatingRowStyle(alternate)

Legt fest, ob ungeraden und geraden Zeilen eines Tabellendiagramms ein abwechselnder Farbstil zugewiesen wird.

Standardmäßig haben die Zeilen einen abwechselnden Farbstil.

Parameter

NameTypBeschreibung
alternateBooleantrue, wenn sich die Farbstile abwechseln sollen, andernfalls false.

Rückflug

TableChartBuilder – Dieser Builder, nützlich für die Verkettung.