Histogram

Ringkasan

Histogram adalah diagram yang mengelompokkan data numerik ke dalam bin, menampilkan bin sebagai kolom yang tersegmentasi. Parameter ini digunakan untuk menggambarkan distribusi set data: seberapa sering nilai berada di dalam rentang.

Google Chart secara otomatis memilih jumlah bin untuk Anda. Semua bin memiliki lebar yang sama dan tingginya sebanding dengan jumlah titik data dalam bin. Selain itu, histogram mirip dengan diagram kolom.

Contoh

Berikut adalah histogram panjang dinosaurus:

Histogram memberi tahu kita bahwa kelompok yang paling umum adalah <10 meter, dan hanya ada satu dinosaurus dengan jarak lebih dari 40 meter. Kita dapat mengarahkan kursor ke bar untuk menemukan bahwa itu adalah Seismosaurus (yang mungkin hanya merupakan Diplodocus yang sangat besar; para pakar paleontologi tidak yakin).

Kode untuk menghasilkan histogram ini ditampilkan di bawah ini. Setelah menentukan data (di sini, dengan google.visualization.arrayToDataTable), diagram akan ditentukan dengan panggilan ke google.visualization.Histogram dan digambar dengan metode draw.

<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([
          ['Dinosaur', 'Length'],
          ['Acrocanthosaurus (top-spined lizard)', 12.2],
          ['Albertosaurus (Alberta lizard)', 9.1],
          ['Allosaurus (other lizard)', 12.2],
          ['Apatosaurus (deceptive lizard)', 22.9],
          ['Archaeopteryx (ancient wing)', 0.9],
          ['Argentinosaurus (Argentina lizard)', 36.6],
          ['Baryonyx (heavy claws)', 9.1],
          ['Brachiosaurus (arm lizard)', 30.5],
          ['Ceratosaurus (horned lizard)', 6.1],
          ['Coelophysis (hollow form)', 2.7],
          ['Compsognathus (elegant jaw)', 0.9],
          ['Deinonychus (terrible claw)', 2.7],
          ['Diplodocus (double beam)', 27.1],
          ['Dromicelomimus (emu mimic)', 3.4],
          ['Gallimimus (fowl mimic)', 5.5],
          ['Mamenchisaurus (Mamenchi lizard)', 21.0],
          ['Megalosaurus (big lizard)', 7.9],
          ['Microvenator (small hunter)', 1.2],
          ['Ornithomimus (bird mimic)', 4.6],
          ['Oviraptor (egg robber)', 1.5],
          ['Plateosaurus (flat lizard)', 7.9],
          ['Sauronithoides (narrow-clawed lizard)', 2.0],
          ['Seismosaurus (tremor lizard)', 45.7],
          ['Spinosaurus (spiny lizard)', 12.2],
          ['Supersaurus (super lizard)', 30.5],
          ['Tyrannosaurus (tyrant lizard)', 15.2],
          ['Ultrasaurus (ultra lizard)', 30.5],
          ['Velociraptor (swift robber)', 1.8]]);

        var options = {
          title: 'Lengths of dinosaurs, in meters',
          legend: { position: 'none' },
        };

        var chart = new google.visualization.Histogram(document.getElementById('chart_div'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <div id="chart_div" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Label (di sini, nama dinosaurus) dapat dihilangkan, sehingga tooltip hanya akan menampilkan nilai numerik.

Warna Kontrol

Berikut adalah histogram populasi nasional:

Ada lebih dari dua ratus negara dengan populasi kurang dari seratus juta, dan penurunan yang parah setelah itu.

Histogram ini menggunakan opsi colors untuk menggambar data dengan warna hijau:

  var options = {
    title: 'Country Populations',
    legend: { position: 'none' },
    colors: ['green'],
  };

Seperti semua Google Chart, warna dapat ditentukan sebagai nama bahasa Inggris atau sebagai nilai heksadesimal.

Bucket Kontrol

Secara default, Google Chart akan memilih ukuran bucket secara otomatis, menggunakan algoritma yang sudah dikenal luas untuk histogram. Namun, terkadang Anda ingin menggantinya, dan diagram di atas hanyalah contoh. Dengan begitu banyaknya negara di kelompok pertama, sulit untuk mempelajarinya di negara lain.

Untuk situasi seperti ini, diagram Histogram menyediakan dua opsi: histogram.bucketSize, yang menggantikan algoritma dan melakukan hardcode pada ukuran bucket; dan histogram.lastBucketPercentile. Opsi kedua memerlukan penjelasan lebih lanjut: opsi ini mengubah komputasi ukuran bucket untuk mengabaikan nilai yang lebih tinggi atau lebih rendah dari nilai lainnya berdasarkan persentase yang Anda tentukan. Nilai ini masih disertakan dalam histogram, tetapi tidak memengaruhi cara pengelompokan nya. Hal ini berguna jika Anda tidak ingin pencilan ditempatkan di bucketnya sendiri. pencilan tersebut akan dikelompokkan dengan bucket pertama atau terakhir.

Pada diagram di atas, kami mengabaikan lima persen nilai teratas dan lima persen terbawah saat menghitung ukuran bucket. Nilainya masih dalam diagram; satu-satunya hal yang berubah adalah ukuran bucket, tetapi histogram menjadi lebih mudah dibaca.

Contoh ini juga menunjukkan cara mengubah skala sumbu vertikal untuk menggunakan skala "log duplikat", yang juga membantu saat membuat diagram data yang memiliki garis panjang yang berisi nilai-nilai kecil.

  var options = {
    title: 'Country Populations',
    legend: { position: 'none' },
    colors: ['#e7711c'],
    histogram: { lastBucketPercentile: 5 },
    vAxis: { scaleType: 'mirrorLog' }
  };

Seperti yang dapat Anda lihat, menghapus lima persen bagian atas dan bawah dari penghitungan akan menghasilkan ukuran bucket 10.000.000, bukan 100.000.000. Jika selama ini Anda tahu bahwa ukuran bucket 10.000.000 adalah yang Anda inginkan, Anda dapat menggunakan histogram.bucketSize untuk melakukannya:

  var options = {
    title: 'Country Populations',
    legend: { position: 'none' },
    colors: ['#e7711c'],
    histogram: { bucketSize: 10000000 }
  };

Pada contoh berikut, kami menunjukkan cara memperluas rentang bucket dan menampilkan lebih banyak bucket tanpa jeda di antara bucket tersebut. Opsi maxNumBuckets dapat digunakan untuk meningkatkan jumlah bucket default. Opsi histogram.minValue dan histogram.maxValue akan memperluas rentang bucket, tetapi perhatikan bahwa jika ada data di luar rentang ini, opsi ini tidak akan memperkecil rentang.

Contoh ini juga menunjukkan bahwa Anda dapat menentukan tick yang akan ditampilkan untuk setiap bucket menggunakan opsi ticks eksplisit untuk hAxis. Hal ini tidak memengaruhi bucket itu sendiri, tetapi hanya bagaimana tick ditampilkan.

Perhatikan juga bahwa kita menentukan chartArea.width sedemikian rupa sehingga jumlah bucket akan sesuai secara lebih tepat tanpa artefak visual. Berikut adalah opsi untuk contoh ini.

  var options = {
    title: 'Approximating Normal Distribution',
    legend: { position: 'none' },
    colors: ['#4285F4'],

    chartArea: { width: 405 },
    hAxis: {
      ticks: [-1, -0.75, -0.5, -0.25, 0, 0.25, 0.5, 0.75, 1]
    },
    bar: { gap: 0 },

    histogram: {
      bucketSize: 0.01,
      maxNumBuckets: 400,
      minValue: -1,
      maxValue: 1
    }
  };

Beberapa Seri

Berikut adalah histogram biaya partikel subatom, sesuai dengan Model Standar:

Diagram di atas memiliki satu deret yang berisi semua partikel. Partikel subatom dapat dibagi menjadi empat kelompok: quarks, lepton, dan boson. Mari kita anggap setiap rangkaian ini sebagai rangkaiannya sendiri:

Dalam diagram ini, kami menggunakan deret yang berbeda (sekaligus warna) untuk masing-masing dari empat jenis partikel subatom. Kami secara eksplisit menetapkan interpolateNulls ke false untuk memastikan bahwa nilai null (diperlukan karena deret tidak sama panjangnya) tidak dipetakan. Kita juga menetapkan legend.maxLines untuk menambahkan baris lain ke legenda:

  var data = google.visualization.arrayToDataTable([
    ['Quarks', 'Leptons', 'Gauge Bosons', 'Scalar Bosons'],
    [2/3, -1, 0, 0],
    [2/3, -1, 0, null],
    [2/3, -1, 0, null],
    [-1/3, 0, 1, null],
    [-1/3, 0, -1, null],
    [-1/3, 0, null, null],
    [-1/3, 0, null, null]
  ]);

  var options = {
    title: 'Charges of subatomic particles',
    legend: { position: 'top', maxLines: 2 },
    colors: ['#5C3292', '#1A8763', '#871B47', '#999999'],
    interpolateNulls: false,
  };

Memuat

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

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

Nama class visualisasi adalah google.visualization.Histogram:

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

Format Data

Ada dua cara untuk mengisi tabel data histogram. Jika hanya ada satu rangkaian:

  var data = google.visualization.arrayToDataTable([
    ['Name', 'Number'],
    ['Name 1', number1],
    ['Name 2', number2],
    ['Name 3', number3],
    ...
  ]);

...dan jika ada beberapa rangkaian:

  var data = google.visualization.arrayToDataTable([
    ['Series Name 1', 'Series Name 2', 'Series Name 3', ...],
    [series1_number1, series2_number1, series3_number1, ...],
    [series1_number2, series2_number2, series3_number2, ...],
    [series1_number3, series2_number3, series3_number3, ...],
    ...
  ]);

Tidak ada peran kolom opsional yang didukung untuk histogram saat ini.

Opsi Konfigurasi

Name
animation.duration

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

Jenis: nomor
Default: 0
animation.easing

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

  • '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
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'
bar.groupWidth
Lebar sekelompok batang, yang ditentukan dalam salah satu format berikut:
  • Piksel (misalnya, 50).
  • Persentase lebar yang tersedia untuk setiap kelompok (misalnya, '20%'), dengan '100%' berarti kelompok tersebut tidak memiliki spasi di antara kelompok tersebut.
Jenis: angka atau string
Default: Rasio emas, sekitar '61,8%'.
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
dataOpacity

Transparansi titik data, dengan 1,0 adalah benar-benar buram dan 0,0 sepenuhnya transparan. Dalam diagram sebar, histogram, batang, dan kolom, ini mengacu pada data yang terlihat: titik di diagram sebar dan persegi panjang di diagram lain. Dalam diagram dengan pemilihan data yang membuat titik, seperti diagram garis dan area, hal ini mengacu pada lingkaran yang muncul saat mengarahkan kursor atau memilih. Diagram kombinasi menunjukkan kedua perilaku tersebut, dan opsi ini tidak berpengaruh pada diagram lainnya. (Untuk mengubah opasitas garis tren, lihat opasitas garis tren .)

Jenis: nomor
Default: 1,0
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.gridlines

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

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

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

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

Perkiraan jumlah garis petak horizontal di dalam area diagram. Jika Anda menentukan angka positif untuk 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
hAxis.gridlines.interval

Array ukuran (sebagai nilai data, bukan piksel) di antara garis petak yang berdekatan. Saat ini, opsi ini hanya untuk sumbu numerik, tetapi setara dengan opsi gridlines.units.<unit>.interval yang hanya digunakan untuk tanggal dan waktu. Untuk skala linear, defaultnya adalah [1, 2, 2.5, 5], yang berarti nilai garis petak dapat berada di setiap unit (1), pada unit genap (2), atau pada kelipatan 2,5 atau 5. Setiap pangkat 10 kali dari nilai ini juga dipertimbangkan (misalnya [10, 20, 25, 50] dan [.1, .2, .25, .5]). Untuk skala log, defaultnya adalah [1, 2, 5].

Jenis: angka antara 1 dan 10, tidak termasuk 10.
Default: dihitung
hAxis.gridlines.minSpacing

Ruang layar minimum, dalam piksel, di antara garis petak utama hAxis. Default untuk garis petak utama adalah 40 untuk skala linear, dan 20 untuk skala log. Jika Anda menentukan count, bukan minSpacing, minSpacing akan dihitung dari jumlah. Sebaliknya, jika Anda menentukan minSpacing, bukan count, jumlah dihitung dari minSpacing. Jika Anda menentukan keduanya, minSpacing akan menggantikannya.

Jenis: nomor
Default: dihitung
hAxis.gridlines.multiple

Semua nilai gridline dan tick harus berupa kelipatan dari nilai opsi ini. Perlu diketahui bahwa, berbeda dengan interval, pangkat 10 kali lipat tidak dipertimbangkan. Jadi, Anda dapat memaksa tick menjadi bilangan bulat dengan menentukan gridlines.multiple = 1, atau memaksa tick menjadi kelipatan 1.000 dengan menentukan gridlines.multiple = 1000.

Jenis: nomor
Default: 1
hAxis.gridlines.units

Mengganti format default untuk berbagai aspek jenis data tanggal/tanggal/waktu saat digunakan dengan garis petak yang dihitung diagram. Memungkinkan pemformatan untuk tahun, bulan, hari, jam, menit, detik, dan milidetik.

Format umumnya adalah:

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]}
    hours: {format: [/*format strings here*/]}
    minutes: {format: [/*format strings here*/]}
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]},
  }
}
    

