Proyek komunitas. Ini bukan situs resmi pemerintah.

Dikelola sukarelawan. Lampung Design System dibangun oleh komunitas open source. Tidak ada instansi pemerintah yang mengelola atau mendukungnya secara resmi.

Layanan resmi memakai go.id. Situs pemerintah Indonesia berakhiran .go.id. Jangan masukkan NIK di situs yang Anda ragukan.

Progress ring

Progress ring

Track melingkar dengan nilai digambar sebagai busur dan angka di tengah. Untuk tempat yang ringkas dan skor yang dinilai; sebutkan juga penilaiannya dengan kata-kata.

Penggunaan

Pakai saat

  • Skor atau tingkat penyelesaian yang harus muat dalam kotak: hasil tes di card, kehadiran di profil, target hari ini di layar beranda ponsel.
  • Skor yang dinilai, saat warnanya menunjukkan lulus, nyaris atau tidak lulus (ring--success|warning|danger), selalu dengan kata-kata di sampingnya.
  • Tugas dengan kemajuan di dalam tile atau baris list ketika bar terlalu lebar.

Pakai yang lain saat

  • Ada ruang untuk garis, atau kemajuannya milik tugas yang panjang: pakai Progress bar.
  • Tingkat atau kapasitas dalam segmen (penyimpanan, kekuatan): pakai Meter.
  • Bagian dari keseluruhan lintas beberapa kategori: pakai Donut.
  • Angkanya sendiri yang penting, dalam deretan angka kunci: pakai Stat row.
  • Tidak ada nilai terukur, hanya menunggu: pakai Spinner.

Letaknya. Di samping label yang diukurnya: di awal card, di baris list sebelum judul, di header hasil di samping keputusannya. Bawaan 64 px; 40 sampai 48 px di baris; jangan lebih besar dari 120 px (lebih dari itu stat row atau grafik lebih mudah dibaca).

Contoh

Skor dengan keputusanWarna mendukung kata-kata; tidak pernah menggantikannya.
Lulus
Nilai batas lulus 65
Sedikit di bawah
Kurang 3 poin
Tidak lulus
Ujian ulang dibuka 2 Desember
<div class="docs-row" style="gap: 28px;">
  <div class="docs-row"><div class="ring ring--success" role="img" aria-label="Skor 86 dari 100, lulus"><svg viewBox="0 0 64 64" aria-hidden="true"><circle class="ring__track" cx="32" cy="32" r="27"></circle><circle class="ring__val" cx="32" cy="32" r="27" stroke-dasharray="169.6" stroke-dashoffset="23.7"></circle></svg><span class="ring__label" aria-hidden="true">86</span></div><div><div class="card__title">Lulus</div><div class="card__sub">Nilai batas lulus 65</div></div></div>
  <div class="docs-row"><div class="ring ring--warning" role="img" aria-label="Skor 62 dari 100, sedikit di bawah batas lulus"><svg viewBox="0 0 64 64" aria-hidden="true"><circle class="ring__track" cx="32" cy="32" r="27"></circle><circle class="ring__val" cx="32" cy="32" r="27" stroke-dasharray="169.6" stroke-dashoffset="64.4"></circle></svg><span class="ring__label" aria-hidden="true">62</span></div><div><div class="card__title">Sedikit di bawah</div><div class="card__sub">Kurang 3 poin</div></div></div>
  <div class="docs-row"><div class="ring ring--danger" role="img" aria-label="Skor 38 dari 100, tidak lulus"><svg viewBox="0 0 64 64" aria-hidden="true"><circle class="ring__track" cx="32" cy="32" r="27"></circle><circle class="ring__val" cx="32" cy="32" r="27" stroke-dasharray="169.6" stroke-dashoffset="105.2"></circle></svg><span class="ring__label" aria-hidden="true">38</span></div><div><div class="card__title">Tidak lulus</div><div class="card__sub">Ujian ulang dibuka 2 Desember</div></div></div>
</div>
Kemajuan tugas yang bergerakBusur bergerak halus ke setiap nilai baru. Tekan tombolnya.
40
<div class="ring" role="progressbar" aria-label="Materi selesai minggu ini" aria-valuemin="0" aria-valuemax="100" aria-valuenow="40">
  <svg viewBox="0 0 64 64" aria-hidden="true">
    <circle class="ring__track" cx="32" cy="32" r="27"></circle>
    <circle class="ring__val" cx="32" cy="32" r="27" stroke-dasharray="169.6" stroke-dashoffset="101.8"></circle>
  </svg>
  <span class="ring__label">40</span>
