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.

File input

File input

Zona lepas dengan tombol Pilih sungguhan, dan satu baris per berkas terpilih yang menampilkan ukuran, progres unggah, galat, dan cara menghapusnya. Tombol adalah jalur utama; menjatuhkan berkas hanya jalan pintas.

Penggunaan

Pakai saat

  • Orang melampirkan berkas ke formulir: KTP, kartu keluarga, foto lokasi, surat pengantar.
  • Beberapa berkas diunggah sekaligus dan masing-masing butuh progres, coba lagi, dan hapus sendiri (.file-row).
  • Satu berkas besar diunggah dan zona lepas itu sendiri menampilkan progres di sekeliling tepinya (uploadProgress).

Pakai yang lain saat

  • Menampilkan berkas yang sudah tersimpan, untuk dibuka atau diunduh: pakai List. Baris bertautan dengan ikon berkas; tanpa zona lepas.
  • Progres satu tugas panjang yang bukan unggahan (verifikasi, impor): pakai Progress bar.
  • Menempel atau mengetik teks, tautan, atau kode: pakai Textarea.
  • Melihat gambar terpilih dalam ukuran besar: pakai Lightbox.

Letaknya. Di formulir, selebar kolomnya, dengan baris berkas tepat di bawah zona lepas. Di ponsel buat zona lepas pendek (orang mengetuk Pilih; tidak ada yang menyeret) dan baris selebar layar.

Contoh

Zona lepas dengan baris berkasPilih berkas (atau seret ke atas zona). Setiap berkas menjadi satu baris; baris yang mengunggah menampilkan bilah tipis, baris selesai menampilkan tombol hapus, baris gagal menyebut alasannya dan menawarkan coba lagi.
Lepaskan dokumen persyaratan di sini PDF atau gambar, masing-masing paling besar 10 MB
  • ktp-pemohon.pdf2,4 MB · Terunggah
  • foto-lokasi-usaha.jpg1,1 MB dari 3,0 MB · 37%
  • surat-pengantar-rt.pdfUnggahan gagal. Periksa koneksi lalu coba lagi.
<div class="drop">
  <span class="ic" aria-hidden="true">upload_file</span>
  <span class="empty__title">Lepaskan dokumen persyaratan di sini</span>
  <span class="empty__body">PDF atau gambar, masing-masing paling besar 10 MB</span>
  <button type="button" class="btn btn--secondary btn--sm">Pilih berkas</button>
  <input type="file" multiple accept=".pdf,image/*" hidden aria-label="Dokumen persyaratan">
</div>
<ul aria-label="Berkas terpilih">
  <li class="file-row">
    <span class="file-row__icon"><span class="ic" aria-hidden="true">image</span></span>
    <span class="file-row__body">
      <span class="file-row__name">foto-lokasi-usaha.jpg</span>
      <span class="file-row__meta">1,1 MB dari 3,0 MB · 37%</span>
      <span class="progress progress--thin" role="progressbar" aria-label="Mengunggah foto-lokasi-usaha.jpg" aria-valuemin="0" aria-valuemax="100" aria-valuenow="37"><span class="progress__fill" style="transform: scaleX(0.37);"></span></span>
    </span>
    <button type="button" class="icon-btn" aria-label="Batalkan unggahan foto-lokasi-usaha.jpg"><span class="ic" aria-hidden="true">close</span></button>
  </li>
  <li class="file-row is-error">…<span class="file-row__meta">Unggahan gagal. Periksa koneksi lalu coba lagi.</span>…</li>
</ul>
<!-- Your code: the button calls input.click(); dragover sets .is-over, dragleave and drop remove it; each file becomes a row. -->
Satu berkas, progres di sekeliling tepiUntuk satu unggahan, zona menelusuri tepinya sendiri dan menampilkan pil persentase; jejaknya menjadi hijau pada 100 %. Tekan Unggah.
denah-lokasi-usaha.pdf 8,6 MB
import { uploadProgress, uploadReset } from 'lampung-design-system/js';

xhr.upload.onprogress = (e) => uploadProgress(drop, (e.loaded / e.total) * 100);
// Starting again: uploadReset(drop)

Anatomi

