PDFkind
תיעוד למפתחים: JavaScript API

עוזר ההעלאה

JavaScript API

הקטינו קובץ PDF או תמונה למגבלת גודל מתוך הקוד שלכם עם PDFkind.fit(file, { max }), וטפלו בכל תוצאה אפשרית.

הסקריפט מוסיף אובייקט גלובלי בשם PDFkind. השתמשו בו כשהקבצים מגיעים ממקור שהמצב האוטומטי לא רואה: הדבקה, מצלמה, בורר קבצים מותאם אישית.

PDFkind.fit(file, options)

JavaScript
try {
  const small = await PDFkind.fit(file, { max: '5MB' });
  upload(small);
} catch (err) {
  if (err.reason === 'too-big') alert('הקובץ גדול מדי, גם אחרי הקטנה.');
  else upload(file);   // חזרה לקובץ המקורי
}
אפשרותסוגתיאור
maxמחרוזת או מספרחובה. אותו פורמט כמו data-pdfkind-max: 5MB, 500KB או מספר בייטים.
elElementאופציונלי. ה-data-lang שלו (או של רכיב הורה) קובע את שפת החלון.

הפונקציה מחזירה Promise שמתממש עם File: הקובץ המוקטן, קובץ ה-JPG המומר לתמונות HEIC, או הקובץ המקורי כשהוא כבר עומד במגבלה (ואז לא נפתח חלון). היא נדחית עם שגיאה שה-reason שלה הוא אחד מהבאים:

reasonמשמעות
too-bigגם אחרי הקטנה, הקובץ חורג מהמגבלה.
unsupportedזה לא קובץ PDF או תמונה שהעוזר יכול להקטין.
cancelהגולש סגר את החלון.
unavailableחלון PDFkind לא נטען תוך 8 שניות.
timeoutהעיבוד נמשך יותר מ-3 דקות.
failedהקובץ פגום, או שמשהו אחר השתבש.
bad-callהפונקציה נקראה בלי File או בלי max.

PDFkind.mount(root)

הופכת רכיבי data-pdfkind-tool לכלים. היא רצה מעצמה בטעינת הדף; קראו לה שוב אחרי שאתם מוסיפים כלים בשלב מאוחר יותר, למשל באפליקציית עמוד יחיד (SPA). הפרמטר root אופציונלי, וברירת המחדל שלו היא הדף כולו.

JavaScript
container.innerHTML = '<div data-pdfkind-tool="split-pdf"></div>';
PDFkind.mount(container);

PDFkind.version

גרסת הסקריפט, כרגע 3. שימושי כדי לבדוק שהסקריפט נטען: הקלידו PDFkind.version במסוף הדפדפן.

הקודםWordPress ובוני טפסיםהבא הטמעת כלי

עודכן לאחרונה: 3 בנובמבר 2026 · שאלות: contact@pdfkind.com