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.

Amount field

Amount field

Text field untuk uang dan angka lain yang bersatuan: mata uang atau satuannya berada di dalam kontrol sebagai teks, keyboard-nya numerik. Ketik angkanya, jangan pernah simbolnya.

Penggunaan

Pakai saat

  • Orang mengetik jumlah uang: iuran bulanan, pembayaran, besaran bantuan, harga.
  • Angka punya satuan yang harus tetap terlihat saat mengetik: %, kg, menit, hari.
  • Nilainya bisa sebesar apa pun, sehingga tombol untuk menghitung naik akan terlalu lambat.

Pakai yang lain saat

  • Bilangan bulat kecil yang diubah satu atau dua (kursi, tiket, orang): pakai Number stepper.
  • Nilai pada skala yang diketahui, ketika posisi lebih penting daripada angka pastinya (volume, tingkat kesulitan): pakai Slider.
  • Nilai minimum dan maksimum (rentang harga, rentang usia): pakai Range slider.
  • Memilih salah satu dari beberapa jumlah tetap (Rp 50.000, Rp 100.000, Rp 200.000): pakai Chips. Atau radio card saat setiap jumlah butuh satu baris keterangan.
  • Teks bebas tanpa satuan: pakai Text field.

Letaknya. Di formulir seperti text field lainnya. Buat selebar nilai terbesar yang masuk akal ditambah satuannya, bukan selebar penuh di layar lebar (sekitar 240 px untuk jumlah rupiah). Di dalam .form__row ia cocok dipasangkan dengan select untuk periode atau mata uang.

Contoh

Uang dengan mata uang dan periodeAngka mengelompokkan ribuan saat diketik; awalan dan periode tetap di luar nilai.
Rpper bulan
Dibulatkan ke ribuan terdekat.
<div class="field">
  <label class="field__label" for="fee">Iuran bulanan</label>
  <div class="control">
    <span class="control__suffix">Rp</span>
    <input id="fee" inputmode="numeric" autocomplete="off" placeholder="0" aria-describedby="fee-help">
    <span class="control__suffix">per bulan</span>
  </div>
  <span class="field__help" id="fee-help">Dibulatkan ke ribuan terdekat.</span>
</div>
<!-- Group digits on input in your own code, and parse the digits back before sending. -->
Melebihi batasPesan galat menyebut batas dan saldo saat ini, sehingga perbaikannya jelas.
Rp
Saldo Anda Rp 1.840.000. Masukkan jumlah itu atau kurang.
<div class="field" style="max-width: 320px;">
  <label class="field__label" for="af-pay">Jumlah yang dicairkan</label>
  <div class="control is-invalid"><span class="control__suffix">Rp</span><input id="af-pay" inputmode="numeric" value="2.500.000" aria-invalid="true" aria-describedby="af-pay-help"></div>
  <span class="field__help field__help--error" id="af-pay-help"><span class="ic" aria-hidden="true">error</span>Saldo Anda Rp 1.840.000. Masukkan jumlah itu atau kurang.</span>
</div>
Satuan selain uangPersen dan berat mengikuti bentuk yang sama. Desimal memakai inputmode="decimal".
%
detik
<div class="form__row" style="max-width: 520px;">
  <div class="field"><label class="field__label" for="af-disc">Keringanan retribusi</label><div class="control"><input id="af-disc" inputmode="decimal" value="12,5"><span class="control__suffix">%</span></div></div>
  <div class="field"><label class="field__label" for="af-time">Waktu layanan per warga</label><div class="control"><input id="af-time" inputmode="numeric" value="90"><span class="control__suffix">detik</span></div></div>
</div>

Anatomi

BagianFungsinya
.field / .field__label / .field__helpWajib. Pembungkus kolom yang sama dengan text field. Teks bantuan menyebut batas dan pembulatan.
.controlWajib. Kotak 44 px.
.control__suffix (first)Mata uang atau awalan ("Rp", "$"), sebelum input. Bukan bagian dari nilai.
input[inputmode]Wajib. inputmode="numeric" untuk jumlah bulat, inputmode="decimal" saat sen atau desimal diizinkan. Tetap type="text".
.control__suffix (last)Satuan atau periode opsional setelah input ("per bulan", "%", "kg").

Status

StatusCaranya
focus / hover / disabled / invalidSama persis dengan text field: .is-invalid dengan aria-invalid, .is-disabled dengan disabled.
emptyTampilkan placeholder 0 dalam warna redup; jangan pernah mengisi dulu jumlah sungguhan yang tidak dipilih orang.

Gerak dan mikrointeraksi

  • Sama dengan text field: garis tepi dan halo bertransisi dalam --d-fast (160 ms) dengan --ease-standard.
  • Pemisah ribuan muncul saat mengetik; jaga caret di akhir dan jangan menganimasikan digit di dalam input. Untuk jumlah yang berubah di luar kolom (total), pakai rolling number.
  • Reduced motion: transisi menjadi 120 ms linear.

Aksesibilitas

  • Tetap type="text" dengan inputmode: type="number" menghilangkan pengelompokan, mengubah nilai saat digulir dan memakai roda mouse, serta terbaca buruk.
  • Awalan dan satuan adalah teks terlihat di area label; jika penting untuk makna, sertakan juga di label ("Iuran bulanan dalam rupiah") atau di aria-describedby.
  • Sebut batas di teks bantuan sebelum galat terjadi ("Paling banyak Rp 5.000.000"), dihubungkan dengan aria-describedby.
  • Urai digitnya saat dikirim; pembaca layar membacakan nilai yang dikelompokkan dengan wajar.

Lakukan dan hindari

Lakukan

  • Kelompokkan ribuan sesuai lokal halaman (toLocaleString), dan urai kembali digitnya sebelum dikirim.
  • Taruh periode atau satuan setelah angka ("per bulan"), mata uang sebelumnya.
  • Sesuaikan lebar kolom dengan nilainya; kolom iuran tidak butuh selebar halaman.

Hindari

  • Memakai type="number" untuk uang.
  • Membiarkan orang mengetik simbol mata uang ke dalam nilai.
  • Memakai stepper untuk jumlah yang bisa mencapai jutaan.

Perilaku dan kode

HTML biasa. Tidak ada di sistem. Format saat input di kode Anda sendiri (kelompokkan digit, batasi panjang) dan urai kembali digitnya saat dikirim.