وثائق المطورين: آلية العمل
مساعد الرفع
مساعد الرفع
تخلّص من أخطاء «الملف كبير جدًا»: تُصغَّر ملفات PDF والصور وصور iPhone بصيغة 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 (صور iPhone) | تُحوَّل دائمًا إلى 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