Visualisasi: Diagram Sebar

Ringkasan

Diagram sebar titik plot pada grafik. Saat pengguna mengarahkan kursor ke titik, tooltip ditampilkan dengan informasi selengkapnya.

Diagram sebar Google dirender dalam browser menggunakan SVG atau VML bergantung pada kemampuan browser.

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(drawChart);

      function drawChart() {
        var data = google.visualization.arrayToDataTable([
          ['Age', 'Weight'],
          [ 8,      12],
          [ 4,      5.5],
          [ 11,     14],
          [ 4,      5],
          [ 3,      3.5],
          [ 6.5,    7]
        ]);

        var options = {
          title: 'Age vs. Weight comparison',
          hAxis: {title: 'Age', minValue: 0, maxValue: 15},
          vAxis: {title: 'Weight', minValue: 0, maxValue: 15},
          legend: 'none'
        };

        var chart = new google.visualization.ScatterChart(document.getElementById('chart_div'));

        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <div id="chart_div" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Mengubah dan menganimasikan bentuk

Secara default, diagram sebar mewakili elemen set data Anda dengan lingkaran. Anda dapat menentukan bentuk lain dengan opsi pointShape, yang dijelaskan dalam dokumentasi Menyesuaikan Titik.

Seperti sebagian besar Google Chart lainnya, Anda dapat menganimasikannya menggunakan peristiwa. Anda dapat menambahkan pemroses peristiwa untuk peristiwa ready pertama dan menggambar ulang diagram setelah melakukan modifikasi yang diinginkan. Setelah peristiwa ready pertama, Anda dapat memproses peristiwa animationfinish untuk mengulangi proses ini, sehingga menghasilkan animasi berkelanjutan. Opsi animation mengontrol cara penggambaran ulang terjadi: segera (tanpa animasi) atau dengan lancar, dan jika lancar berapa cepat dan dengan perilaku apa.

Bagian yang bagus
  var options = {
    legend: 'none',
    colors: ['#087037'],
    pointShape: 'star',
    pointSize: 18,
    animation: {
      duration: 200,
      easing: 'inAndOut',
    }
  };

  // Start the animation by listening to the first 'ready' event.
  google.visualization.events.addOneTimeListener(chart, 'ready', randomWalk);

  // Control all other animations by listening to the 'animationfinish' event.
  google.visualization.events.addListener(chart, 'animationfinish', randomWalk);
  ...
  function randomWalk() {
    ...
  }
HTML lengkap
<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 = new google.visualization.DataTable();
      data.addColumn('number');
      data.addColumn('number');

      var radius = 100;
      for (var i = 0; i < 6.28; i += 0.1) {
        data.addRow([radius * Math.cos(i), radius * Math.sin(i)]);
      }

      // Our central point, which will jiggle.
      data.addRow([0, 0]);

      var options = {
        legend: 'none',
        colors: ['#087037'],
        pointShape: 'star',
        pointSize: 18,
        animation: {
          duration: 200,
          easing: 'inAndOut',
        }
      };

      var chart = new google.visualization.ScatterChart(document.getElementById('animatedshapes_div'));

      // Start the animation by listening to the first 'ready' event.
      google.visualization.events.addOneTimeListener(chart, 'ready', randomWalk);

      // Control all other animations by listening to the 'animationfinish' event.
      google.visualization.events.addListener(chart, 'animationfinish', randomWalk);

      chart.draw(data, options);

      function randomWalk() {
        var x = data.getValue(data.getNumberOfRows() - 1, 0);
        var y = data.getValue(data.getNumberOfRows() - 1, 1);
        x += 5 * (Math.random() - 0.5);
        y += 5 * (Math.random() - 0.5);
        if (x * x + y * y > radius * radius) {
          // Out of bounds. Bump toward center.
          x += Math.random() * ((x < 0) ? 5 : -5);
          y += Math.random() * ((y < 0) ? 5 : -5);
        }
        data.setValue(data.getNumberOfRows() - 1, 0, x);
        data.setValue(data.getNumberOfRows() - 1, 1, y);
        chart.draw(data, options);
      }
    }
  </script>
  </head>
  <body>
    <div id="animatedshapes_div" style="width: 500px; height: 500px;"></div>
  </body>
</html>

Membuat diagram sebar Material

Pada tahun 2014, Google mengumumkan pedoman yang dimaksudkan untuk mendukung tampilan dan nuansa yang sama di seluruh properti dan aplikasi (seperti aplikasi Android) yang berjalan di platform Google. Kami menyebutnya upaya Desain Material. Kami akan menyediakan versi "Material" dari semua diagram inti kami; Anda dapat menggunakannya jika Anda menyukainya.

Membuat Diagram Sebar Material mirip dengan membuat yang sekarang kita sebut sebagai Diagram Sebar "Klasik". Anda memuat Google Visualization API (meskipun dengan paket 'scatter', bukan paket 'corechart'), tentukan tabel data, lalu buat objek (tetapi bukan class google.charts.Scatter, bukan google.visualization.ScatterChart).

Catatan: Diagram Material tidak akan berfungsi di Internet Explorer versi lama. (Versi IE8 dan versi sebelumnya tidak mendukung SVG, yang memerlukan Diagram Material.)

Diagram Sebar Material memiliki banyak peningkatan kecil dibandingkan Diagram Sebar Klasik, termasuk opasitas variabel agar keterbacaan titik yang tumpang-tindih, palet warna yang ditingkatkan, pemformatan label yang lebih jelas, spasi default yang lebih padat, garis dan judul yang lebih lembut (dan penambahan subtitel). 

      google.charts.load('current', {'packages':['scatter']});
      google.charts.setOnLoadCallback(drawChart);

      function drawChart () {

        var data = new google.visualization.DataTable();
        data.addColumn('number', 'Hours Studied');
        data.addColumn('number', 'Final');

        data.addRows([
          [0, 67], [1, 88], [2, 77],
          [3, 93], [4, 85], [5, 91],
          [6, 71], [7, 78], [8, 93],
          [9, 80], [10, 82],[0, 75],
          [5, 80], [3, 90], [1, 72],
          [5, 75], [6, 68], [7, 98],
          [3, 82], [9, 94], [2, 79],
          [2, 95], [2, 86], [3, 67],
          [4, 60], [2, 80], [6, 92],
          [2, 81], [8, 79], [9, 83],
          [3, 75], [1, 80], [3, 71],
          [3, 89], [4, 92], [5, 85],
          [6, 92], [7, 78], [6, 95],
          [3, 81], [0, 64], [4, 85],
          [2, 83], [3, 96], [4, 77],
          [5, 89], [4, 89], [7, 84],
          [4, 92], [9, 98]
        ]);

        var options = {
          width: 800,
          height: 500,
          chart: {
            title: 'Students\' Final Grades',
            subtitle: 'based on hours studied'
          },
          hAxis: {title: 'Hours Studied'},
          vAxis: {title: 'Grade'}
        };

        var chart = new google.charts.Scatter(document.getElementById('scatterchart_material'));

        chart.draw(data, google.charts.Scatter.convertOptions(options));
      }

