Class BarChartBuilder

BarChartBuilder

Builder untuk diagram batang. Untuk mengetahui detail selengkapnya, lihat dokumentasi Google Charts.

Berikut adalah contoh yang menunjukkan cara membuat diagram batang. Data diimpor dari spreadsheet Google.

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

const chartBuilder = Charts.newBarChart()
                         .setTitle('Top Grossing Films in US and Canada')
                         .setXAxisTitle('USD')
                         .setYAxisTitle('Film')
                         .setDimensions(600, 500)
                         .setLegendPosition(Charts.Position.BOTTOM)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
build()ChartMembuat diagram.
reverseCategories()BarChartBuilderMembalikkan gambar deret di sumbu domain.
reverseDirection()BarChartBuilderMembalik arah pertumbuhan batang di sepanjang sumbu horizontal.
setBackgroundColor(cssValue)BarChartBuilderMenetapkan warna latar belakang untuk diagram.
setColors(cssValues)BarChartBuilderMenetapkan warna untuk garis dalam diagram.
setDataSourceUrl(url)BarChartBuilderMenetapkan URL sumber data yang digunakan untuk mengambil data dari sumber eksternal, seperti Google Spreadsheet.
setDataTable(tableBuilder)BarChartBuilderMenetapkan tabel data yang akan digunakan untuk diagram menggunakan DataTableBuilder.
setDataTable(table)BarChartBuilderMenetapkan tabel data yang berisi garis untuk diagram, serta label sumbu X.
setDataViewDefinition(dataViewDefinition)BarChartBuilderMenetapkan definisi tampilan data yang akan digunakan untuk diagram.
setDimensions(width, height)BarChartBuilderMenetapkan dimensi untuk diagram.
setLegendPosition(position)BarChartBuilderMenetapkan posisi legenda sehubungan dengan diagram.
setLegendTextStyle(textStyle)BarChartBuilderMenetapkan gaya teks legenda diagram.
setOption(option, value)BarChartBuilderMenetapkan opsi lanjutan untuk diagram ini.
setRange(start, end)BarChartBuilderMenetapkan rentang untuk diagram.
setStacked()BarChartBuilderMenggunakan garis bertumpuk, yang berarti nilai garis dan batang ditumpuk (diakumulasikan).
setTitle(chartTitle)BarChartBuilderMenetapkan judul diagram.
setTitleTextStyle(textStyle)BarChartBuilderMenetapkan gaya teks judul diagram.
setXAxisTextStyle(textStyle)BarChartBuilderMenetapkan gaya teks sumbu horizontal.
setXAxisTitle(title)BarChartBuilderMenambahkan judul ke sumbu horizontal.
setXAxisTitleTextStyle(textStyle)BarChartBuilderMenetapkan gaya teks judul sumbu horizontal.
setYAxisTextStyle(textStyle)BarChartBuilderMenetapkan gaya teks sumbu vertikal.
setYAxisTitle(title)BarChartBuilderMenambahkan judul ke sumbu vertikal.
setYAxisTitleTextStyle(textStyle)BarChartBuilderMenetapkan gaya teks judul sumbu vertikal.
useLogScale()BarChartBuilderMembuat sumbu rentang menjadi skala logaritmik (memerlukan semua nilai positif).

Dokumentasi mendetail

build()

Membuat diagram.

Pulang pergi

Chart — Objek Diagram, yang dapat disematkan ke dalam dokumen, elemen UI, atau digunakan sebagai gambar statis.


reverseCategories()

Membalikkan gambar deret di sumbu domain. Untuk diagram rentang vertikal (seperti diagram garis, area, atau kolom), ini berarti sumbu horizontal digambar dari kanan ke kiri. Untuk diagram rentang horizontal (seperti diagram batang), ini berarti sumbu vertikal digambar dari atas ke bawah. Untuk diagram lingkaran, ini berarti irisan digambar berlawanan arah jarum jam.

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

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


reverseDirection()

Membalik arah pertumbuhan batang di sepanjang sumbu horizontal. Secara default, nilai bertambah dari kiri ke kanan. Memanggil metode ini akan menyebabkannya tumbuh dari kanan ke kiri.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setBackgroundColor(cssValue)

Menetapkan warna latar belakang untuk diagram.

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

Parameter

NamaJenisDeskripsi
cssValueStringNilai CSS untuk warna (seperti "blue" atau "#00f").

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setColors(cssValues)

Menetapkan warna untuk garis dalam diagram.

// 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

NamaJenisDeskripsi
cssValuesString[]Array nilai CSS warna, seperti ["red", "#acf"]. Elemen ke-n dalam array mewakili warna garis ke-n dalam diagram.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setDataSourceUrl(url)

Menetapkan URL sumber data yang digunakan untuk mengambil data dari sumber eksternal, seperti Google Spreadsheet. Jika URL sumber data dan DataTable disediakan, URL sumber data akan diabaikan.

Untuk informasi selengkapnya tentang cara membuat kueri sumber data, lihat dokumentasi Google Charts.

Parameter

NamaJenisDeskripsi
urlStringURL sumber data, termasuk parameter kueri.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setDataTable(tableBuilder)

Menetapkan tabel data yang akan digunakan untuk diagram menggunakan DataTableBuilder. Ini adalah metode praktis untuk menetapkan tabel data tanpa perlu memanggil build().

Parameter