Informasi tambahan dapat ditemukan di Tanggal dan Waktu.

Jenis: objek
Default: null
hAxis.minorGridlines

Objek dengan anggota untuk mengonfigurasi garis petak minor pada sumbu horizontal, mirip dengan opsi hAxis.gridlines.

Jenis: objek
Default: null
hAxis.minorGridlines.color

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

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

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

Jenis: nomor
Default:1
hAxis.minorGridlines.interval

Opsi minorGridlines.interval mirip dengan opsi interval garis petak utama, tetapi interval yang dipilih akan selalu menjadi pembagi genap dari interval garis petak utama. Interval default untuk skala linear adalah [1, 1.5, 2, 2.5, 5], dan untuk skala log adalah [1, 2, 5].

Jenis: nomor
Default:1
hAxis.minorGridlines.minSpacing

Ruang minimum yang diperlukan, dalam piksel, di antara garis petak minor yang berdekatan, dan antara garis petak kecil dan utama. Nilai defaultnya adalah 1/2 minSpacing dari garis petak utama untuk skala linear, dan 1/5 minSpacing untuk skala log.

Jenis: nomor
Default:terhitung
hAxis.minorGridlines.multiple

Sama seperti utama gridlines.multiple.

Jenis: nomor
Default: 1
hAxis.minorGridlines.units