BagianFungsinya
.dropWajib. Zonanya: kolom di tengah, padding 28 px, tepi garis 1.5 px. .is-over selama berkas diseret di atasnya.
.drop > .icWajib. Ikon 28 px (upload_file atau cloud_upload); naik 3 px selama .is-over.
.empty__title / .empty__bodyJudul ("Lepaskan berkas Anda di sini") serta jenis dan ukuran yang diterima. Zona lepas tidak punya kelas teks sendiri; kelas empty state ini memberi tipografi yang tepat.
.btn + input[type=file][hidden]Wajib. Tombol sungguhan yang membuka input berkas tersembunyi. Ini jalur keyboard dan ponsel.
ul > li.file-rowSatu baris per berkas, 56 px, isian tenang, berjarak 6 px. Masuk dengan blur-in singkat.
.file-row__iconPetak 36 px dengan ikon jenis berkas (description, image, insert_drive_file); menampilkan error saat gagal.
.file-row__bodyNama (.file-row__name, satu baris dengan elipsis), meta (.file-row__meta, ukuran dan status), dan .progress.progress--thin selama mengunggah.
.icon-btnAksi di belakang: batal saat mengunggah, hapus saat selesai, coba lagi saat galat. Dinamai dengan berkasnya.
.drop__ring / .drop__pctDibuat oleh uploadProgress(drop, pct): jejak di sekeliling tepi dan pil persentase.

Status

StatusCaranya
.drop.is-overBerkas sedang diseret di atasnya: warna aksen tipis, tepi aksen 2 px, skala 1.01, ikon naik 3 px.
.drop.is-uploading / .is-completeDisetel oleh uploadProgress: tepi menjadi tenang, jejak tergambar, pil menampilkan persentase; selesai mengubah keduanya menjadi hijau.
.file-row uploadingMeta berbunyi "1,1 MB dari 3,0 MB · 37%", bilah .progress--thin di bawahnya, tombol batal.
.file-row doneMeta menyebut ukuran dan "Terunggah"; bilah hilang; tombol hapus.
.file-row.is-errorIkon dan meta dalam warna danger; meta menyebut apa yang gagal dan apa yang harus dilakukan; tombol coba lagi.
rejected fileJenis salah atau terlalu besar: jangan tambahkan baris; sebutkan di bawah zona dengan .field__help--error ("surat.docx bukan PDF atau gambar").

Gerak dan mikrointeraksi

  • Seret di atas: warna dan tepi dalam --d-fast (160 ms) dengan --ease-standard; zona berskala 1.01 dengan --spring-smooth (560 ms); ikon naik dengan --spring-snappy. Keluar membalik transisi yang sama.
  • Baris baru masuk dengan lds-blur-in (naik 4 px dan blur 4 px) dalam --d-standard (240 ms) dengan --ease-enter.
  • Bilah baris terisi dengan transform: scaleX() dalam --d-considered (480 ms) dengan --ease-inout, sehingga event progres yang melompat-lompat tetap tampak halus.
  • Jejak tepi (uploadProgress) menggerakkan garis putusnya dalam 200 ms linear; pil turun dari 10 px dengan blur memakai --spring-snappy; pada 100 % haptic berhasil berbunyi di ponsel. Lihat upload progress.
  • Reduced motion: tanpa skala atau naik; perubahan warna dan progres menjadi 120 ms linear.

Aksesibilitas

  • Pengguna keyboard dan pembaca layar memakai tombol Pilih, <button type="button"> sungguhan yang memanggil input.click() pada input berkas hidden dengan aria-label. Menjatuhkan berkas tidak pernah menjadi satu-satunya cara.
  • Setel accept dan sebutkan jenis serta ukurannya di teks zona, sebelum orang memilih.
  • Setiap baris yang mengunggah punya bilah role="progressbar" dengan aria-valuenow dan nama; pil persentase dari uploadProgress juga progressbar.
  • Tombol baris menyebut aksi dan berkasnya ("Coba lagi surat-pengantar-rt.pdf"). Umumkan unggahan yang selesai atau gagal di area aria-live="polite" atau toast.

Lakukan dan hindari

Lakukan

  • Unggah langsung setelah memilih dan tampilkan progres per berkas; biarkan orang tetap mengisi formulir.
  • Sebutkan alasan berkas gagal dan pertahankan barisnya agar bisa dicoba lagi.
  • Pakai tombol sungguhan yang dilabeli sesuai hasilnya ("Pilih berkas", "Pilih foto").

Hindari

  • Mengandalkan seret dan lepas saja, atau menyembunyikan input berkas tanpa tombol.
  • Menambahkan baris untuk berkas yang akan ditolak; jelaskan di bawah zona.
  • Menggambar bilah progres sendiri di dalam baris; pakai .progress--thin.

Perilaku dan kode

HTML biasa. uploadProgress(drop, pct) membuat jejak tepi dan pil persentase pada .drop lalu memperbaruinya (menambahkan .is-uploading, .is-complete pada 100 %); uploadReset(drop) menghapus kedua kelas. Memilih berkas, seret di atas, dan baris berkas adalah tugas Anda: sistem tidak punya hook data-lds-* untuk itu.