Tài liệu cho nhà phát triển: Cách hoạt động
Trợ lý tải lên
Trợ lý tải lên
Chấm dứt lỗi “file quá lớn”: PDF, ảnh chụp và ảnh HEIC từ iPhone được giảm dung lượng ngay trên trình duyệt của khách truy cập rồi chuyển cho biểu mẫu, nên biểu mẫu nhận được file vừa giới hạn.
Đặt giới hạn ở đâu
Thêm data-pdfkind-max vào nơi nhận file. Phần tử gần nhất có thuộc tính này sẽ được ưu tiên, nên một trường có thể có giới hạn riêng bên trong một biểu mẫu có giới hạn khác.
| Kiểu tải lên | Đặt data-pdfkind-max lên | Ví dụ |
|---|---|---|
| Một trường tải file | thẻ input | <input type="file" data-pdfkind-max="5MB"> |
| Một vùng kéo thả | vùng đó (áp dụng cho cả thao tác thả file lẫn nút “chọn file” của vùng) | <div class="dropzone" data-pdfkind-max="5MB"> |
| Cả một biểu mẫu | thẻ form | <form data-pdfkind-max="5MB"> |
| Mọi trường trên trang | thẻ script, dưới dạng data-max | <script src="…/embed.js" data-max="5MB" defer> |
Cách viết giới hạn
Viết theo dạng 5MB, 500KB, 2.5 MB hoặc 800ko, hoặc dưới dạng số byte như 5000000. 1 MB bằng 1.000.000 byte.
5MB: giá trị này thấp hơn một chút, nên file sau khi giảm luôn vượt qua bước kiểm tra của bạn.Mỗi loại file được xử lý thế nào
| File | Trợ lý làm gì |
|---|---|
| Dưới giới hạn | Không làm gì. File được chuyển thẳng tới biểu mẫu, không mở cửa sổ nào. |
| PDF vượt giới hạn | Được giảm dung lượng: font chữ và dữ liệu trùng lặp được tinh gọn trước, sau đó ảnh chỉ được làm nhẹ ở mức cần thiết. Chữ vẫn sắc nét và chọn được. |
| JPG, PNG, WebP vượt giới hạn | Được mã hóa lại và thu nhỏ ở mức cần thiết. File PNG không có nền trong suốt mà không thể vừa giới hạn sẽ được chuyển thành JPG. |
| HEIC hoặc HEIF (ảnh iPhone) | Luôn được chuyển sang JPG, kể cả khi dưới giới hạn, vì phần lớn biểu mẫu không nhận HEIC. |
| Mọi file khác (Word, ZIP…) | Giữ nguyên. |
| Nhiều file cùng lúc | Từng file được xử lý lần lượt; trường tải file nhận đủ tất cả. |
Khách truy cập sẽ thấy gì
Một cửa sổ PDFkind nhỏ mở ra trên trang của bạn với dòng “Đang giảm dung lượng file…”, sau đó hiển thị kết quả (“Đã giảm từ 8.2 MB xuống 3.9 MB”) rồi tự đóng. Phần lớn file mất từ 1 đến 5 giây; một bản scan dài trên điện thoại cũ có thể mất khoảng 15 giây.
| Nếu | Thì |
|---|---|
| file không thể giảm xuống dưới giới hạn | Cửa sổ giải thích lý do, sau đó file gốc được chuyển đi để biểu mẫu hiển thị thông báo lỗi như thường lệ. |
| khách truy cập đóng cửa sổ | File gốc được chuyển đi. |
| cửa sổ không tải được trong vòng 8 giây | File gốc được chuyển đi ngay (do mất mạng, hoặc bị quy tắc bảo mật của bạn chặn). |
| bản thân script không tải được | Trang của bạn không có gì thay đổi: biểu mẫu hoạt động như trước. |
Ngôn ngữ của cửa sổ
Cửa sổ dùng theo <html lang> của trang. Đặt data-lang="fr" trên trường tải file hoặc trên script để tự chọn. Xem Ngôn ngữ.
Framework
Cập nhật lần cuối 3 tháng 11, 2026 · Câu hỏi: contact@pdfkind.com