Diagram Area yang Dilangkah

Ringkasan

Diagram area berundak 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 Google Chart, diagram area berundak memiliki banyak opsi, yang ditampilkan di sini. Berikut adalah contoh yang menunjukkan beberapa hal yang paling umum:

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

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

Diagram Area Bertumpuk

Diagram area berundak juga mendukung penumpukan, termasuk 100% penumpukan. Diagram area berundak adalah diagram area berundak yang menempatkan nilai terkait di atas satu sama lain. Jika ada nilai negatif, nilai tersebut akan ditumpuk dalam urutan terbalik di bawah dasar pengukuran diagram. Untuk penumpukan 100%, tumpukan elemen di setiap nilai domain akan diskalakan ulang sedemikian rupa sehingga jumlahnya mencapai 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 dalam diagram bertumpuk 100% di sebelah kanan, nilai tick ditulis berdasarkan skala relatif 0-1 sebagai pecahan 1.

Bertumpuk
        var options_stacked = {
          isStacked: true,
          height: 300,
          legend: {position: 'top', maxLines: 3},
          vAxis: {minValue: 0}
        };
    
100% Bertumpuk
        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 visualisasi adalah google.visualization.SteppedAreaChart.

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

Format Data

Baris: Setiap baris dalam tabel mewakili sekelompok batang.

Kolom:

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

 

Opsi Konfigurasi

Name
aggregationTarget
Cara beberapa pilihan data digabungkan ke dalam tooltip:
  • 'category': Mengelompokkan data yang dipilih berdasarkan nilai x.
  • 'series': Mengelompokkan data yang dipilih menurut deret.
  • 'auto': Mengelompokkan data yang dipilih menurut nilai x jika semua pilihan memiliki nilai x yang sama, dan menurut deret jika tidak.
  • 'none': Hanya menampilkan satu tooltip per pilihan.
aggregationTarget akan sering digunakan bersama 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'
animation.duration

Durasi animasi, dalam milidetik. Untuk detailnya, lihat dokumentasi animasi.

Jenis: nomor
Default: 0
animation.easing

Fungsi easing yang diterapkan pada animasi. Tersedia opsi-opsi berikut:

  • 'linear' - Kecepatan konstan.
  • 'in' - Kemudahan masuk - Mulai dengan lambat lalu percepat.
  • 'out' - Mengurangi - Mulai dengan cepat dan perlahan.
  • 'inAndOut' - Mudah masuk dan keluar - Mulai perlahan, percepat, lalu perlambat.
Jenis: string
Default: 'linear'
animation.startup

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

Jenis: boolean
Default false
areaOpacity

Opasitas default area di bawah langkah, dengan 0,0 sepenuhnya transparan dan 1,0 sepenuhnya tidak tembus pandang. Tidak memengaruhi opasitas garis berundak. Untuk mencapai diagram garis berundak, tetapkan nilai ini ke 0. Guna menentukan opasitas bagi masing-masing deret, tetapkan nilai areaOpacity dalam properti series.

Jenis: angka, 0.0–1.0
Default: 0,3
axisTitlesPosition

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

  • in - Menggambar judul sumbu di dalam area bagan.
  • out - Menggambar judul sumbu di luar area diagram.
  • tidak ada - Menghilangkan judul sumbu.
Jenis: string
Default: 'out'
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 batas diagram, sebagai string warna HTML.

Jenis: string
Default: '#666'
backgroundColor.strokeWidth

Lebar pembatas, dalam piksel.

Jenis: nomor
Default: 0
backgroundColor.fill

Warna pengisi diagram, sebagai string warna HTML.

Jenis: string
Default: 'putih'
chartArea

Objek dengan anggota untuk mengonfigurasi penempatan dan ukuran area diagram (tempat diagram itu sendiri digambar, tidak termasuk sumbu dan legenda). Dua format didukung: angka, atau angka yang diikuti dengan %. Angka sederhana adalah nilai dalam piksel; angka yang diikuti dengan % adalah persentase. Contoh: chartArea:{left:20,top:0,width:'50%',height:'75%'}

