Halaman ini diterjemahkan oleh Cloud Translation API.

Class ScatterChartBuilder

Builder untuk diagram sebar. Untuk mengetahui detail selengkapnya, lihat dokumentasi Google Chart.

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

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

var chartBuilder = Charts.newScatterChart()
    .setTitle('Adjusted GDP & U.S. Population')
    .setXAxisTitle('U.S. Population (millions)')
    .setYAxisTitle('Adjusted GDP ($ billions)')
    .setDimensions(600, 500)
    .setLegendPosition(Charts.Position.NONE)
    .setDataSourceUrl(dataSourceUrl);

var chart = chartBuilder.build();

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`build()`	`Chart`	Membuat diagram.
`setBackgroundColor(cssValue)`	`ScatterChartBuilder`	Menetapkan warna latar belakang untuk diagram.
`setColors(cssValues)`	`ScatterChartBuilder`	Menetapkan warna untuk garis dalam diagram.
`setDataSourceUrl(url)`	`ScatterChartBuilder`	Menetapkan URL sumber data yang digunakan untuk mengambil data dari sumber eksternal, seperti Google Spreadsheet.
`setDataTable(tableBuilder)`	`ScatterChartBuilder`	Menetapkan tabel data yang akan digunakan untuk diagram menggunakan DataTableBuilder.
`setDataTable(table)`	`ScatterChartBuilder`	Menetapkan tabel data yang berisi garis untuk diagram, serta label sumbu X.
`setDataViewDefinition(dataViewDefinition)`	`ScatterChartBuilder`	Menetapkan definisi tampilan data yang akan digunakan untuk diagram.
`setDimensions(width, height)`	`ScatterChartBuilder`	Menetapkan dimensi untuk diagram.
`setLegendPosition(position)`	`ScatterChartBuilder`	Menetapkan posisi legenda sehubungan dengan diagram.
`setLegendTextStyle(textStyle)`	`ScatterChartBuilder`	Menetapkan gaya teks legenda diagram.
`setOption(option, value)`	`ScatterChartBuilder`	Menetapkan opsi lanjutan untuk diagram ini.
`setPointStyle(style)`	`ScatterChartBuilder`	Menetapkan gaya untuk titik dalam garis.
`setTitle(chartTitle)`	`ScatterChartBuilder`	Menetapkan judul diagram.
`setTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Menetapkan gaya teks judul diagram.
`setXAxisLogScale()`	`ScatterChartBuilder`	Membuat sumbu horizontal menjadi skala logaritmik (mengharuskan semua nilai positif).
`setXAxisRange(start, end)`	`ScatterChartBuilder`	Menetapkan rentang untuk sumbu horizontal diagram.
`setXAxisTextStyle(textStyle)`	`ScatterChartBuilder`	Menetapkan gaya teks sumbu horizontal.
`setXAxisTitle(title)`	`ScatterChartBuilder`	Menambahkan judul ke sumbu horizontal.
`setXAxisTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Menetapkan gaya teks judul sumbu horizontal.
`setYAxisLogScale()`	`ScatterChartBuilder`	Membuat sumbu vertikal menjadi skala logaritmik (mengharuskan semua nilai positif).
`setYAxisRange(start, end)`	`ScatterChartBuilder`	Menetapkan rentang untuk sumbu vertikal diagram.
`setYAxisTextStyle(textStyle)`	`ScatterChartBuilder`	Menetapkan gaya teks sumbu vertikal.
`setYAxisTitle(title)`	`ScatterChartBuilder`	Menambahkan judul ke sumbu vertikal.
`setYAxisTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Menetapkan gaya teks judul sumbu vertikal.

Dokumentasi mendetail

`build()`

Membuat diagram.

Return

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

`setBackgroundColor(cssValue)`

Menetapkan warna latar belakang untuk diagram.

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

Parameter

Nama	Jenis	Deskripsi
`cssValue`	`String`	Nilai CSS untuk warna (seperti `"blue"` atau `"#00f"`).

Return

ScatterChartBuilder — 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.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parameter

Nama	Jenis	Deskripsi
`cssValues`	`String[]`	Array nilai CSS warna, seperti `["red", "#acf"]`. Elemen ke-n dalam array merepresentasikan warna garis ke-n dalam diagram.

Return

ScatterChartBuilder — 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 diberikan, URL sumber data akan diabaikan.

Untuk informasi lebih lanjut tentang melakukan kueri sumber data, lihat dokumentasi Google Chart.

Parameter

Nama	Jenis	Deskripsi
`url`	`String`	URL sumber data, termasuk parameter kueri apa pun.

Return

ScatterChartBuilder — Builder ini berguna untuk membuat rantai.

`setDataTable(tableBuilder)`

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

Parameter

Nama	Jenis	Deskripsi
`tableBuilder`	`DataTableBuilder`	Pembuat tabel data. Tabel data baru dibuat secara instan sebagai bagian dari panggilan ini, sehingga update lebih lanjut pada builder tidak akan tercermin dalam diagram.

Return

ScatterChartBuilder — 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. Berapa pun jumlah kolom bisa mengikuti, semuanya harus numerik. Setiap kolom ditampilkan sebagai garis terpisah.

Parameter

Nama	Jenis	Deskripsi
`table`	`DataTableSource`	Tabel data yang akan digunakan untuk diagram.

Return

ScatterChartBuilder — Builder ini berguna untuk membuat rantai.

`setDataViewDefinition(dataViewDefinition)`

Menetapkan definisi tampilan data yang akan digunakan untuk diagram.

Parameter

Nama	Jenis	Deskripsi
`dataViewDefinition`	`DataViewDefinition`	Objek definisi tampilan data yang menentukan tampilan yang harus berasal dari sumber data tertentu untuk gambar diagram.

Return

ScatterChartBuilder — Builder ini berguna untuk membuat rantai.

`setDimensions(width, height)`

Menetapkan dimensi untuk diagram.

Parameter

Nama	Jenis	Deskripsi
`width`	`Integer`	Lebar diagram, dalam piksel.
`height`	`Integer`	Tinggi diagram, dalam piksel.

Return

ScatterChartBuilder — 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.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Parameter

Nama	Jenis	Deskripsi
`position`	`Position`	Posisi legenda.

Return

ScatterChartBuilder — 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.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Parameter

Nama	Jenis	Deskripsi
`textStyle`	`TextStyle`	Gaya teks yang akan digunakan untuk legenda diagram.

Return

ScatterChartBuilder — 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 scatter chart with a 1-second animation duration.
var builder = Charts.newScatterChart();
builder.setOption('animation.duration', 1000);
var chart = builder.build();

Parameter

Nama	Jenis	Deskripsi
`option`	`String`	Opsi yang akan ditetapkan.
`value`	`Object`	Nilai yang akan ditetapkan.

Return

ScatterChartBuilder — Builder ini berguna untuk membuat rantai.

`setPointStyle(style)`

Menetapkan gaya untuk titik dalam garis. Secara default, titik tidak memiliki gaya tertentu, dan hanya garis yang terlihat.

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

Parameter

Nama	Jenis	Deskripsi
`style`	`PointStyle`	Gaya yang akan digunakan untuk titik dalam garis.

Return

ScatterChartBuilder — Builder ini berguna untuk membuat rantai.

Lihat juga

PointStyle

`setTitle(chartTitle)`

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

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

Parameter

Nama	Jenis	Deskripsi
`chartTitle`	`String`	judul bagan.

Return

ScatterChartBuilder — 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.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Parameter

Nama	Jenis	Deskripsi
`textStyle`	`TextStyle`	Gaya teks yang akan digunakan untuk judul diagram. Anda dapat membuat objek `TextStyleBuilder` dengan memanggil `Charts.newTextStyle()`.

Return

ScatterChartBuilder — Builder ini berguna untuk membuat rantai.

`setXAxisLogScale()`

Membuat sumbu horizontal menjadi skala logaritmik (mengharuskan semua nilai positif).

Return

ScatterChartBuilder — Builder ini berguna untuk membuat rantai.

`setXAxisRange(start, end)`

Menetapkan rentang untuk sumbu horizontal diagram.

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

// Creates a scatter chart builder and sets the X-axis range to be 0 to 100.
var builder = Charts.newTableChart();
builder.setXAxisRange(0, 100);

Parameter

Nama	Jenis	Deskripsi
`start`	`Number`	Nilai untuk garis petak terendah dari sumbu horizontal.
`end`	`Number`	Nilai untuk garis petak tertinggi sumbu horizontal.

Return

ScatterChartBuilder — 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.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

Parameter

Nama	Jenis	Deskripsi
`textStyle`	`TextStyle`	Gaya teks yang akan digunakan untuk judul sumbu horizontal. Anda dapat membuat objek `TextStyleBuilder` dengan memanggil `Charts.newTextStyle()`.

Return

ScatterChartBuilder — Builder ini berguna untuk membuat rantai.

`setXAxisTitle(title)`

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

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

Parameter

Nama	Jenis	Deskripsi
`title`	`String`	Judul untuk sumbu X.

Return

ScatterChartBuilder — 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.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Parameter

Nama	Jenis	Deskripsi
`textStyle`	`TextStyle`	Gaya teks yang akan digunakan untuk judul sumbu horizontal. Anda dapat membuat objek `TextStyleBuilder` dengan memanggil `Charts.newTextStyle()`.

Return

ScatterChartBuilder — Builder ini berguna untuk membuat rantai.

`setYAxisLogScale()`

Membuat sumbu vertikal menjadi skala logaritmik (mengharuskan semua nilai positif).

Return

ScatterChartBuilder — Builder ini berguna untuk membuat rantai.

`setYAxisRange(start, end)`

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

// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100.
var builder = Charts.newTableChart();
builder.setYAxisRange(0, 100);

Parameter

Nama	Jenis	Deskripsi
`start`	`Number`	Nilai untuk garis petak terendah sumbu vertikal.
`end`	`Number`	Nilai untuk garis petak tertinggi sumbu vertikal.

Return

ScatterChartBuilder — 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.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

Parameter

Nama	Jenis	Deskripsi
`textStyle`	`TextStyle`	Gaya teks yang akan digunakan untuk judul sumbu horizontal. Anda dapat membuat objek `TextStyleBuilder` dengan memanggil `Charts.newTextStyle()`.

Return

ScatterChartBuilder — Builder ini berguna untuk membuat rantai.

`setYAxisTitle(title)`

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

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

Parameter

Nama	Jenis	Deskripsi
`title`	`String`	Judul untuk sumbu Y.

Return

ScatterChartBuilder — 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.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Parameter

Nama	Jenis	Deskripsi
`textStyle`	`TextStyle`	Gaya teks yang akan digunakan untuk judul sumbu horizontal. Anda dapat membuat objek `TextStyleBuilder` dengan memanggil `Charts.newTextStyle()`.

Return

ScatterChartBuilder — Builder ini berguna untuk membuat rantai.