</div>
Kecil, di baris listPada 40 px, atur ukurannya secara inline dan kecilkan labelnya juga.
Pemahaman bacaan
15 dari 20 soal
Penalaran numerik
6 dari 20 soal
<div class="list" style="max-width: 420px;">
  <div class="lrow"><div class="ring" style="width: 40px; height: 40px;" role="img" aria-label="75 persen selesai"><svg viewBox="0 0 64 64" aria-hidden="true"><circle class="ring__track" cx="32" cy="32" r="27"></circle><circle class="ring__val" cx="32" cy="32" r="27" stroke-dasharray="169.6" stroke-dashoffset="42.4"></circle></svg><span class="ring__label" style="font-size: 12px;" aria-hidden="true">75</span></div><div class="lrow__body"><div class="lrow__title">Pemahaman bacaan</div><div class="lrow__sub">15 dari 20 soal</div></div></div>
  <div class="lrow"><div class="ring" style="width: 40px; height: 40px;" role="img" aria-label="30 persen selesai"><svg viewBox="0 0 64 64" aria-hidden="true"><circle class="ring__track" cx="32" cy="32" r="27"></circle><circle class="ring__val" cx="32" cy="32" r="27" stroke-dasharray="169.6" stroke-dashoffset="118.7"></circle></svg><span class="ring__label" style="font-size: 12px;" aria-hidden="true">30</span></div><div class="lrow__body"><div class="lrow__title">Penalaran numerik</div><div class="lrow__sub">6 dari 20 soal</div></div></div>
</div>

Anatomi

BagianFungsinya
.ringWajib. Kotak 64 x 64. Atur width dan height secara inline untuk ukuran lain; ketebalan garis ikut berskala.
svg[viewBox="0 0 64 64"]Wajib. Diputar agar busur dimulai dari arah jam 12.
circle.ring__trackWajib. cx="32" cy="32" r="27": track abu-abu penuh.
circle.ring__valWajib. Lingkaran yang sama dengan stroke-dasharray="169.6" (keliling, 2 x pi x 27) dan stroke-dashoffset="169.6 x (1 - value)".
.ring__labelAngka opsional di tengah ring, angka tabular.
.ring--success|warning|dangerMewarnai busur untuk skor yang dinilai. Bawaannya aksen.

Varian dan ukuran

Kelas atau atributKapan
ringBusur aksen. Kemajuan tanpa penilaian.
ring--successLulus, sesuai jalur.
ring--warningNyaris, perlu perhatian.
ring--dangerGagal atau jauh tertinggal.

Status

StatusCaranya
valuestroke-dashoffset = 169.6 x (1 - value / max) pada .ring__val.
emptyOffset 169.6: hanya track yang tampil. Tulis "Belum dimulai" di sampingnya.
completeOffset 0. Pertimbangkan ring--success dan satu kata ("Selesai").

Gerak dan mikrointeraksi

  • Busur bergerak lewat stroke-dashoffset dengan --ease-inout selama --d-considered (480 ms), sebagai transition, jadi nilai baru berganti target dari posisi saat itu.
  • Ring di React juga menghitung naik angkanya sekali selama 900 ms dengan ease-out cubic; dengan reduced motion nilainya langsung tampil.
  • Dengan reduced motion perubahan busur menjadi perubahan linear 120 ms.

Aksesibilitas

  • Skor adalah gambar dari sebuah angka: role="img" dengan aria-label yang menyebut angka dan keputusannya ("Skor 86 dari 100, lulus"), dan aria-hidden pada label yang terlihat.
  • Kemajuan tugas langsung: role="progressbar" dengan aria-valuemin, aria-valuemax, aria-valuenow dan nama.
  • SVG memakai aria-hidden="true". Jangan biarkan warna ring menjadi satu-satunya sinyal; tulis keputusannya di samping.

Lakukan dan hindari

Lakukan

  • Tulis keputusannya dengan kata-kata di samping ring berwarna.
  • Isi label hanya dengan angka; letakkan satuan dan konteks di luar.
  • Pakai r = 27 dan dasharray 169.6 agar setiap ring di produk tergambar sama.

Hindari

  • Memakai ring untuk beberapa kategori; pakai donut.
  • Menjadikannya grafik utama lebih dari 120 px.
  • Menaruh angka tiga digit di ring 40 px tanpa mengecilkan labelnya.

Perilaku dan kode

HTML biasa. Tidak ada di HTML biasa: atur stroke-dashoffset dan label dari kode Anda.

React. Dari lampung-design-system/react.

import { Ring } from 'lampung-design-system/react';

<Ring value={86} tone="success" ariaLabel="Score 86 of 100, passed" />
<Ring value={12} max={20} size={44} label="12" ariaLabel="12 of 20 lessons" />