Class ColumnChartBuilder

ColumnChartBuilder

Builder für Säulendiagramme. Weitere Informationen finden Sie in der Google Charts-Dokumentation.

In diesem Beispiel wird gezeigt, wie Sie ein Säulendiagramm mit Daten aus einer Datentabelle erstellen.

const sampleData = Charts.newDataTable()
                       .addColumn(Charts.ColumnType.STRING, 'Year')
                       .addColumn(Charts.ColumnType.NUMBER, 'Sales')
                       .addColumn(Charts.ColumnType.NUMBER, 'Expenses')
                       .addRow(['2004', 1000, 400])
                       .addRow(['2005', 1170, 460])
                       .addRow(['2006', 660, 1120])
                       .addRow(['2007', 1030, 540])
                       .addRow(['2008', 800, 600])
                       .addRow(['2009', 943, 678])
                       .addRow(['2010', 1020, 550])
                       .addRow(['2011', 910, 700])
                       .addRow(['2012', 1230, 840])
                       .build();

const chart = Charts.newColumnChart()
                  .setTitle('Sales & Expenses')
                  .setXAxisTitle('Year')
                  .setYAxisTitle('Amount (USD)')
                  .setDimensions(600, 500)
                  .setDataTable(sampleData)
                  .build();

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
build()	Chart	Erstellt das Diagramm.
reverseCategories()	ColumnChartBuilder	Kehrt die Darstellung von Reihen auf der Bereichsachse um.
setBackgroundColor(cssValue)	ColumnChartBuilder	Legt die Hintergrundfarbe für das Diagramm fest.
setColors(cssValues)	ColumnChartBuilder	Legt die Farben für die Linien im Diagramm fest.
setDataSourceUrl(url)	ColumnChartBuilder	Legt die Datenquellen-URL fest, die verwendet wird, um Daten aus einer externen Quelle wie Google Sheets abzurufen.
setDataTable(tableBuilder)	ColumnChartBuilder	Legt die Datentabelle fest, die für das Diagramm verwendet werden soll. Dazu wird ein DataTableBuilder verwendet.
setDataTable(table)	ColumnChartBuilder	Legt die Datentabelle fest, die die Linien für das Diagramm sowie die X-Achsenbeschriftungen enthält.
setDataViewDefinition(dataViewDefinition)	ColumnChartBuilder	Legt die Definition der Datenansicht fest, die für das Diagramm verwendet werden soll.
setDimensions(width, height)	ColumnChartBuilder	Legt die Abmessungen für das Diagramm fest.
setLegendPosition(position)	ColumnChartBuilder	Hiermit wird die Position der Legende im Verhältnis zum Diagramm festgelegt.
setLegendTextStyle(textStyle)	ColumnChartBuilder	Legt den Textstil der Diagrammlegende fest.
setOption(option, value)	ColumnChartBuilder	Legt erweiterte Optionen für dieses Diagramm fest.
setRange(start, end)	ColumnChartBuilder	Legt den Bereich für das Diagramm fest.
setStacked()	ColumnChartBuilder	Verwendet gestapelte Linien. Das bedeutet, dass Linien- und Balkenwerte gestapelt (kumuliert) werden.
setTitle(chartTitle)	ColumnChartBuilder	Legt den Titel des Diagramms fest.
setTitleTextStyle(textStyle)	ColumnChartBuilder	Legt den Textstil des Diagrammtitels fest.
setXAxisTextStyle(textStyle)	ColumnChartBuilder	Legt den Textstil der horizontalen Achse fest.
setXAxisTitle(title)	ColumnChartBuilder	Fügt der horizontalen Achse einen Titel hinzu.
setXAxisTitleTextStyle(textStyle)	ColumnChartBuilder	Legt den Textstil für den Titel der horizontalen Achse fest.
setYAxisTextStyle(textStyle)	ColumnChartBuilder	Legt den Textstil der vertikalen Achse fest.
setYAxisTitle(title)	ColumnChartBuilder	Fügt der vertikalen Achse einen Titel hinzu.
setYAxisTitleTextStyle(textStyle)	ColumnChartBuilder	Legt den Textstil für den Titel der vertikalen Achse fest.
useLogScale()	ColumnChartBuilder	Legt fest, dass die Bereichsachse logarithmisch skaliert wird. Dazu müssen alle Werte positiv sein.

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.

---

reverseCategories()

Kehrt die Darstellung von Reihen auf der Bereichsachse um. Bei Diagrammen mit vertikalem Bereich (z. B. Linien-, Flächen- oder Säulendiagrammen) wird die horizontale Achse von rechts nach links gezeichnet. Bei Diagrammen mit horizontalem Bereich (z. B. Balkendiagrammen) wird die vertikale Achse von oben nach unten gezeichnet. Bei Kreisdiagrammen werden die Segmente gegen den Uhrzeigersinn gezeichnet.

// Creates a pie chart builder and sets drawing of the slices in a
// counter-clockwise manner.
const builder = Charts.newPieChart();
builder.reverseCategories();

Rückflug

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

---

setBackgroundColor(cssValue)

Legt die Hintergrundfarbe für das Diagramm fest.

// Creates a line chart builder and sets the background color to gray
const builder = Charts.newLineChart();
builder.setBackgroundColor('gray');

Parameter

Name	Typ	Beschreibung
cssValue	String	Der CSS-Wert für die Farbe, z. B. "blue" oder "#00f".

Rückflug

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

---

setColors(cssValues)

Legt die Farben für die Linien im Diagramm fest.

// Creates a line chart builder and sets the first two lines to be drawn in
// green and red, respectively.
const builder = Charts.newLineChart();
builder.setColors(['green', 'red']);

Parameter