Jenis: objek
Default: null
chartArea.backgroundColor
Warna latar belakang area diagram. Jika digunakan, string dapat berupa string heksadesimal (misalnya, '#fdc') atau nama warna bahasa Inggris. Saat sebuah objek digunakan, properti berikut dapat diberikan:
  • stroke: warna, disediakan sebagai string heksadesimal atau nama warna bahasa Inggris.
  • strokeWidth: jika disediakan, menggambar batas di sekitar area diagram dengan lebar yang ditentukan (dan dengan warna stroke).
Jenis: string atau objek
Default: 'putih'
chartArea.left

Seberapa jauh menggambar diagram dari batas kiri.

Jenis: angka atau string
Default: otomatis
chartArea.top

Seberapa jauh menggambar diagram dari batas atas.

Jenis: angka atau string
Default: otomatis
chartArea.width

Lebar area diagram.

Jenis: angka atau string
Default: otomatis
chartArea.height

Tinggi area diagram.

Jenis: angka atau string
Default: otomatis
warna

Warna yang akan digunakan untuk elemen diagram. Array string, dengan setiap elemennya adalah string warna HTML, misalnya: colors:['red','#004411'].

Jenis: Array string
Default: warna default
connectSteps

Jika disetel ke true, akan menghubungkan langkah-langkah untuk membentuk garis berundak. Jika tidak, hanya baris teratas yang akan muncul. Defaultnya adalah menghubungkan langkah-langkah.

Jenis: boolean
Default: benar (true)
enableInteractivity

Apakah diagram menampilkan peristiwa berbasis pengguna atau bereaksi terhadap interaksi pengguna. Jika salah, diagram tidak akan menampilkan peristiwa 'select' atau peristiwa berbasis interaksi lainnya (tetapi akan menampilkan peristiwa siap atau error), dan tidak akan menampilkan teks informasi atau berubah, bergantung pada input pengguna.

Jenis: boolean
Default: benar (true)
focusTarget

Jenis entitas yang menerima fokus pada pengarahan kursor mouse. Juga memengaruhi entity yang dipilih oleh klik mouse, dan elemen tabel data yang dikaitkan dengan peristiwa. Dapat berupa salah satu dari hal berikut:

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

Di focusTarget 'category', tooltip menampilkan semua nilai kategori. Cara ini mungkin berguna untuk membandingkan nilai berbagai deret.

Jenis: string
Default: 'datum'
fontSize

Ukuran font default, dalam piksel, untuk semua teks dalam diagram. Anda dapat menggantinya menggunakan properti untuk elemen diagram tertentu.

Jenis: nomor
Default: otomatis
fontName

Tampilan font default untuk semua teks dalam diagram. Anda dapat menggantinya menggunakan properti untuk elemen diagram tertentu.

Jenis: string
Default: 'XXXXXXXX'
forceIFrame

Menggambar diagram di dalam bingkai inline. (Perhatikan bahwa pada IE8, opsi ini diabaikan; semua diagram IE8 digambar dalam i-frame.)

Jenis: boolean
Default: false
hAxis

Objek dengan anggota untuk mengonfigurasi berbagai elemen sumbu horizontal. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditunjukkan di sini:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
Jenis: objek
Default: null
hAxis.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: 'out'
hAxis.textStyle

Objek yang menetapkan 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.

Jenis: objek
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.ticks

Mengganti tanda petik sumbu X yang dihasilkan secara otomatis dengan array yang ditentukan. Setiap elemen array harus berupa nilai tick yang valid (seperti angka, tanggal, datetime, atau waktu), atau sebuah objek. Jika berupa objek, objek tersebut harus memiliki properti v untuk nilai tick, dan properti f opsional yang berisi string literal untuk ditampilkan sebagai label.

ViewWindow akan otomatis diperluas untuk menyertakan tick min dan maks 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 menetapkan 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.