Diagram Material tersedia dalam versi beta. Tampilan dan interaktivitas sebagian besar bersifat final, tetapi banyak opsi yang tersedia di Diagram Klasik belum tersedia di dalamnya. Anda dapat menemukan daftar opsi yang belum didukung dalam masalah ini.

Selain itu, cara deklarasi opsi belum final. Jadi, jika Anda menggunakan salah satu opsi klasik, Anda harus mengonversinya menjadi opsi material dengan mengganti baris ini:

chart.draw(data, options);

...dengan ini:

chart.draw(data, google.charts.Scatter.convertOptions(options));

Diagram ganda Y

Terkadang, Anda mungkin ingin menampilkan dua seri dalam diagram sebar, dengan dua sumbu y independen: sumbu kiri untuk satu rangkaian, dan sumbu kanan untuk seri lainnya:

Perlu diketahui bahwa sumbu y tidak hanya diberi label secara berbeda ("Nilai Ujian Akhir" versus "Jam yang Dipelajari"), tetapi masing-masing memiliki skala dan garis kisinya sendiri. Jika ingin menyesuaikan perilaku ini, gunakan opsi vAxis.gridlines.

Dalam kode di bawah, opsi axes dan series bersama-sama menentukan tampilan Y dua kali pada diagram. Opsi series menentukan sumbu yang akan digunakan untuk masing-masing ('final grade' dan 'hours studied'; tidak perlu ada hubungan dengan nama kolom dalam tabel data). Opsi axes kemudian menjadikan diagram ini sebagai diagram Y-dua, dengan menempatkan sumbu 'Final Exam Grade' di sebelah kiri dan sumbu 'Hours Studied' di sebelah kanan. 

      google.charts.load('current', {'packages':['corechart', 'scatter']});
      google.charts.setOnLoadCallback(drawStuff);

      function drawStuff() {

        var button = document.getElementById('change-chart');
        var chartDiv = document.getElementById('chart_div');

        var data = new google.visualization.DataTable();
        data.addColumn('number', 'Student ID');
        data.addColumn('number', 'Hours Studied');
        data.addColumn('number', 'Final');

        data.addRows([
          [0, 0, 67],  [1, 1, 88],   [2, 2, 77],
          [3, 3, 93],  [4, 4, 85],   [5, 5, 91],
          [6, 6, 71],  [7, 7, 78],   [8, 8, 93],
          [9, 9, 80],  [10, 10, 82], [11, 0, 75],
          [12, 5, 80], [13, 3, 90],  [14, 1, 72],
          [15, 5, 75], [16, 6, 68],  [17, 7, 98],
          [18, 3, 82], [19, 9, 94],  [20, 2, 79],
          [21, 2, 95], [22, 2, 86],  [23, 3, 67],
          [24, 4, 60], [25, 2, 80],  [26, 6, 92],
          [27, 2, 81], [28, 8, 79],  [29, 9, 83]
        ]);

        var materialOptions = {
          chart: {
            title: 'Students\' Final Grades',
            subtitle: 'based on hours studied'
          },
          width: 800,
          height: 500,
          series: {
            0: {axis: 'hours studied'},
            1: {axis: 'final grade'}
          },
          axes: {
            y: {
              'hours studied': {label: 'Hours Studied'},
              'final grade': {label: 'Final Exam Grade'}
            }
          }
        };

        var classicOptions = {
          width: 800,
          series: {
            0: {targetAxisIndex: 0},
            1: {targetAxisIndex: 1}
          },
          title: 'Students\' Final Grades - based on hours studied',

          vAxes: {
            // Adds titles to each axis.
            0: {title: 'Hours Studied'},
            1: {title: 'Final Exam Grade'}
          }
        };

        function drawMaterialChart() {
          var materialChart = new google.charts.Scatter(chartDiv);
          materialChart.draw(data, google.charts.Scatter.convertOptions(materialOptions));
          button.innerText = 'Change to Classic';
          button.onclick = drawClassicChart;
        }

        function drawClassicChart() {
          var classicChart = new google.visualization.ScatterChart(chartDiv);
          classicChart.draw(data, classicOptions);
          button.innerText = 'Change to Material';
          button.onclick = drawMaterialChart;
        }

        drawMaterialChart();
    };

Diagram Teratas

Catatan: Sumbu Top-X hanya tersedia untuk diagram Material (yaitu yang memiliki paket scatter).

Jika Anda ingin menempatkan label dan judul sumbu X di bagian atas diagram, bukan di bagian bawah, Anda dapat melakukannya di diagram Material dengan opsi axes.x: 

      google.charts.load('current', {'packages':['scatter']});
      google.charts.setOnLoadCallback(drawChart);

      function drawChart () {

        var data = new google.visualization.DataTable();
        data.addColumn('number', 'Hours Studied');
        data.addColumn('number', 'Final');

        data.addRows([
          [0, 67],  [1, 88],  [2, 77],
          [3, 93],  [4, 85],  [5, 91],
          [6, 71],  [7, 78],  [8, 93],
          [9, 80],  [10, 82], [0, 75],
          [5, 80],  [3, 90],  [1, 72],
          [5, 75],  [6, 68],  [7, 98],
          [3, 82],  [9, 94],  [2, 79],
          [2, 95],  [2, 86],  [3, 67],
          [4, 60],  [2, 80],  [6, 92],
          [2, 81],  [8, 79],  [9, 83],
          [3, 75],  [1, 80],  [3, 71],
          [3, 89],  [4, 92],  [5, 85],
          [6, 92],  [7, 78],  [6, 95],
          [3, 81],  [0, 64],  [4, 85],
          [2, 83],  [3, 96],  [4, 77],
          [5, 89],  [4, 89],  [7, 84],
          [4, 92],  [9, 98]
        ]);

        var options = {
          width: 800,
          height: 500,
          chart: {
            title: 'Students\' Final Grades',
            subtitle: 'based on hours studied'
          },
          axes: {
            x: {
              0: {side: 'top'}
            }
          }
        };

        var chart = new google.charts.Scatter(document.getElementById('scatter_top_x'));

        chart.draw(data, google.charts.Scatter.convertOptions(options));
      }

