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, dimensi ketiga sebagai warna, dan dimensi 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>
Warnai Menurut Angka
Anda dapat menggunakan opsi colorAxis untuk mewarnai balon
secara proporsional dengan nilai, seperti yang ditunjukkan dalam 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 adanya ruang kosong di sekelilingnya. Hal itu disebut aura, dan jika
ingin diagram tanpa bagan tersebut, 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 visualisasi 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 deret atau nilai yang merepresentasikan warna pada skala gradien,
        bergantung pada jenis kolom: 
 | Ukuran; nilai dalam kolom ini dipetakan ke nilai piksel sebenarnya menggunakan opsi sizeAxis. | 
| Jenis Data: | string | number | number | string atau angka | number | 
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' | 
| bubble | Objek dengan anggota untuk mengonfigurasi properti visual balon. Jenis: objek Default: null | 
| bubble.opacity | Opasitas balon, dengan 0 sepenuhnya transparan dan 1 sepenuhnya tidak tembus pandang. Jenis: angka antara 0.0 dan 1.0 Default: 0,8 | 
| bubble.stroke | Warna goresan balon. Jenis: string Default: '#ccc' | 
| bubble.textStyle | Objek yang menetapkan gaya teks balon. Objek memiliki format ini: {color: <string>, fontName: <string>, fontSize: <number>}
         Jenis: objek 
        Default:
         
          {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
         | 
| 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 | 
| colorAxis | 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 ditampilkan di sini:  {minValue: 0,  colors: ['#FF0000', '#00FF00']}Jenis: objek Default: null | 
| colorAxis.minValue | 
      Jika ada, tentukan nilai minimum untuk data warna diagram. Nilai data warna dari nilai ini dan yang lebih rendah akan dirender sebagai warna pertama dalam rentang  Jenis: nomor Default: Nilai minimum kolom warna dalam data diagram | 
| colorAxis.maxValue | 
      Jika ada, tentukan nilai maksimum untuk data warna diagram. Nilai data warna dari nilai ini dan yang lebih tinggi akan dirender sebagai warna terakhir dalam rentang  Jenis: nomor 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 dalam array  Jenis: array angka Default: null | 
| colorAxis.colors | 
      Warna untuk menetapkan nilai-nilai dalam visualisasi. Array string, dengan setiap elemennya adalah string warna HTML, misalnya:  Jenis: array string warna Default: null | 
| colorAxis.legend | Objek yang menetapkan gaya legenda warna gradien. Jenis: objek Default: null | 
| colorAxis.legend.position | Posisi legenda. Dapat berupa salah satu dari hal berikut: 
 Jenis: objek Default: 'atas' | 
| colorAxis.legend.textStyle | Objek yang menetapkan gaya teks legenda. Objek memiliki format ini: {color: <string>, fontName: <string>, fontSize: <number>}
         Jenis: objek 
        Default:
         
          {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
         | 
| colorAxis.legend.numberFormat | 
        String format untuk label numerik. Ini adalah subset dari
        
          kumpulan pola ICU
        .
        Misalnya,  Jenis: string Default: otomatis | 
| 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) | 
| explorer | 
      Opsi  Fitur ini bersifat eksperimental dan dapat berubah dalam rilis mendatang. Catatan: Penjelajah hanya berfungsi dengan sumbu kontinu (seperti angka atau tanggal). Jenis: objek Default: null | 
| explorer.actions | Penjelajah Google Chart mendukung tiga tindakan: 
 Jenis: Array string Default: ['dragToPan', 'rightClickToReset'] | 
| explorer.axis | 
      Secara default, pengguna dapat menggeser secara horizontal dan vertikal saat opsi  Jenis: string Default: penggeseran horizontal dan vertikal | 
| explorer.keepInBounds | 
      Secara default, pengguna dapat menggeser ke semua bagian, di mana pun data berada. Untuk memastikan pengguna tidak menggeser di luar diagram yang asli, gunakan  Jenis: boolean Default: false | 
| explorer.maxZoomIn | 
      Jumlah maksimum yang dapat diperbesar oleh penjelajah. Secara default, pengguna dapat memperbesar secukupnya sehingga mereka hanya melihat 25% tampilan aslinya. Dengan menetapkan  Jenis: nomor Default: 0,25 | 
| explorer.maxZoomOut | 
      Batas maksimum yang dapat diperkecil oleh penjelajah. Secara default, pengguna dapat memperkecil tampilan hingga diagram hanya menggunakan 1/4 dari ruang yang tersedia. Menetapkan  Jenis: nomor Default: 4 | 
| explorer.zoomDelta | 
      Saat pengguna memperbesar atau memperkecil,  Jenis: nomor Default: 1,5 | 
| 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.baseline | Garis dasar untuk sumbu horizontal. Jenis: nomor Default: otomatis | 
| hAxis.baselineColor | 
      Warna dasar pengukuran untuk sumbu horizontal. Dapat berupa string warna HTML apa pun, misalnya:
       Jenis: nomor 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 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 | 
| 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.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.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.logScale | 
      Properti  Jenis: boolean Default: false | 
| 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: '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.ticks | 
      Mengganti tanda petik sumbu X 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 | 
| 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.maxValue | 
      Memindahkan nilai maksimum sumbu horizontal ke nilai yang ditentukan; tindakan ini akan ke kanan di
      sebagian besar diagram. Diabaikan jika ini ditetapkan ke nilai yang lebih kecil dari nilai x data maksimum.
       Jenis: nomor Default: otomatis | 
| hAxis.minValue | 
      Memindahkan nilai min sumbu horizontal ke nilai yang ditentukan; ini akan ke kiri di
      sebagian besar diagram. Diabaikan jika ditetapkan ke nilai yang lebih besar dari nilai x minimum data.
       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.mindanhaxis.viewWindow.maxlebih diutamakan jika digunakan. | 
| hAxis.viewWindow | Menentukan rentang pemangkasan sumbu horizontal. Jenis: objek Default: null | 
| hAxis.viewWindow.max | Nilai data horizontal maksimum yang akan dirender. Diabaikan jika  Jenis: nomor Default: otomatis | 
| hAxis.viewWindow.min | Nilai data horizontal minimum yang akan dirender. Diabaikan jika  Jenis: nomor Default: otomatis | 
| tinggi | Tinggi diagram, dalam piksel. Jenis: nomor Default: tinggi elemen yang memuatnya | 
| 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>}
       | 
