Number count
Saat angka berubah di depan seseorang, setiap kolom digit bergulir ke nilai barunya dengan smooth spring, dan bar serta ring meluncur ke panjang barunya dengan kurva in-out. Perubahannya terlihat, nilai barunya langsung terbaca, dan lebarnya tidak pernah melompat.
Penggunaan
Pakai saat
- Hitungan yang baru diubah orang: stepper, jumlah suka, isi keranjang, kursi yang dipesan.
- Angka langsung yang diperbarui saat sedang dilihat: laporan yang masuk, orang yang sedang daring, skor yang sedang dijumlahkan.
- Nilai progres yang bergerak: progress bar, progress ring, meter.
Pakai yang lain saat
- Kata atau label yang berubah (Tersimpan, Sedang ditinjau): pakai Text morph.
- Angka yang ditampilkan sekali saat dimuat (total dalam laporan): pakai Stat row. Tampilkan saja; jangan menghitung naik dari nol.
- Hitung mundur menuju tenggat: pakai Timer.
- Menunggu tanpa jumlah yang diketahui: pakai Thinking.
Letaknya. Di mana pun angkanya berada: di dalam number stepper, tombol suka, angka kunci, sel tabel yang diperbarui langsung. .roll mewarisi font, jadi berfungsi di ukuran apa pun.
Contoh
<div class="field">
<span class="field__label" id="nc-seat">Kursi bus yang dipesan</span>
<div class="stepper-field" role="group" aria-labelledby="nc-seat" data-lds-stepper data-min="1" data-max="40" data-value="18">
<button aria-label="Kurangi kursi"><span class="ic" aria-hidden="true">remove</span></button>
<span class="stepper-field__value"><span class="roll" aria-live="polite"></span></span>
<button aria-label="Tambah kursi"><span class="ic" aria-hidden="true">add</span></button>
</div>
</div>Pasien terlayani sejauh ini
dari 32
<span class="roll" data-lds-roll="27"></span>
<script type="module">
import { setRoll } from 'lampung-design-system/js';
setRoll(document.querySelector('.roll'), 28);
</script><div class="docs-col" style="max-width: 360px;" data-p="60">
<div class="progress-meta"><span>Kelengkapan berkas</span><b>12 dari 20 berkas</b></div>
<div class="progress" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" aria-label="Kelengkapan berkas"><div class="progress__fill" style="transform: scaleX(0.6);"></div></div>
<div class="docs-row"><div class="ring" role="img" aria-label="Kelengkapan berkas 60 persen"><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="67.8"></circle></svg><span class="ring__label">60%</span></div><button class="btn btn--secondary btn--sm" onclick="const box = this.closest('.docs-col'); let p = Number(box.dataset.p || 60); p = p >= 100 ? 20 : p + 20; box.dataset.p = p; box.querySelector('.progress__fill').style.transform = 'scaleX(' + p / 100 + ')'; box.querySelector('.progress').setAttribute('aria-valuenow', p); box.querySelector('.ring__val').setAttribute('stroke-dashoffset', (169.6 * (1 - p / 100)).toFixed(1)); box.querySelector('.ring__label').textContent = p + '%'; box.querySelector('.ring').setAttribute('aria-label', 'Kelengkapan berkas ' + p + ' persen');">Unggah satu berkas</button></div>
</div>Gerak dan mikrointeraksi
- Digit bergulir: setiap
.roll__coladalah kolom 0 sampai 9 yang digeser dengantranslateY(-n × 1.2em)dengan--spring-smoothselama--d-smooth(560 ms). Kolom bergulir sendiri-sendiri; digit yang tidak berubah tetap diam. Angka tabular menjaga lebarnya. - Saat jumlah digit berubah (9 ke 10), kolom baru muncul tanpa bergulir dan sisanya bergulir seperti biasa.
- Bar:
.progress__fillberubah skala pada sumbu X selama--d-considered(480 ms) dengan--ease-inout. Ring:stroke-dashoffsetdengan durasi yang sama. Grafik memakai pasangan yang sama untuk perubahan data. - Interupsi: ini transisi, jadi nilai baru di tengah guliran mengalihkan gerakan dari posisi kolom saat itu.
- Jangan menghitung naik dari nol saat dimuat: angka yang belum pernah dilihat cukup ditampilkan.
- Reduced motion: digit, bar, dan ring berubah dalam 120 ms linear.
Aksesibilitas
setRollmenulis nilai lengkap kearia-labelpada.rolldan menyembunyikan kolomnya (aria-hidden), sehingga pembaca layar membaca "28", bukan sepuluh digit.- Untuk hitungan yang berubah karena tindakan orang (stepper),
aria-live="polite"pada.rollmembacakan nilai baru; untuk hitungan langsung yang sering berubah, jangan jadikan live region. - Bar dan ring tetap memakai
role="progressbar"denganaria-valuenow(atau label teks) yang selaras dengan tampilannya.
Lakukan dan hindari
Lakukan
- Pakai
.rolluntuk hitungan yang berubah di depan orang. - Pertahankan
font-variant-numeric: tabular-nums(sudah ada di.roll). - Gerakkan bar dengan transform, bukan width.
Hindari
- Menghitung naik dari nol saat halaman dimuat.
- Menggulirkan angka di dalam tabel yang dirender ulang setiap kali diurutkan.
- Menganimasikan nilai yang tidak bisa dilihat orang berubah (di luar layar); cukup setel nilainya.
Perilaku dan kode
HTML biasa. data-lds-roll="128" merender nilainya saat init(); setRoll(el, value) mengubahnya. data-lds-stepper (dengan data-min, data-max, data-value) menggerakkan roll dari kedua tombolnya, menonaktifkan tombol di batas, dan memancarkan lds:change dengan { value }. Tombol suka menggulirkan hitungannya sendiri.