Memuat

Nama paket google.charts.load adalah "corechart", dan nama class visualisasinya adalah google.visualization.ScatterChart. 

  google.charts.load("current", {packages: ["corechart"]});

  var visualization = new google.visualization.ScatterChart(container);

Untuk Diagram Sebar Material, nama paket google.charts.load adalah "scatter", dan nama class visualisasinya adalah google.charts.Scatter. 

  google.charts.load("current", {packages: ["scatter"]});

  var visualization = new google.charts.Scatter(container);

Format data

Baris: Setiap baris dalam tabel mewakili sekumpulan titik data dengan nilai sumbu x yang sama.

Kolom:

  Kolom 0 Kolom 1 ... Kolom N
Tujuan: Nilai titik data X Nilai Y Seri 1 Y ... Nilai rangkaian N Y
Jenis Data: string, angka, atau tanggal/tanggal/waktu string, angka, atau tanggal/tanggal/waktu ... string, angka, atau tanggal/tanggal/waktu
Peran: data data ... data
Peran kolom opsional:

None

 ...

Untuk menentukan beberapa rangkaian, tentukan dua atau lebih kolom sumbu Y, dan tentukan nilai Y hanya dalam satu kolom Y:

Nilai X Nilai Seri 1 Y Nilai Seri 2 Y
10 null 75
20 null 18
33 null 22
55 16 null
14 61 null
48 3 null

 

Opsi konfigurasi

Name
targetagregasi
Cara beberapa pilihan data digabungkan menjadi tooltip:
  • 'category': Mengelompokkan data yang dipilih berdasarkan nilai x.
  • 'series': Mengelompokkan data yang dipilih menurut seri.
  • 'auto': Mengelompokkan data yang dipilih menurut nilai x jika semua pilihan memiliki nilai x yang sama, dan berdasarkan rangkaian jika tidak.
  • 'none': Hanya menampilkan satu tooltip per pilihan.
aggregationTarget akan sering digunakan bersama-sama dengan selectionMode dan tooltip.trigger, misalnya: 
var options = {
  // Allow multiple
  // simultaneous selections.
  selectionMode: 'multiple',
  // Trigger tooltips
  // on selections.
  tooltip: {trigger: 'selection'},
  // Group selections
  // by x-value.
  aggregationTarget: 'category',
};
Jenis: string
Default: 'otomatis'
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:

  • 'linear' - Kecepatan konstan.
  • 'in' - Relax in - Mulai dengan lambat dan percepat.
  • 'out' - Relax out - Memulai dengan cepat dan melambat.
  • 'inAndOut' - Kemudahan masuk dan keluar - Mulai dengan lambat, mempercepat, lalu memperlambat.
Jenis: string
Default: 'linear'
animasi.mulai

Menentukan apakah diagram akan dianimasikan pada gambar awal. Jika true, diagram akan dimulai pada dasar pengukuran dan akan dianimasikan ke status akhirnya.

Jenis: boolean
Default false
annotation.boxStyle

Untuk diagram yang mendukung anotasi, objek annotations.boxStyle mengontrol tampilan kotak di sekitar anotasi: 

var options = {
  annotations: {
    boxStyle: {
      // Color of the box outline.
      stroke: '#888',
      // Thickness of the box outline.
      strokeWidth: 1,
      // x-radius of the corner curvature.
      rx: 10,
      // y-radius of the corner curvature.
      ry: 10,
      // Attributes for linear gradient fill.
      gradient: {
        // Start color for gradient.
        color1: '#fbf6a7',
        // Finish color for gradient.
        color2: '#33b679',
        // Where on the boundary to start and
        // end the color1/color2 gradient,
        // relative to the upper left corner
        // of the boundary.
        x1: '0%', y1: '0%',
        x2: '100%', y2: '100%',
        // If true, the boundary for x1,
        // y1, x2, and y2 is the box. If
        // false, it's the entire chart.
        useObjectBoundingBoxUnits: true
      }
    }
  }
};

Opsi ini saat ini didukung untuk diagram area, batang, kolom, kombinasi, garis, dan sebar. Ini tidak didukung oleh Diagram Anotasi.

Objek Type:
Default: null
anotasi.datum
Untuk diagram yang mendukung anotasi, objek annotations.datum memungkinkan Anda mengganti pilihan Google Chart untuk anotasi yang disediakan untuk elemen data individual (seperti nilai yang ditampilkan dengan setiap batang pada diagram batang). Anda dapat mengontrol warna dengan annotations.datum.stem.color, panjang batang dengan annotations.datum.stem.length, dan gaya dengan annotations.datum.style.
Objek Type:
Default: warna "black"; panjangnya 12; gaya adalah "point".
anotasi.domain
Untuk diagram yang mendukung anotasi, objek annotations.domain memungkinkan Anda mengganti pilihan Google Chart untuk anotasi yang disediakan untuk domain (sumbu utama diagram, seperti sumbu X pada diagram garis standar). Anda dapat mengontrol warna dengan annotations.domain.stem.color, panjang batang dengan annotations.domain.stem.length, dan gaya dengan annotations.domain.style.
Objek Type:
Default: warna "hitam"; panjangnya 5; gaya adalah "titik".
anotasi.highContrast
Untuk diagram yang mendukung anotasi, boolean annotations.highContrast memungkinkan Anda mengganti pilihan warna anotasi di Google Chart. Secara default, annotations.highContrast disetel ke benar (true), yang menyebabkan Diagram memilih warna anotasi dengan kontras yang baik: warna terang pada latar belakang gelap, dan gelap pada terang. Jika Anda menyetel annotations.highContrast ke false dan tidak menentukan warna anotasi Anda sendiri, Google Chart akan menggunakan warna seri default untuk anotasi tersebut:
Jenis: boolean
Default: true (benar):
anotasi.stem
Untuk diagram yang mendukung anotasi, objek annotations.stem memungkinkan Anda mengganti pilihan Google Chart untuk gaya stem. Anda dapat mengontrol warna dengan annotations.stem.color dan panjang batang dengan annotations.stem.length. Perhatikan bahwa opsi panjang stem tidak berpengaruh pada anotasi dengan gaya 'line': untuk anotasi datum 'line', panjang stem selalu sama dengan teks, dan untuk anotasi domain 'line', stem memanjang di seluruh diagram.
Objek Type:
Default: warna "black"; panjangnya adalah 5 untuk anotasi domain dan 12 untuk anotasi datum.
anotasi.gaya
Untuk diagram yang mendukung anotasi, opsi annotations.style memungkinkan Anda mengganti pilihan jenis anotasi di Google Chart. Ini dapat berupa 'line' atau 'point'.
Jenis: string
Default: 'point'
annotation.textStyle
Untuk diagram yang mendukung anotasi, objek annotations.textStyle mengontrol tampilan teks anotasi: 
var options = {
  annotations: {
    textStyle: {
      fontName: 'Times-Roman',
      fontSize: 18,
      bold: true,
      italic: true,
      // The color of the text.
      color: '#871b47',
      // The color of the text outline.
      auraColor: '#d799ae',
      // The transparency of the text.
      opacity: 0.8
    }
  }
};