NamaJenisDeskripsi
tableBuilderDataTableBuilderBuilder tabel data. Tabel data baru akan langsung dibuat sebagai bagian dari panggilan ini, sehingga pembaruan lebih lanjut pada builder tidak akan tercermin dalam diagram.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setDataTable(table)

Menetapkan tabel data yang berisi garis untuk diagram, serta label sumbu X. Kolom pertama harus berupa string, dan berisi label sumbu horizontal. Jumlah kolom yang dapat mengikuti, semuanya harus berupa angka. Setiap kolom ditampilkan sebagai baris terpisah.

Parameter

NamaJenisDeskripsi
tableDataTableSourceTabel data yang akan digunakan untuk diagram.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setDataViewDefinition(dataViewDefinition)

Menetapkan definisi tampilan data yang akan digunakan untuk diagram.

Parameter

NamaJenisDeskripsi
dataViewDefinitionDataViewDefinitionObjek definisi tampilan data yang menentukan tampilan yang harus berasal dari sumber data tertentu untuk gambar diagram.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setDimensions(width, height)

Menetapkan dimensi untuk diagram.

Parameter

NamaJenisDeskripsi
widthIntegerLebar diagram, dalam piksel.
heightIntegerTinggi diagram, dalam piksel.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setLegendPosition(position)

Menetapkan posisi legenda sehubungan dengan diagram. Secara default, tidak ada legenda.

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

Parameter

NamaJenisDeskripsi
positionPositionPosisi legenda.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setLegendTextStyle(textStyle)

Menetapkan gaya teks legenda diagram.

// 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

NamaJenisDeskripsi
textStyleTextStyleGaya teks yang akan digunakan untuk legenda diagram.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setOption(option, value)

Menetapkan opsi lanjutan untuk diagram ini. Lihat opsi yang tersedia untuk diagram ini. Metode ini tidak berpengaruh jika opsi yang diberikan tidak valid.

// Build a bar chart with a 1-second animation duration.
const builder = Charts.newBarChart();
builder.setOption('animation.duration', 1000);
const chart = builder.build();

Parameter

NamaJenisDeskripsi
optionStringOpsi yang akan ditetapkan.
valueObjectNilai yang akan ditetapkan.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setRange(start, end)

Menetapkan rentang untuk diagram.

Jika ada titik data yang berada di luar rentang, rentang akan diperluas untuk menyertakan titik data tersebut.

Parameter

NamaJenisDeskripsi
startNumberNilai untuk garis petak terendah pada sumbu rentang.
endNumberNilai untuk garis petak tertinggi pada sumbu rentang.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setStacked()

Menggunakan garis bertumpuk, yang berarti nilai garis dan batang ditumpuk (diakumulasikan). Secara default, tidak ada penumpukan.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setTitle(chartTitle)

Menetapkan judul diagram. Judul ditampilkan di tengah di atas diagram.

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

Parameter

NamaJenisDeskripsi
chartTitleStringjudul diagram.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setTitleTextStyle(textStyle)

Menetapkan gaya teks judul diagram.

// 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

NamaJenisDeskripsi
textStyleTextStyleGaya teks yang akan digunakan untuk judul diagram. Anda dapat membuat objek TextStyleBuilder dengan memanggil Charts.newTextStyle().

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setXAxisTextStyle(textStyle)

Menetapkan gaya teks sumbu horizontal.

// 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

NamaJenisDeskripsi
textStyleTextStyleGaya teks yang akan digunakan untuk judul sumbu horizontal. Anda dapat membuat objek TextStyleBuilder dengan memanggil Charts.newTextStyle().

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setXAxisTitle(title)

Menambahkan judul ke sumbu horizontal. Judul dipusatkan dan muncul di bawah label nilai sumbu.

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

Parameter

NamaJenisDeskripsi
titleStringJudul untuk sumbu X.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setXAxisTitleTextStyle(textStyle)

Menetapkan gaya teks judul sumbu horizontal.

// 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

NamaJenisDeskripsi
textStyleTextStyleGaya teks yang akan digunakan untuk judul sumbu horizontal. Anda dapat membuat objek TextStyleBuilder dengan memanggil Charts.newTextStyle().

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setYAxisTextStyle(textStyle)

Menetapkan gaya teks sumbu vertikal.

// 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

NamaJenisDeskripsi
textStyleTextStyleGaya teks yang akan digunakan untuk judul sumbu horizontal. Anda dapat membuat objek TextStyleBuilder dengan memanggil Charts.newTextStyle().

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setYAxisTitle(title)

Menambahkan judul ke sumbu vertikal. Judul dipusatkan dan muncul di sebelah kiri label nilai.

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

Parameter

NamaJenisDeskripsi
titleStringJudul untuk sumbu Y.

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


setYAxisTitleTextStyle(textStyle)

Menetapkan gaya teks judul sumbu vertikal.

// 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

NamaJenisDeskripsi
textStyleTextStyleGaya teks yang akan digunakan untuk judul sumbu horizontal. Anda dapat membuat objek TextStyleBuilder dengan memanggil Charts.newTextStyle().

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.


useLogScale()

Membuat sumbu rentang menjadi skala logaritmik (memerlukan semua nilai positif). Sumbu rentang adalah sumbu vertikal untuk diagram vertikal (seperti garis, area, atau kolom) dan sumbu horizontal untuk diagram horizontal (seperti batang).

Pulang pergi

BarChartBuilder — Builder ini berguna untuk membuat rantai.