Name	Typ	Beschreibung
cssValues	String[]	Ein Array von CSS-Farbwerten, z. B. ["red", "#acf"]. Das n-te Element im Array stellt die Farbe der n-ten Linie im Diagramm dar.

Rückflug

ColumnChartBuilder – 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

Name	Typ	Beschreibung
url	String	Die Datenquellen-URL, einschließlich aller Suchparameter.

Rückflug

ColumnChartBuilder – 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

Name	Typ	Beschreibung
tableBuilder	DataTableBuilder	Ein 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

ColumnChartBuilder – 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

Name	Typ	Beschreibung
table	DataTableSource	Die Datentabelle, die für das Diagramm verwendet werden soll.

Rückflug

ColumnChartBuilder – 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

Name	Typ	Beschreibung
dataViewDefinition	DataViewDefinition	Ein 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

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

---

setDimensions(width, height)

Legt die Abmessungen für das Diagramm fest.

Parameter

Name	Typ	Beschreibung
width	Integer	Die Breite des Diagramms in Pixeln.
height	Integer	Die Höhe des Diagramms in Pixeln.

Rückflug

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

---

setLegendPosition(position)

Hiermit wird die Position der Legende im Verhältnis zum Diagramm festgelegt. Standardmäßig ist keine Legende vorhanden.

// Creates a line chart builder and sets the legend position to right.
const builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Parameter

Name	Typ	Beschreibung
position	Position	Die Position der Legende.

Rückflug

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

---

setLegendTextStyle(textStyle)

Legt den Textstil der Diagrammlegende fest.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Parameter

Name	Typ	Beschreibung
textStyle	TextStyle	Der Textstil, der für die Diagrammlegende verwendet werden soll.

Rückflug

ColumnChartBuilder – 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 column chart with a 1-second animation duration.
const builder = Charts.newColumnChart();
builder.setOption('animation.duration', 1000);
const chart = builder.build();

Parameter

Name	Typ	Beschreibung
option	String	Die festzulegende Option.
value	Object	Der festzulegende Wert.

Rückflug

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

---

setRange(start, end)

Legt den Bereich für das Diagramm fest.

Wenn Datenpunkte außerhalb des Bereichs liegen, wird der Bereich erweitert, um diese Datenpunkte einzuschließen.

Parameter

Name	Typ	Beschreibung
start	Number	Der Wert für die unterste Rasterlinie der Bereichsachse.
end	Number	Der Wert für die oberste Rasterlinie der Bereichsachse.

Rückflug

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

---

setStacked()

Verwendet gestapelte Linien. Das bedeutet, dass Linien- und Balkenwerte gestapelt (kumuliert) werden. Standardmäßig werden keine Stapel erstellt.

Rückflug

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

---

setTitle(chartTitle)

Legt den Titel des Diagramms fest. Der Titel wird zentriert über dem Diagramm angezeigt.

// Creates a line chart builder and title to 'My Line Chart'.
const builder = Charts.newLineChart();
builder.setTitle('My Line Chart');

Parameter

Name	Typ	Beschreibung
chartTitle	String	den Diagrammtitel.

Rückflug

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

---

setTitleTextStyle(textStyle)

Legt den Textstil des Diagrammtitels fest.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Parameter

Name	Typ	Beschreibung
textStyle	TextStyle	Der Textstil, der für den Diagrammtitel verwendet werden soll. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

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

---

setXAxisTextStyle(textStyle)

Legt den Textstil der horizontalen Achse fest.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

Parameter

Name	Typ	Beschreibung
textStyle	TextStyle	Der für den Titel der horizontalen Achse zu verwendende Textstil. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

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

---

setXAxisTitle(title)

Fügt der horizontalen Achse einen Titel hinzu. Der Titel ist zentriert und wird unter den Achsenwertlabels angezeigt.

// Creates a line chart builder and sets the X-axis title.
const builder = Charts.newLineChart();
builder.setTitle('X-axis Title');

Parameter

Name	Typ	Beschreibung
title	String	Der Titel für die X-Achse.

Rückflug

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

---

setXAxisTitleTextStyle(textStyle)

Legt den Textstil für den Titel der horizontalen Achse fest.

// Creates a line chart builder and sets the X-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Parameter

Name	Typ	Beschreibung
textStyle	TextStyle	Der für den Titel der horizontalen Achse zu verwendende Textstil. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

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

---

setYAxisTextStyle(textStyle)

Legt den Textstil der vertikalen Achse fest.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

Parameter

Name	Typ	Beschreibung
textStyle	TextStyle	Der für den Titel der horizontalen Achse zu verwendende Textstil. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

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

---

setYAxisTitle(title)

Fügt der vertikalen Achse einen Titel hinzu. Der Titel ist zentriert und wird links neben den Wertlabels angezeigt.

// Creates a line chart builder and sets the Y-axis title.
const builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title');

Parameter

Name	Typ	Beschreibung
title	String	Der Titel für die Y-Achse.

Rückflug

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

---

setYAxisTitleTextStyle(textStyle)

Legt den Textstil für den Titel der vertikalen Achse fest.

// Creates a line chart builder and sets the Y-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Parameter

Name	Typ	Beschreibung
textStyle	TextStyle	Der für den Titel der horizontalen Achse zu verwendende Textstil. Sie können ein TextStyleBuilder-Objekt erstellen, indem Sie Charts.newTextStyle() aufrufen.

Rückflug

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

---

useLogScale()

Legt fest, dass die Bereichsachse logarithmisch skaliert wird. Dazu müssen alle Werte positiv sein. Die Bereichsachse ist die vertikale Achse für vertikale Diagramme (z. B. Linien-, Flächen- oder Säulendiagramme) und die horizontale Achse für horizontale Diagramme (z. B. Balkendiagramme).

Rückflug

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