Opsi ini saat ini didukung untuk diagram area, batang, kolom, kombinasi, garis, dan sebar. Ini tidak didukung oleh Diagram Anotasi .

Objek Type:
Default: null
axeTitlesPosition

Tempat untuk menempatkan judul sumbu, dibandingkan dengan area diagram. Nilai yang didukung:

  • in - Menggambar judul sumbu di dalam area diagram.
  • out - Gambar judul sumbu di luar area diagram.
  • tidak ada - Hapus judul sumbu.
Jenis: string
Default: 'keluar'
backgroundColor

Warna latar belakang untuk area utama diagram. Dapat berupa string warna HTML sederhana, misalnya: 'red' atau '#00cc00', atau objek dengan properti berikut.

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'
chart.title

Untuk Diagram Material, opsi ini menentukan judul.

Jenis: string
Default: null
subjudul.diagram

Untuk Diagram Material, opsi ini menentukan subtitel. Hanya Diagram Material yang mendukung subtitel.

Jenis: string
Default: null
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: chartArea:{left:20,top:0,width:'50%',height:'75%'}

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:
  • stroke: warna, diberikan sebagai string heksadesimal atau nama warna dalam bahasa Inggris.
  • strokeWidth: jika diberikan, menggambar batas di sekitar area diagram dengan lebar yang diberikan (dan dengan warna stroke).
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: colors:['red','#004411'].

Jenis: Array string
Default: warna default
crosshair

Objek yang berisi properti crosshair untuk diagram.

Objek Type:
Default: null
crosshair.warna

Warna garis bidik, dinyatakan sebagai nama warna (mis., "biru") atau nilai RGB (misalnya, "#adf").

Jenis: string
Jenis: default
berfokus pada crosshair.

Objek yang berisi properti crosshair setelah fokus.
Contoh: crosshair: { focused: { color: '#3bc', opacity: 0.8 } }

Objek Type:
Default: default
crosshair.opacity

Opasitas crosshair, dengan 0.0 transparan sepenuhnya dan 1.0 sepenuhnya buram.

Jenis: angka
Default: 1.0
crosshair.orientation

Orientasi crosshair, yang dapat berupa 'vertikal' hanya untuk rambut vertikal, 'horizontal' hanya untuk rambut horizontal, atau 'keduanya' untuk garis bidik tradisional.

Jenis: string
Default: 'keduanya'
crosshair.dipilih

Objek yang berisi properti crosshair saat pemilihan.
Contoh: crosshair: { selected: { color: '#3bc', opacity: 0.8 } }

Objek Type:
Default: default
crosshair.trigger

Waktu untuk menampilkan garis bidik: pada 'focus', 'selection', atau 'both'.

Jenis: string
Default: 'keduanya'
curveType

Mengontrol kurva garis jika lebar garis bukan nol. Dapat berupa salah satu dari hal berikut:

  • 'tidak ada' - Garis lurus tanpa kurva.
  • 'function' - Sudut garis akan dihaluskan.
Jenis:string
Default: 'tidak ada'
DataOpacity

Transparansi titik data, dengan 1,0 menjadi sepenuhnya buram dan 0,0 sepenuhnya transparan. Di diagram sebar, histogram, batang, dan kolom, data ini mengacu pada data yang terlihat: titik di diagram sebar dan persegi panjang di diagram lainnya. Dalam diagram dengan memilih data akan menghasilkan titik, seperti diagram garis dan area, ini merujuk pada lingkaran yang muncul saat kursor diarahkan atau dipilih. Diagram kombinasi menunjukkan kedua perilaku tersebut, dan opsi ini tidak berpengaruh pada diagram lainnya. (Untuk mengubah opasitas garis tren, lihat Opasitas garis tren .)

Jenis: angka
Default: 1.0
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 explorer memungkinkan pengguna menggeser dan melakukan zoom pada diagram Google. explorer: {} menyediakan perilaku penjelajah default, yang memungkinkan pengguna menggeser secara horizontal dan vertikal dengan menarik, serta memperbesar dan memperkecil dengan men-scroll.

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:

  • dragToPan: Tarik untuk menggeser diagram secara horizontal dan vertikal. Untuk menggeser hanya di sepanjang sumbu horizontal, gunakan explorer: { axis: 'horizontal' }. Demikian pula untuk sumbu vertikal.
  • dragToZoom: Perilaku default penjelajah adalah memperbesar dan memperkecil saat pengguna men-scroll. Jika explorer: { actions: ['dragToZoom', 'rightClickToReset'] } digunakan, menarik area persegi panjang akan memperbesar area tersebut. Sebaiknya gunakan rightClickToReset setiap kali dragToZoom digunakan. Lihat explorer.maxZoomIn, explorer.maxZoomOut, dan explorer.zoomDelta untuk penyesuaian zoom.
  • rightClickToReset: Mengklik kanan diagram akan menampilkannya ke tingkat menggeser dan zoom asli.
Jenis: Array string
Default: ['dragToPan', 'rightClickToReset']
explorer.axe

