واجهة JavaScript البرمجية

صغّر ملف 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` أو عدد البايتات.
`el`	Element	اختياري. تحدد السمة `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 إلى أدوات. تعمل تلقائيًا عند تحميل الصفحة؛ استدعها مجددًا بعد إضافة أدوات لاحقًا، في تطبيق الصفحة الواحدة مثلًا. المعامل 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