Mengganti format default untuk berbagai aspek jenis data tanggal/tanggal/waktu/waktu jika digunakan dengan garis minorGrid yang dihitung pada diagram. Memungkinkan pemformatan untuk tahun, bulan, hari, jam, menit, detik, dan milidetik.

Format umumnya adalah:

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]}
    hours: {format: [/*format strings here*/]}
    minutes: {format: [/*format strings here*/]}
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]},
  }
}
    

Informasi tambahan dapat ditemukan di Tanggal dan Waktu.

Jenis: objek
Default: null
hAxis.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.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.viewWindowMode

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

  • 'pretty' - Menskalakan 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 petak minor terdekat untuk tanggal dan waktu.
  • 'maximized' - Menskalakan nilai horizontal sehingga nilai data maksimum dan minimum menyentuh sisi kiri dan kanan area diagram. Hal ini akan menyebabkan haxis.viewWindow.min dan haxis.viewWindow.max diabaikan.
  • 'eksplisit' - Opsi yang tidak digunakan lagi untuk menentukan nilai skala kiri dan kanan 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.

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
histogram.bucketSize

Lakukan hardcode ukuran setiap batang histogram, bukan membiarkannya ditentukan secara algoritma.

Jenis: nomor
Default: otomatis
histogram.hideBucketItems