Secara default, pengguna dapat menggeser secara horizontal dan vertikal saat opsi explorer digunakan. Jika Anda ingin pengguna hanya menggeser secara horizontal, gunakan explorer: { axis: 'horizontal' }. Demikian pula, explorer: { axis: 'vertical' } memungkinkan penggeseran hanya vertikal.

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 explorer: { keepInBounds: true }.

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 explorer: { maxZoomIn: .5 } akan memungkinkan pengguna memperbesar cukup jauh untuk melihat setengah tampilan asli.

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 explorer: { maxZoomOut: 8 } akan memungkinkan pengguna memperkecil tampilan cukup jauh sehingga diagram hanya akan menggunakan 1/8 dari ruang yang tersedia.

Jenis: angka
Default: 4
explorer.zoomDelta

Saat pengguna memperbesar atau memperkecil, explorer.zoomDelta akan menentukan seberapa besar zoom yang dilakukan pengguna. Semakin kecil angkanya, semakin halus dan semakin lambat zoom-nya.

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: 'red' atau '#00cc00'.

Jenis: angka
Default: 'hitam'
hAxis.direction

Arah pertumbuhan nilai di sepanjang sumbu horizontal. Tentukan -1 untuk membalik urutan nilai.

Jenis: 1 atau -1
Default: 1
hAxis.format

String format untuk label sumbu numerik. Ini adalah subset dari kumpulan pola ICU . Misalnya, {format:'#,###%'} akan menampilkan nilai "1.000%", "750%", dan "50%" untuk nilai 10, 7.5, dan 0.5. Anda juga dapat menyediakan salah satu dari hal berikut:

  • {format: 'none'}: menampilkan angka tanpa format (mis., 8000000)
  • {format: 'decimal'}: menampilkan angka dengan pemisah ribuan (misalnya, 8.000.000)
  • {format: 'scientific'}: menampilkan angka dalam notasi ilmiah (misalnya, 8e6)
  • {format: 'currency'}: menampilkan angka dalam mata uang lokal (misalnya, $8.000.000,00)
  • {format: 'percent'}: menampilkan angka sebagai persentase (misalnya, 800.000.000%)
  • {format: 'short'}: menampilkan angka yang disingkat (misalnya, 8 JT)
  • {format: 'long'}: menampilkan angka sebagai kata lengkap (misalnya, 8 juta)

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 format:"#" jika hanya ingin menampilkan nilai centang bilangan bulat, tetapi perhatikan bahwa jika tidak ada alternatif yang memenuhi kondisi ini, tidak ada garis petak atau tick yang akan ditampilkan.

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 gridlines.count, angka tersebut akan digunakan untuk menghitung minSpacing di antara garis kisi. Anda dapat menentukan nilai 1 untuk hanya menggambar satu garis petak, atau 0 untuk tidak menggambar garis kisi. Tentukan -1, yang merupakan default, untuk menghitung jumlah garis kisi secara otomatis berdasarkan opsi lain.

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 minorGridlines.count sebagian besar tidak digunakan lagi, kecuali untuk menonaktifkan garis kisi minor dengan menetapkan jumlahnya ke 0. Jumlah garis petak kecil kini sepenuhnya bergantung pada interval antara garis petak utama (lihat hAxis.gridlines.interval) dan ruang minimum yang diperlukan (lihat hAxis.minorGridlines.minSpacing).

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 hAxis yang membuat sumbu horizontal menjadi skala logaritmik (memerlukan semua nilai yang harus positif). Tetapkan ke true untuk ya.

Jenis: boolean
Default: false (salah)
Jenis hAxis.scaleType

Properti hAxis yang membuat sumbu horizontal skala logaritmik. Dapat berupa salah satu dari hal berikut:

  • null - Tidak ada penskalaan logaritmik yang dilakukan.
  • 'log' - Penskalaan logaritmik. Nilai negatif dan nol tidak dipetakan. Opsi ini sama dengan setelan hAxis: { logscale: true }.
  • 'mirrorLog' - Penskalaan logaritmik dengan nilai negatif dan nol dipetakan. Nilai dipetakan angka negatif adalah negatif dari log nilai absolut. Nilai yang mendekati 0 dipetakan pada skala linear.
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> }

color dapat berupa string warna HTML apa pun, misalnya: 'red' atau '#00cc00'. Lihat juga fontName dan fontSize.

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 v untuk nilai centang, dan properti f opsional yang berisi string literal yang akan ditampilkan sebagai label.

ViewWindow akan otomatis diperluas untuk menyertakan tick minimum dan maksimum, kecuali jika Anda menentukan viewWindow.min atau viewWindow.max yang akan diganti.

Contoh:

  • hAxis: { ticks: [5,10,15,20] }
  • hAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
  • hAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
  • hAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }
Jenis: Array elemen
Default: otomatis
hAxis.title

Properti hAxis yang menentukan judul sumbu horizontal.

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

color dapat berupa string warna HTML apa pun, misalnya: 'red' atau '#00cc00'. Lihat juga fontName dan fontSize.

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. hAxis.viewWindow.max mengganti properti ini.

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. hAxis.viewWindow.min mengganti properti ini.

Jenis: angka
Default: otomatis
hAxis.viewWindowMode

Menentukan cara menskalakan sumbu horizontal untuk merender nilai dalam area diagram. Nilai string berikut didukung:

  • 'pretty' - Skalakan nilai horizontal sehingga nilai data maksimum dan minimum dirender sedikit di dalam kiri dan kanan area diagram. viewWindow diperluas ke garis petak utama terdekat untuk angka, atau garis kisi kecil terdekat untuk tanggal dan waktu.
  • 'maksimal' - Menskalakan nilai horizontal sehingga nilai data maksimum dan minimum menyentuh kiri dan kanan area diagram. Hal ini akan menyebabkan haxis.viewWindow.min dan haxis.viewWindow.max diabaikan.
  • 'explicit' - Opsi yang tidak digunakan lagi untuk menentukan nilai skala kiri dan kanan pada area diagram. (Tidak digunakan lagi karena redundan dengan haxis.viewWindow.min dan haxis.viewWindow.max.) Nilai data di luar nilai ini akan dipangkas. Anda harus menentukan objek hAxis.viewWindow yang menjelaskan nilai maksimum dan minimum untuk ditampilkan.
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 hAxis.viewWindowMode adalah 'pretty' atau 'maksimal'.

Jenis: angka
Default: otomatis
hAxis.viewWindow.min

Nilai data horizontal minimum yang akan dirender.

