Ringkasan
Histogram adalah diagram yang mengelompokkan data numerik ke dalam bin, menampilkan bin sebagai kolom yang tersegmentasi. Parameter ini digunakan untuk menggambarkan distribusi set data: seberapa sering nilai berada di dalam rentang.
Google Chart secara otomatis memilih jumlah bin untuk Anda. Semua bin memiliki lebar yang sama dan tingginya sebanding dengan jumlah titik data dalam bin. Selain itu, histogram mirip dengan diagram kolom.
Contoh
Berikut adalah histogram panjang dinosaurus:
Histogram memberi tahu kita bahwa kelompok yang paling umum adalah <10 meter, dan hanya ada satu dinosaurus dengan jarak lebih dari 40 meter. Kita dapat mengarahkan kursor ke bar untuk menemukan bahwa itu adalah Seismosaurus (yang mungkin hanya merupakan Diplodocus yang sangat besar; para pakar paleontologi tidak yakin).
Kode untuk menghasilkan histogram ini ditampilkan di bawah ini. Setelah menentukan
data (di sini,
dengan google.visualization.arrayToDataTable), diagram
akan ditentukan dengan panggilan ke google.visualization.Histogram dan
digambar dengan metode draw.
<html>
<head>
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
<script type="text/javascript">
google.charts.load("current", {packages:["corechart"]});
google.charts.setOnLoadCallback(drawChart);
function drawChart() {
var data = google.visualization.arrayToDataTable([
['Dinosaur', 'Length'],
['Acrocanthosaurus (top-spined lizard)', 12.2],
['Albertosaurus (Alberta lizard)', 9.1],
['Allosaurus (other lizard)', 12.2],
['Apatosaurus (deceptive lizard)', 22.9],
['Archaeopteryx (ancient wing)', 0.9],
['Argentinosaurus (Argentina lizard)', 36.6],
['Baryonyx (heavy claws)', 9.1],
['Brachiosaurus (arm lizard)', 30.5],
['Ceratosaurus (horned lizard)', 6.1],
['Coelophysis (hollow form)', 2.7],
['Compsognathus (elegant jaw)', 0.9],
['Deinonychus (terrible claw)', 2.7],
['Diplodocus (double beam)', 27.1],
['Dromicelomimus (emu mimic)', 3.4],
['Gallimimus (fowl mimic)', 5.5],
['Mamenchisaurus (Mamenchi lizard)', 21.0],
['Megalosaurus (big lizard)', 7.9],
['Microvenator (small hunter)', 1.2],
['Ornithomimus (bird mimic)', 4.6],
['Oviraptor (egg robber)', 1.5],
['Plateosaurus (flat lizard)', 7.9],
['Sauronithoides (narrow-clawed lizard)', 2.0],
['Seismosaurus (tremor lizard)', 45.7],
['Spinosaurus (spiny lizard)', 12.2],
['Supersaurus (super lizard)', 30.5],
['Tyrannosaurus (tyrant lizard)', 15.2],
['Ultrasaurus (ultra lizard)', 30.5],
['Velociraptor (swift robber)', 1.8]]);
var options = {
title: 'Lengths of dinosaurs, in meters',
legend: { position: 'none' },
};
var chart = new google.visualization.Histogram(document.getElementById('chart_div'));
chart.draw(data, options);
}
</script>
</head>
<body>
<div id="chart_div" style="width: 900px; height: 500px;"></div>
</body>
</html>
Label (di sini, nama dinosaurus) dapat dihilangkan, sehingga tooltip hanya akan menampilkan nilai numerik.
Warna Kontrol
Berikut adalah histogram populasi nasional:
Ada lebih dari dua ratus negara dengan populasi kurang dari seratus juta, dan penurunan yang parah setelah itu.
Histogram ini menggunakan opsi colors untuk menggambar data dengan warna hijau:
var options = {
title: 'Country Populations',
legend: { position: 'none' },
colors: ['green'],
};
Seperti semua Google Chart, warna dapat ditentukan sebagai nama bahasa Inggris atau sebagai nilai heksadesimal.
Bucket Kontrol
Secara default, Google Chart akan memilih ukuran bucket secara otomatis, menggunakan algoritma yang sudah dikenal luas untuk histogram. Namun, terkadang Anda ingin menggantinya, dan diagram di atas hanyalah contoh. Dengan begitu banyaknya negara di kelompok pertama, sulit untuk mempelajarinya di negara lain.
Untuk situasi seperti ini, diagram Histogram menyediakan dua
opsi: histogram.bucketSize, yang menggantikan
algoritma dan melakukan hardcode pada ukuran bucket;
dan histogram.lastBucketPercentile. Opsi kedua memerlukan penjelasan lebih lanjut: opsi ini mengubah komputasi ukuran bucket untuk mengabaikan nilai yang lebih tinggi atau lebih rendah dari nilai lainnya berdasarkan persentase yang Anda tentukan. Nilai ini masih
disertakan dalam histogram, tetapi tidak memengaruhi cara pengelompokan
nya. Hal ini berguna jika Anda tidak ingin pencilan ditempatkan di bucketnya sendiri. pencilan tersebut akan dikelompokkan dengan bucket pertama atau terakhir.
Pada diagram di atas, kami mengabaikan lima persen nilai teratas dan lima persen terbawah saat menghitung ukuran bucket. Nilainya masih dalam diagram; satu-satunya hal yang berubah adalah ukuran bucket, tetapi histogram menjadi lebih mudah dibaca.
Contoh ini juga menunjukkan cara mengubah skala sumbu vertikal untuk menggunakan skala "log duplikat", yang juga membantu saat membuat diagram data yang memiliki garis panjang yang berisi nilai-nilai kecil.
var options = {
title: 'Country Populations',
legend: { position: 'none' },
colors: ['#e7711c'],
histogram: { lastBucketPercentile: 5 },
vAxis: { scaleType: 'mirrorLog' }
};
Seperti yang dapat Anda lihat, menghapus lima persen bagian atas dan bawah dari penghitungan akan menghasilkan ukuran bucket 10.000.000, bukan 100.000.000. Jika selama ini Anda tahu bahwa
ukuran bucket 10.000.000 adalah yang Anda inginkan, Anda dapat
menggunakan histogram.bucketSize untuk melakukannya:
var options = {
title: 'Country Populations',
legend: { position: 'none' },
colors: ['#e7711c'],
histogram: { bucketSize: 10000000 }
};
Pada contoh berikut, kami menunjukkan cara memperluas rentang bucket dan menampilkan lebih banyak bucket tanpa jeda di antara bucket tersebut. Opsi maxNumBuckets dapat digunakan untuk meningkatkan jumlah bucket default. Opsi histogram.minValue dan histogram.maxValue akan memperluas rentang bucket, tetapi perhatikan bahwa jika ada data di luar rentang ini, opsi ini tidak akan memperkecil rentang.
Contoh ini juga menunjukkan bahwa Anda dapat menentukan tick yang akan ditampilkan untuk setiap bucket menggunakan opsi ticks eksplisit untuk hAxis. Hal ini tidak memengaruhi bucket itu sendiri, tetapi hanya bagaimana tick ditampilkan.
Perhatikan juga bahwa kita menentukan chartArea.width sedemikian rupa sehingga jumlah bucket akan sesuai secara lebih tepat tanpa artefak visual. Berikut adalah opsi untuk contoh ini.
var options = {
title: 'Approximating Normal Distribution',
legend: { position: 'none' },
colors: ['#4285F4'],
chartArea: { width: 405 },
hAxis: {
ticks: [-1, -0.75, -0.5, -0.25, 0, 0.25, 0.5, 0.75, 1]
},
bar: { gap: 0 },
histogram: {
bucketSize: 0.01,
maxNumBuckets: 400,
minValue: -1,
maxValue: 1
}
};
Beberapa Seri
Berikut adalah histogram biaya partikel subatom, sesuai dengan Model Standar:
Diagram di atas memiliki satu deret yang berisi semua partikel. Partikel subatom dapat dibagi menjadi empat kelompok: quarks, lepton, dan boson. Mari kita anggap setiap rangkaian ini sebagai rangkaiannya sendiri:
Dalam diagram ini, kami menggunakan deret yang berbeda (sekaligus warna) untuk masing-masing dari empat jenis partikel subatom. Kami secara eksplisit
menetapkan interpolateNulls ke false untuk memastikan bahwa
nilai null (diperlukan karena deret tidak sama panjangnya)
tidak dipetakan. Kita juga menetapkan legend.maxLines untuk menambahkan baris lain ke legenda:
var data = google.visualization.arrayToDataTable([
['Quarks', 'Leptons', 'Gauge Bosons', 'Scalar Bosons'],
[2/3, -1, 0, 0],
[2/3, -1, 0, null],
[2/3, -1, 0, null],
[-1/3, 0, 1, null],
[-1/3, 0, -1, null],
[-1/3, 0, null, null],
[-1/3, 0, null, null]
]);
var options = {
title: 'Charges of subatomic particles',
legend: { position: 'top', maxLines: 2 },
colors: ['#5C3292', '#1A8763', '#871B47', '#999999'],
interpolateNulls: false,
};
Memuat
Nama paket google.charts.load
adalah "corechart".
google.charts.load("current", {packages: ["corechart"]});
Nama class visualisasi adalah google.visualization.Histogram:
var visualization = new google.visualization.Histogram(container);
Format Data
Ada dua cara untuk mengisi tabel data histogram. Jika hanya ada satu rangkaian:
var data = google.visualization.arrayToDataTable([
['Name', 'Number'],
['Name 1', number1],
['Name 2', number2],
['Name 3', number3],
...
]);
...dan jika ada beberapa rangkaian:
var data = google.visualization.arrayToDataTable([
['Series Name 1', 'Series Name 2', 'Series Name 3', ...],
[series1_number1, series2_number1, series3_number1, ...],
[series1_number2, series2_number2, series3_number2, ...],
[series1_number3, series2_number3, series3_number3, ...],
...
]);
Tidak ada peran kolom opsional yang didukung untuk histogram saat ini.
Opsi Konfigurasi
| Name | |
|---|---|
| animation.duration |
Durasi animasi, dalam milidetik. Untuk detailnya, lihat dokumentasi animasi. Jenis: nomor
Default: 0
|
| animation.easing |
Fungsi easing yang diterapkan pada animasi. Tersedia opsi-opsi berikut:
Jenis: string
Default: 'linear'
|
| animation.startup |
Menentukan apakah diagram akan dianimasikan pada penggambaran awal. Jika Jenis: boolean
Default false
|
| axisTitlesPosition |
Lokasi untuk menempatkan judul sumbu, dibandingkan dengan area diagram. Nilai yang didukung:
Jenis: string
Default: 'out'
|
| backgroundColor |
Warna latar belakang untuk area utama diagram. Dapat berupa string warna HTML sederhana, misalnya: Jenis: string atau objek
Default: 'putih'
|
| backgroundColor.stroke |
Warna batas diagram, sebagai string warna HTML. Jenis: string
Default: '#666'
|
| backgroundColor.strokeWidth |
Lebar pembatas, dalam piksel. Jenis: nomor
Default: 0
|
| backgroundColor.fill |
Warna pengisi diagram, sebagai string warna HTML. Jenis: string
Default: 'putih'
|
| bar.groupWidth |
Lebar sekelompok batang, yang ditentukan dalam salah satu format berikut:
Jenis: angka atau string
Default: Rasio emas, sekitar '61,8%'.
|
| chartArea |
Objek dengan anggota untuk mengonfigurasi penempatan dan ukuran area diagram (tempat diagram itu sendiri digambar, tidak termasuk sumbu dan legenda). Dua format didukung: angka, atau
angka yang diikuti dengan %. Angka sederhana adalah nilai dalam piksel; angka yang diikuti dengan % adalah
persentase. Contoh: Jenis: objek
Default: null
|
| chartArea.backgroundColor |
Warna latar belakang area diagram. Jika digunakan, string dapat berupa string heksadesimal (misalnya, '#fdc') atau nama warna bahasa Inggris. Saat sebuah objek digunakan, properti berikut dapat
diberikan:
Jenis: string atau objek
Default: 'putih'
|
| chartArea.left |
Seberapa jauh menggambar diagram dari batas kiri. Jenis: angka atau string
Default: otomatis
|
| chartArea.top |
Seberapa jauh menggambar diagram dari batas atas. Jenis: angka atau string
Default: otomatis
|
| chartArea.width |
Lebar area diagram. Jenis: angka atau string
Default: otomatis
|
| chartArea.height |
Tinggi area diagram. Jenis: angka atau string
Default: otomatis
|
| warna |
Warna yang akan digunakan untuk elemen diagram. Array string, dengan setiap elemennya adalah string warna HTML, misalnya: Jenis: Array string
Default: warna default
|
| dataOpacity |
Transparansi titik data, dengan 1,0 adalah benar-benar buram dan 0,0 sepenuhnya transparan. Dalam diagram sebar, histogram, batang, dan kolom, ini mengacu pada data yang terlihat: titik di diagram sebar dan persegi panjang di diagram lain. Dalam diagram dengan pemilihan data yang membuat titik, seperti diagram garis dan area, hal ini mengacu pada lingkaran yang muncul saat mengarahkan kursor atau memilih. Diagram kombinasi menunjukkan kedua perilaku tersebut, dan opsi ini tidak berpengaruh pada diagram lainnya. (Untuk mengubah opasitas garis tren, lihat opasitas garis tren .) Jenis: nomor
Default: 1,0
|
| enableInteractivity |
Apakah diagram menampilkan peristiwa berbasis pengguna atau bereaksi terhadap interaksi pengguna. Jika salah, diagram tidak akan menampilkan peristiwa 'select' atau peristiwa berbasis interaksi lainnya (tetapi akan menampilkan peristiwa siap atau error), dan tidak akan menampilkan teks informasi atau berubah, bergantung pada input pengguna. Jenis: boolean
Default: benar (true)
|
| focusTarget |
Jenis entitas yang menerima fokus pada pengarahan kursor mouse. Juga memengaruhi entity yang dipilih oleh klik mouse, dan elemen tabel data yang dikaitkan dengan peristiwa. Dapat berupa salah satu dari hal berikut:
Di focusTarget 'category', tooltip menampilkan semua nilai kategori. Cara ini mungkin berguna untuk membandingkan nilai berbagai deret. Jenis: string
Default: 'datum'
|
| fontSize |
Ukuran font default, dalam piksel, untuk semua teks dalam diagram. Anda dapat menggantinya menggunakan properti untuk elemen diagram tertentu. Jenis: nomor
Default: otomatis
|
| fontName |
Tampilan font default untuk semua teks dalam diagram. Anda dapat menggantinya menggunakan properti untuk elemen diagram tertentu. Jenis: string
Default: 'XXXXXXXX'
|
| forceIFrame |
Menggambar diagram di dalam bingkai inline. (Perhatikan bahwa pada IE8, opsi ini diabaikan; semua diagram IE8 digambar dalam i-frame.) Jenis: boolean
Default: false
|
| hAxis |
Objek dengan anggota untuk mengonfigurasi berbagai elemen sumbu horizontal. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditunjukkan di sini:
{
title: 'Hello',
titleTextStyle: {
color: '#FF0000'
}
}
Jenis: objek
Default: null
|
| hAxis.gridlines |
Objek dengan properti untuk mengonfigurasi garis petak pada sumbu horizontal. Perhatikan bahwa garis petak sumbu horizontal digambar secara vertikal. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditunjukkan di sini: {color: '#333', minSpacing: 20}
Jenis: objek
Default: null
|
| hAxis.gridlines.color |
Warna garis petak horizontal di dalam area diagram. Tentukan string warna HTML yang valid. Jenis: string
Default: '#CCC'
|
| hAxis.gridlines.count |
Perkiraan jumlah garis petak horizontal di dalam area diagram.
Jika Anda menentukan angka positif untuk Jenis: nomor
Default: -1
|
| hAxis.gridlines.interval |
Array ukuran (sebagai nilai data, bukan piksel) di antara garis petak yang berdekatan. Saat ini, opsi ini hanya untuk sumbu numerik,
tetapi setara dengan
opsi Jenis: angka antara 1 dan 10, tidak termasuk 10.
Default: dihitung
|
| hAxis.gridlines.minSpacing |
Ruang layar minimum, dalam piksel, di antara garis petak utama hAxis.
Default untuk garis petak utama adalah Jenis: nomor
Default: dihitung
|
| hAxis.gridlines.multiple |
Semua nilai gridline dan tick harus berupa kelipatan dari nilai
opsi ini. Perlu diketahui bahwa, berbeda dengan interval, pangkat 10 kali lipat tidak dipertimbangkan.
Jadi, Anda dapat memaksa tick menjadi bilangan bulat dengan menentukan Jenis: nomor
Default: 1
|
| hAxis.gridlines.units |
Mengganti format default untuk berbagai aspek jenis data tanggal/tanggal/waktu saat digunakan dengan garis petak yang dihitung diagram. Memungkinkan pemformatan untuk tahun, bulan, hari, jam, menit, detik, dan milidetik. Format umumnya adalah:
gridlines: {
units: {
years: {format: [/*format strings here*/]},
months: {format: [/*format strings here*/]},
days: {format: [/*format strings here*/]}
hours: {format: [/*format strings here*/]}
minutes: {format: [/*format strings here*/]}
seconds: {format: [/*format strings here*/]},
milliseconds: {format: [/*format strings here*/]},
}
}
Informasi tambahan dapat ditemukan di Tanggal dan Waktu. Jenis: objek
Default: null
|
| hAxis.minorGridlines |
Objek dengan anggota untuk mengonfigurasi garis petak minor pada sumbu horizontal, mirip dengan opsi hAxis.gridlines. Jenis: objek
Default: null
|
| hAxis.minorGridlines.color |
Warna garis petak minor horizontal di dalam area diagram. Tentukan string warna HTML yang valid. Jenis: string
Default: Kombinasi warna garis petak dan latar belakang
|
| hAxis.minorGridlines.count |
Opsi Jenis: nomor
Default:1
|
| hAxis.minorGridlines.interval |
Opsi minorGridlines.interval mirip dengan opsi interval
garis petak utama, tetapi interval yang dipilih akan selalu
menjadi pembagi genap dari interval garis petak utama.
Interval default untuk skala linear adalah
Jenis: nomor
Default:1
|
| hAxis.minorGridlines.minSpacing |
Ruang minimum yang diperlukan, dalam piksel, di antara garis petak minor yang berdekatan, dan antara garis petak kecil dan utama. Nilai defaultnya adalah 1/2 minSpacing dari garis petak utama untuk skala linear, dan 1/5 minSpacing untuk skala log. Jenis: nomor
Default:terhitung
|
| hAxis.minorGridlines.multiple |
Sama seperti utama Jenis: nomor
Default: 1
|
| hAxis.minorGridlines.units |
Mengganti format default untuk berbagai aspek jenis data tanggal/tanggal/waktu/waktu jika digunakan dengan garis minorGrid yang dihitung pada diagram. Memungkinkan pemformatan untuk tahun, bulan, hari, jam, menit, detik, dan milidetik. Format umumnya adalah:
gridlines: {
units: {
years: {format: [/*format strings here*/]},
months: {format: [/*format strings here*/]},
days: {format: [/*format strings here*/]}
hours: {format: [/*format strings here*/]}
minutes: {format: [/*format strings here*/]}
seconds: {format: [/*format strings here*/]},
milliseconds: {format: [/*format strings here*/]},
}
}
Informasi tambahan dapat ditemukan di Tanggal dan Waktu. Jenis: objek
Default: null
|
| hAxis.textPosition |
Posisi teks sumbu horizontal, relatif terhadap area diagram. Nilai yang didukung: 'out', 'in', 'none'. Jenis: string
Default: 'out'
|
| hAxis.textStyle |
Objek yang menetapkan gaya teks sumbu horizontal. Objek memiliki format ini:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Jenis: objek
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| hAxis.title |
Properti Jenis: string
Default: null
|
| hAxis.titleTextStyle |
Objek yang menetapkan gaya teks judul sumbu horizontal. Objek memiliki format ini:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Jenis: objek
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| hAxis.allowContainerBoundaryTextCutoff |
Jika salah (false), label terluar akan disembunyikan, bukan sehingga dapat dipangkas oleh penampung diagram. Jika true (benar), pemangkasan label akan diizinkan. Jenis: boolean
Default: false
|
| hAxis.slantedText |
Jika true (benar), gambar teks sumbu horizontal pada sudut tertentu, untuk membantu menyesuaikan lebih banyak teks di sepanjang sumbu; jika
salah, gambar teks sumbu horizontal secara tegak. Perilaku defaultnya adalah teks miring jika tidak semuanya muat saat digambar tegak. Perhatikan bahwa opsi ini hanya tersedia jika Jenis: boolean
Default: otomatis
|
| hAxis.slantedTextAngle |
Sudut teks sumbu horizontal, jika digambar miring. Diabaikan jika Jenis: angka, -90—90
Default: 30
|
| hAxis.maxAlternation |
Jumlah maksimum tingkat teks sumbu horizontal. Jika label teks sumbu terlalu padat, server mungkin akan memindahkan label yang berdekatan ke atas atau ke bawah agar label berdekatan. Nilai ini menentukan jumlah tingkat paling banyak yang akan digunakan; server dapat menggunakan lebih sedikit tingkat, jika label dapat dimuat tanpa tumpang-tindih. Untuk tanggal dan waktu, defaultnya adalah 1. Jenis: nomor
Default: 2
|
| hAxis.maxTextLines |
Jumlah baris maksimum yang diizinkan untuk label teks. Label dapat mencakup beberapa baris jika terlalu panjang, dan jumlah baris secara default dibatasi oleh tinggi ruang yang tersedia. Jenis: nomor
Default: otomatis
|
| hAxis.minTextSpacing |
Spasi horizontal minimum, dalam piksel, diizinkan di antara dua label teks yang berdekatan. Jika jarak label terlalu padat atau terlalu panjang, jaraknya bisa turun di bawah batas ini, dan dalam hal ini salah satu ukuran label yang tidak rapi akan diterapkan (misalnya, memotong label atau membuang sebagian). Jenis: nomor
Default: Nilai
hAxis.textStyle.fontSize |
| hAxis.showTextEvery |
Jumlah label sumbu horizontal yang akan ditampilkan, dengan 1 berarti menampilkan setiap label, 2 berarti menampilkan setiap label lainnya, dan seterusnya. Defaultnya adalah mencoba menampilkan label sebanyak mungkin tanpa tumpang-tindih. Jenis: nomor
Default: otomatis
|
| hAxis.viewWindowMode |
Menentukan cara menskalakan sumbu horizontal untuk merender nilai dalam area diagram. Nilai string berikut ini didukung:
Jenis: string
Default: Setara dengan 'pretty', tetapi
haxis.viewWindow.min dan haxis.viewWindow.max lebih diutamakan jika digunakan.
|
| hAxis.viewWindow |
Menentukan rentang pemangkasan sumbu horizontal. Jenis: objek
Default: null
|
| hAxis.viewWindow.max |
Indeks baris berbasis nol tempat periode pemangkasan berakhir. Titik data pada indeks ini dan yang lebih tinggi akan dipangkas. Sehubungan dengan Diabaikan jika Jenis: nomor
Default: otomatis
|
| hAxis.viewWindow.min |
Indeks baris berbasis nol tempat periode pemangkasan dimulai. Titik data pada indeks yang lebih rendah dari ini akan dipangkas. Sehubungan dengan Diabaikan jika Jenis: nomor
Default: otomatis
|
| histogram.bucketSize |
Lakukan hardcode ukuran setiap batang histogram, bukan membiarkannya ditentukan secara algoritma. Jenis: nomor
Default: otomatis
|
| histogram.hideBucketItems |
Hilangkan pembagian tipis antara blok histogram, menjadikannya serangkaian batang solid. Jenis: boolean
Default: false
|
| histogram.lastBucketPercentile |
Saat menghitung ukuran bucket histogram, abaikan
Jenis: nomor
Default: 0
|
| histogram.minValue |
Perluas rentang bucket untuk menyertakan nilai ini. Jenis: nomor
Default: otomatis - gunakan min data
|
| histogram.maxValue |
Perluas rentang bucket untuk menyertakan nilai ini. Jenis: nomor
Default: otomatis - gunakan maksimum data
|
| histogram.numBucketsRule |
Cara menghitung jumlah bucket default. Nilai yang dimungkinkan adalah:
Jenis: string
Default:
'sqrt' |
| tinggi |
Tinggi diagram, dalam piksel. Jenis: nomor
Default: tinggi elemen yang memuatnya
|
| interpolateNulls |
Apakah untuk menebak nilai poin yang hilang. Jika true (benar), metode ini akan menebak nilai data yang hilang berdasarkan titik di dekatnya. Jika salah, nilai ini akan meninggalkan jeda di garis pada titik yang tidak diketahui.
Hal ini tidak didukung oleh diagram Area dengan opsi Jenis: boolean
Default: false
|
| isStacked |
Jika disetel ke benar (true), elemen untuk semua deret akan ditumpuk di setiap nilai domain. Catatan: Di diagram Kolom, Area, dan SteppedArea, Google Chart membalik urutan item legenda agar lebih sesuai dengan tumpukan elemen deret (Misalnya, deret 0 akan menjadi item legenda paling bawah). Hal ini tidak berlaku untuk Diagram Batang.
Opsi Opsi untuk
Untuk penumpukan 100%, nilai yang dihitung untuk setiap elemen akan muncul di tooltip setelah nilai sebenarnya.
Sumbu target akan ditetapkan secara default ke nilai tick berdasarkan skala 0-1 relatif sebagai pecahan
1 untuk
100% stack hanya mendukung nilai data jenis Jenis: boolean/string
Default: false
|
| legenda |
Objek dengan anggota untuk mengonfigurasi berbagai aspek legenda. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditunjukkan di sini: {position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Jenis: objek
Default: null
|
| legend.alignment |
Perataan legenda. Dapat berupa salah satu dari hal berikut:
Awal, tengah, dan akhir berhubungan dengan gaya -- vertikal atau horizontal -- legenda. Misalnya, pada legenda 'kanan', 'start' dan 'end' masing-masing berada di bagian atas dan bawah; untuk legenda 'top', 'start' dan 'end' akan berada di sebelah kiri dan kanan area tersebut. Nilai default-nya bergantung pada posisi legenda. Untuk legenda 'bawah', defaultnya adalah 'center'; legenda lainnya ditetapkan secara default ke 'start'. Jenis: string
Default: otomatis
|
| legend.maxLines |
Jumlah baris maksimum dalam legenda. Tetapkan string ini ke angka yang lebih besar dari satu untuk menambahkan garis ke legenda. Catatan: Logika sebenarnya yang digunakan untuk menentukan jumlah baris sebenarnya yang dirender masih dalam fluks. Opsi ini saat ini hanya berfungsi jika legend.position adalah 'top'. Jenis: nomor
Default: 1
|
| legend.pageIndex |
Indeks halaman legenda awal yang dipilih berdasarkan nol. Jenis: nomor
Default: 0
|
| legend.position |
Posisi legenda. Dapat berupa salah satu dari hal berikut:
Jenis: string
Default: 'right'
|
| legend.textStyle |
Objek yang menetapkan gaya teks legenda. Objek memiliki format ini:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Jenis: objek
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| orientasi |
Orientasi diagram. Jika ditetapkan ke Jenis: string
Default: 'horizontal'
|
| reverseCategories |
Jika disetel ke true, akan menggambar deret dari kanan ke kiri. Defaultnya adalah menggambar dari kiri ke kanan. Jenis: boolean
Default: false
|
| series |
Array objek, masing-masing menjelaskan format deret yang sesuai dalam diagram. Untuk menggunakan nilai default rangkaian, tetapkan objek kosong {}. Jika rangkaian atau nilai tidak ditetapkan, nilai global yang akan digunakan. Setiap objek mendukung properti berikut:
Anda dapat menentukan array objek, yang masing-masing berlaku untuk deret dalam urutan yang ditentukan, atau Anda dapat menentukan objek yang setiap turunan memiliki kunci numerik yang menunjukkan ke deret mana hal tersebut diterapkan. Misalnya, dua deklarasi berikut identik, dan deklarasikan deret pertama sebagai hitam dan tidak ada di legenda, sedangkan yang keempat sebagai merah dan tidak ada di legenda:
series: [
{color: 'black', visibleInLegend: false}, {}, {},
{color: 'red', visibleInLegend: false}
]
series: {
0:{color: 'black', visibleInLegend: false},
3:{color: 'red', visibleInLegend: false}
}
Jenis: Array objek atau objek dengan objek bertingkat
Default: {}
|
| tema |
Tema adalah sekumpulan nilai opsi yang telah ditentukan yang bekerja sama untuk mencapai perilaku diagram atau efek visual tertentu. Saat ini hanya satu tema yang tersedia:
Jenis: string
Default: null
|
| title |
Teks yang akan ditampilkan di atas diagram. Jenis: string
Default: tanpa judul
|
| titlePosition |
Lokasi untuk menempatkan judul bagan, dibandingkan dengan area bagan. Nilai yang didukung:
Jenis: string
Default: 'out'
|
| titleTextStyle |
Objek yang menetapkan gaya teks judul. Objek memiliki format ini:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Jenis: objek
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| tooltip |
Objek dengan anggota untuk mengonfigurasi berbagai elemen tooltip. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditampilkan di sini: {textStyle: {color: '#FF0000'}, showColorCode: true}
Jenis: objek
Default: null
|
| tooltip.isHtml |
Jika disetel ke benar (true), gunakan tooltip yang dirender dengan HTML (bukan yang dirender SVG. Lihat Menyesuaikan Konten Tooltip untuk mengetahui detail selengkapnya. Catatan: penyesuaian konten tooltip HTML melalui peran data kolom tooltip tidak didukung oleh visualisasi Bubble Chart. Jenis: boolean
Default: false
|
| tooltip.showColorCode |
Jika benar, tampilkan kotak berwarna di samping informasi serial dalam tooltip. Nilai defaultnya adalah benar (true) jika Jenis: boolean
Default: otomatis
|
| tooltip.textStyle |
Objek yang menentukan gaya teks tooltip. Objek memiliki format ini:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Jenis: objek
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| tooltip.trigger |
Interaksi pengguna yang menyebabkan tooltip ditampilkan:
Jenis: string
Default: 'fokus'
|
| vAxes |
Menentukan properti untuk masing-masing sumbu vertikal, jika diagram memiliki beberapa sumbu vertikal.
Setiap objek turunan adalah objek
Untuk menentukan diagram dengan beberapa sumbu vertikal, pertama-tama tentukan sumbu baru menggunakan
{
series: {
2: {
targetAxisIndex:1
}
},
vAxes: {
1: {
title:'Losses',
textStyle: {color: 'red'}
}
}
}
Properti ini dapat berupa objek atau array: objek adalah kumpulan objek,
masing-masing dengan label numerik yang menentukan sumbu yang ditentukan--ini adalah format yang ditampilkan
di atas; array adalah array objek, satu per sumbu. Misalnya, notasi gaya array berikut identik dengan objek
vAxes: [
{}, // Nothing specified for axis 0
{
title:'Losses',
textStyle: {color: 'red'} // Axis 1
}
]
Jenis: Array objek atau objek dengan objek turunan
Default: null
|
| vAxis |
Objek dengan anggota untuk mengonfigurasi berbagai elemen sumbu vertikal. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditunjukkan di sini: {title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Jenis: objek
Default: null
|
| vAxis.baseline |
Properti Jenis: nomor
Default: otomatis
|
| vAxis.baselineColor |
Menentukan warna dasar pengukuran untuk sumbu vertikal. Dapat berupa string warna HTML apa pun, misalnya: Jenis: nomor
Default: 'hitam'
|
| vAxis.direction |
Arah perkembangan nilai di sepanjang sumbu vertikal. Secara default, nilai yang rendah berada di bagian bawah diagram. Tentukan Jenis: 1 atau -1
Default: 1
|
| vAxis.format |
String format untuk label sumbu numerik. Ini adalah subset dari
kumpulan pola ICU
.
Misalnya,
Format sebenarnya yang diterapkan pada label berasal dari lokalitas yang memuat API. Untuk mengetahui detail selengkapnya, lihat memuat diagram dengan lokalitas tertentu .
Dalam menghitung nilai tick dan garis petak, beberapa kombinasi alternatif dari semua opsi garis petak yang relevan akan dipertimbangkan, dan alternatifnya akan ditolak jika label titik skala yang diformat akan diduplikasi atau tumpang tindih.
Jadi, Anda dapat menentukan Jenis: string
Default: otomatis
|
| vAxis.gridlines |
Objek dengan anggota untuk mengonfigurasi garis petak pada sumbu vertikal. Perhatikan bahwa garis petak sumbu vertikal digambar secara horizontal. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditunjukkan di sini: {color: '#333', minSpacing: 20}
Jenis: objek
Default: null
|
| vAxis.gridlines.color |
Warna garis petak vertikal di dalam area diagram. Tentukan string warna HTML yang valid. Jenis: string
Default: '#CCC'
|
| vAxis.gridlines.count |
Perkiraan jumlah garis petak horizontal di dalam area diagram.
Jika Anda menentukan angka positif untuk Jenis: nomor
Default: -1
|
| vAxis.gridlines.interval |
Array ukuran (sebagai nilai data, bukan piksel) di antara garis petak yang berdekatan. Saat ini, opsi ini hanya untuk sumbu numerik,
tetapi setara dengan
opsi Jenis: angka antara 1 dan 10, tidak termasuk 10.
Default: dihitung
|
| vAxis.gridlines.minSpacing |
Ruang layar minimum, dalam piksel, di antara garis petak utama hAxis.
Default untuk garis petak utama adalah Jenis: nomor
Default: dihitung
|
| vAxis.gridlines.multiple |
Semua nilai gridline dan tick harus berupa kelipatan dari nilai
opsi ini. Perlu diketahui bahwa, berbeda dengan interval, pangkat 10 kali lipat tidak dipertimbangkan.
Jadi, Anda dapat memaksa tick menjadi bilangan bulat dengan menentukan Jenis: nomor
Default: 1
|
| vAxis.gridlines.units |
Mengganti format default untuk berbagai aspek jenis data tanggal/tanggal/waktu saat digunakan dengan garis petak yang dihitung diagram. Memungkinkan pemformatan untuk tahun, bulan, hari, jam, menit, detik, dan milidetik. Format umumnya adalah:
gridlines: {
units: {
years: {format: [/*format strings here*/]},
months: {format: [/*format strings here*/]},
days: {format: [/*format strings here*/]},
hours: {format: [/*format strings here*/]},
minutes: {format: [/*format strings here*/]},
seconds: {format: [/*format strings here*/]},
milliseconds: {format: [/*format strings here*/]}
}
}
Informasi tambahan dapat ditemukan di Tanggal dan Waktu. Jenis: objek
Default: null
|
| vAxis.minorGridlines |
Objek dengan anggota untuk mengonfigurasi garis petak minor pada sumbu vertikal, mirip dengan opsi vAxis.gridlines. Jenis: objek
Default: null
|
| vAxis.minorGridlines.color |
Warna garis petak minor vertikal di dalam area diagram. Tentukan string warna HTML yang valid. Jenis: string
Default: Kombinasi warna garis petak dan latar belakang
|
| vAxis.minorGridlines.count |
Opsi minorGridlines.count sebagian besar tidak digunakan lagi, kecuali untuk menonaktifkan garis petak minor dengan menetapkan hitungan ke 0. Jumlah garis petak minor bergantung pada interval antara garis petak utama (lihat vAxis.gridlines.interval) dan ruang minimum yang diperlukan (lihat vAxis.minorGridlines.minSpacing). Jenis: nomor
Default: 1
|
| vAxis.minorGridlines.interval |
Opsi minorGridlines.interval mirip dengan opsi interval
garis petak utama, tetapi interval yang dipilih akan selalu
menjadi pembagi genap dari interval garis petak utama.
Interval default untuk skala linear adalah
Jenis: nomor
Default:1
|
| vAxis.minorGridlines.minSpacing |
Ruang minimum yang diperlukan, dalam piksel, di antara garis petak minor yang berdekatan, dan antara garis petak kecil dan utama. Nilai defaultnya adalah 1/2 minSpacing dari garis petak utama untuk skala linear, dan 1/5 minSpacing untuk skala log. Jenis: nomor
Default:terhitung
|
| vAxis.minorGridlines.multiple |
Sama seperti utama Jenis: nomor
Default: 1
|
| vAxis.minorGridlines.units |
Mengganti format default untuk berbagai aspek jenis data tanggal/tanggal/waktu/waktu jika digunakan dengan garis minorGrid yang dihitung pada diagram. Memungkinkan pemformatan untuk tahun, bulan, hari, jam, menit, detik, dan milidetik. Format umumnya adalah:
gridlines: {
units: {
years: {format: [/*format strings here*/]},
months: {format: [/*format strings here*/]},
days: {format: [/*format strings here*/]}
hours: {format: [/*format strings here*/]}
minutes: {format: [/*format strings here*/]}
seconds: {format: [/*format strings here*/]},
milliseconds: {format: [/*format strings here*/]},
}
}
Informasi tambahan dapat ditemukan di Tanggal dan Waktu. Jenis: objek
Default: null
|
| vAxis.logScale |
Jika true (benar), menjadikan sumbu vertikal sebagai skala logaritmik. Catatan: Semua nilai harus positif. Jenis: boolean
Default: false
|
| vAxis.scaleType |
Properti
Jenis: string
Default: null
|
| vAxis.textPosition |
Posisi teks sumbu vertikal, relatif terhadap area diagram. Nilai yang didukung: 'out', 'in', 'none'. Jenis: string
Default: 'out'
|
| vAxis.textStyle |
Objek yang menetapkan gaya teks sumbu vertikal. Objek memiliki format ini:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Jenis: objek
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| vAxis.ticks |
Mengganti tanda petik sumbu Y yang dihasilkan secara otomatis dengan array yang ditentukan. Setiap elemen array harus berupa nilai tick yang valid (seperti angka, tanggal, datetime, atau waktu), atau sebuah objek. Jika berupa objek, objek tersebut harus memiliki properti
ViewWindow akan otomatis diperluas untuk
menyertakan tick min dan maks kecuali jika Anda menentukan
Contoh:
Jenis: Array elemen
Default: otomatis
|
| vAxis.title |
Properti Jenis: string
Default: tanpa judul
|
| vAxis.titleTextStyle |
Objek yang menentukan gaya teks judul sumbu vertikal. Objek memiliki format ini:
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
Jenis: objek
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| vAxis.maxValue |
Memindahkan nilai maksimum sumbu vertikal ke nilai yang ditentukan; ini akan ke atas pada sebagian besar diagram. Diabaikan jika ditetapkan ke nilai yang lebih kecil dari nilai y maksimum data.
Jenis: nomor
Default: otomatis
|
| vAxis.minValue |
Memindahkan nilai min sumbu vertikal ke nilai yang ditentukan; ini akan ke bawah di sebagian besar diagram. Diabaikan jika ditetapkan ke nilai yang lebih besar dari nilai y minimum data.
Jenis: nomor
Default: null
|
| vAxis.viewWindowMode |
Menentukan cara menskalakan sumbu vertikal untuk merender nilai dalam area diagram. Nilai string berikut ini didukung:
Jenis: string
Default: Setara dengan 'pretty', tetapi
vaxis.viewWindow.min dan vaxis.viewWindow.max lebih diutamakan jika digunakan.
|
| vAxis.viewWindow |
Menentukan rentang pemangkasan sumbu vertikal. Jenis: objek
Default: null
|
| vAxis.viewWindow.max |
Nilai data vertikal maksimum yang akan dirender. Diabaikan jika Jenis: nomor
Default: otomatis
|
| vAxis.viewWindow.min |
Nilai data vertikal minimum yang akan dirender. Diabaikan jika Jenis: nomor
Default: otomatis
|
| lebar |
Lebar diagram, dalam piksel. Jenis: nomor
Default: lebar elemen yang memuatnya
|
Metode
| Metode | |
|---|---|
draw(data, options) |
Menggambar diagram. Diagram menerima panggilan metode lebih lanjut hanya setelah peristiwa Jenis Pengembalian: tidak ada
|
getAction(actionID) |
Menampilkan objek tindakan tooltip dengan Jenis Pengembalian: objek
|
getBoundingBox(id) |
Menampilkan objek yang berisi bagian kiri, atas, lebar, dan tinggi elemen diagram
Nilai bersifat relatif terhadap penampung diagram. Panggil ini setelah diagram digambar. Jenis Pengembalian: objek
|
getChartAreaBoundingBox() |
Menampilkan objek yang berisi bagian kiri, atas, lebar, dan tinggi konten diagram (yaitu, tidak termasuk label dan legenda):
Nilai bersifat relatif terhadap penampung diagram. Panggil ini setelah diagram digambar. Jenis Pengembalian: objek
|
getChartLayoutInterface() |
Menampilkan objek yang berisi informasi tentang penempatan diagram dan elemennya di layar. Metode berikut dapat dipanggil pada objek yang ditampilkan:
Panggil ini setelah diagram digambar. Jenis Pengembalian: objek
|
getHAxisValue(xPosition, optional_axis_index) |
Menampilkan nilai data horizontal pada Contoh: Panggil ini setelah diagram digambar. Jenis Pengembalian: nomor
|
getImageURI() |
Menampilkan diagram yang diserialisasi sebagai URI gambar. Panggil ini setelah diagram digambar. Lihat Mencetak Diagram PNG. Jenis Pengembalian: string
|
getSelection() |
Menampilkan array entitas diagram yang dipilih.
Entitas yang dapat dipilih adalah batang, entri legenda, dan kategori.
Untuk diagram ini, hanya satu entitas yang dapat dipilih pada waktu tertentu.
Jenis Pengembalian: Array elemen pilihan
|
getVAxisValue(yPosition, optional_axis_index) |
Menampilkan nilai data vertikal pada Contoh: Panggil ini setelah diagram digambar. Jenis Pengembalian: nomor
|
getXLocation(dataValue, optional_axis_index) |
Menampilkan koordinat x piksel dari Contoh: Panggil ini setelah diagram digambar. Jenis Pengembalian: nomor
|
getYLocation(dataValue, optional_axis_index) |
Menampilkan koordinat y piksel dari Contoh: Panggil ini setelah diagram digambar. Jenis Pengembalian: nomor
|
removeAction(actionID) |
Menghapus tindakan tooltip dengan Jenis Pengembalian:
none |
setAction(action) |
Menetapkan tindakan tooltip yang akan dijalankan saat pengguna mengklik teks tindakan.
Metode
Setiap dan semua tindakan tooltip harus ditetapkan sebelum memanggil metode Jenis Pengembalian:
none |
setSelection() |
Memilih entitas diagram yang ditentukan. Membatalkan pilihan sebelumnya.
Entitas yang dapat dipilih adalah batang, entri legenda, dan kategori.
Untuk diagram ini, hanya satu entitas yang dapat dipilih pada satu waktu.
Jenis Pengembalian: tidak ada
|
clearChart() |
Mengosongkan diagram, dan melepaskan semua resource yang dialokasikan. Jenis Pengembalian: tidak ada
|
Acara
Untuk informasi selengkapnya tentang cara menggunakan peristiwa ini, lihat Interaktivitas Dasar, Menangani Peristiwa, dan Mengaktifkan Peristiwa.
| Name | |
|---|---|
animationfinish |
Diaktifkan saat animasi transisi selesai. Properti: tidak ada
|
click |
Diaktifkan saat pengguna mengklik di dalam diagram. Dapat digunakan untuk mengidentifikasi kapan judul, elemen data, entri legenda, sumbu, garis petak, atau label diklik. Properti: targetID
|
error |
Diaktifkan saat terjadi error saat mencoba merender diagram. Properties: id, pesan
|
legendpagination |
Diaktifkan saat pengguna mengklik panah penomoran halaman legenda. Meneruskan kembali indeks halaman berbasis nol pada legenda saat ini dan jumlah total halaman. Properti: currentPageIndex, totalPages
|
onmouseover |
Diaktifkan saat pengguna mengarahkan mouse ke entitas visual. Meneruskan kembali indeks baris dan kolom dari elemen tabel data yang sesuai. Sebuah batang berkorelasi dengan sel dalam tabel data, entri legenda ke kolom (indeks baris {i>null<i}), dan kategori ke baris (indeks kolom adalah {i>null<i}). Properti: baris, kolom
|
onmouseout |
Diaktifkan saat pengguna menjauhi entity visual. Meneruskan kembali indeks baris dan kolom dari elemen tabel data yang sesuai. Sebuah batang berkorelasi dengan sel dalam tabel data, entri legenda ke kolom (indeks baris {i>null<i}), dan kategori ke baris (indeks kolom adalah {i>null<i}). Properti: baris, kolom
|
ready |
Diagram siap untuk panggilan metode eksternal. Jika ingin berinteraksi dengan diagram, dan memanggil metode setelah menggambarnya, Anda harus menyiapkan pemroses untuk peristiwa ini sebelum memanggil metode Properti: tidak ada
|
select |
Diaktifkan saat pengguna mengklik entitas visual. Untuk mempelajari apa yang telah dipilih, panggil
Properti: tidak ada
|
Kebijakan Data
Semua kode dan data diproses dan dirender di browser. Tidak ada data yang dikirim ke server mana pun.