Jenis: objek
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.allowContainerBoundaryTextCutoff

Jika salah (false), label terluar akan disembunyikan, bukan sehingga dapat dipangkas oleh penampung diagram. Jika true (benar), pemangkasan label akan diizinkan.

Jenis: boolean
Default: false
hAxis.slantedText

Jika true (benar), gambar teks sumbu horizontal pada sudut tertentu, untuk membantu menyesuaikan lebih banyak teks di sepanjang sumbu; jika salah, gambar teks sumbu horizontal secara tegak. Perilaku defaultnya adalah teks miring jika tidak semuanya muat saat digambar tegak. Perhatikan bahwa opsi ini hanya tersedia jika hAxis.textPosition ditetapkan ke 'out' (yang merupakan default). Setelan default-nya 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, rotasinya berlawanan arah jarum jam, dan jika negatif, maka rotasinya adalah searah jarum jam.

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

Jumlah maksimum tingkat teks sumbu horizontal. Jika label teks sumbu terlalu padat, server mungkin akan memindahkan label yang berdekatan ke atas atau ke bawah agar label berdekatan. Nilai ini menentukan jumlah tingkat paling banyak yang akan digunakan; server dapat menggunakan lebih sedikit tingkat, jika label dapat dimuat tanpa tumpang-tindih. Untuk tanggal dan waktu, defaultnya adalah 1.

Jenis: nomor
Default: 2
hAxis.maxTextLines

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

Jenis: nomor
Default: otomatis
hAxis.minTextSpacing

Spasi horizontal minimum, dalam piksel, diizinkan di antara dua label teks yang berdekatan. Jika jarak label terlalu padat atau terlalu panjang, jaraknya bisa turun di bawah batas ini, dan dalam hal ini salah satu ukuran label yang tidak rapi akan diterapkan (misalnya, memotong label atau membuang sebagian).

Jenis: nomor
Default: Nilai hAxis.textStyle.fontSize
hAxis.showTextEvery

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

Jenis: nomor
Default: otomatis
hAxis.viewWindow

Menentukan rentang pemangkasan sumbu horizontal.

Jenis: objek
Default: null
hAxis.viewWindow.max

Indeks baris berbasis nol tempat periode pemangkasan berakhir. Titik data pada indeks ini dan yang lebih tinggi akan dipangkas. Sehubungan dengan vAxis.viewWindowMode.min, rentang ini 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 jika hAxis.viewWindowMode bersifat 'cantik' atau 'dimaksimalkan'.

Jenis: nomor
Default: otomatis
hAxis.viewWindow.min

Indeks baris berbasis nol tempat periode pemangkasan dimulai. Titik data pada indeks yang lebih rendah dari ini akan dipangkas. Sehubungan dengan vAxis.viewWindowMode.max, rentang ini 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 jika hAxis.viewWindowMode bersifat 'cantik' atau 'dimaksimalkan'.

Jenis: nomor
Default: otomatis
tinggi

Tinggi diagram, dalam piksel.

Jenis: nomor
Default: tinggi elemen yang memuatnya
isStacked

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

Opsi isStacked juga mendukung penumpukan 100%, yaitu tumpukan elemen pada setiap nilai domain diskalakan ulang agar jumlahnya mencapai 100%.

Opsi untuk isStacked adalah:

  • false — elemen tidak akan ditumpuk. Ini adalah opsi default.
  • true — menumpuk elemen untuk semua deret di setiap nilai domain.
  • 'percent' — menumpuk elemen untuk semua deret di setiap nilai domain dan menskalakan ulangnya agar bertambah hingga 100%, dengan nilai setiap elemen dihitung sebagai persentase 100%.
  • 'relative' — menumpuk elemen untuk semua deret di setiap nilai domain dan menskalakan ulangnya sehingga jumlahnya menjadi 1, dengan nilai setiap elemen dihitung sebagai pecahan 1.
  • 'absolute' — berfungsi sama dengan isStacked: true.

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

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

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

