Menyesuaikan visualisasi menggunakan Chart Config Editor

Anda dapat menggunakan Chart Config Editor untuk menyesuaikan opsi pemformatan pada visualisasi Looker yang menggunakan HighCharts API. Ini mencakup sebagian besar diagram Kartesius, seperti diagram kolom, diagram batang, dan diagram garis.

Prasyarat

Untuk mengakses Chart Config Editor, Anda harus memiliki izin can_override_vis_config.

Menyesuaikan visualisasi

Untuk menyesuaikan visualisasi dengan Chart Config Editor, ikuti langkah-langkah berikut:

  1. Melihat visualisasi dalam Eksplorasi, atau mengedit visualisasi dalam Tampilan atau dasbor.
  2. Buka menu Edit dalam visualisasi.

  3. Klik tombol Edit Chart Config di tab Plot. Looker akan menampilkan dialog Edit Chart Config.

    • Panel Chart Config (Source) berisi JSON asli dari visualisasi Anda dan tidak dapat diedit.

    • Panel Chart Config (Override) berisi JSON yang akan menggantikan JSON sumber. Saat Anda pertama kali membuka dialog Edit Chart Config, Looker akan mengisi panel dengan beberapa JSON default. Anda dapat memulai dengan JSON ini, atau Anda dapat menghapus JSON ini dan memasukkan JSON HighCharts yang valid.

  4. Pilih bagian Konfigurasi Diagram (Ganti) dan masukkan beberapa JSON HighCharts yang valid. Nilai baru akan menggantikan nilai apa pun di bagian Konfigurasi Diagram (Sumber).

    • Lihat bagian Contoh dalam artikel ini untuk melihat contoh JSON HighCharts yang valid.
    • Looker menerima semua nilai JSON yang valid. Looker tidak menerima fungsi, tanggal, atau nilai yang tidak ditentukan.

  5. Klik <> (Format code) untuk mengizinkan Looker memformat JSON Anda dengan benar.

  6. Klik Pratinjau untuk menguji perubahan Anda.

  7. Klik Terapkan untuk menerapkan perubahan Anda. Visualisasi akan ditampilkan menggunakan nilai JSON kustom.

Setelah Anda menyesuaikan visualisasi, Anda dapat menyimpan visualisasi tersebut. Jika Anda melihat visualisasi dalam eksplorasi, simpan Jelajah tersebut. Jika Anda mengedit Tampilan atau dasbor, klik Simpan.

Jika Anda ingin mengedit opsi visualisasi default, hapus terlebih dahulu perubahan yang Anda buat di Chart Config Editor, lalu ganti nanti. Secara khusus, ikuti langkah-langkah berikut:

  1. Klik tombol Edit Chart Config di tab Plot. Looker akan menampilkan dialog Edit Chart Config.
  2. Salin teks di panel Chart Config (Override).
  3. Klik tombol Clear Chart Overrides untuk menghapus semua perubahan.
  4. Klik Terapkan.
  5. Edit visualisasi Anda menggunakan opsi visualisasi default.
  6. Klik tombol Edit Chart Config di tab Plot. Looker akan menampilkan dialog Edit Chart Config.
  7. Masukkan beberapa JSON HighCharts yang valid di panel Chart Config (Override). Anda dapat menggunakan teks yang disalin pada langkah 2 sebagai template, tetapi pastikan untuk menguji perubahan Anda menggunakan tombol Pratinjau untuk memastikan tidak ada konflik.
  8. Klik Terapkan.

Format bersyarat dengan series formatters

Chart Config Editor menerima JSON HighCharts yang paling valid. Elemen ini juga menerima atribut series formatters, yang hanya ada di Looker. Setiap serial dapat memiliki beberapa pemformat untuk menggabungkan aturan gaya yang berbeda.

Atribut series formatters menerima dua atribut: select dan style.

  • Masukkan ekspresi logika dalam atribut select untuk menunjukkan nilai data yang akan diformat.
  • Masukkan beberapa JSON ke dalam atribut style untuk menunjukkan cara memformat nilai data.