Diabaikan saat hAxis.viewWindowMode adalah 'pretty' atau 'maksimal'.

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:

  • 'start' - Menyejajarkan ke awal area yang dialokasikan untuk legenda.
  • 'center' - Dipusatkan di area yang dialokasikan untuk legenda.
  • 'end' - Rata ke akhir area yang dialokasikan untuk legenda.

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:

  • 'bawah' - Di bawah diagram.
  • 'kiri' - Di sebelah kiri diagram, sumbu kiri tidak memiliki rangkaian yang terkait dengan diagram tersebut. Jadi, jika Anda menginginkan legenda di sebelah kiri, gunakan opsi targetAxisIndex: 1.
  • 'in' - Di dalam diagram, di pojok kiri atas.
  • 'tidak ada' - Tidak ada legenda yang ditampilkan.
  • 'kanan' - Di sebelah kanan diagram. Tidak kompatibel dengan opsi vAxes.
  • 'top' - Di atas diagram.
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> }

color dapat berupa string warna HTML apa pun, misalnya: 'red' atau '#00cc00'. Lihat juga fontName dan fontSize.

Objek Type:
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lebar baris

Lebar garis dalam piksel. Gunakan nol untuk menyembunyikan semua baris dan hanya menampilkan titik.

Jenis: angka
Default: 0
orientasi

Orientasi diagram. Jika ditetapkan ke 'vertical', sumbu sumbu diagram akan dirotasi sehingga (misalnya) diagram kolom menjadi diagram batang, dan diagram area akan tumbuh ke kanan, bukan ke atas:

Jenis: string
Default: 'horizontal'
bentuk Bentuk

Bentuk elemen data individual: 'lingkaran', 'segitiga', 'persegi', 'berlian', 'bintang', atau 'poligon'. Lihat dokumentasi poin untuk mengetahui contohnya.

Jenis: string
Default: 'lingkaran'
pointSize

Diameter titik data, dalam piksel. Gunakan nol untuk menyembunyikan semua titik. Anda dapat mengganti nilai untuk setiap rangkaian menggunakan properti series. Jika Anda menggunakan garis tren, opsi ini juga akan memengaruhi pointSize titik yang menyusunnya, yang akan mengubah lebar garis tren yang terlihat. Untuk menghindari hal ini, Anda dapat menggantinya dengan opsi trendlines.n.pointsize.

Jenis: angka
Default: 7
PointsVisible

Menentukan apakah titik akan ditampilkan. Tetapkan ke false untuk menyembunyikan semua titik. Anda dapat mengganti nilai untuk setiap rangkaian menggunakan properti series. Jika Anda menggunakan garis tren, opsi pointsVisible akan memengaruhi visibilitas titik di semua garis tren, kecuali jika Anda menggantinya dengan opsi trendlines.n.pointsVisible.

Nama ini juga dapat diganti menggunakan peran gaya dalam bentuk "point {visible: true}".

Jenis: boolean
Default: true (benar):
modeMode

Jika selectionMode adalah 'multiple', pengguna dapat memilih beberapa titik data.

Jenis: string
Default: 'single'
serial

Array objek, yang masing-masing menjelaskan format seri yang sesuai dalam diagram. Untuk menggunakan nilai default untuk suatu rangkaian, tentukan objek kosong {}. Jika rangkaian atau nilai tidak ditentukan, nilai global akan digunakan. Setiap objek mendukung properti berikut:

  • color - Warna yang akan digunakan untuk rangkaian ini. Tentukan string warna HTML yang valid.
  • labelInLegend - Deskripsi seri yang muncul di legenda diagram.
  • lineWidth - Mengganti nilai lineWidth global untuk rangkaian ini.
  • pointShape - Mengganti nilai pointShape global untuk rangkaian ini.
  • pointSize - Mengganti nilai pointSize global untuk rangkaian ini.
  • pointsVisible - Mengganti nilai pointsVisible global untuk rangkaian ini.
  • visibleInLegend - Nilai boolean, jika benar (true), berarti seri harus memiliki entri legenda, dan salah (false) berarti tidak boleh. Defaultnya adalah true (benar).

Anda bisa menentukan array objek, yang masing-masingnya berlaku untuk rangkaian dalam urutan yang diberikan, atau Anda dapat menentukan objek dengan setiap turunan memiliki kunci numerik yang menunjukkan rangkaian mana yang diterapkan padanya. Misalnya, dua deklarasi berikut identik, dan mendeklarasikan rangkaian pertama sebagai hitam dan tidak ada dalam legenda, serta yang keempat berwarna merah dan tidak ada dalam 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 ditetapkan sebelumnya dan berfungsi bersama untuk mencapai perilaku diagram atau efek visual tertentu. Saat ini hanya tersedia satu tema:

  • 'maksimal' - Memaksimalkan area diagram, dan menggambar legenda dan semua label di dalam area diagram. Menetapkan opsi berikut: 
    chartArea: {width: '100%', height: '100%'},
legend: {position: 'in'},
titlePosition: 'in', axisTitlesPosition: 'in',
hAxis: {textPosition: 'in'}, vAxis: {textPosition: 'in'}
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:

  • in - Gambar judul di dalam area diagram.
  • out - Gambar judul di luar area diagram.
  • tidak ada - Hapus judul.
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> }

color dapat berupa string warna HTML apa pun, misalnya: 'red' atau '#00cc00'. Lihat juga fontName dan fontSize.

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.ignoreBounds

Jika ditetapkan ke true, memungkinkan gambar tooltip mengalir di luar batas diagram di semua sisi.

Catatan: Ini hanya berlaku untuk tooltip HTML. Jika ini diaktifkan dengan tooltip SVG, setiap overflow di luar batas diagram akan dipangkas. Lihat Menyesuaikan Konten Tooltip untuk detail selengkapnya.

Jenis: boolean
Default: false (salah)
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.showColorCode

Jika true, tampilkan kotak berwarna di samping informasi seri dalam tooltip.

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

color dapat berupa string warna HTML apa pun, misalnya: 'red' atau '#00cc00'. Lihat juga fontName dan fontSize.

Objek Type:
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
tooltip.pemicu

Interaksi pengguna yang menyebabkan tooltip ditampilkan:

  • 'fokus' - Tooltip akan ditampilkan saat pengguna mengarahkan kursor ke elemen.
  • 'tidak ada' - Tooltip tidak akan ditampilkan.
  • 'selection' - Tooltip akan ditampilkan saat pengguna memilih elemen.
Jenis: string
Default: 'fokus'
garis tren

