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.

Timer

Timer

Pil hitung mundur dengan angka mono tabular yang berubah kuning saat waktu hampir habis dan merah di nol, lalu memicu lds:timeup. Untuk tenggat sungguhan yang sedang dikejar orang.

Penggunaan

Pakai saat

  • Ujian atau tryout berwaktu: sisa waktu untuk seluruh tes atau untuk satu bagian.
  • Masa tahan singkat yang harus segera ditindaklanjuti: nomor antrean yang dipesan, batas waktu pembayaran, kode yang akan kedaluwarsa.
  • Menghitung naik terhadap target kerja: waktu tunggu nomor antrean di loket, chat pengaduan yang menunggu balasan, panggilan darurat yang sedang ditahan (data-lds-elapsed).

Pakai yang lain saat

  • Menampilkan berapa lama pekerjaan yang sedang berjalan: pakai Thinking.
  • Kapan sesuatu terjadi atau jatuh tempo, dalam kata-kata ("3 hari lagi", "5 menit lalu"): pakai Timestamp.
  • Batas waktu untuk membatalkan aksi di toast: pakai Toast. Toast punya bar menyusut sendiri.
  • Kemajuan melewati sejumlah soal yang tetap: pakai Progress bar.

Letaknya. Di tempat tetap yang bisa dilirik tanpa mencari: bar atas layar ujian (sisi kanan), header langkah pembayaran, di samping kolom kode. Di ponsel letakkan di bar atas; jangan pernah di dalam konten yang bergulir, karena bisa keluar dari layar.

Contoh

Menghitung naik terhadap targetWaktu tunggu nomor antrean di loket puskesmas, dengan target 12 menit. Yang pertama aman, yang kedua mendekati, yang ketiga terlambat. Kata-kata di samping pil menyebut hal yang sama.
Antrean A-04 · sesuai target
Antrean A-09 · mendekati target
Antrean A-12 · terlambat
<div class="docs-col" style="max-width: 360px;">
  <div class="docs-row"><span class="timer" data-lds-elapsed="185" data-target="720" aria-label="Antrean A-04, waktu tunggu"><span class="ic" aria-hidden="true">schedule</span><span class="timer__t"></span></span><span class="docs-note">Antrean A-04 · sesuai target</span></div>
  <div class="docs-row"><span class="timer" data-lds-elapsed="610" data-target="720" aria-label="Antrean A-09, waktu tunggu"><span class="ic" aria-hidden="true">schedule</span><span class="timer__t"></span></span><span class="docs-note">Antrean A-09 · mendekati target</span></div>
  <div class="docs-row"><span class="timer" data-lds-elapsed="905" data-target="720" aria-label="Antrean A-12, waktu tunggu"><span class="ic" aria-hidden="true">schedule</span><span class="timer__t"></span></span><span class="docs-note">Antrean A-12 · terlambat</span></div>
</div>
Sisa waktu ujian1 jam 30 menit ditampilkan sebagai h:mm:ss; di bawah satu jam sebagai m:ss.
Bagian 2 dari 3
<div class="docs-row"><span class="timer" data-lds-timer="5400" data-low="300" aria-label="Sisa waktu"></span><span class="docs-note">Bagian 2 dari 3</span></div>
Hampir habis, lalu habisTimer 20 detik yang berubah kuning di detik 10 dan mencapai nol. Tekan Replay untuk menjalankannya lagi.
<span class="timer" data-lds-timer="20" data-low="10" aria-label="Nomor antrean ditahan selama"></span>
Tampilan setiap stateSeperti apa tiga state-nya.
42:10 4:59 0:00
<div class="docs-row">
  <span class="timer" role="timer">42:10</span>
  <span class="timer is-low" role="timer">4:59</span>
  <span class="timer is-up" role="timer">0:00</span>
</div>

Anatomi

BagianFungsinya
.timerWajib. Pil 32 px di atas isian tenang, angka mono tabular semibold 15 px.
[data-lds-timer]Wajib untuk perilakunya. Jumlah detik untuk dihitung mundur.
[data-low]Sisa detik saat ia berubah menjadi .is-low (bawaan 60).
.timer__tElemen dalam opsional tempat JS menulis waktunya, agar .ic bisa berada di sampingnya. Tanpa elemen ini JS menulis waktunya ke seluruh pil.
.is-low / .is-upDiatur oleh JS: warna warning saat hampir habis, warna danger di nol.
[data-lds-elapsed]Menghitung naik: detik yang sudah berlalu saat dirender. Dengan data-target (detik) ia berubah menjadi .is-low mulai data-low (bawaan 80 % dari target) dan .is-up setelah melewati target.

Status

StatusCaranya
runningIsian tenang, teks tegas.
.is-lowPada atau di bawah data-low detik: warna latar dan teks warning.
.is-upDi nol: warna danger; lds:timeup dipicu sekali pada elemen (bubbles).

Gerak dan mikrointeraksi

  • Warna latar dan teks berubah selama --d-standard (240 ms). Digit berganti di tempat dengan angka tabular, jadi lebarnya tidak pernah bergeser.
  • Tanpa denyut atau getar saat waktu hampir habis; perubahan warna dan pengumuman sudah cukup dalam situasi tertekan.
  • Reduced motion: perubahan warna menjadi linear 120 ms; hitungannya tidak berubah.

Aksesibilitas

  • JS memasang role="timer", yang tidak diumumkan pada setiap perubahan (live region nonaktif). Beri nama dengan aria-label ("Sisa waktu").
  • Umumkan ambang batas sendiri, masing-masing sekali: baris role="status" tersembunyi yang menyebut "Sisa 5 menit" saat hampir habis, dan apa yang terjadi di nol pada lds:timeup ("Waktu habis. Jawaban Anda sudah dikumpulkan.").
  • Jangan pernah menjalankan aksi di nol tanpa memberi tahu orang apa yang terjadi. Untuk kebutuhan aksesibilitas, beri tambahan waktu jika aturan mengizinkan.

Lakukan dan hindari

Lakukan

  • Beri tahu orang sebelum timer dimulai berapa lama waktunya dan apa yang terjadi di nol.
  • Atur data-low ke peringatan yang berguna: 5 menit untuk ujian, 60 detik untuk masa tahan.
  • Dengarkan lds:timeup dan simpan pekerjaan orang terlebih dahulu.

Hindari

  • Menampilkan hitung mundur untuk sesuatu yang tidak punya tenggat sungguhan.
  • Menampilkan detik untuk tenggat yang masih berhari-hari lagi; pakai timestamp.
  • Menjalankan dua timer di satu layar.

Perilaku dan kode

HTML biasa. data-lds-timer="seconds" memulai hitung mundur sejak halaman dimuat (dari waktu akhir yang tetap, jadi tidak pernah meleset), memformat h:mm:ss atau m:ss, mengganti .is-low di bawah data-low (bawaan 60) dan .is-up di nol, memasang role="timer" dan memicu lds:timeup pada elemen. Diperbarui setiap 250 ms. Untuk melanjutkan timer setelah halaman dimuat ulang, render dengan sisa detiknya. data-lds-elapsed="seconds" menghitung naik dari sejumlah detik itu; dengan data-target ia mengganti .is-low mulai data-low (bawaan 80 % dari target) dan .is-up setelah melewatinya, dan memicu lds:overdue sekali. Elemen penghitung yang dikeluarkan dari halaman (antrean yang dipindahkan) menyimpan waktu mulainya selama lima menit, jadi mengembalikannya dengan Urungkan akan melanjutkan hitungan.