Jenis: boolean/string
Default: false
legenda

Objek dengan anggota untuk mengonfigurasi berbagai aspek legenda. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditunjukkan di sini:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Jenis: objek
Default: null
legend.alignment

Perataan legenda. Dapat berupa salah satu dari hal berikut:

  • 'start' - Diratakan dengan awal area yang dialokasikan untuk legenda.
  • 'center' - Dipusatkan pada area yang dialokasikan untuk legenda.
  • 'end' - Disejajarkan dengan akhir area yang dialokasikan untuk legenda.

Awal, tengah, dan akhir berhubungan dengan gaya -- vertikal atau horizontal -- legenda. Misalnya, pada legenda 'kanan', 'start' dan 'end' masing-masing berada di bagian atas dan bawah; untuk legenda 'top', 'start' dan 'end' akan berada di sebelah kiri dan kanan area tersebut.

Nilai default-nya bergantung pada posisi legenda. Untuk legenda 'bawah', defaultnya adalah 'center'; legenda lainnya ditetapkan secara default ke 'start'.

Jenis: string
Default: otomatis
legend.maxLines

Jumlah baris maksimum dalam legenda. Tetapkan string ini ke angka yang lebih besar dari satu untuk menambahkan garis ke legenda. Catatan: Logika sebenarnya yang digunakan untuk menentukan jumlah baris sebenarnya yang dirender masih dalam fluks.

Opsi ini saat ini hanya berfungsi jika legend.position adalah 'top'.

Jenis: nomor
Default: 1
legend.position

Posisi legenda. Dapat berupa salah satu dari hal berikut:

  • 'bottom' - Di bawah diagram.
  • 'left' - Di sebelah kiri diagram, asalkan sumbu kiri tidak memiliki deret yang terkait dengannya. Jadi, jika Anda ingin legenda di sebelah kiri, gunakan opsi targetAxisIndex: 1.
  • 'in' - Di dalam diagram, di sudut kiri atas.
  • 'none' - Tidak ada legenda yang ditampilkan.
  • 'right' - Di sebelah kanan diagram. Tidak kompatibel dengan opsi vAxes.
  • 'top' - Di atas diagram.
Jenis: string
Default: 'right'
legend.textStyle

Objek yang menetapkan gaya teks legenda. Objek memiliki format ini:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

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

Jenis: objek
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lineDashStyle

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

Jenis: Array angka
Default: null
reverseCategories

Jika disetel ke true, akan menggambar deret dari kanan ke kiri. Defaultnya adalah menggambar dari kiri ke kanan.

Jenis: boolean
Default: false
selectionMode

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

Jenis: string
Default: 'tunggal'
series

Array objek, masing-masing menjelaskan format deret yang sesuai dalam diagram. Untuk menggunakan nilai default rangkaian, tetapkan objek kosong {}. Jika rangkaian atau nilai tidak ditetapkan, nilai global yang akan digunakan. Setiap objek mendukung properti berikut:

  • areaOpacity - Mengganti areaOpacity global untuk rangkaian ini.
  • color - Warna yang akan digunakan untuk deret ini. Tentukan string warna HTML yang valid.
  • labelInLegend - Deskripsi deret yang akan muncul di legenda diagram.
  • lineDashStyle - Mengganti nilai lineDashStyle global untuk rangkaian ini.
  • targetAxisIndex - Sumbu mana yang akan ditetapkan ke deret ini, dengan 0 sebagai sumbu default, dan 1 adalah sumbu yang berlawanan. Nilai defaultnya adalah 0; tetapkan ke 1 untuk menentukan diagram dengan deret yang berbeda-beda dirender pada sumbu yang berbeda. Setidaknya satu deret yang banyak dialokasikan ke sumbu default. Anda dapat menentukan skala yang berbeda untuk sumbu yang berbeda.
  • visibleInLegend - Nilai boolean, jika benar (true) berarti deret harus memiliki entri legenda, dan salah (false) berarti tidak boleh. Defaultnya adalah true (benar).

