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
- ktp-pemohon.pdf
- foto-lokasi-usaha.jpg
- surat-pengantar-rt.pdf
<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. -->import { uploadProgress, uploadReset } from 'lampung-design-system/js';
xhr.upload.onprogress = (e) => uploadProgress(drop, (e.loaded / e.total) * 100);
// Starting again: uploadReset(drop)Anatomi
| Bagian | Fungsinya |
|---|---|
.drop | Wajib. Zonanya: kolom di tengah, padding 28 px, tepi garis 1.5 px. .is-over selama berkas diseret di atasnya. |
.drop > .ic | Wajib. Ikon 28 px (upload_file atau cloud_upload); naik 3 px selama .is-over. |
.empty__title / .empty__body | Judul ("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-row | Satu baris per berkas, 56 px, isian tenang, berjarak 6 px. Masuk dengan blur-in singkat. |
.file-row__icon | Petak 36 px dengan ikon jenis berkas (description, image, insert_drive_file); menampilkan error saat gagal. |
.file-row__body | Nama (.file-row__name, satu baris dengan elipsis), meta (.file-row__meta, ukuran dan status), dan .progress.progress--thin selama mengunggah. |
.icon-btn | Aksi di belakang: batal saat mengunggah, hapus saat selesai, coba lagi saat galat. Dinamai dengan berkasnya. |
.drop__ring / .drop__pct | Dibuat oleh uploadProgress(drop, pct): jejak di sekeliling tepi dan pil persentase. |
Status
| Status | Caranya |
|---|---|
.drop.is-over | Berkas sedang diseret di atasnya: warna aksen tipis, tepi aksen 2 px, skala 1.01, ikon naik 3 px. |
.drop.is-uploading / .is-complete | Disetel oleh uploadProgress: tepi menjadi tenang, jejak tergambar, pil menampilkan persentase; selesai mengubah keduanya menjadi hijau. |
.file-row uploading | Meta berbunyi "1,1 MB dari 3,0 MB · 37%", bilah .progress--thin di bawahnya, tombol batal. |
.file-row done | Meta menyebut ukuran dan "Terunggah"; bilah hilang; tombol hapus. |
.file-row.is-error | Ikon dan meta dalam warna danger; meta menyebut apa yang gagal dan apa yang harus dilakukan; tombol coba lagi. |
rejected file | Jenis 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 memanggilinput.click()pada input berkashiddendenganaria-label. Menjatuhkan berkas tidak pernah menjadi satu-satunya cara. - Setel
acceptdan sebutkan jenis serta ukurannya di teks zona, sebelum orang memilih. - Setiap baris yang mengunggah punya bilah
role="progressbar"denganaria-valuenowdan nama; pil persentase dariuploadProgressjuga 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.