Bar chart
Batang vertikal yang membandingkan satu nilai di beberapa kategori atau periode (hari, kecamatan, jenis layanan). Batang dimulai dari nol, jawabannya disorot, sisanya memudar.
Penggunaan
Pakai saat
- Membandingkan jumlah atau besaran di 3 sampai 12 kategori: laporan per hari, kunjungan per puskesmas, permohonan per jenis izin.
- Periode terpisah ketika tiap batang adalah kelompoknya sendiri (minggu, bulan) dan pembaca membandingkan ukurannya.
Pakai yang lain saat
- Tren berkelanjutan dengan banyak titik: pakai Line chart.
- Bagian dari satu keseluruhan yang berjumlah 100 %: pakai Percentage bar.
- Aktivitas per hari selama berbulan-bulan: pakai Heatmap.
- Satu angka dan trennya: pakai Sparkline stat.
- Kemajuan satu hal menuju target: pakai Progress bar.
Letaknya. Di .chart-card, setengah lebar di dasbor (auto-grid dengan --min: 320px) atau selebar halaman di laporan. Tinggi plot 180 px. Di ponsel tampilkan paling banyak tujuh batang; kelompokkan sisanya (minggu, bukan hari).
Contoh
data-lds-grow batang naik dari garis dasar saat pertama terlihat.<div class="chart-card" style="max-width: 520px;">
<div><div class="chart-card__q">Hari apa yang paling sibuk?</div><div class="chart-card__sub">Laporan warga yang masuk per hari, minggu ini</div></div>
<div class="bars" role="img" data-lds-grow aria-label="Laporan warga per hari. Jumat paling sibuk dengan 31 laporan.">
<div class="bars__col"><span class="bars__bar bars__bar--muted" style="height: 38%;"><span class="bars__tip">12 laporan</span></span><span class="bars__x">Sen</span></div>
<div class="bars__col"><span class="bars__bar bars__bar--muted" style="height: 56%;"><span class="bars__tip">18 laporan</span></span><span class="bars__x">Sel</span></div>
<div class="bars__col"><span class="bars__bar bars__bar--muted" style="height: 81%;"><span class="bars__tip">26 laporan</span></span><span class="bars__x">Rab</span></div>
<div class="bars__col"><span class="bars__bar bars__bar--muted" style="height: 69%;"><span class="bars__tip">22 laporan</span></span><span class="bars__x">Kam</span></div>
<div class="bars__col"><span class="bars__bar" style="height: 97%;"><span class="bars__tip">31 laporan</span></span><span class="bars__x">Jum</span></div>
<div class="bars__col"><span class="bars__bar bars__bar--muted" style="height: 28%;"><span class="bars__tip">9 laporan</span></span><span class="bars__x">Sab</span></div>
<div class="bars__col"><span class="bars__bar bars__bar--muted" style="height: 13%;"><span class="bars__tip">4 laporan</span></span><span class="bars__x">Min</span></div>
</div>
</div><div class="chart-card" style="max-width: 520px;">
<div class="cluster" style="justify-content: space-between; align-items: flex-start;">
<div><div class="chart-card__q">Hari apa yang paling sibuk?</div><div class="chart-card__sub">Laporan warga yang masuk per hari</div></div>
<div class="seg" role="group" aria-label="Periode" data-lds-segmented style="width: 200px;">
<span class="seg__thumb"></span>
<button class="seg__btn" aria-pressed="true" onclick="this.closest('.chart-card').querySelectorAll('.bars__bar').forEach(b => { b.style.height = b.dataset.a; b.firstChild.textContent = b.dataset.ta; })">Minggu ini</button>
<button class="seg__btn" aria-pressed="false" onclick="this.closest('.chart-card').querySelectorAll('.bars__bar').forEach(b => { b.style.height = b.dataset.b; b.firstChild.textContent = b.dataset.tb; })">Minggu lalu</button>
</div>
</div>
<div class="bars" role="img" aria-label="Laporan warga per hari untuk minggu yang dipilih">
<div class="bars__col"><span class="bars__bar" style="height: 38%;" data-a="38%" data-ta="12 laporan" data-b="47%" data-tb="15 laporan"><span class="bars__tip">12 laporan</span></span><span class="bars__x">Sen</span></div>
<div class="bars__col"><span class="bars__bar" style="height: 56%;" data-a="56%" data-ta="18 laporan" data-b="66%" data-tb="21 laporan"><span class="bars__tip">18 laporan</span></span><span class="bars__x">Sel</span></div>
<div class="bars__col"><span class="bars__bar" style="height: 81%;" data-a="81%" data-ta="26 laporan" data-b="59%" data-tb="19 laporan"><span class="bars__tip">26 laporan</span></span><span class="bars__x">Rab</span></div>
<div class="bars__col"><span class="bars__bar" style="height: 69%;" data-a="69%" data-ta="22 laporan" data-b="75%" data-tb="24 laporan"><span class="bars__tip">22 laporan</span></span><span class="bars__x">Kam</span></div>
<div class="bars__col"><span class="bars__bar" style="height: 97%;" data-a="97%" data-ta="31 laporan" data-b="53%" data-tb="17 laporan"><span class="bars__tip">31 laporan</span></span><span class="bars__x">Jum</span></div>
<div class="bars__col"><span class="bars__bar" style="height: 28%;" data-a="28%" data-ta="9 laporan" data-b="19%" data-tb="6 laporan"><span class="bars__tip">9 laporan</span></span><span class="bars__x">Sab</span></div>
<div class="bars__col"><span class="bars__bar" style="height: 13%;" data-a="13%" data-ta="4 laporan" data-b="25%" data-tb="8 laporan"><span class="bars__tip">4 laporan</span></span><span class="bars__x">Min</span></div>
</div>
</div><div class="chart-card" style="max-width: 420px;">
<div><div class="chart-card__q">Bagaimana sebaran akreditasi sekolah?</div><div class="chart-card__sub">Nilai akreditasi SD negeri, satu kecamatan</div></div>
<div class="bars" role="img" aria-label="Akreditasi: A 12, B 18, C 9, D atau di bawahnya 3 sekolah">
<div class="bars__col"><span class="bars__bar" style="height: 60%; background: var(--series-3);"><span class="bars__tip">12 sekolah</span></span><span class="bars__x">A</span></div>
<div class="bars__col"><span class="bars__bar" style="height: 90%; background: var(--series-3);"><span class="bars__tip">18 sekolah</span></span><span class="bars__x">B</span></div>
<div class="bars__col"><span class="bars__bar" style="height: 45%; background: var(--series-3);"><span class="bars__tip">9 sekolah</span></span><span class="bars__x">C</span></div>
<div class="bars__col"><span class="bars__bar" style="height: 15%; background: var(--series-3);"><span class="bars__tip">3 sekolah</span></span><span class="bars__x">D</span></div>
</div>
</div>data-lds-chart; matikan satu status di legenda dan yang lain merapat.<div class="auto-grid" style="--min: 300px;">
<section class="chart-card" aria-labelledby="bc-g"><div><div class="chart-card__q" id="bc-g">Apakah makin banyak laporan ditangani tepat waktu?</div><div class="chart-card__sub">Laporan warga per minggu menurut status</div></div><div class="chart" data-lds-chart='{"label":"Laporan warga per minggu menurut status, 6 minggu terakhir. Tepat waktu naik dari 58 ke 74; terlambat tetap di bawah 12.","x":["M41","M42","M43","M44","M45","M46"],"xFull":["Minggu 5 Okt","Minggu 12 Okt","Minggu 19 Okt","Minggu 26 Okt","Minggu 2 Nov","Minggu 9 Nov"],"xName":"Minggu","kind":"bar","series":[{"name":"Tepat waktu","values":[58,61,66,63,70,74]},{"name":"Terlambat","values":[11,9,12,8,7,6]},{"name":"Belum ditangani","values":[6,5,4,6,3,2],"color":"neutral"}],"height":200}'></div></section>
<section class="chart-card" aria-labelledby="bc-s"><div><div class="chart-card__q" id="bc-s">Berapa total laporan tiap minggu?</div><div class="chart-card__sub">Laporan warga per minggu, bertumpuk menurut status</div></div><div class="chart" data-lds-chart='{"label":"Laporan warga per minggu, bertumpuk menurut status. Totalnya antara 75 dan 82; porsi yang belum ditangani terus mengecil.","x":["M41","M42","M43","M44","M45","M46"],"xFull":["Minggu 5 Okt","Minggu 12 Okt","Minggu 19 Okt","Minggu 26 Okt","Minggu 2 Nov","Minggu 9 Nov"],"xName":"Minggu","kind":"bar","series":[{"name":"Tepat waktu","values":[58,61,66,63,70,74]},{"name":"Terlambat","values":[11,9,12,8,7,6]},{"name":"Belum ditangani","values":[6,5,4,6,3,2],"color":"neutral"}],"height":200,"stacked":true,"total":true}'></div></section>
</div><section class="chart-card" style="max-width: 640px;" aria-labelledby="bc-c"><div><div class="chart-card__q" id="bc-c">Apakah setiap bulan berakhir surplus?</div><div class="chart-card__sub">Retribusi pasar dan biaya perawatan per bulan, 2026</div></div><div class="chart" data-lds-chart='{"label":"Uang masuk dan keluar per bulan, 2026. Semua bulan kecuali Agustus berakhir surplus.","x":["Jun","Jul","Agu","Sep","Okt","Nov"],"xFull":["Juni","Juli","Agustus","September","Oktober","November"],"xName":"Bulan","kind":"bar","stacked":true,"total":true,"format":{"prefix":"Rp ","suffix":" jt","compact":true},"series":[{"name":"Retribusi pasar","values":[184,212,158,241,269,283],"color":3},{"name":"Biaya perawatan","values":[-142,-151,-173,-168,-179,-186],"color":2}],"height":220}'></div></section>Anatomi
| Bagian | Fungsinya |
|---|---|
.bars | Wajib. Plotnya: baris flex setinggi 180 px, batang rata bawah, berjarak 8 px. role="img" dengan aria-label yang menyatakan kesimpulannya. |
.bars__col | Wajib. Satu kategori: batang dan labelnya. |
.bars__bar | Wajib. Tinggi diatur inline sebagai persen dari plot. --series-1 secara default, lebar maksimal 36 px, sudut atas membulat. |
.bars__bar--muted | Opsional. Memudarkan batang yang bukan jawaban. |
.bars__tip | Opsional. Nilai dalam tip gelap di atas batang saat hover. |
.bars__x | Wajib. Label kategori di bawah batang, 12 px --text-muted. |
Varian dan ukuran
| Kelas atau atribut | Kapan |
|---|---|
.bars (HTML) | Satu seri, markup statis, sorotan, dan tip saat hover. Tambahkan data-lds-grow agar batang tumbuh saat pertama terlihat. |
data-lds-chart, kind "bar" | Digambar dari data: beberapa seri berkelompok berdampingan, tooltip per periode, toggle legenda, pembacaan dengan keyboard, tabel tersembunyi. |
stacked: true | Batang bertumpuk menjadi total; nilai negatif bertumpuk di bawah nol (masuk dan keluar, untung dan rugi). |
highlight: index | Satu seri yang digambar dari data: jawabannya memakai warna seri, sisanya diredam. |
Status
| Status | Caranya |
|---|---|
hover | Setiap batang meredup ke 45 % kecuali yang di-hover, yang .bars__tip-nya naik muncul. |
data change | Atur tinggi baru; tingginya bertransisi. Perbarui juga aria-label. |
loading, empty, error | Lihat state grafik. |
Gerak dan mikrointeraksi
- Tinggi bertransisi selama
--d-considered(480 ms) dengan--ease-inout, karena ini nilai yang sudah tampil dan sedang berubah. - Hover: opasitas selama
--d-fast; tip muncul pudar selama--d-fastdan naik 3 px dengan--spring-snappy. - Saat pertama terlihat: dengan
data-lds-grow(batang HTML) atau saat digambar dari data, batang tumbuh dari garis dasar dengan--spring-smooth(560 ms), berjarak 35 ms. Tanpa itu batang langsung tampil pada tingginya. - Grafik yang digambar dari data men-tween nilai dan skala selama 480 ms dari yang tampil saat data berubah atau satu seri dimatikan.
- Dengan reduced motion perubahan tinggi menjadi 120 ms dan tidak ada yang tumbuh.
Aksesibilitas
role="img"pada.barsdenganaria-labelyang menyebut kesimpulan dan angka kuncinya.- Tip hanya muncul saat hover dan batang tidak bisa difokus, jadi taruh setiap nilai penting di label atau tabel
.sr-only. - Label kategori adalah teks asli di bawah setiap batang; buat singkat (Sen, Sel, A, B).
- Batang yang diredam adalah bantuan visual; jawaban yang disorot harus juga ada di judul atau label.
Lakukan dan hindari
Lakukan
- Mulai dari nol dan jaga lebar batang tetap sama.
- Sorot batang yang menjawab pertanyaan.
- Urutkan kategori menurut maknanya (hari berurutan) atau menurut nilainya, jangan acak.
Hindari
- Memakai lebih dari 12 batang atau memutar label.
- Memberi warna berbeda untuk setiap batang.
- Menumpuk atau mengelompokkan batang secara manual di markup
.bars; gambar dari data dengandata-lds-chart.
Perilaku dan kode
HTML biasa. Batang HTML tidak butuh script (data-lds-grow menambahkan animasi masuk). Batang berkelompok, bertumpuk, dan divergen: data-lds-chart dengan kind: "bar", atau drawChart(el, config); lihat area chart untuk semua opsinya.