Anda dapat menentukan array objek, yang masing-masing berlaku untuk deret dalam urutan yang ditentukan, atau Anda dapat menentukan objek yang setiap turunan memiliki kunci numerik yang menunjukkan ke deret mana hal tersebut diterapkan. Misalnya, dua deklarasi berikut identik, dan deklarasikan deret pertama sebagai hitam dan tidak ada di legenda, sedangkan yang keempat sebagai merah dan tidak ada di legenda:

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    
Jenis: Array objek atau objek dengan objek bertingkat
Default: {}
tema

Tema adalah sekumpulan nilai opsi yang telah ditentukan yang bekerja sama untuk mencapai perilaku diagram atau efek visual tertentu. Saat ini hanya satu tema yang tersedia:

  • 'maximized' - Memaksimalkan area diagram, dan menggambar legenda serta 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
title

Teks yang akan ditampilkan di atas diagram.

Jenis: string
Default: tanpa judul
titlePosition

Lokasi untuk menempatkan judul bagan, dibandingkan dengan area bagan. Nilai yang didukung:

  • in - Menggambar judul di dalam area bagan.
  • out - Menggambar judul di luar area bagan.
  • tidak ada - Hapus judul.
Jenis: string
Default: 'out'
titleTextStyle

Objek yang menetapkan gaya teks judul. Objek memiliki format ini:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

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

Jenis: objek
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
tooltip

Objek dengan anggota untuk mengonfigurasi berbagai elemen tooltip. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditampilkan di sini:

{textStyle: {color: '#FF0000'}, showColorCode: true}
Jenis: objek
Default: null
tooltip.ignoreBounds

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

Catatan: Ini hanya berlaku untuk tooltip HTML. Jika kebijakan ini diaktifkan dengan tooltip SVG, kelebihan apa pun di luar batas diagram akan dipangkas. Lihat Menyesuaikan Konten Tooltip untuk mengetahui detail selengkapnya.

Jenis: boolean
Default: false
tooltip.isHtml

