Class AreaChartBuilder

AreaChartBuilder

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

Hier ist ein Beispiel für die Erstellung eines Flächendiagramms.

// Create a data table with some sample data.
const sampleData = Charts.newDataTable()
                       .addColumn(Charts.ColumnType.STRING, 'Month')
                       .addColumn(Charts.ColumnType.NUMBER, 'Dining')
                       .addColumn(Charts.ColumnType.NUMBER, 'Total')
                       .addRow(['Jan', 60, 520])
                       .addRow(['Feb', 50, 430])
                       .addRow(['Mar', 53, 440])
                       .addRow(['Apr', 70, 410])
                       .addRow(['May', 80, 390])
                       .addRow(['Jun', 60, 500])
                       .addRow(['Jul', 100, 450])
                       .addRow(['Aug', 140, 431])
                       .addRow(['Sep', 75, 488])
                       .addRow(['Oct', 70, 521])
                       .addRow(['Nov', 58, 388])
                       .addRow(['Dec', 63, 400])
                       .build();

const chart = Charts.newAreaChart()
                  .setTitle('Yearly Spending')
                  .setXAxisTitle('Month')
                  .setYAxisTitle('Spending (USD)')
                  .setDimensions(600, 500)
                  .setStacked()
                  .setColors(['red', 'green'])
                  .setDataTable(sampleData)
                  .build();

Methoden

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

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

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

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

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

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

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

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

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

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

AreaChartBuilder – 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 an area chart with a 1-second animation duration.
const builder = Charts.newAreaChart();
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

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

---

setPointStyle(style)

Legt den Stil für Punkte in der Linie fest. Standardmäßig haben Punkte keine besonderen Formatierungen und nur die Linie ist sichtbar.

// Creates a line chart builder and sets large point style.
const builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

Parameter

Name	Typ	Beschreibung
style	PointStyle	Der Stil, der für Punkte in der Linie verwendet werden soll.

Rückflug

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

Weitere Informationen

• PointStyle

---

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

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

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

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

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

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

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

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

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

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

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

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