Menampilkan garis tren pada diagram yang mendukungnya. Secara default, garis tren linear digunakan, tetapi ini dapat disesuaikan dengan opsi trendlines.n.type.

Garis tren ditentukan berdasarkan per seri, sehingga biasanya opsi Anda akan terlihat seperti ini: 

var options = {
  trendlines: {
    0: {
      type: 'linear',
      color: 'green',
      lineWidth: 3,
      opacity: 0.3,
      showR2: true,
      visibleInLegend: true
    }
  }
}
Objek Type:
Default: null
trendsline.n.warna

Warna garis tren , yang dinyatakan sebagai nama warna Inggris atau string heksadesimal.

Jenis: string
Default: warna seri default
trenline.n.derajat

Untuk garis tren dari type: 'polynomial', derajat polinomial (2 untuk kuadrat, 3 untuk kubik, dan seterusnya). (Derajat defaultnya dapat berubah dari 3 menjadi 2 dalam rilis Google Chart mendatang.)

Jenis: angka
Default: 3
trenlines.n.labelInLegend

Jika disetel, garis tren akan muncul dalam legenda sebagai string ini.

Jenis: string
Default: null
trendinglines.n.lineWidth

Lebar garis garis tren , dalam piksel.

Jenis: angka
Default: 2
trenlines.n.opacity

Transparansi garis tren , dari 0.0 (transparan) ke 1.0 (buram).

Jenis: angka
Default: 1.0
trenlines.n.pointSize

Garis tren disusun dengan memberi tanda titik pada diagram; opsi yang jarang diperlukan ini memungkinkan Anda menyesuaikan ukuran titik. Opsi lineWidth garis tren biasanya akan lebih disukai. Namun, Anda memerlukan opsi ini jika menggunakan opsi pointSize global dan menginginkan ukuran titik yang berbeda untuk garis tren.

Jenis: angka
Default: 1
trenlines.n.pointsVisible

Garis tren disusun dengan memberi tanda titik pada diagram. Opsi pointsVisible garis tren menentukan apakah titik untuk garis tren tertentu terlihat.

Jenis: boolean
Default: true (benar):
trenlines.n.showR2

Apakah akan menampilkan koefisien determinasi dalam tooltip legenda atau garis tren.

Jenis: boolean
Default: false (salah)
trenlines.n.type

Apakah garis tren adalah 'linear' (default), 'exponential', atau 'polynomial'.

Jenis: string
Default: linear
trenlines.n.visibleInLegend

Apakah persamaan garis tren muncul dalam legenda. (Label ini akan muncul di tooltip garis tren.)

Jenis: boolean
Default: false (salah)
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 vAxis yang menentukan dasar pengukuran sumbu vertikal. Jika dasar pengukuran lebih besar dari garis petak tertinggi atau lebih kecil dari garis petak terendah, garis dasar akan dibulatkan ke garis kisi terdekat.

Jenis: angka
Default: otomatis
vAxis.baselineColor

Menentukan warna dasar pengukuran untuk sumbu vertikal. Dapat berupa string warna HTML apa pun, misalnya: 'red' atau '#00cc00'.

Jenis: angka
Default: 'hitam'
vAxis.direction

Arah pertumbuhan nilai di sepanjang sumbu vertikal. Secara default, nilai rendah berada di bagian bawah diagram. Tentukan -1 untuk membalik urutan nilai.

Jenis: 1 atau -1
Default: 1
format vAxis

String format untuk label sumbu numerik. Ini adalah subset dari kumpulan pola ICU . Misalnya, {format:'#,###%'} akan menampilkan nilai "1.000%", "750%", dan "50%" untuk nilai 10, 7.5, dan 0.5. Anda juga dapat menyediakan salah satu dari hal berikut:

  • {format: 'none'}: menampilkan angka tanpa format (mis., 8000000)
  • {format: 'decimal'}: menampilkan angka dengan pemisah ribuan (misalnya, 8.000.000)
  • {format: 'scientific'}: menampilkan angka dalam notasi ilmiah (misalnya, 8e6)
  • {format: 'currency'}: menampilkan angka dalam mata uang lokal (misalnya, $8.000.000,00)
  • {format: 'percent'}: menampilkan angka sebagai persentase (misalnya, 800.000.000%)
  • {format: 'short'}: menampilkan angka yang disingkat (misalnya, 8 JT)
  • {format: 'long'}: menampilkan angka sebagai kata lengkap (misalnya, 8 juta)

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 format:"#" jika hanya ingin menampilkan nilai centang bilangan bulat, tetapi perhatikan bahwa jika tidak ada alternatif yang memenuhi kondisi ini, tidak ada garis petak atau tick yang akan ditampilkan.

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 gridlines.count, angka tersebut akan digunakan untuk menghitung minSpacing di antara garis kisi. Anda dapat menentukan nilai 1 untuk hanya menggambar satu garis petak, atau 0 untuk tidak menggambar garis kisi. Tentukan -1, yang merupakan default, untuk menghitung jumlah garis kisi secara otomatis berdasarkan opsi lain.

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 vAxis yang membuat sumbu vertikal menjadi skala logaritmik. Dapat berupa salah satu dari hal berikut:

  • null - Tidak ada penskalaan logaritmik yang dilakukan.
  • 'log' - Penskalaan logaritmik. Nilai negatif dan nol tidak dipetakan. Opsi ini sama dengan setelan vAxis: { logscale: true }.
  • 'mirrorLog' - Penskalaan logaritmik dengan nilai negatif dan nol dipetakan. Nilai dipetakan angka negatif adalah negatif dari log nilai absolut. Nilai yang mendekati 0 dipetakan pada skala linear.
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> }

color dapat berupa string warna HTML apa pun, misalnya: 'red' atau '#00cc00'. Lihat juga fontName dan fontSize.

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 v untuk nilai centang, dan properti f opsional yang berisi string literal yang akan ditampilkan sebagai label.

ViewWindow akan otomatis diperluas untuk menyertakan tick minimum dan maksimum, kecuali jika Anda menentukan viewWindow.min atau viewWindow.max yang akan diganti.

Contoh:

  • vAxis: { ticks: [5,10,15,20] }
  • vAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
  • vAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
  • vAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }
Jenis: Array elemen
Default: otomatis
vAxis.title

Properti vAxis yang menentukan judul untuk sumbu vertikal.

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