Hilangkan pembagian tipis antara blok histogram, menjadikannya serangkaian batang solid.

Jenis: boolean
Default: false
histogram.lastBucketPercentile

Saat menghitung ukuran bucket histogram, abaikan lastBucketPercentile persen bagian atas dan bawah. Nilai ini masih disertakan dalam histogram, tetapi tidak memengaruhi pengelompokan.

Jenis: nomor
Default: 0
histogram.minValue

Perluas rentang bucket untuk menyertakan nilai ini.

Jenis: nomor
Default: otomatis - gunakan min data
histogram.maxValue

Perluas rentang bucket untuk menyertakan nilai ini.

Jenis: nomor
Default: otomatis - gunakan maksimum data
histogram.numBucketsRule

Cara menghitung jumlah bucket default. Nilai yang dimungkinkan adalah:

  • 'sqrt' - Menghitung akar kuadrat dari jumlah titik data.
  • 'sturges' - Berasal dari distribusi binomial. Secara implisit mengasumsikan distribusi yang kira-kira normal.
  • 'rice' - Alternatif yang lebih sederhana untuk aturan Sturges.
Untuk detail selengkapnya, lihat Wikipedia - Histogram: Jumlah kelompok dan lebar

Jenis: string
Default:'sqrt'
tinggi