Jika disetel ke benar (true), gunakan tooltip yang dirender dengan HTML (bukan yang dirender SVG. Lihat Menyesuaikan Konten Tooltip untuk mengetahui detail selengkapnya.

Catatan: penyesuaian konten tooltip HTML melalui peran data kolom tooltip tidak didukung oleh visualisasi Bubble Chart.

Jenis: boolean
Default: false
tooltip.showColorCode

Jika benar, tampilkan kotak berwarna di samping informasi serial dalam tooltip. Nilai defaultnya adalah benar (true) jika focusTarget ditetapkan ke 'category', jika tidak, nilai default-nya salah.

Jenis: boolean
Default: otomatis
tooltip.textStyle

Objek yang menentukan gaya teks tooltip. Objek memiliki format ini:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

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

Jenis: objek
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
tooltip.trigger

Interaksi pengguna yang menyebabkan tooltip ditampilkan:

  • 'focus' - Tooltip akan ditampilkan saat pengguna mengarahkan kursor ke elemen.
  • 'none' - Tooltip tidak akan ditampilkan.
  • 'selection' - Tooltip akan ditampilkan saat pengguna memilih elemen.
Jenis: string
Default: 'fokus'
vAxes

Menentukan properti untuk masing-masing sumbu vertikal, 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 untuk properti yang sama.

Untuk menentukan diagram dengan beberapa sumbu vertikal, pertama-tama tentukan sumbu baru menggunakan series.targetAxisIndex, lalu konfigurasikan sumbu menggunakan vAxes. Contoh berikut menetapkan seri 2 ke sumbu kanan serta menentukan gaya judul dan gaya teks kustom untuk sumbu tersebut:

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

Properti ini dapat berupa objek atau array: objek adalah kumpulan objek, masing-masing dengan label numerik yang menentukan sumbu yang ditentukan--ini adalah format yang ditampilkan di atas; array adalah array objek, satu per sumbu. Misalnya, notasi gaya array berikut identik dengan objek 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
vAxis

Objek dengan anggota untuk mengonfigurasi berbagai elemen sumbu vertikal. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditunjukkan di sini:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Jenis: objek
Default: null
vAxis.baseline

Properti vAxis yang menentukan dasar pengukuran untuk sumbu vertikal. Jika dasar pengukuran lebih besar dari garis petak tertinggi atau lebih kecil dari garis petak terendah, garis dasar akan dibulatkan ke garis petak terdekat.

Jenis: nomor
Default: otomatis
vAxis.baselineColor

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

Jenis: nomor
Default: 'hitam'
vAxis.direction

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

Jenis: 1 atau -1
Default: 1
vAxis.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 berikut ini:

  • {format: 'none'}: menampilkan angka tanpa format (misalnya, 8.000.000)
  • {format: 'decimal'}: menampilkan angka dengan pemisah ribuan (misalnya, 8.000.000)
  • {format: 'scientific'}: menampilkan angka dalam notasi ilmiah (mis., 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 singkatan angka (misalnya, 8 jt)
  • {format: 'long'}: menampilkan angka sebagai kata lengkap (mis., 8 juta)

Format sebenarnya yang diterapkan pada label berasal dari lokalitas yang memuat API. Untuk mengetahui detail selengkapnya, lihat memuat diagram dengan lokalitas tertentu .

Dalam menghitung nilai tick dan garis petak, beberapa kombinasi alternatif dari semua opsi garis petak yang relevan akan dipertimbangkan, dan alternatifnya akan ditolak jika label titik skala yang diformat akan diduplikasi atau tumpang tindih. Jadi, Anda dapat menentukan format:"#" jika hanya ingin menampilkan nilai tick bilangan bulat, tetapi perlu diketahui bahwa jika tidak ada alternatif yang memenuhi kondisi ini, tidak ada garis petak atau titik skala yang akan ditampilkan.

Jenis: string
Default: otomatis
vAxis.gridlines

Objek dengan anggota untuk mengonfigurasi garis petak pada sumbu vertikal. Perhatikan bahwa garis petak sumbu vertikal digambar secara horizontal. Untuk menentukan properti objek ini, Anda dapat menggunakan notasi literal objek, seperti yang ditunjukkan di sini:

{color: '#333', minSpacing: 20}
Jenis: objek
Default: null
vAxis.gridlines.color

Warna garis petak vertikal di dalam area diagram. Tentukan string warna HTML yang valid.

Jenis: string
Default: '#CCC'
vAxis.gridlines.count

Perkiraan jumlah garis petak horizontal di dalam area diagram. Jika Anda menentukan angka positif untuk gridlines.count, angka tersebut akan digunakan untuk menghitung minSpacing di antara garis petak. Anda dapat menentukan nilai 1 untuk menggambar satu garis petak saja, atau 0 untuk menggambar garis petak tanpa garis. Tentukan -1, yang merupakan default, untuk menghitung jumlah garis petak secara otomatis berdasarkan opsi lain.

Jenis: nomor
Default: -1
vAxis.minorGridlines

Objek dengan anggota untuk mengonfigurasi garis petak minor pada sumbu vertikal, mirip dengan opsi vAxis.gridlines.

Jenis: objek
Default: null
vAxis.minorGridlines.color

Warna garis petak minor vertikal di dalam area diagram. Tentukan string warna HTML yang valid.

Jenis: string
Default: Kombinasi warna garis petak dan latar belakang
vAxis.minorGridlines.count

Opsi minorGridlines.count sebagian besar tidak digunakan lagi, kecuali untuk menonaktifkan garis petak minor dengan menetapkan hitungan ke 0. Jumlah garis petak minor bergantung pada interval antara garis petak utama (lihat vAxis.gridlines.interval) dan ruang minimum yang diperlukan (lihat vAxis.minorGridlines.minSpacing).

Jenis: nomor
Default: 1
vAxis.logScale

Jika true (benar), menjadikan sumbu vertikal sebagai skala logaritmik. Catatan: Semua nilai harus positif.

Jenis: boolean
Default: false
vAxis.scaleType

Properti vAxis yang membuat sumbu vertikal menjadi skala logaritmik. Dapat berupa salah satu dari hal berikut:

  • null - Penskalaan logaritmik tidak dilakukan.
  • 'log' - Penskalaan logaritmik. Nilai negatif dan nol tidak dipetakan. Opsi ini sama dengan menyetel vAxis: { logscale: true }.
  • 'mirrorLog' - Penskalaan logaritmik yang memetakan nilai negatif dan nol. Nilai yang dipetakan angka negatif adalah negatif dari log nilai absolut. Nilai yang mendekati 0 dipetakan pada skala linier.
Jenis: string
Default: null
vAxis.textPosition

Posisi teks sumbu vertikal, relatif terhadap area diagram. Nilai yang didukung: 'out', 'in', 'none'.

Jenis: string
Default: 'out'
vAxis.textStyle

Objek yang menetapkan gaya teks sumbu vertikal. Objek memiliki format ini:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

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

Jenis: objek
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.ticks

Mengganti tanda petik sumbu Y yang dihasilkan secara otomatis dengan array yang ditentukan. Setiap elemen array harus berupa nilai tick yang valid (seperti angka, tanggal, datetime, atau waktu), atau sebuah objek. Jika berupa objek, objek tersebut harus memiliki properti v untuk nilai tick, dan properti f opsional yang berisi string literal untuk ditampilkan sebagai label.

ViewWindow akan otomatis diperluas untuk menyertakan tick min dan maks 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.

Jenis: objek
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.maxValue

Memindahkan nilai maksimum sumbu vertikal ke nilai yang ditentukan; ini akan ke atas pada sebagian besar diagram. Diabaikan jika ditetapkan ke nilai yang lebih kecil dari nilai y maksimum data. vAxis.viewWindow.max mengganti properti ini.

Jenis: nomor
Default: otomatis
vAxis.minValue

Memindahkan nilai min sumbu vertikal ke nilai yang ditentukan; ini akan ke bawah di sebagian besar diagram. Diabaikan jika ditetapkan ke nilai yang lebih besar dari nilai y minimum data. vAxis.viewWindow.min mengganti properti ini.

Jenis: nomor
Default: null
vAxis.viewWindowMode

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

  • 'pretty' - Menskalakan 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 petak minor terdekat untuk tanggal dan waktu.
  • 'maximized' - 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 ini 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.

Jenis: objek
Default: null
vAxis.viewWindow.max

Nilai data vertikal maksimum yang akan dirender.

Diabaikan jika vAxis.viewWindowMode bersifat 'cantik' atau 'dimaksimalkan'.

Jenis: nomor
Default: otomatis
vAxis.viewWindow.min

Nilai data vertikal minimum yang akan dirender.

Diabaikan jika vAxis.viewWindowMode bersifat 'cantik' atau 'dimaksimalkan'.

Jenis: nomor
Default: otomatis
lebar

Lebar diagram, dalam piksel.

Jenis: nomor
Default: lebar elemen yang memuatnya

Metode

Metode
draw(data, options)

Menggambar diagram. Diagram menerima panggilan metode lebih lanjut hanya setelah peristiwa ready diaktifkan. Extended description.

Jenis Pengembalian: tidak ada
getAction(actionID)

Menampilkan objek tindakan tooltip dengan actionID yang diminta.

Jenis Pengembalian: objek
getBoundingBox(id)

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

var cli = chart.getChartLayoutInterface();

Tinggi area diagram
cli.getBoundingBox('chartarea').height
Lebar batang ketiga dalam deret pertama diagram batang atau kolom
cli.getBoundingBox('bar#0#2').width
Kotak pembatas dari 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 suatu diagram horizontal (misalnya, batang):
cli.getBoundingBox('hAxis#0#gridline')

Nilai bersifat relatif terhadap penampung diagram. Panggil ini setelah diagram digambar.

Jenis Pengembalian: objek
getChartAreaBoundingBox()

Menampilkan objek yang berisi bagian kiri, atas, lebar, dan tinggi konten diagram (yaitu, tidak termasuk label dan legenda):

var cli = chart.getChartLayoutInterface();

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

Nilai bersifat relatif terhadap penampung diagram. Panggil ini setelah diagram digambar.

Jenis Pengembalian: objek
getChartLayoutInterface()

Menampilkan objek yang berisi informasi tentang penempatan diagram dan elemennya di layar.

Metode berikut dapat dipanggil pada objek yang ditampilkan:

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

Panggil ini setelah diagram digambar.

Jenis Pengembalian: objek
getHAxisValue(xPosition, optional_axis_index)

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

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

Panggil ini setelah diagram digambar.

Jenis Pengembalian: nomor
getImageURI()

Menampilkan diagram yang diserialisasi sebagai URI gambar.

Panggil ini setelah diagram digambar.

Lihat Mencetak Diagram PNG.

Jenis Pengembalian: string
getSelection()

Menampilkan array entitas diagram yang dipilih. Entitas yang dapat dipilih adalah langkah, entri legenda, dan kategori. Langkah sesuai dengan sel dalam tabel data, entri legenda ke kolom (indeks baris null), dan kategori dengan baris (indeks kolom null). Untuk diagram ini, hanya satu entitas yang dapat dipilih pada waktu tertentu. Extended description

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

Menampilkan nilai data vertikal pada yPosition, yang merupakan offset piksel ke bawah dari tepi atas penampung diagram. Bisa negatif.

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

Panggil ini setelah diagram digambar.

Jenis Pengembalian: nomor
getXLocation(dataValue, optional_axis_index)

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

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

Panggil ini setelah diagram digambar.

Jenis Pengembalian: nomor
getYLocation(dataValue, optional_axis_index)

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

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

Panggil ini setelah diagram digambar.

Jenis Pengembalian: nomor
removeAction(actionID)

Menghapus tindakan tooltip dengan actionID yang diminta dari diagram.

Jenis Pengembalian: none
setAction(action)

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

Metode setAction mengambil objek sebagai parameter tindakannya. Objek ini harus menentukan 3 properti: id— ID tindakan yang sedang ditetapkan, text —teks yang akan muncul dalam 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 lengkap.

Jenis Pengembalian: 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 null), dan kategori dengan baris (indeks kolom null). Untuk diagram ini, hanya satu entitas yang dapat dipilih pada satu waktu. Extended description

Jenis Pengembalian: tidak ada
clearChart()

Mengosongkan diagram, dan melepaskan semua resource yang dialokasikan.

Jenis Pengembalian: tidak ada

Acara

Untuk informasi selengkapnya tentang cara menggunakan peristiwa ini, lihat Interaktivitas Dasar, Menangani Peristiwa, dan Mengaktifkan Peristiwa.

Name
animationfinish

Diaktifkan saat animasi transisi selesai.

Properti: tidak ada
click

Diaktifkan saat pengguna mengklik di dalam diagram. Dapat digunakan untuk mengidentifikasi kapan judul, elemen data, entri legenda, sumbu, garis petak, atau label diklik.

Properti: targetID
error

Diaktifkan saat terjadi error saat mencoba merender diagram.

Properties: id, pesan
legendpagination

Diaktifkan saat pengguna mengklik panah penomoran halaman legenda. Meneruskan kembali indeks halaman berbasis nol pada legenda saat ini dan jumlah total halaman.

Properti: currentPageIndex, totalPages
onmouseover

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

Properti: baris, kolom
onmouseout

Diaktifkan saat pengguna menjauhi entity 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.