Misalnya, JSON berikut akan mewarnai setiap nilai data menjadi oranye jika lebih besar dari atau sama dengan 380:

{
  series: [{
    formatters: [{
      select: 'value >= 380',
      style: {
        color: 'orange'
      }
    }]
  }]
}

Bagian berikut menjelaskan nilai potensial dari atribut select dan style secara lebih mendetail.

Atribut select

Anda dapat menggunakan nilai berikut dalam ekspresi select:

  • value: Variabel ini menampilkan nilai deret. Misalnya, Anda dapat menggunakan select: value > 0 untuk menargetkan semua nilai positif, atau value = 100 untuk hanya mencocokkan deret yang memiliki nilai 100.
  • max: Menggunakan select: max untuk menargetkan nilai deret yang memiliki nilai maksimum.
  • min: Gunakan select: min untuk menargetkan nilai deret yang memiliki nilai minimum.
  • percent_rank: Variabel ini menargetkan nilai deret dengan persentil yang ditentukan. Misalnya, Anda dapat menggunakan select: percent_rank >= 0.9 untuk menargetkan nilai deret dalam persentil kesembilan puluh.
  • name: Variabel ini menampilkan nilai dimensi deret. Misalnya, jika Anda memiliki laporan yang menampilkan pesanan Terjual, Dibatalkan, dan Dikembalikan, Anda dapat menggunakan select: name = Sold untuk menargetkan seri tempat nilai dimensi Terjual.
  • AND/OR Gunakan AND dan OR untuk menggabungkan beberapa ekspresi logika.

Untuk melihat ekspresi ini diterapkan di Chart Config Editor, lihat contoh Mewarnai nilai maksimum, minimum, dan persentil.

Atribut style

Atribut style dapat digunakan untuk menerapkan gaya yang didukung HighCharts. Misalnya, Anda dapat mewarnai nilai deret menggunakan style.color, warna batas deret menggunakan style.borderColor, dan menetapkan lebar batas seri menggunakan style.borderWidth. Untuk daftar opsi gaya yang lebih lengkap, lihat Opsi Highcharts untuk series.column.data.

Untuk visualisasi garis, gunakan style.marker.fillColor dan style.marker.lineColor, bukan style.color. Untuk daftar opsi gaya garis yang lebih lengkap, lihat Opsi Highcharts untuk series.line.data.marker.

Untuk melihat pemformatan warna yang diterapkan di Chart Config Editor, lihat contoh Mewarnai nilai maksimum, minimum, dan persentil.

Contoh

Bagian berikut memberikan contoh beberapa kasus penggunaan umum untuk Chart Config Editor. Untuk mengetahui daftar lengkap atribut yang dapat Anda edit, lihat dokumentasi HighCharts API.

Mengubah warna latar belakang dan warna teks sumbu

Untuk mengubah warna latar belakang visualisasi, gunakan atribut chart.backgroundColor.

Demikian pula, untuk mengubah warna teks sumbu dalam visualisasi, gunakan atribut berikut:

JSON HighCharts berikut mengubah warna latar belakang visualisasi menjadi ungu, dan teks judul serta label sumbu menjadi putih.

{
  chart: {
    backgroundColor: "purple"
  },

  xAxis: {
    labels: {
      style: {
        color: "white"
      }
    },
    title: {
      style: {
        color: "white"
      }
    }
  },

  yAxis: {
    labels: {
      style: {
        color: "white"
      }
    },
    title: {
      style: {
        color: "white"
      }
    }
  }
}

Sesuaikan warna tooltip

Untuk menyesuaikan warna tooltip, gunakan atribut berikut:

JSON HighCharts berikut mengubah warna latar belakang tooltip menjadi sian, dan mengubah warna teks tooltip menjadi hitam.

{
  tooltip: {
    backgroundColor: "cyan",
    style: {
      color: "black"
    }
  }
}

Sesuaikan konten dan gaya tooltip