Tinggi diagram, dalam piksel.

Jenis: nomor
Default: tinggi elemen yang memuatnya
interpolateNulls

Apakah untuk menebak nilai poin yang hilang. Jika true (benar), metode ini akan menebak nilai data yang hilang berdasarkan titik di dekatnya. Jika salah, nilai ini akan meninggalkan jeda di garis pada titik yang tidak diketahui.

Hal ini tidak didukung oleh diagram Area dengan opsi isStacked: true/'percent'/'relative'/'absolute'.

Jenis: boolean
Default: false
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.pageIndex

Indeks halaman legenda awal yang dipilih berdasarkan nol.

Jenis: nomor
Default: 0
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>}
orientasi

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

Jenis: string
Default: 'horizontal'
reverseCategories

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

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

  • color - Warna yang akan digunakan untuk deret ini. Tentukan string warna HTML yang valid.
  • labelInLegend - Deskripsi deret yang akan muncul di legenda diagram.
  • 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.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.
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.gridlines.interval

Array ukuran (sebagai nilai data, bukan piksel) di antara garis petak yang berdekatan. Saat ini, opsi ini hanya untuk sumbu numerik, tetapi setara dengan opsi gridlines.units.<unit>.interval yang hanya digunakan untuk tanggal dan waktu. Untuk skala linear, defaultnya adalah [1, 2, 2.5, 5], yang berarti nilai garis petak dapat berada di setiap unit (1), pada unit genap (2), atau pada kelipatan 2,5 atau 5. Setiap pangkat 10 kali dari nilai ini juga dipertimbangkan (misalnya [10, 20, 25, 50] dan [.1, .2, .25, .5]). Untuk skala log, defaultnya adalah [1, 2, 5].

Jenis: angka antara 1 dan 10, tidak termasuk 10.
Default: dihitung
vAxis.gridlines.minSpacing

