Diagram Area Melangkah

Ringkasan

Diagram area bertahap yang dirender dalam browser menggunakan SVG atau VML. Menampilkan tips saat mengarahkan kursor ke langkah.

Contoh Sederhana

<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([
          ['Director (Year)',  'Rotten Tomatoes', 'IMDB'],
          ['Alfred Hitchcock (1935)', 8.4,         7.9],
          ['Ralph Thomas (1959)',     6.9,         6.5],
          ['Don Sharp (1978)',        6.5,         6.4],
          ['James Hawes (2008)',      4.4,         6.2]
        ]);

        var options = {
          title: 'The decline of \'The 39 Steps\'',
          vAxis: {title: 'Accumulated Rating'},
          isStacked: true
        };

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

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

Beberapa Opsi Umum

Seperti semua Diagram Google, diagram area bertahap memiliki banyak opsi, yang ditampilkan di sini. Berikut adalah contoh yang menunjukkan beberapa hal yang paling umum:

Pada diagram di atas, kami telah mengubah warna latar belakang dengan backgroundColor, memindahkan legenda ke bawah dengan legend.position, menghapus garis vertikal dengan menyetel connectSteps ke salah, dan menyesuaikan warna. Berikut adalah cara melakukannya:

  var options = {
      backgroundColor: '#ddd',
      legend: { position: 'bottom' },
      connectSteps: false,
      colors: ['#4374E0', '#53A8FB', '#F1CA3A', '#E49307'],
      isStacked: true,
  };

Diagram Area yang Ditumpuk

Diagram area berundak juga mendukung penumpukan, termasuk penumpukan 100%. Diagram area berundak yang bertumpuk adalah diagram area bertahap yang menempatkan nilai terkait di atas satu sama lain. Jika ada nilai negatif, nilai tersebut ditumpuk dalam urutan terbalik di bawah garis dasar diagram. Untuk menumpuk 100%, tumpukan elemen di setiap nilai domain diskalakan ulang sehingga berjumlah hingga 100%. Opsi untuk ini adalah isStacked: 'percent', yang memformat setiap nilai sebagai persentase 100%, dan isStacked: 'relative', yang memformat setiap nilai sebagai pecahan 1. Ada juga opsi isStacked: 'absolute', yang secara fungsional setara dengan isStacked: true.

Perhatikan bahwa pada diagram tumpuk 100% di sebelah kanan, nilai centang ditulis berdasarkan skala 0-1 relatif sebagai pecahan 1.

Menumpuk
        var options_stacked = {
          isStacked: true,
          height: 300,
          legend: {position: 'top', maxLines: 3},
          vAxis: {minValue: 0}
        };
    
100% Ditumpuk
        var options_fullStacked = {
          isStacked: 'relative',
          height: 300,
          legend: {position: 'top', maxLines: 3},
          vAxis: {
            minValue: 0,
            ticks: [0, .3, .6, .9, 1]
          }
        };
    

Memuat

Nama paket google.charts.load adalah "corechart".

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

Nama class visualisasinya adalah google.visualization.SteppedAreaChart.

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

Format Data

Baris: Setiap baris dalam tabel mewakili grup batang.

Kolom:

  Kolom 0 Kolom 1 ... Kolom N
Tujuan: Label grup sumbu X Nilai batang 1 dalam grup ini ... Nilai N batang di grup ini
Jenis Data: string angka ... angka
Peran: domain data ... data
Peran kolom opsional: ...

 

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
opasitas area

Opasitas default area di bawah langkah, dengan 0,0 sepenuhnya transparan dan 1,0 sepenuhnya buram. Tidak memengaruhi opasitas garis berundak. Untuk mencapai diagram garis bertahap, tetapkan nilai ini ke 0. Untuk menentukan opasitas untuk setiap rangkaian, tetapkan nilai areaOpacity dalam properti series.

Jenis: angka, 0,0–1,0
Default: 0,3
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'
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
ConnectSteps

Jika disetel ke benar (true), akan menghubungkan langkah-langkah untuk membentuk garis bertahap. Jika tidak, hanya baris atas yang muncul. Setelan defaultnya adalah menghubungkan langkah-langkah.

Jenis: boolean
Default: true (benar):
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):
targetTarget

Jenis entitas yang menerima fokus saat kursor diarahkan ke kursor. Juga memengaruhi entity mana yang dipilih oleh klik mouse, dan elemen tabel data mana yang terkait dengan peristiwa. Dapat berupa salah satu dari hal berikut:

  • 'datum' - Fokus pada satu titik data. Korelasi dengan sel dalam tabel data.
  • 'category' - Memfokuskan pada pengelompokan semua titik data di sepanjang sumbu utama. Berkaitan dengan baris di tabel data.

Dalam FocusTarget 'category', tooltip menampilkan semua nilai kategori. Tindakan ini mungkin berguna untuk membandingkan nilai rangkaian yang berbeda.

