PDFKit هي مكتبة Node.js تسهل على المطورين إنشاء ملفات PDF والعمل معها. يوفر واجهة برمجة تطبيقات واضحة وفعالة لإنتاج ملفات PDF وإضافة أنواع مختلفة من المحتوى إليها ، مثل النصوص والصور والأشكال.
تعرف على كيفية استخدام PDF Kit لإنشاء ملفات PDF في Node.js.
إعداد PDFkit
يجب أن تمتلك تم تثبيت Node.js و npm (مدير الحزم Node.js) على جهازك لمتابعة على طول.
تأكد من تثبيت هذه الأدوات عن طريق تشغيل أوامر المحطة الطرفية التالية:
عقدة الخامس
npm -v
لبدء استخدام PDFKit في مشروع Node.js الخاص بك ، قم بتثبيته عن طريق تشغيل الأمر npm التالي:
npm تثبيت pdfkit
سيقوم هذا الأمر بتثبيت PDFKit وإضافته إلى تبعيات مشروعك.
إنشاء مستند PDF باستخدام PDFKit
لإنشاء مستند PDF باستخدام PDFKit ، اطلب pdfkit الحزمة و خ (نظام الملفات) في ملف البرنامج النصي الخاص بك:
مقدار ثابت PDFDocument = يتطلب("pdfkit");
مقدار ثابت خ = يتطلب('fs');
بعد ذلك ، قم بإنشاء مثيل جديد لملف وثيقة PDF فصل. يمثل هذا الفصل ملف PDF:
مقدار ثابت doc = جديد PDFDocument () ؛
المثيل الذي تم إنشاؤه عبارة عن دفق قابل للقراءة ، مما يعني أنه يمكنك استخدام ملحق يضخ() طريقة لحفظ محتوياته في ملف.
للقيام بذلك ، قم بتوجيه وثيقة المثيل إلى دفق قابل للكتابة تم إنشاؤه بواسطة fs.createWriteStream:
doc.pipe (fs.createWriteStream ("MyPDFDoc.pdf"));
ال createWriteStream طريقة حفظ محتويات ملف PDF في موقع محدد على نظام الملفات المحلي.
سيحفظ مقطع التعليمات البرمجية أعلاه ملف PDF الناتج في دليل العمل الحالي الخاص بك ، بالاسم MyPDFDoc.pdf.
من المهم دائمًا إنهاء البث بعد إضافة محتوى إلى ملف PDF. يمكنك القيام بذلك باستخدام هذا الأمر:
doc.end () ؛
الآن قم بتشغيل أمر العقدة العقدة [اسم البرنامج النصي] لإنشاء ملف PDF MyPDFDoc.pdf في دليل العمل الحالي الخاص بك.
إضافة نص باستخدام PDFKit
قبل توجيه المستند لحفظه ، يمكنك إجراء العديد من التغييرات. يجعل PDFKit إضافة نص إلى المستندات أمرًا بسيطًا ويتضمن العديد من الخيارات لتخصيص عرض المخرجات.
لإضافة نص إلى المستند ، ما عليك سوى الاتصال بـ نص() الطريقة ومرر النص الذي تريد إضافته كوسيطة:
doc.text ("الترميز سهل!")
نظرًا لأن PDFKIT يضيف نصًا إلى المستند ، فإنه يتتبع مواضع X و Y الحالية للنص. لذلك ، كلما اتصلت بطريقة النص ، ستضيف PDFKit سطرًا جديدًا أسفل السطر السابق.
ومع ذلك ، من خلال توفير إحداثيات X و Y لطريقة النص بعد النص نفسه ، يمكنك تغيير موضعه:
doc.text ("البرمجة سهلة!", 100, 100)
للتحرك لأعلى أو لأسفل في الخط ، اتصل بـ تحرك لأسفل أو تحرك طريقة مع عدد الأسطر التي يجب أن يتحرك بها النص:
doc.moveDown (3);
doc.moveUp () ،
بشكل افتراضي ، سيؤدي استدعاء أي من الطريقتين دون تمرير وسيطة إلى تحريكها بسطر واحد فقط.
يدعم PDFKit كل خط من الخطوط القياسية الأربعة عشر المحددة بواسطة تنسيق PDF. ال وثائق نصية PDFKit لديه قائمة كاملة من هذه الخطوط القياسية.
استخدم ال الخط () طريقة لتحديد الخط المطلوب. ما عليك سوى تمرير اسم الخط المقابل كسلسلة:
doc.font ("تايمز روماني")
.نص("البرمجة سهلة!");يمكنك أيضًا تغيير حجم الخط ولون النص باستخدام تنسيق حجم الخط() و ال fillColor () الطرق ، على التوالي.
على سبيل المثال:
// هذا يغير لون النص إلى اللون الأحمر ويعطيه حجم خط يبلغ 8
doc.fillColor ('أحمر')
.حجم الخط(8)
.نص("البرمجة سهلة!");
إضافة الصور باستخدام PDFKit
إلى صورة إلى مستند PDF الخاص بك ، ما عليك سوى تمرير مسارها إلى ملف صورة الطريقة على مثيل المستند:
doc.image ("مسار / إلى / image.jpeg")
يتيح لك PDFKit إضافة الصور بتنسيق تنسيق JPEG أو PNG.
بشكل افتراضي ، سيقوم PDFKit بإدراج الصورة بحجمها الأصلي. يمكنك تغيير أبعاد الصورة من خلال توفير كائن يحتوي على أزواج مفتاح - قيمة كوسيطة لـ صورة() طريقة. يمكنك تحديد عرض وارتفاع ومحاذاة أفقية ورأسية.
على سبيل المثال:
// تحديد العرض وحده
doc.image ("path / to / image.jpg", { عرض: 300 });
// تحديد كل من العرض والارتفاع
doc.image ("path / to / image.jpg", { عرض: 300, ارتفاع:200 })
إضافة صفحات باستخدام PDFKit
لإضافة صفحات جديدة إلى مستند PDF ، ما عليك سوى استدعاء إضافة صفحة الطريقة على مثيل المستند:
doc.addPage ()
لإضافة محتوى تلقائيًا في كل مرة تضيف فيها صفحة جديدة ، استخدم ملف تمت إضافة الصفحة حدث في مثيل المستند.
على سبيل المثال:
doc.on ("الصفحة مضافة"، () => doc.text ("الترميز سهل!"));
يتيح لك PDFKit تحديد أبعاد الصفحة عند إنشاء مستند جديد أو إضافة صفحة جديدة إلى مستند موجود. هناك العديد من أحجام الصفحات المحددة مسبقًا التي يمكن لـ وثائق PDFKit الورقية يشرح.
لاستخدام أي من أحجام الصفحات المحددة مسبقًا ، قم بتمرير كائن إلى ملف وثيقة PDF منشئ أو إضافة صفحة() طريقة. استخدم خاصية size لتحديد سلسلة تمثل اسم حجم الورق.
على سبيل المثال:
// البناء
مقدار ثابت doc = جديد PDFDocument ({ مقاس: "A5" });
// وظيفة addPage
doc.addPage ({ مقاس: "أ 7" });
تمرير كائن الخيارات هذا إلى وثيقة PDF يحدد المُنشئ حجم الصفحة الافتراضي للمستند بأكمله. يمكنك بعد ذلك الكتابة فوق هذا الإعداد الافتراضي عن طريق تمرير قيمة مختلفة إلى إضافة صفحة طريقة.
يمكنك تعيين هوامش الصفحة عن طريق تمرير كائن إلى ملف هوامش الخاصية عند إضافة الصفحات.
ال هوامش تأخذ الخاصية كائنًا بامتداد أعلى ، أسفل ، يسار ، و يمين الخصائص التي تمثل كل هامش.
على سبيل المثال:
// أضف هوامش مختلفة على كل جانب
doc.addPage ({
الهوامش: {
قمة: 72,
قاع: 72,
غادر: 50,
يمين: 50
}
});
يقوم هذا الرمز بتعيين الهوامش العلوية والسفلية على 72 نقطة ، والهوامش اليمنى واليسرى على 50 نقطة. لاحظ أن الهامش الافتراضي للمستندات التي تم إنشاؤها بواسطة PDFKit هو هامش 1 بوصة (72 نقطة) من كل الجوانب.
لتعيين جميع الهوامش العلوية والسفلية واليسرى واليمنى على نفس القيمة ، ما عليك سوى تمرير كائن بامتداد هامِش ملكية ل إضافة صفحة طريقة:
doc.addPage ({ هامِش: 60 }) // أضف هامشًا بمقدار 60 نقطة لكل جانب
مزايا إنشاء ملفات PDF باستخدام PDFKit في Node.js
يمكّنك PDFKit من إنتاج مستندات قياسية ومدعومة من تطبيقات Node.js الخاصة بك. باستخدام PDFKit ، يمكنك التعامل مع المستندات المعقدة بسهولة. بالإضافة إلى ذلك ، يمكنه تسهيل تسليم المستندات للمستخدمين وجعلها أسهل للمشاركة والطباعة.