Ringkasan
Diagram balon yang dirender dalam browser menggunakan SVG atau VML. Menampilkan tips saat mengarahkan kursor ke balon.
Diagram balon digunakan untuk memvisualisasikan set data dengan dua hingga empat dimensi. Dua dimensi pertama divisualisasikan sebagai koordinat, yang ketiga sebagai warna dan yang keempat sebagai ukuran.
Contoh
<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(drawSeriesChart); function drawSeriesChart() { var data = google.visualization.arrayToDataTable([ ['ID', 'Life Expectancy', 'Fertility Rate', 'Region', 'Population'], ['CAN', 80.66, 1.67, 'North America', 33739900], ['DEU', 79.84, 1.36, 'Europe', 81902307], ['DNK', 78.6, 1.84, 'Europe', 5523095], ['EGY', 72.73, 2.78, 'Middle East', 79716203], ['GBR', 80.05, 2, 'Europe', 61801570], ['IRN', 72.49, 1.7, 'Middle East', 73137148], ['IRQ', 68.09, 4.77, 'Middle East', 31090763], ['ISR', 81.55, 2.96, 'Middle East', 7485600], ['RUS', 68.6, 1.54, 'Europe', 141850000], ['USA', 78.09, 2.05, 'North America', 307007000] ]); var options = { title: 'Fertility rate vs life expectancy in selected countries (2010).' + ' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region', hAxis: {title: 'Life Expectancy'}, vAxis: {title: 'Fertility Rate'}, bubble: {textStyle: {fontSize: 11}} }; var chart = new google.visualization.BubbleChart(document.getElementById('series_chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="series_chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
Warna menurut Angka
Anda dapat menggunakan opsi colorAxis
untuk memberi warna pada balon sesuai dengan nilai, seperti yang ditunjukkan pada contoh di bawah.
<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([ ['ID', 'X', 'Y', 'Temperature'], ['', 80, 167, 120], ['', 79, 136, 130], ['', 78, 184, 50], ['', 72, 278, 230], ['', 81, 200, 210], ['', 72, 170, 100], ['', 68, 477, 80] ]); var options = { colorAxis: {colors: ['yellow', 'red']} }; var chart = new google.visualization.BubbleChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
Menyesuaikan Label
Anda dapat mengontrol jenis huruf, font, dan warna balon dengan
opsi bubble.textStyle
:
var options = { title: 'Fertility rate vs life expectancy in selected countries (2010).' + ' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region', hAxis: {title: 'Life Expectancy'}, vAxis: {title: 'Fertility Rate'}, bubble: { textStyle: { fontSize: 12, fontName: 'Times-Roman', color: 'green', bold: true, italic: true } } };
<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([ ['ID', 'Life Expectancy', 'Fertility Rate', 'Region', 'Population'], ['CAN', 80.66, 1.67, 'North America', 33739900], ['DEU', 79.84, 1.36, 'Europe', 81902307], ['DNK', 78.6, 1.84, 'Europe', 5523095], ['EGY', 72.73, 2.78, 'Middle East', 79716203], ['GBR', 80.05, 2, 'Europe', 61801570], ['IRN', 72.49, 1.7, 'Middle East', 73137148], ['IRQ', 68.09, 4.77, 'Middle East', 31090763], ['ISR', 81.55, 2.96, 'Middle East', 7485600], ['RUS', 68.6, 1.54, 'Europe', 141850000], ['USA', 78.09, 2.05, 'North America', 307007000] ]); var options = { title: 'Fertility rate vs life expectancy in selected countries (2010).' + ' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region', hAxis: {title: 'Life Expectancy'}, vAxis: {title: 'Fertility Rate'}, bubble: { textStyle: { fontSize: 12, fontName: 'Times-Roman', color: 'green', bold: true, italic: true } } }; var chart = new google.visualization.BubbleChart(document.getElementById('textstyle')); chart.draw(data, options); } </script> </head> <body> <div id="textstyle" style="width: 900px; height: 500px;"></div> </body> </html>
Label pada diagram di atas sulit dibaca, dan salah satu alasannya
adalah ruang kosong di sekitarnya. Hal ini disebut aura, dan jika
Anda lebih memilih diagram tanpanya, Anda dapat menetapkan
bubble.textStyle.auraColor
ke 'none'
.
var options = { title: 'Fertility rate vs life expectancy in selected countries (2010).' + ' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region', hAxis: {title: 'Life Expectancy'}, vAxis: {title: 'Fertility Rate'}, bubble: { textStyle: { auraColor: 'none' } } };
<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([ ['ID', 'Life Expectancy', 'Fertility Rate', 'Region', 'Population'], ['CAN', 80.66, 1.67, 'North America', 33739900], ['DEU', 79.84, 1.36, 'Europe', 81902307], ['DNK', 78.6, 1.84, 'Europe', 5523095], ['EGY', 72.73, 2.78, 'Middle East', 79716203], ['GBR', 80.05, 2, 'Europe', 61801570], ['IRN', 72.49, 1.7, 'Middle East', 73137148], ['IRQ', 68.09, 4.77, 'Middle East', 31090763], ['ISR', 81.55, 2.96, 'Middle East', 7485600], ['RUS', 68.6, 1.54, 'Europe', 141850000], ['USA', 78.09, 2.05, 'North America', 307007000] ]); var options = { title: 'Fertility rate vs life expectancy in selected countries (2010).' + ' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region', hAxis: {title: 'Life Expectancy'}, vAxis: {title: 'Fertility Rate'}, bubble: { textStyle: { auraColor: 'none', } } }; var chart = new google.visualization.BubbleChart(document.getElementById('noAura')); chart.draw(data, options); } </script> </head> <body> <div id="noAura" style="width: 900px; height: 500px;"></div> </body> </html>
Memuat
Nama paket google.charts.load
adalah "corechart"
.
google.charts.load("current", {packages: ["corechart"]});
Nama class visualisasinya adalah google.visualization.BubbleChart
.
var visualization = new google.visualization.BubbleChart(container);
Format Data
Baris: Setiap baris dalam tabel mewakili satu balon.
Kolom:
Kolom 0 | Kolom 1 | Kolom 2 | Kolom 3 (opsional) | Kolom 4 (opsional) | |
---|---|---|---|---|---|
Tujuan: | ID (nama) balon | Koordinat X | Koordinat Y | ID seri atau nilai yang mewakili warna pada skala gradien, bergantung pada jenis kolom:
|
Ukuran; nilai dalam kolom ini dipetakan ke nilai piksel sebenarnya menggunakan opsi
sizeAxis . |
Jenis Data: | string | angka | angka | string atau angka | angka |
Opsi Konfigurasi
Name | |
---|---|
animasi.durasi |
Durasi animasi, dalam milidetik. Untuk mengetahui detailnya, lihat dokumentasi animasi. Jenis: angka
Default: 0
|
animasi.easing |
Fungsi easing diterapkan pada animasi. Tersedia opsi-opsi berikut:
Jenis: string
Default: 'linear'
|
animasi.mulai |
Menentukan apakah diagram akan dianimasikan pada gambar awal. Jika Jenis: boolean
Default false
|
axeTitlesPosition |
Tempat untuk menempatkan judul sumbu, dibandingkan dengan area diagram. Nilai yang didukung:
Jenis: string
Default: 'keluar'
|
backgroundColor |
Warna latar belakang untuk area utama diagram. Dapat berupa string warna HTML sederhana, misalnya: Jenis: string atau objek
Default: 'putih'
|
backgroundColor.stroke |
Warna garis batas diagram, sebagai string warna HTML. Jenis: string
Default: '#666'
|
backgroundColor.strokeWidth |
Lebar pembatas, dalam piksel. Jenis: angka
Default: 0
|
backgroundColor.fill |
Warna pengisi diagram, sebagai string warna HTML. Jenis: string
Default: 'putih'
|
gelembung |
Objek dengan anggota untuk mengonfigurasi properti visual balon. Objek Type:
Default: null
|
balon.opasitas |
Opasitas balon, dengan 0 sepenuhnya transparan dan 1 sepenuhnya buram. Jenis: angka antara 0,0 dan 1,0
Default: 0.8
|
balon.goresan |
Warna guratan balon. Jenis: string
Default: '#ccc'
|
balon.teksGaya |
Objek yang menentukan gaya teks balon. Objek memiliki format ini: {color: <string>, fontName: <string>, fontSize: <number>}
Objek Type:
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
diagramArea |
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 diikuti %. Angka sederhana adalah nilai dalam piksel; angka yang diikuti oleh % adalah
persentase. Contoh: Objek Type:
Default: null
|
chartArea.backgroundColor |
Warna latar belakang area diagram. Jika digunakan, string dapat berupa string hex (mis., '#fdc') atau nama warna dalam bahasa Inggris. Ketika sebuah objek digunakan, properti berikut dapat
disediakan:
Jenis: string atau objek
Default: 'putih'
|
chartArea.left |
Seberapa jauh gambar dari batas kiri. Jenis: angka atau string
Default: otomatis
|
baganArea.atas |
Seberapa jauh gambar 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 elemen adalah string warna HTML, misalnya: Jenis: Array string
Default: warna default
|
Sumbu warna |
Objek yang menentukan pemetaan antara nilai kolom warna dan warna atau skala gradien. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditunjukkan di sini: {minValue: 0, colors: ['#FF0000', '#00FF00']} Objek Type:
Default: null
|
colorAxis.minValue |
Jika ada, menentukan nilai minimum untuk data warna diagram. Nilai data warna dari nilai ini dan yang lebih rendah akan dirender sebagai warna pertama dalam rentang Jenis: angka
Default: Nilai minimum kolom warna dalam data diagram
|
colorAxis.maxValue |
Jika ada, menentukan nilai maksimum untuk data warna diagram. Nilai data warna dari nilai ini dan yang lebih tinggi akan dirender sebagai warna terakhir dalam rentang Jenis: angka
Default: Nilai maksimum kolom warna dalam data diagram
|
colorAxis.values |
Jika ada, kontrol cara nilai dikaitkan dengan warna. Setiap nilai dikaitkan dengan
warna yang sesuai di array Jenis: array angka
Default: null
|
colorAxis.colors |
Warna yang akan ditetapkan ke nilai dalam visualisasi. Array string, dengan setiap elemen adalah string warna HTML, misalnya: Jenis: array string warna
Default: null
|
warnaAxis.legend |
Objek yang menentukan gaya legenda warna gradien. Objek Type:
Default: null
|
warnaAxis.legend.position |
Posisi legenda. Dapat berupa salah satu dari hal berikut:
Objek Type:
Default: 'top'
|
warnaAxis.legend.textStyle |
Objek yang menentukan gaya teks legenda. Objek memiliki format ini: {color: <string>, fontName: <string>, fontSize: <number>}
Objek Type:
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
warnaAxis.legend.numberFormat |
String format untuk label numerik. Ini adalah subset dari
kumpulan pola ICU
.
Misalnya, Jenis: string
Default: otomatis
|
aktifkanInteraktivitas |
Apakah diagram menampilkan peristiwa berbasis pengguna atau bereaksi terhadap interaksi pengguna. Jika salah, diagram tidak akan menampilkan peristiwa 'pilih' atau peristiwa berbasis interaksi lainnya (tetapi akan menampilkan peristiwa siap atau error), dan tidak akan menampilkan pengarahan teks atau mengubah bergantung pada input pengguna. Jenis: boolean
Default: true (benar):
|
explorer |
Opsi Fitur ini bersifat eksperimental dan dapat berubah dalam rilis mendatang. Catatan: Penjelajah hanya berfungsi dengan sumbu berkelanjutan (seperti angka atau tanggal). Objek Type:
Default: null
|
explorer.actions |
Penjelajah Google Chart mendukung tiga tindakan:
Jenis: Array string
Default: ['dragToPan', 'rightClickToReset']
|
explorer.axe |
Secara default, pengguna dapat menggeser secara horizontal dan vertikal saat opsi Jenis: string
Default: pergeseran horizontal dan vertikal
|
explorer.keepInBounds |
Secara default, pengguna dapat menggeser di mana pun data berada. Untuk memastikan pengguna tidak menggeser melampaui diagram asli, gunakan Jenis: boolean
Default: false (salah)
|
explorer.maxZoomIn |
Jumlah maksimum yang dapat diperbesar oleh penjelajah. Secara default, pengguna dapat memperbesar cukup
sehingga hanya akan melihat 25% dari tampilan asli. Menetapkan
Jenis: angka
Default: 0,25
|
explorer.maxZoomOut |
Jumlah maksimum yang dapat dijelajahi oleh penjelajah. Secara default, pengguna akan dapat memperkecil cukup jauh sehingga diagram hanya akan menggunakan 1/4 dari ruang yang tersedia. Menetapkan
Jenis: angka
Default: 4
|
explorer.zoomDelta |
Saat pengguna memperbesar atau memperkecil, Jenis: angka
Default: 1,5
|
ukuranFont |
Ukuran font default, dalam piksel, dari semua teks dalam diagram. Anda dapat menggantinya menggunakan properti untuk elemen diagram tertentu. Jenis: angka
Default: otomatis
|
NamaFont |
Tampilan font default untuk semua teks dalam diagram. Anda dapat menggantinya menggunakan properti untuk elemen diagram tertentu. Jenis: string
Default: 'chromebook'
|
forceIFrame |
Menggambar diagram di dalam frame inline. (Perhatikan bahwa di IE8, opsi ini diabaikan; semua diagram IE8 digambar dalam i-frame.) Jenis: boolean
Default: false (salah)
|
Sumbu h |
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' } } Objek Type:
Default: null
|
hAxis.baseline |
Garis dasar untuk sumbu horizontal. Jenis: angka
Default: otomatis
|
hAxis.baselineColor |
Warna garis dasar untuk sumbu horizontal. Dapat berupa string warna HTML apa pun, misalnya: Jenis: angka
Default: 'hitam'
|
hAxis.direction |
Arah pertumbuhan nilai di sepanjang sumbu horizontal. Tentukan Jenis: 1 atau -1
Default: 1
|
hAxis.format |
String format untuk label sumbu numerik. Ini adalah subset dari
kumpulan pola ICU
. Misalnya,
Format sebenarnya yang diterapkan pada label berasal dari lokalitas API yang telah dimuat. Untuk detail selengkapnya, lihat memuat diagram dengan lokalitas tertentu .
Dalam menghitung nilai centang dan garis kisi, beberapa kombinasi alternatif dari semua opsi garis kisi yang relevan akan dipertimbangkan dan alternatif akan ditolak jika label centang yang diformat akan diduplikasi atau tumpang-tindih.
Jadi, Anda dapat menentukan Jenis: string
Default: otomatis
|
hAxis.gridline |
Objek dengan properti untuk mengonfigurasi garis kisi pada sumbu horizontal. Perhatikan bahwa garis kisi 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} Objek Type:
Default: null
|
hAxis.gridlines.color |
Warna garis kisi horizontal di dalam area diagram. Tentukan string warna HTML yang valid. Jenis: string
Default: '#CCC'
|
hAxis.gridlines.count |
Perkiraan jumlah garis kisi horizontal di dalam area diagram.
Jika Anda menentukan angka positif untuk Jenis: angka
Default: -1
|
hAxis.gridlines.units |
Mengganti format default untuk berbagai aspek jenis data tanggal/tanggal/waktu ketika digunakan dengan garis kisi 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. Objek Type:
Default: null
|
hAxis.minorGridlines |
Objek dengan anggota untuk mengonfigurasi garis petak kecil pada sumbu horizontal, mirip dengan opsi hAxis.gridlines. Objek Type:
Default: null
|
hAxis.minorGridlines.color |
Warna garis petak kecil horizontal di dalam area diagram. Tentukan string warna HTML yang valid. Jenis: string
Default: Gabungan antara warna petak dan latar belakang
|
hAxis.minorGridlines.count |
Opsi Jenis: angka
Default:1
|
hAxis.minorGridlines.units |
Mengganti format default untuk berbagai aspek jenis data tanggal/tanggal/waktu ketika digunakan dengan minorGridlines 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. Objek Type:
Default: null
|
hAxis.logScale |
Properti Jenis: boolean
Default: false (salah)
|
Jenis hAxis.scaleType |
Properti
Jenis: string
Default: null
|
hAxis.textPosition |
Posisi teks sumbu horizontal, relatif terhadap area diagram. Nilai yang didukung: 'out', 'in', 'none'. Jenis: string
Default: 'keluar'
|
hAxis.textStyle |
Objek yang menentukan gaya teks sumbu horizontal. Objek memiliki format ini: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Objek Type:
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.ticks |
Mengganti tick sumbu X yang dibuat secara otomatis dengan array yang ditentukan. Setiap elemen array harus berupa nilai tick yang valid (seperti angka, tanggal, tanggal/waktu), atau objek. Jika berupa objek, properti tersebut harus memiliki properti
ViewWindow akan otomatis diperluas untuk menyertakan tick minimum dan maksimum, kecuali jika Anda menentukan Contoh:
Jenis: Array elemen
Default: otomatis
|
hAxis.title |
Properti Jenis: string
Default: null
|
hAxis.titleTextStyle |
Objek yang menentukan gaya teks judul sumbu horizontal. Objek memiliki format ini: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Objek Type:
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.maxValue |
Memindahkan nilai maksimum sumbu horizontal ke nilai yang ditentukan; nilai ini akan berada tepat di sebagian besar diagram. Diabaikan jika nilai ini ditetapkan ke nilai yang lebih kecil dari nilai x maksimum data.
Jenis: angka
Default: otomatis
|
hAxis.minValue |
Memindahkan nilai min sumbu horizontal ke nilai yang ditentukan; nilai ini akan ke kiri di sebagian besar diagram. Diabaikan jika nilai ini ditetapkan ke nilai yang lebih besar dari nilai x minimum data.
Jenis: angka
Default: otomatis
|
hAxis.viewWindowMode |
Menentukan cara menskalakan sumbu horizontal untuk merender nilai dalam area diagram. Nilai string berikut 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. Objek Type:
Default: null
|
hAxis.viewWindow.max |
Nilai data horizontal maksimum yang akan dirender. Diabaikan saat Jenis: angka
Default: otomatis
|
hAxis.viewWindow.min |
Nilai data horizontal minimum yang akan dirender. Diabaikan saat Jenis: angka
Default: otomatis
|
tinggi |
Tinggi diagram, dalam piksel. Jenis: angka
Default: tinggi elemen penampung
|
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}} Objek Type:
Default: null
|
legenda.penyelarasan |
Penyelarasan legenda. Dapat berupa salah satu dari hal berikut:
Awal, tengah, dan akhir relatif terhadap gaya -- vertikal atau horizontal -- legenda. Misalnya, pada legenda 'right', 'start' dan 'end' berturut-turut berada di bagian atas dan bawah; untuk legenda 'top', masing-masing 'start' dan 'end' akan berada di kiri dan kanan area. Nilai defaultnya bergantung pada posisi legenda. Untuk legenda 'bottom', 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 baris ke legenda. Catatan: Logika persis yang digunakan untuk menentukan jumlah baris sebenarnya yang dirender masih berubah-ubah. Opsi ini saat ini hanya berfungsi jika legend.position adalah 'top'. Jenis: angka
Default: 1
|
legend.pageIndex |
Awal indeks halaman berbasis nol yang dipilih untuk legenda. Jenis: angka
Default: 0
|
legenda.posisi |
Posisi legenda. Dapat berupa salah satu dari hal berikut:
Jenis: string
Default: 'kanan'
|
legenda.teksGaya |
Objek yang menentukan gaya teks legenda. Objek memiliki format ini: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Objek Type:
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
modeMode |
Jika Jenis: string
Default: 'single'
|
serial |
Objek, dengan kunci adalah nama rangkaian (nilai dalam kolom Warna) dan setiap objek yang menjelaskan format rangkaian terkait dalam diagram. Jika rangkaian atau nilai tidak ditentukan, nilai global akan digunakan. Setiap objek mendukung properti berikut:
series: {'Europe': {color: 'green'}} Jenis: Objek dengan objek bertingkat
Default: {}
|
Sumbu ukuran |
Objek dengan anggota untuk mengonfigurasi bagaimana nilai dikaitkan dengan ukuran balon. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditunjukkan di sini: {minValue: 0, maxSize: 20} Objek Type:
Default: null
|
sizeAxis.maxSize |
Radius maksimum balon yang memungkinkan, dalam piksel. Jenis: angka
Default: 30
|
sizeAxis.maxValue |
Nilai ukuran (seperti yang muncul dalam data diagram) yang akan dipetakan ke Jenis: angka
Default: Nilai maksimum kolom ukuran dalam data diagram
|
sizeAxis.minSize |
Radius minimum balon terkecil yang mungkin, dalam piksel. Jenis: angka
Default: 5
|
sizeAxis.minValue |
Nilai ukuran (seperti yang muncul dalam data diagram) yang akan dipetakan ke Jenis: angka
Default: Nilai minimum kolom ukuran di data diagram
|
UrutkanBalonMenurutUkuran |
Jika benar, urutkan balon sesuai ukuran sehingga balon yang lebih kecil muncul di atas balon yang lebih besar. Jika salah, balon diurutkan sesuai dengan urutannya di DataTable. Jenis: boolean
Default: true (benar):
|
tema |
Tema adalah sekumpulan nilai opsi yang telah ditetapkan sebelumnya dan berfungsi bersama untuk mencapai perilaku diagram atau efek visual tertentu. Saat ini hanya tersedia satu tema:
Jenis: string
Default: null
|
judul |
Teks yang akan ditampilkan di atas diagram. Jenis: string
Default: tanpa judul
|
titlePosition |
Tempat untuk menempatkan judul diagram, dibandingkan dengan area diagram. Nilai yang didukung:
Jenis: string
Default: 'keluar'
|
titleTextStyle |
Objek yang menentukan gaya teks judul. Objek memiliki format ini: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Objek Type:
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 ditunjukkan di sini: {textStyle: {color: '#FF0000'}, showColorCode: true} Objek Type:
Default: null
|
tooltip.isHtml |
Jika disetel ke benar (true), gunakan tooltip yang dirender HTML (bukan yang dirender SVG). Lihat Menyesuaikan Konten Tooltip untuk detail selengkapnya. Catatan: penyesuaian konten tooltip HTML melalui peran data kolom tooltip tidak didukung oleh visualisasi Diagram Balon. Jenis: boolean
Default: false (salah)
|
tooltip.teksGaya |
Objek yang menentukan gaya teks tooltip. Objek memiliki format ini: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Objek Type:
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
tooltip.pemicu |
Interaksi pengguna yang menyebabkan tooltip ditampilkan:
Jenis: string
Default: 'fokus'
|
Sumbu V |
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'}} Objek Type:
Default: null
|
vXx.baseline |
Properti Jenis: angka
Default: otomatis
|
vAxis.baselineColor |
Menentukan warna dasar pengukuran untuk sumbu vertikal. Dapat berupa string warna HTML apa pun, misalnya: Jenis: angka
Default: 'hitam'
|
vAxis.direction |
Arah pertumbuhan nilai di sepanjang sumbu vertikal. Secara default, nilai rendah
berada di bagian bawah diagram. Tentukan Jenis: 1 atau -1
Default: 1
|
format vAxis |
String format untuk label sumbu numerik. Ini adalah subset dari
kumpulan pola ICU
.
Misalnya,
Format sebenarnya yang diterapkan pada label berasal dari lokalitas API yang telah dimuat. Untuk detail selengkapnya, lihat memuat diagram dengan lokalitas tertentu .
Dalam menghitung nilai centang dan garis kisi, beberapa kombinasi alternatif dari semua opsi garis kisi yang relevan akan dipertimbangkan dan alternatif akan ditolak jika label centang yang diformat akan diduplikasi atau tumpang-tindih.
Jadi, Anda dapat menentukan Jenis: string
Default: otomatis
|
baris vAxis.grid |
Objek dengan anggota untuk mengonfigurasi garis kisi pada sumbu vertikal. Perhatikan bahwa garis kisi 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} Objek Type:
Default: null
|
vAxis.gridlines.color |
Warna garis kisi vertikal di dalam area diagram. Tentukan string warna HTML yang valid. Jenis: string
Default: '#CCC'
|
vAxis.gridlines.count |
Perkiraan jumlah garis kisi horizontal di dalam area diagram.
Jika Anda menentukan angka positif untuk Jenis: angka
Default: -1
|
vAxis.gridlines.units |
Mengganti format default untuk berbagai aspek jenis data tanggal/tanggal/waktu ketika digunakan dengan garis kisi 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. Objek Type:
Default: null
|
Garis Vektor Axis.minorGrid |
Objek dengan anggota untuk mengonfigurasi garis petak kecil pada sumbu vertikal, mirip dengan opsi vAxis.gridlines. Objek Type:
Default: null
|
vAxis.minorGridlines.color |
Warna garis petak vertikal vertikal di dalam area diagram. Tentukan string warna HTML yang valid. Jenis: string
Default: Gabungan antara warna petak dan latar belakang
|
vAxis.minorGridlines.count |
Opsi minorGridlines.count sebagian besar tidak digunakan lagi, kecuali untuk menonaktifkan garis petak minor dengan menetapkan jumlahnya ke 0. Jumlah garis petak kecil bergantung pada interval antara garis kisi utama (lihat vAxis.gridlines.interval) dan ruang minimum yang diperlukan (lihat vAxis.minorGridlines.minSpacing). Jenis: angka
Default: 1
|
vAxis.minorGridlines.units |
Mengganti format default untuk berbagai aspek jenis data tanggal/tanggal/waktu ketika digunakan dengan minorGridlines 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. Objek Type:
Default: null
|
Skala vAxis.log |
Jika true, membuat sumbu vertikal menjadi skala logaritmik. Catatan: Semua nilai harus positif. Jenis: boolean
Default: false (salah)
|
Jenis vAxis.scale |
Properti
Jenis: string
Default: null
|
vAxis.textPosition |
Posisi teks sumbu vertikal, relatif terhadap area diagram. Nilai yang didukung: 'out', 'in', 'none'. Jenis: string
Default: 'keluar'
|
vAxis.textStyle |
Objek yang menentukan gaya teks sumbu vertikal. Objek memiliki format ini: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Objek Type:
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
vAxis.ticks |
Mengganti tick sumbu Y yang dibuat secara otomatis dengan array yang ditentukan. Setiap elemen array harus berupa nilai tick yang valid (seperti angka, tanggal, tanggal/waktu), atau objek. Jika berupa objek, properti tersebut harus memiliki properti
ViewWindow akan otomatis diperluas untuk menyertakan tick minimum dan maksimum, 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> }
Objek Type:
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
NilaiVaxis.max |
Memindahkan nilai maksimum sumbu vertikal ke nilai yang ditentukan; nilai ini akan naik ke sebagian besar
diagram. Diabaikan jika nilai ini ditetapkan ke nilai yang lebih kecil dari nilai y maksimum data.
Jenis: angka
Default: otomatis
|
NilaiVvx.minNilai |
Memindahkan nilai min sumbu vertikal ke nilai yang ditentukan; ini akan ke bawah di sebagian besar diagram. Diabaikan jika nilai ini ditetapkan ke nilai yang lebih besar dari nilai y minimum data.
Jenis: angka
Default: null
|
vAxis.viewWindowMode |
Menentukan cara menskalakan sumbu vertikal untuk merender nilai dalam area diagram. Nilai string berikut 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. Objek Type:
Default: null
|
vAxis.viewWindow.maks |
Nilai data vertikal maksimum yang akan dirender. Diabaikan saat Jenis: angka
Default: otomatis
|
vAxis.viewWindow.min |
Nilai data vertikal minimum yang akan dirender. Diabaikan saat Jenis: angka
Default: otomatis
|
lebar |
Lebar diagram, dalam piksel. Jenis: angka
Default: lebar elemen yang memuatnya
|
Metode
Metode | |
---|---|
draw(data, options) |
Menggambar diagram. Diagram menerima panggilan metode lebih lanjut hanya setelah peristiwa Jenis Hasil: tidak ada
|
getAction(actionID) |
Menampilkan objek tindakan tooltip dengan Return Type:
|
getBoundingBox(id) |
Menampilkan objek yang berisi kiri, atas, lebar, dan tinggi elemen diagram
Nilai relatif terhadap penampung diagram. Panggil ini setelah diagram digambar. Return Type:
|
getChartAreaBoundingBox() |
Menampilkan objek yang berisi bagian kiri, atas, lebar, dan tinggi konten diagram (yaitu, tidak termasuk label dan legenda):
Nilai relatif terhadap penampung diagram. Panggil ini setelah diagram digambar. Return Type:
|
getChartLayoutInterface() |
Menampilkan objek yang berisi informasi tentang penempatan di layar diagram dan elemennya. Metode berikut dapat dipanggil pada objek yang ditampilkan:
Panggil ini setelah diagram digambar. Return Type:
|
getHAxisValue(xPosition, optional_axis_index) |
Menampilkan nilai data horizontal pada Contoh: Panggil ini setelah diagram digambar. Jenis Hasil: angka
|
getImageURI() |
Menampilkan diagram yang diserialisasi sebagai URI gambar. Panggil ini setelah diagram digambar. Lihat Mencetak Diagram PNG. Jenis Hasil: string
|
getSelection() |
Menampilkan array entitas diagram yang dipilih.
Entitas yang dapat dipilih adalah balon.
Untuk diagram ini, hanya satu entitas yang dapat dipilih pada waktu tertentu.
Jenis Hasil: Array elemen pilihan
|
getVAxisValue(yPosition, optional_axis_index) |
Menampilkan nilai data vertikal di Contoh: Panggil ini setelah diagram digambar. Jenis Hasil: angka
|
getXLocation(dataValue, optional_axis_index) |
Menampilkan koordinat x piksel Contoh: Panggil ini setelah diagram digambar. Jenis Hasil: angka
|
getYLocation(dataValue, optional_axis_index) |
Menampilkan koordinat y piksel Contoh: Panggil ini setelah diagram digambar. Jenis Hasil: angka
|
removeAction(actionID) |
Menghapus tindakan tooltip dengan Jenis Hasil:
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 Hasil:
none |
setSelection() |
Memilih entitas diagram yang ditentukan. Membatalkan pilihan sebelumnya.
Entitas yang dapat dipilih adalah balon.
Untuk diagram ini, hanya satu entitas yang dapat dipilih sekaligus.
Jenis Hasil: tidak ada
|
clearChart() |
Menghapus diagram, dan melepaskan semua resource yang dialokasikan. Jenis Hasil: tidak ada
|
Acara
Untuk informasi selengkapnya tentang cara menggunakan peristiwa ini, lihat Interaktivitas Dasar, Menangani Peristiwa, dan Peristiwa Pengaktifan.
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 |
Dipicu jika terjadi error saat mencoba merender diagram. Properties: ID, pesan
|
legendpagination |
Dipicu jika pengguna mengklik panah penomoran halaman legenda. Meneruskan indeks halaman berbasis nol legenda saat ini dan jumlah total halaman. Properti: currentPageIndex, totalPage
|
onmouseover |
Diaktifkan saat pengguna mengarahkan mouse ke entitas visual. Meneruskan kembali indeks baris dan kolom dari elemen tabel data yang sesuai. Balon berhubungan dengan baris di tabel data (indeks kolom bernilai null). Properti: baris, kolom
|
onmouseout |
Diaktifkan saat pengguna mouse menjauh dari entitas visual. Meneruskan kembali indeks baris dan kolom dari elemen tabel data yang sesuai. Balon berhubungan dengan baris di tabel data (indeks kolom bernilai null). 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.