Untuk menyesuaikan konten tooltip, gunakan atribut berikut:

JSON HighCharts berikut mengubah format tooltip sehingga nilai sumbu x muncul di bagian atas tooltip dalam ukuran font yang lebih besar, diikuti dengan daftar semua nilai deret pada titik tersebut.

Contoh ini menggunakan fungsi dan variabel HighCharts berikut:

  • {key} adalah variabel yang menampilkan nilai sumbu x titik yang dipilih. (dalam contoh ini, bulan dan tahun).
  • {#each points}{/each} adalah fungsi yang mengulangi kode tertutup untuk setiap deret dalam diagram.
  • {series.name} adalah variabel yang menampilkan nama deret.
  • {y:.2f} adalah variabel yang menampilkan nilai sumbu y dari titik yang dipilih, yang dibulatkan menjadi dua angka desimal.
    • {y} adalah variabel yang menampilkan nilai sumbu y dari titik yang dipilih.
    • {variable:.2f} membulatkan variable ke dua angka desimal. Lihat Dokumentasi template Highcharts untuk mengetahui contoh lainnya tentang pemformatan nilai.
{
  tooltip: {
    format: '<span style="font-size: 1.8em">{key}</span><br/>{#each points}<span style="color:{color}; font-weight: bold;">\u25CF {series.name}: </span>{y:.2f}<br/>{/each}',
    shared: true
  },
}

Menambahkan anotasi dan teks diagram

Untuk menambahkan anotasi, gunakan atribut annotations. Untuk menambahkan teks ke diagram, gunakan atribut caption.

Untuk mendapatkan koordinat titik, klik Periksa Metadata Titik di bagian atas dialog Edit Chart Config. Lalu, arahkan kursor ke titik data yang ingin Anda beri anotasi. Looker menampilkan ID titik, yang dapat Anda gunakan dalam atribut annotations.labels.point.

JSON HighCharts berikut menambahkan dua anotasi ke diagram untuk menjelaskan penurunan item inventaris setelah jangka waktu tertentu. Ia juga menambahkan teks ke bagian bawah diagram untuk menjelaskan anotasi secara lebih rinci.

{
  caption: {
    text: 'Items go on clearance after 60 days, and are thrown away after 80 days. Thus we see large drops in inventory after these events.'
  },
  annotations: [{
    labels: [{
        point: "inventory_items.count-60-79",
        text: "Clearance sale"
      },
      {
        point: "inventory_items.count-80+",
        text: "Thrown away"
      },
    ]
  }]
}

Tambahkan rentang rujukan vertikal

Untuk menambahkan rentang rujukan vertikal, gunakan atribut xAxis.plotBands.

JSON HighCharts berikut menambahkan rentang referensi vertikal antara 24 November 2022 dan 29 November 2022 untuk menunjukkan periode penjualan. Ada juga keterangan di bagian bawah bagan untuk menjelaskan pentingnya band tersebut.

Perhatikan bahwa atribut to dan from dari xAxis.plotBands harus sesuai dengan nilai data dalam diagram. Dalam contoh ini, karena data berbasis waktu, atribut menerima nilai stempel waktu Unix (1669680000000 untuk 29 November 2022 dan 1669248000000 untuk 24 November 2022). Format tanggal berbasis string seperti MM/DD/YYYY dan DD-MM-YY tidak didukung di atribut HighChart to dan from.

{
  caption: {
    text: 'This chart uses the HighCharts plotBands attribute to display a band around the Black Friday Cyber Monday sale period.'
  },
  xAxis: {
    plotBands: [{
      to: 1669680000000,
      from: 1669248000000,
      label: {
        text: 'BFCM Sale Period'
      }
    }]
  },
}

Warnai nilai maksimum, minimum, dan persentil

Lihat halaman Mendapatkan hasil maksimal dari buku resep visualisasi Looker: Penyesuaian pemformatan bersyarat di diagram Kartesius untuk contoh mendalam tentang mewarnai nilai maksimum, minimum, dan persentil dari visualisasi Kartesius.