Dokumentasi pengembang: Cara kerja
Asisten unggah
Asisten unggah
Akhiri error “file terlalu besar”: PDF, foto, dan gambar HEIC dari iPhone diperkecil di browser pengunjung lalu diserahkan ke formulir Anda, yang menerima file dengan ukuran sesuai.
Tempat memasang batas
Tambahkan data-pdfkind-max di tempat file masuk. Elemen terdekat yang memiliki atribut ini yang berlaku, sehingga satu kolom bisa memiliki batasnya sendiri di dalam formulir yang memakai batas lain.
| Unggahan Anda | Pasang data-pdfkind-max pada | Contoh |
|---|---|---|
| Kolom file | input-nya | <input type="file" data-pdfkind-max="5MB"> |
| Area drag-and-drop | area tersebut (mencakup drop file dan tombol “browse”-nya) | <div class="dropzone" data-pdfkind-max="5MB"> |
| Seluruh formulir | formulirnya | <form data-pdfkind-max="5MB"> |
| Semua kolom di halaman | tag script, sebagai data-max | <script src="…/embed.js" data-max="5MB" defer> |
Menuliskan batas
Tuliskan seperti 5MB, 500KB, 2.5 MB, atau 800ko, atau sebagai jumlah byte seperti 5000000. 1 MB sama dengan 1.000.000 byte.
5MB: nilainya sedikit lebih kecil, sehingga file yang diperkecil selalu lolos pemeriksaan Anda.Apa yang terjadi pada setiap file
| File | Yang dilakukan asisten |
|---|---|
| Di bawah batas | Tidak ada. File langsung diteruskan ke formulir Anda, tanpa membuka jendela. |
| PDF di atas batas | Diperkecil: font dan data duplikat dirampingkan terlebih dahulu, lalu gambar dikurangi kualitasnya hanya seperlunya. Teks tetap tajam dan bisa dipilih. |
| JPG, PNG, WebP di atas batas | Di-encode ulang dan diubah ukurannya hanya seperlunya. PNG tanpa transparansi yang tetap tidak muat akan diubah menjadi JPG. |
| HEIC atau HEIF (foto iPhone) | Selalu diubah menjadi JPG, meskipun di bawah batas, karena sebagian besar formulir tidak menerima HEIC. |
| File lainnya (Word, ZIP…) | Dibiarkan apa adanya. |
| Beberapa file sekaligus | Masing-masing diproses bergiliran; kolom Anda menerima semuanya. |
Yang dilihat pengunjung
Jendela kecil PDFkind terbuka di atas halaman Anda dengan pesan “Memperkecil file Anda…”, lalu menampilkan hasilnya (“Diperkecil dari 8,2 MB menjadi 3,9 MB”) dan menutup dengan sendirinya. Sebagian besar file membutuhkan 1 hingga 5 detik; hasil scan yang panjang di ponsel lama bisa memakan waktu sekitar 15 detik.
| Jika | Maka |
|---|---|
| file tidak bisa diperkecil hingga di bawah batas | Jendela menjelaskan alasannya, lalu file asli diteruskan sehingga formulir Anda menampilkan error seperti biasa. |
| pengunjung menutup jendela | File asli diteruskan. |
| jendela tidak dapat dimuat dalam 8 detik | File asli langsung diteruskan (sedang offline, atau diblokir oleh aturan keamanan Anda). |
| script-nya sendiri tidak dapat dimuat | Tidak ada yang berubah di halaman Anda: formulir berfungsi seperti sebelumnya. |
Bahasa jendela
Jendela mengikuti <html lang> halaman Anda. Pasang data-lang="fr" pada kolom atau script untuk memilihnya. Lihat Bahasa.
Framework
Terakhir diperbarui 3 November 2026 · Ada pertanyaan? contact@pdfkind.com