תיעוד למפתחים: איך זה עובד
עוזר ההעלאה
עוזר ההעלאה
די לשגיאות „הקובץ גדול מדי”: קובצי PDF, תמונות ותמונות HEIC מאייפון מוקטנים בדפדפן של הגולש ומועברים לטופס, שמקבל קובץ בגודל המתאים.
איפה מגדירים את המגבלה
הוסיפו את data-pdfkind-max במקום שבו הקבצים נכנסים. הרכיב הקרוב ביותר שיש לו את המאפיין קובע, כך שלשדה אחד יכולה להיות מגבלה משלו בתוך טופס עם מגבלה אחרת.
| ההעלאה שלכם | איפה לשים את data-pdfkind-max | דוגמה |
|---|---|---|
| שדה קובץ | על שדה הקלט | <input type="file" data-pdfkind-max="5MB"> |
| אזור גרירה ושחרור | על האזור (כולל השחרור ואת כפתור „עיון” שלו) | <div class="dropzone" data-pdfkind-max="5MB"> |
| טופס שלם | על הטופס | <form data-pdfkind-max="5MB"> |
| כל השדות בדף | על תג ה-script, בתור data-max | <script src="…/embed.js" data-max="5MB" defer> |
איך כותבים את המגבלה
כתבו אותה בצורה כמו 5MB, 500KB, 2.5 MB או 800ko, או כמספר בייטים, למשל 5000000. 1 MB הוא 1,000,000 בייטים.
5MB: הערך הזה קצת נמוך יותר, כך שקבצים מוקטנים תמיד יעברו את הבדיקה שלכם.מה קורה לכל קובץ
| קובץ | מה העוזר עושה |
|---|---|
| מתחת למגבלה | כלום. הקובץ עובר ישר לטופס, ולא נפתח שום חלון. |
| PDF מעל המגבלה | מוקטן: קודם מצמצמים גופנים ונתונים כפולים, ואז מקלים את התמונות רק כמה שצריך. הטקסט נשאר חד וניתן לבחירה. |
| JPG, PNG, WebP מעל המגבלה | מקודדים מחדש ומשנים את הגודל רק כמה שצריך. קובץ PNG בלי שקיפות שלא מצליח להיכנס במגבלה הופך ל-JPG. |
| HEIC או HEIF (תמונות מאייפון) | תמיד מומרים ל-JPG, גם מתחת למגבלה, כי רוב הטפסים לא מקבלים HEIC. |
| כל קובץ אחר (Word, ZIP…) | נשאר ללא שינוי. |
| כמה קבצים בבת אחת | כל קובץ מטופל בתורו, והשדה מקבל את כולם. |
מה הגולש רואה
חלון PDFkind קטן נפתח מעל הדף שלכם עם „מקטינים את הקובץ שלכם…”, מציג את התוצאה („הוקטן מ-8.2 MB ל-3.9 MB”) ונסגר מעצמו. רוב הקבצים לוקחים 1 עד 5 שניות; סריקה ארוכה בטלפון ישן יכולה לקחת כ-15 שניות.
| אם | אז |
|---|---|
| אי אפשר להקטין את הקובץ אל מתחת למגבלה | החלון מסביר למה, ואז הקובץ המקורי עובר, כך שהטופס מציג את השגיאה הרגילה שלו. |
| הגולש סוגר את החלון | הקובץ המקורי עובר. |
| החלון לא נטען תוך 8 שניות | הקובץ המקורי עובר מיד (אין חיבור לאינטרנט, או שכללי האבטחה שלכם חוסמים אותו). |
| הסקריפט עצמו לא נטען | שום דבר לא משתנה בדף: הטופס עובד כמו קודם. |
שפת החלון
החלון מוצג בשפה שמוגדרת ב-<html lang> של הדף שלכם. כדי לבחור שפה אחרת, הגדירו data-lang="fr" על השדה או על הסקריפט. ראו שפות.
פריימוורקים
עודכן לאחרונה: 3 בנובמבר 2026 · שאלות: contact@pdfkind.com