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.

Rolling number

Rolling number

Angka yang setiap digitnya bergeser ke nilai barunya dengan spring yang halus, seperti odometer. Untuk hitungan yang berubah saat orang sedang melihatnya.

Penggunaan

Pakai saat

  • Hitungan yang berubah di depan orang: suka, kursi terisi, nilai stepper, butir di keranjang.
  • Angka langsung yang naik atau turun selama halaman terbuka.

Pakai yang lain saat

  • Angka yang menghitung naik dari nol sekali saat pertama muncul: pakai Number count.
  • Hitung mundur ke tenggat: pakai Timer.
  • Angka statis: pakai Stat row. Tulis sebagai teks dengan angka tabular.
  • Angka yang diketik atau dinaik-turunkan orang: pakai Number stepper. Stepper sudah memakai rolling number untuk nilainya.

Letaknya. Sebaris di dalam teks atau kontrol pemilik angka itu: tombol suka, stepper, nilai statistik, badge keranjang. Mewarisi font, ukuran, dan warna dari induknya.

Contoh

Kursi terisiSetiap digit bergeser ke tempat barunya. Tekan tombolnya.
<span class="roll" role="img" data-lds-roll="128"></span>
<script type="module">
  import { setRoll } from 'lampung-design-system/js';
  setRoll(document.querySelector('.roll'), 129);
</script>
Di dalam kontrolTombol suka menggulirkan hitungannya; stepper menggulirkan nilainya.
<button class="like" aria-pressed="false" data-lds-like aria-label="Suka"><span class="like__heart"><span class="ic" aria-hidden="true">favorite</span></span><span class="roll" data-lds-roll="24"></span></button>

Anatomi

BagianFungsinya
.rollWajib. Kotak sebaris setinggi 1,2 em yang memotong kolomnya. Angka tabular.
[data-lds-roll]Nilai awal. init() membangun kolom darinya.
.roll__colSatu kolom per digit berisi digit 0 sampai 9, digeser dengan transform. Dibangun oleh JS; aria-hidden.

Status

StatusCaranya
valuesetRoll(el, value) memasang aria-label, menambah atau menghapus kolom, dan menggeser masing-masing ke digitnya.

Gerak dan mikrointeraksi

  • Setiap kolom bergerak dengan transform: translateY() memakai --spring-smooth (--d-smooth, 560 ms), jadi 128 ke 175 menggulirkan puluhan dan satuan bersamaan sementara ratusan diam.
  • Ini transition: nilai baru di tengah gulir mengarah ulang dari posisi digit saat itu.
  • Kolom yang ditambah atau dihapus (99 ke 100) muncul dan hilang seketika.
  • Reduced motion: perubahan linear 120 ms.

Aksesibilitas

  • Kolomnya aria-hidden; setRoll menulis nilainya ke aria-label pada .roll. span biasa berlabel tidak dibaca semua pembaca layar, jadi beri .roll role="img" bila berdiri sendiri, atau andalkan label kontrol di sekitarnya.
  • Jangan jadikan live region. Bila perubahannya penting, umumkan sekali di baris role="status" ("129 kursi terisi").

Lakukan dan hindari

Lakukan

  • Pakai untuk hitungan yang berubah di depan mata, bukan untuk setiap angka di halaman.
  • Biarkan ukuran dan ketebalannya mewarisi teks di sekitarnya.

Hindari

  • Memberikan pemisah ribuan, tanda, atau desimal: yang digulir hanya digit. Format "1.280" atau "-3" sebagai teks.
  • Menggulirkan angka saat halaman pertama dimuat; pakai number count sekali, atau tidak sama sekali.

Perilaku dan kode

HTML biasa. data-lds-roll="128" membangun kolom saat init(). setRoll(el, value) menggulir ke nilai baru (hanya digit 0 sampai 9).