Lewati ke konten

File Upload

Unduh .md

File Upload menerima file lewat tarik-lepas atau pemilih file, lalu menampilkan setiap file dengan ukuran, progres, dan error-nya, misalnya file master audio.

  • Pakai saat form butuh file: master, surat pengantar, kontrak.
  • Tulis jenis file dan batas ukuran di hint: “WAV atau FLAC, maks. 200 MB.”
  • Klien hanya membatasi pemilih file dengan accept. Backend yang memeriksa isi file, dan pesannya tampil di bawah file itu.
  • Di HP tidak ada yang bisa ditarik: area ini menjadi tombol yang membuka pemilih file.
React

WAV atau FLAC, maks. 200 MB.

  • demo-lama.mp34,1 MB
Vue

WAV atau FLAC, maks. 200 MB.

  • demo-lama.mp34,1 MB
1234
  1. 1Area taruh file, sekaligus tombol
  2. 2Ikon unggah
  3. 3Baris file
  4. 4Progres unggahan
Bagian Gaya
Area unggah rounded-lg, border putus-putus input, bg-muted/30, padding 24px, rata tengah. Saat hover dan saat file ditarik ke atasnya: border-primary dan bg-primary-soft.
Teks “Tarik file ke sini atau pilih file”, lalu hint dengan text-xs muted-foreground.
Baris file Satu baris per file di card dengan border: nama, ukuran, bar Progress saat mengunggah, dan tombol hapus.
Error Pesan dari backend di bawah file dengan warna destructive; border barisnya ikut destructive.
React Vue Flutter Tipe Bawaan Kegunaan
accept accept allowedExtensions di file_picker teks semua Membatasi pemilih file, misalnya .wav,.flac.
multiple multiple allowMultiple boolean false Mengizinkan beberapa file.
files, onFilesChange v-model:files daftarmu sendiri { file, progress?, error? }[] [] Daftar file, dengan progres (0–100) dan error dari backend.
onRemove @remove handler-mu fungsi tidak ada Dijalankan setelah file dihapus, misalnya untuk membatalkan unggahannya.
hint, error hint, error Text teks tidak ada Batasannya, dan pesan backend tentang unggahan secara keseluruhan.
label, buttonLabel label, button-label Text teks bahasa Inggris Teks area: label mulai sm, buttonLabel di HP, misalnya “Pilih file”.
removeLabel, uploadingLabel sama Semantics fungsi bahasa Inggris Nama tombol dan bar, misalnya “Hapus master.wav”.
locale locale locale NumberFormat teks en-GB Cara ukuran file ditulis, misalnya "id-ID" untuk 4,1 MB.

Flutter tidak punya widget unggah; snippet-nya menggambar area dari tema, dan produk membuka pemilih file dengan paket file_picker.

import { useEffect, useState } from "react"
import { FileUpload, type FileUploadItem } from "@/components/ui/file-upload"
/** A file the backend already turned down, so the demo shows the error state. */
const rejected = new File(["demo"], "demo-lama.mp3", { type: "audio/mpeg" })
Object.defineProperty(rejected, "size", { value: 4_300_000 })
export default function FileUploadDemo() {
const [files, setFiles] = useState<FileUploadItem[]>([{ file: rejected, error: "Format file-nya belum pas." }])
// Pretend to upload: new files fill their progress bar, then settle.
useEffect(() => {
if (!files.some((f) => f.progress !== undefined)) return
const timer = setTimeout(
() =>
setFiles((list) =>
list.map((f) => (f.progress === undefined ? f : f.progress >= 100 ? { file: f.file } : { ...f, progress: f.progress + 25 }))
),
400
)
return () => clearTimeout(timer)
}, [files])
return (
<FileUpload
className="max-w-md"
accept=".wav,.flac"
multiple
label="Tarik file ke sini atau pilih file"
buttonLabel="Pilih file"
locale="id-ID"
hint="WAV atau FLAC, maks. 200 MB."
removeLabel={(name) => `Hapus ${name}`}
uploadingLabel={(name) => `Mengunggah ${name}`}
files={files}
onFilesChange={(next) => setFiles(next.map((f) => (files.includes(f) ? f : { file: f.file, progress: 0 })))}
/>
)
}
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/file-upload.json
  • Area unggah adalah tombol: Enter dan Spasi membuka pemilih file.
  • Hint dan error backend tentang unggahan secara keseluruhan terhubung ke area itu lewat aria-describedby.
  • Setiap tombol hapus dinamai sesuai file-nya, misalnya “Hapus master.wav”, dan error sebuah file terhubung ke tombol itu.
  • Setiap bar progres diberi nama, misalnya “Mengunggah master.wav”.