Ruang layar minimum, dalam piksel, di antara garis petak utama hAxis. Default untuk garis petak utama adalah 40 untuk skala linear, dan 20 untuk skala log. Jika Anda menentukan count, bukan minSpacing, minSpacing akan dihitung dari jumlah. Sebaliknya, jika Anda menentukan minSpacing, bukan count, jumlah dihitung dari minSpacing. Jika Anda menentukan keduanya, minSpacing akan menggantikannya.

Jenis: nomor
Default: dihitung
vAxis.gridlines.multiple

Semua nilai gridline dan tick harus berupa kelipatan dari nilai opsi ini. Perlu diketahui bahwa, berbeda dengan interval, pangkat 10 kali lipat tidak dipertimbangkan. Jadi, Anda dapat memaksa tick menjadi bilangan bulat dengan menentukan gridlines.multiple = 1, atau memaksa tick menjadi kelipatan 1.000 dengan menentukan gridlines.multiple = 1000.

Jenis: nomor
Default: 1
vAxis.gridlines.units

Mengganti format default untuk berbagai aspek jenis data tanggal/tanggal/waktu saat digunakan dengan garis petak yang dihitung diagram. Memungkinkan pemformatan untuk tahun, bulan, hari, jam, menit, detik, dan milidetik.

Format umumnya adalah:

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]},
    hours: {format: [/*format strings here*/]},
    minutes: {format: [/*format strings here*/]},
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]}
  }
}
    

Informasi tambahan dapat ditemukan di Tanggal dan Waktu.

Jenis: objek
Default: null
vAxis.minorGridlines

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

Jenis: objek
Default: null
vAxis.minorGridlines.color

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

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

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

Jenis: nomor
Default: 1
vAxis.minorGridlines.interval

Opsi minorGridlines.interval mirip dengan opsi interval garis petak utama, tetapi interval yang dipilih akan selalu menjadi pembagi genap dari interval garis petak utama. Interval default untuk skala linear adalah [1, 1.5, 2, 2.5, 5], dan untuk skala log adalah [1, 2, 5].

Jenis: nomor
Default:1
vAxis.minorGridlines.minSpacing

Ruang minimum yang diperlukan, dalam piksel, di antara garis petak minor yang berdekatan, dan antara garis petak kecil dan utama. Nilai defaultnya adalah 1/2 minSpacing dari garis petak utama untuk skala linear, dan 1/5 minSpacing untuk skala log.

Jenis: nomor
Default:terhitung
vAxis.minorGridlines.multiple

Sama seperti utama gridlines.multiple.

Jenis: nomor
Default: 1
vAxis.minorGridlines.units

Mengganti format default untuk berbagai aspek jenis data tanggal/tanggal/waktu/waktu jika digunakan dengan garis minorGrid yang dihitung pada diagram. Memungkinkan pemformatan untuk tahun, bulan, hari, jam, menit, detik, dan milidetik.

Format umumnya adalah:

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]}
    hours: {format: [/*format strings here*/]}
    minutes: {format: [/*format strings here*/]}
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]},
  }
}
    

Informasi tambahan dapat ditemukan di Tanggal dan Waktu.

Jenis: objek
Default: null
vAxis.logScale

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

Jenis: boolean
Default: false
vAxis.scaleType

Properti 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 batang, entri legenda, dan kategori. 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 batang, entri legenda, dan kategori. 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. Sebuah batang berkorelasi dengan sel dalam tabel data, entri legenda ke kolom (indeks baris {i>null<i}), dan kategori ke baris (indeks kolom adalah {i>null<i}).

Properti: baris, kolom
onmouseout

Diaktifkan saat pengguna menjauhi entity visual. Meneruskan kembali indeks baris dan kolom dari elemen tabel data yang sesuai. Sebuah batang berkorelasi dengan sel dalam tabel data, entri legenda ke kolom (indeks baris {i>null<i}), dan kategori ke baris (indeks kolom adalah {i>null<i}).

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.