Jenis: string
Default: 'datum'
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.direction

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

Jenis: 1 atau -1
Default: 1
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.allowContainerBoundaryTextCutoff

Jika salah, akan menyembunyikan label terluar, bukan membiarkannya dipangkas oleh penampung diagram. Jika true (benar), akan memungkinkan pemangkasan label.

Jenis: boolean
Default: false (salah)
Teks hAxis.slanted

Jika true, gambar teks sumbu horizontal pada suatu sudut untuk membantu menyesuaikan lebih banyak teks di sepanjang sumbu; jika salah, gambar teks sumbu horizontal dengan tegak. Perilaku defaultnya adalah teks miring jika tidak semuanya pas saat digambar tegak. Perhatikan bahwa opsi ini hanya tersedia jika hAxis.textPosition ditetapkan ke 'out' (yang merupakan default). Defaultnya adalah false untuk tanggal dan waktu.

Jenis: boolean
Default: otomatis
hAxis.slantedTextAngle

Sudut teks sumbu horizontal, jika digambar miring. Diabaikan jika hAxis.slantedText adalah false, atau dalam mode otomatis, dan diagram memutuskan untuk menggambar teks secara horizontal. Jika sudutnya positif, rotasi berlawanan arah jarum jam, dan jika negatif, searah jarum jam.

Jenis: angka, -90—90
Default: 30
hAxis.maxAlternation

Jumlah tingkat maksimum teks sumbu horizontal. Jika label teks sumbu terlalu padat, server dapat menggeser label yang berdekatan ke atas atau ke bawah agar pas dengan label yang berdekatan. Nilai ini menentukan jumlah level yang paling banyak digunakan; server dapat menggunakan lebih sedikit level, jika label dapat disesuaikan tanpa tumpang tindih. Untuk tanggal dan waktu, default-nya adalah 1.

Jenis: angka
Default: 2
hAxis.maxTextLines

Jumlah baris maksimum yang diizinkan untuk label teks. Label dapat mencakup beberapa baris jika terlalu panjang, dan secara default jumlah baris dibatasi oleh tinggi ruang yang tersedia.

Jenis: angka
Default: otomatis
hAxis.minTextSpacing

Spasi horizontal minimum, dalam piksel, yang diizinkan di antara dua label teks yang berdekatan. Jika label diberi spasi yang terlalu padat, atau terlalu panjang, spasinya dapat berada di bawah batas ini, dan dalam hal ini salah satu tindakan penghapusan label akan diterapkan (misalnya, memotong label atau menghapus beberapa label).

Jenis: angka
Default: Nilai hAxis.textStyle.fontSize
hAxis.showTextSetiap

Jumlah label sumbu horizontal yang akan ditampilkan, dengan 1 berarti setiap label, 2 berarti setiap label lainnya, dan seterusnya. Defaultnya adalah mencoba menampilkan sebanyak mungkin label tanpa tumpang-tindih.

Jenis: angka
Default: otomatis
hAxis.viewWindow

Menentukan rentang pemangkasan sumbu horizontal.

Objek Type:
Default: null
hAxis.viewWindow.max

Indeks baris berbasis nol tempat periode pemangkasan berakhir. Titik data pada indeks ini dan yang lebih tinggi akan dipangkas. Bersama vAxis.viewWindowMode.min, menentukan rentang setengah terbuka [min, maks) yang menunjukkan indeks elemen yang akan ditampilkan. Dengan kata lain, setiap indeks sedemikian rupa sehingga min <= index < max akan ditampilkan.

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

Jenis: angka
Default: otomatis
hAxis.viewWindow.min

Indeks baris berbasis nol tempat periode pemangkasan dimulai. Titik data pada indeks yang lebih rendah dari ini akan dipangkas. Bersama vAxis.viewWindowMode.max, menentukan rentang setengah terbuka [min, maks) yang menunjukkan indeks elemen yang akan ditampilkan. Dengan kata lain, setiap indeks sedemikian rupa sehingga min <= index < max akan ditampilkan.

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

Jenis: angka
Default: otomatis
tinggi

Tinggi diagram, dalam piksel.

Jenis: angka
Default: tinggi elemen penampung
Ditumpuk

Jika disetel ke benar (true), tumpukan elemen untuk semua seri di setiap nilai domain. Catatan: Pada diagram Kolom, Area, dan SteppedArea, Google Chart membalik urutan item legenda agar lebih sesuai dengan tumpukan elemen seri (misalnya, seri 0 akan menjadi item legenda paling bawah). Ini tidak berlaku untuk Diagram Batang.

Opsi isStacked juga mendukung stacking 100%, dan stack elemen pada setiap nilai domain diskalakan ulang hingga mencapai 100%.