| selectionMode | 
      Jika  Jenis: string Default: 'tunggal' | 
| series | Objek objek, dengan kunci adalah nama seri (nilai dalam kolom Color) dan setiap objek yang menjelaskan format deret yang sesuai dalam diagram. Jika deret atau nilai tidak ditentukan, nilai global akan digunakan. Setiap objek mendukung properti berikut: 
 series: {'Europe': {color: 'green'}}Jenis: Objek dengan objek bertingkat Default: {} | 
| sizeAxis | Objek dengan anggota untuk mengonfigurasi cara 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}Jenis: objek Default: null | 
| sizeAxis.maxSize | Radius maksimum balon terbesar, dalam piksel. Jenis: nomor Default: 30 | 
| sizeAxis.maxValue | 
      Nilai ukuran (seperti yang muncul pada data diagram) yang akan dipetakan ke  Jenis: nomor Default: Nilai maksimum kolom ukuran dalam data diagram | 
| sizeAxis.minSize | Radius minimal balon terkecil, dalam piksel. Jenis: nomor Default: 5 | 
| sizeAxis.minValue | 
      Nilai ukuran (seperti yang muncul pada data diagram) yang akan dipetakan ke  Jenis: nomor Default: Nilai minimum kolom ukuran dalam data diagram | 
| sortBubblesBySize | Jika true (benar), mengurutkan balon berdasarkan ukuran sehingga balon yang lebih kecil akan muncul di atas balon yang lebih besar. Jika salah, balon akan diurutkan sesuai dengan urutannya di DataTable. Jenis: boolean Default: benar (true) | 
| 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.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' | 
| 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.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.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.mindanvaxis.viewWindow.maxlebih 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 balon.
    
    
    
      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 balon.
    
    
    
      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. Gelembung berkorelasi dengan baris dalam tabel data (indeks kolom null). Properti: baris, kolom | 
| onmouseout | Diaktifkan saat pengguna menjauhi entity visual. Meneruskan kembali indeks baris dan kolom dari elemen tabel data yang sesuai. Gelembung berkorelasi dengan baris dalam tabel data (indeks kolom 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.