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.

Date range

Date range

Tombol yang menampilkan rentang saat ini dan membuka pilihan siap di samping kalender dua bulan (satu bulan di ponsel). Pilihan siap langsung berlaku; memilih tanggal awal menampilkan pratinjau rentang saat Anda bergerak, memilih tanggal akhir menunggu Terapkan.

Penggunaan

Pakai saat

  • Periode dasbor, laporan, atau ekspor: 30 hari terakhir, bulan ini, rentang khusus.
  • Menyaring catatan berdasarkan waktu kejadiannya: permohonan di antara dua tanggal, pendaftaran kuartal ini.

Pakai yang lain saat

  • Satu tanggal di formulir: pakai Date field.
  • Memilih hari ketika melihat minggunya penting dan kalendernya adalah halaman itu sendiri: pakai Calendar.
  • Hanya dua sampai lima periode tetap (7 hari, 30 hari, 90 hari): pakai Segmented control. Lebih cepat daripada membuka pemilih.

Letaknya. Di aksi header halaman atau toolbar, biasanya di akhir baris; popover-nya terbuka di bawahnya dan menjaga dirinya tetap di layar. Di bawah 720 px pilihan siap menjadi baris pil yang menggulir di atas satu bulan.

Contoh

Periode laporanBuka: pilih pilihan siap untuk langsung menerapkannya, atau pilih hari pertama, gerakkan di atas kalender untuk melihat rentangnya, pilih hari terakhir lalu Terapkan. Hari setelah hari ini tidak tersedia.
<div class="daterange" data-lds-daterange data-start="2026-10-18" data-end="2026-11-16" data-today="2026-11-16">
  <button class="btn btn--secondary btn--md daterange__trigger" aria-haspopup="dialog" aria-expanded="false" data-lds-menu="dr-1"><span class="ic" aria-hidden="true">calendar_month</span><span class="daterange__label">18 Okt sampai 16 Nov 2026</span><span class="ic" aria-hidden="true">expand_more</span></button>
  <div class="popover daterange__pop" id="dr-1" role="dialog" aria-label="Pilih tanggal"></div>
</div>

Anatomi

BagianFungsinya
.daterange[data-lds-daterange]Wajib. data-start, data-end (tanggal ISO); data-today untuk contoh tetap; data-locale.
.btn.daterange__triggerWajib. Pemicu dengan data-lds-menu yang menunjuk ke popover: ikon calendar_month, .daterange__label, dan expand_more.
.popover.daterange__popWajib. Popover role="dialog" kosong; hook mengisinya dengan .daterange__presets, .daterange__months (dua kalender), dan .daterange__foot (ringkasan rentang, Batal, Terapkan).

Status

StatusCaranya
pickingSetelah hari pertama: ujung yang disorot atau difokus menampilkan pratinjau rentang dengan warna tenang, ringkasan berbunyi "Pilih hari terakhir", dan Terapkan menunggu.
rangeKedua ujung terisi, hari di antaranya berwarna aksen tipis (.is-range).
preset onPilihan siap yang cocok dengan rentang tampil tertekan.
future daysRedup dan nonaktif.

Gerak dan mikrointeraksi

  • Popover terbuka seperti popover lainnya: dari sudut pemicunya dengan --spring-smooth, keluar dengan --ease-exit.
  • Warna hari berubah perlahan selama --d-fast dan mengecil ke 0.88 saat ditekan, kembali dengan --spring-snappy.

Aksesibilitas

  • Pemicu menyebut rentangnya dalam kata dan punya aria-haspopup="dialog" serta aria-expanded.
  • Setiap hari adalah tombol berlabel tanggal lengkap; tombol panah berpindah per hari dan per minggu melintasi kedua bulan (dan berganti bulan bila perlu), Enter atau Spasi memilih.
  • Escape dan klik di luar menutup tanpa mengubah rentang; Terapkan dan pilihan siap mengembalikan fokus ke pemicu dan rentang baru diumumkan.

Lakukan dan hindari

Lakukan

  • Mulai dengan bawaan yang masuk akal (30 hari terakhir) dan tampilkan di pemicu.
  • Kirim permintaan data Anda saat lds:change, bukan di setiap pilihan.

Hindari

  • Memaksa orang memilih kedua ujung untuk rentang yang umum; tawarkan sebagai pilihan siap.
  • Mengizinkan hari di masa depan untuk data yang belum mungkin ada.

Perilaku dan kode

HTML biasa. data-lds-daterange menghubungkannya (atau panggil dateRange(el)), memakai hook menu untuk membuka dan menutup. Ia memicu lds:change dengan { start, end } (tanggal ISO). Handle-nya punya start, end, dan set(start, end).