color dapat berupa string warna HTML apa pun, misalnya: 'red' atau '#00cc00'. Lihat juga fontName dan fontSize.

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. vAxis.viewWindow.max mengganti properti ini.

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. vAxis.viewWindow.min mengganti properti ini.

Jenis: angka
Default: null
vAxis.viewWindowMode

Menentukan cara menskalakan sumbu vertikal untuk merender nilai dalam area diagram. Nilai string berikut didukung:

  • 'pretty' - Skalakan nilai vertikal sehingga nilai data maksimum dan minimum dirender sedikit di dalam bagian bawah dan atas area diagram. viewWindow diperluas ke garis petak utama terdekat untuk angka, atau garis kisi kecil terdekat untuk tanggal dan waktu.
  • 'maksimal' - Menskalakan nilai vertikal sehingga nilai data maksimum dan minimum menyentuh bagian atas dan bawah area diagram. Hal ini akan menyebabkan vaxis.viewWindow.min dan vaxis.viewWindow.max diabaikan.
  • 'eksplisit' - Opsi yang tidak digunakan lagi untuk menentukan nilai skala atas dan bawah dari area diagram. (Tidak digunakan lagi karena redundan dengan vaxis.viewWindow.min dan vaxis.viewWindow.max. Nilai data di luar nilai tersebut akan dipangkas. Anda harus menentukan objek vAxis.viewWindow yang menjelaskan nilai maksimum dan minimum untuk ditampilkan.
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 vAxis.viewWindowMode adalah 'pretty' atau 'maksimal'.

Jenis: angka
Default: otomatis
vAxis.viewWindow.min

Nilai data vertikal minimum yang akan dirender.

Diabaikan saat vAxis.viewWindowMode adalah 'pretty' atau 'maksimal'.

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 ready diaktifkan. Extended description

Jenis Hasil: tidak ada
getAction(actionID)

Menampilkan objek tindakan tooltip dengan actionID yang diminta.

Return Type:
getBoundingBox(id)

Menampilkan objek yang berisi kiri, atas, lebar, dan tinggi elemen diagram id. Format untuk id belum didokumentasikan (ini adalah nilai hasil pengendali peristiwa), tetapi berikut adalah beberapa contohnya:

var cli = chart.getChartLayoutInterface();

Ketinggian area diagram
cli.getBoundingBox('chartarea').height
Lebar batang ketiga dalam rangkaian pertama diagram batang atau kolom
cli.getBoundingBox('bar#0#2').width
Kotak pembatas pada dudukan kelima diagram lingkaran
cli.getBoundingBox('slice#4')
Kotak pembatas data diagram dari diagram vertikal (misalnya: kolom):
cli.getBoundingBox('vAxis#0#gridline')
Kotak pembatas data diagram dari diagram horizontal (misalnya, batang):
cli.getBoundingBox('hAxis#0#gridline')

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):

var cli = chart.getChartLayoutInterface();

cli.getChartAreaBoundingBox().left
cli.getChartAreaBoundingBox().top
cli.getChartAreaBoundingBox().height
cli.getChartAreaBoundingBox().width

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:

  • getBoundingBox
  • getChartAreaBoundingBox
  • getHAxisValue
  • getVAxisValue
  • getXLocation
  • getYLocation

Panggil ini setelah diagram digambar.

Return Type:
getHAxisValue(xPosition, optional_axis_index)

Menampilkan nilai data horizontal pada xPosition, yang merupakan offset piksel dari tepi kiri penampung diagram. Dapat bernilai negatif.

Contoh: chart.getChartLayoutInterface().getHAxisValue(400).

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 entri poin dan legenda. Titik sesuai dengan sel di tabel data, dan entri legenda ke kolom (indeks baris adalah null). Untuk diagram ini, hanya satu entitas yang dapat dipilih pada waktu tertentu. Extended description

Jenis Hasil: Array elemen pilihan
getVAxisValue(yPosition, optional_axis_index)

Menampilkan nilai data vertikal di yPosition, yang merupakan offset piksel ke bawah dari tepi atas penampung diagram. Dapat bernilai negatif.

Contoh: chart.getChartLayoutInterface().getVAxisValue(300).

Panggil ini setelah diagram digambar.

Jenis Hasil: angka
getXLocation(dataValue, optional_axis_index)

Menampilkan koordinat x piksel dataValue yang relatif terhadap tepi kiri penampung diagram.

Contoh: chart.getChartLayoutInterface().getXLocation(400).

Panggil ini setelah diagram digambar.

Jenis Hasil: angka
getYLocation(dataValue, optional_axis_index)

Menampilkan koordinat y piksel dataValue relatif terhadap tepi atas penampung diagram.

Contoh: chart.getChartLayoutInterface().getYLocation(300).

Panggil ini setelah diagram digambar.

Jenis Hasil: angka
removeAction(actionID)

Menghapus tindakan tooltip dengan actionID yang diminta dari diagram.

Jenis Hasil: none
setAction(action)

Menetapkan tindakan tooltip yang akan dijalankan saat pengguna mengklik teks tindakan.

Metode setAction menggunakan objek sebagai parameter tindakannya. Objek ini harus menentukan 3 properti: id— ID tindakan yang ditetapkan, text —teks yang akan muncul di tooltip untuk tindakan, dan action — fungsi yang harus dijalankan saat pengguna mengklik teks tindakan.

Setiap dan semua tindakan tooltip harus ditetapkan sebelum memanggil metode draw() diagram. Deskripsi yang diperluas.

Jenis Hasil: none
setSelection()

Memilih entitas diagram yang ditentukan. Membatalkan pilihan sebelumnya. Entitas yang dapat dipilih adalah entri poin dan legenda. Titik sesuai dengan sel di tabel data, dan entri legenda ke kolom (indeks baris adalah null). Untuk diagram ini, hanya satu entitas yang dapat dipilih sekaligus. Extended description

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.

Properti: baris, kolom
onmouseout

Diaktifkan saat pengguna mouse menjauh dari entitas visual. Meneruskan kembali indeks baris dan kolom dari elemen tabel data yang sesuai.

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 draw, dan memanggilnya hanya setelah peristiwa diaktifkan.

Properti: tidak ada
select

Diaktifkan saat pengguna mengklik entitas visual. Untuk mempelajari apa yang telah dipilih, panggil getSelection().

Properti: tidak ada

Kebijakan data

Semua kode dan data diproses dan dirender di browser. Tidak ada data yang dikirim ke server mana pun.