Opsi untuk isStacked adalah:

  • false — elemen tidak akan ditumpuk. Ini adalah opsi default.
  • true — menumpuk elemen untuk semua rangkaian di setiap nilai domain.
  • 'percent' — menumpuk elemen untuk semua rangkaian di setiap nilai domain dan menskalakannya kembali hingga mencapai 100%, dengan nilai setiap elemen dihitung sebagai persentase 100%.
  • 'relative' — menumpuk elemen untuk semua rangkaian di setiap nilai domain dan menskalakannya kembali sehingga menambahkan hingga 1, dengan setiap nilai elemen dihitung sebagai pecahan 1.
  • 'absolute' — berfungsi sama seperti isStacked: true.

Untuk penumpukan 100%, nilai yang dihitung untuk setiap elemen akan muncul di tooltip setelah nilai yang sebenarnya.

Sumbu target akan ditetapkan secara default ke nilai skala berdasarkan skala 0-1 relatif sebagai pecahan 1 untuk 'relative', dan 0-100% untuk 'percent' (Catatan: saat menggunakan opsi 'percent', nilai sumbu/centang ditampilkan sebagai persentase, tetapi nilai sebenarnya adalah nilai skala 0-1 relatif. Hal ini karena tick sumbu persentase adalah hasil penerapan format "#.##%" ke nilai skala 0-1 relatif. Saat menggunakan isStacked: 'percent', pastikan untuk menentukan tick/gridline apa pun menggunakan nilai skala 0-1 relatif). Anda dapat menyesuaikan nilai petak dan nilai skala serta pemformatan menggunakan opsi hAxis/vAxis yang sesuai.

Penumpukan 100% hanya mendukung nilai data jenis number, dan harus memiliki dasar pengukuran nol.

Jenis: boolean/string
Default: false (salah)
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
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>}
GayaDashline

Pola aktif dan nonaktif untuk garis putus-putus. Misalnya, [4, 4] akan mengulangi tanda hubung 4 panjang yang diikuti dengan celah 4 panjang, dan [5, 1, 3] akan mengulangi tanda hubung 5 panjang, celah 1 panjang, tanda hubung 3 panjang, celah 5 panjang, tanda hubung 1 panjang, dan celah 3 panjang. Lihat Garis Putus-Putus untuk informasi selengkapnya.

Jenis: Array angka
Default: null
reverseKategori

Jika disetel ke benar, akan menggambar rangkaian dari kanan ke kiri. Defaultnya adalah menggambar kiri-ke-kanan.

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

  • areaOpacity - Mengganti areaOpacity global untuk seri ini.
  • color - Warna yang akan digunakan untuk rangkaian ini. Tentukan string warna HTML yang valid.
  • labelInLegend - Deskripsi seri yang muncul di legenda diagram.
  • lineDashStyle - Mengganti nilai lineDashStyle global untuk rangkaian ini.
  • targetAxisIndex - Sumbu mana yang akan ditetapkan untuk rangkaian ini, dengan 0 adalah sumbu default, dan 1 adalah sumbu yang berlawanan. Nilai defaultnya adalah 0; tetapkan ke 1 untuk menentukan diagram tempat serial yang berbeda dirender terhadap sumbu yang berbeda. Setidaknya satu seri dapat dialokasikan ke sumbu default. Anda dapat menentukan skala yang berbeda untuk sumbu yang berbeda.
  • 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. Defaultnya adalah true jika focusTarget ditetapkan ke 'category', atau default ke false.

Jenis: boolean
Default: otomatis
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'
Vaksin

Menentukan properti untuk sumbu vertikal masing-masing, jika diagram memiliki beberapa sumbu vertikal. Setiap objek turunan adalah objek vAxis, dan dapat berisi semua properti yang didukung oleh vAxis. Nilai properti ini menggantikan setelan global apa pun untuk properti yang sama.

Untuk menentukan diagram dengan beberapa sumbu vertikal, tentukan sumbu baru terlebih dahulu menggunakan series.targetAxisIndex, lalu konfigurasikan sumbu menggunakan vAxes. Contoh berikut menetapkan seri 2 ke sumbu kanan, lalu menentukan gaya kustom dan judul:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

Properti ini dapat berupa objek atau array: objek adalah kumpulan objek, masing-masing dengan label numerik yang menentukan sumbu yang ditentukannya - ini adalah format yang ditampilkan di atas; array adalah array objek, satu per sumbu. Misalnya, notasi gaya array berikut identik dengan objek vAxis yang ditampilkan di atas:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    
Jenis: Array objek, atau objek dengan objek turunan
Default: null
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
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
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 langkah, entri legenda, dan kategori. Langkah sesuai dengan sel dalam tabel data, entri legenda ke kolom (indeks baris adalah null), dan kategori ke baris (indeks kolom bernilai 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 langkah, entri legenda, dan kategori. Langkah sesuai dengan sel dalam tabel data, entri legenda ke kolom (indeks baris adalah null), dan kategori ke baris (indeks kolom bernilai 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.