Αναγνώστες σαν εσάς βοηθούν στην υποστήριξη του MUO. Όταν κάνετε μια αγορά χρησιμοποιώντας συνδέσμους στον ιστότοπό μας, ενδέχεται να κερδίσουμε μια προμήθεια θυγατρικών. Διαβάστε περισσότερα.

Το PDFKit είναι μια βιβλιοθήκη Node.js που διευκολύνει τους προγραμματιστές να δημιουργούν και να εργάζονται με αρχεία PDF. Προσφέρει ένα απλό αλλά αποτελεσματικό API για την παραγωγή PDF και την προσθήκη διαφορετικών ειδών περιεχομένου σε αυτά, όπως κείμενο, εικόνες και σχήματα.

Μάθετε πώς να χρησιμοποιείτε το PDF Kit για τη δημιουργία αρχείων PDF στο Node.js.

Ρύθμιση του PDFkit

Θα πρέπει να έχετε Node.js και npm (ο διαχειριστής πακέτων Node.js) που είναι εγκατεστημένα στον υπολογιστή σας να ακολουθήσει.

Βεβαιωθείτε ότι έχετε εγκαταστήσει αυτά τα εργαλεία εκτελώντας τις ακόλουθες εντολές τερματικού:

κόμβος -v
npm -v

Για να ξεκινήσετε να χρησιμοποιείτε το PDFKit στο έργο σας Node.js, εγκαταστήστε το εκτελώντας την ακόλουθη εντολή npm:

npm εγκατάσταση pdfkit

Αυτή η εντολή θα εγκαταστήσει το PDFKit και θα το προσθέσει στις εξαρτήσεις του έργου σας.

instagram viewer

Δημιουργία εγγράφου PDF με το PDFKit

Για να δημιουργήσετε ένα έγγραφο PDF χρησιμοποιώντας το PDFKit, απαιτήστε το pdfkit πακέτο και το fs ενότητα (σύστημα αρχείων) στο αρχείο σεναρίου σας:

συνθ PDFDocument = απαιτώ('pdfkit');
συνθ fs = απαιτώ('fs');

Στη συνέχεια, δημιουργήστε μια νέα παρουσία του PDFDocument τάξη. Αυτή η τάξη αντιπροσωπεύει ένα αρχείο 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 υποστηρίζει καθεμία από τις 14 τυπικές γραμματοσειρές που ορίζονται από τη μορφή PDF. ο Τεκμηρίωση κειμένου PDFKit έχει μια πλήρη λίστα με αυτές τις τυπικές γραμματοσειρές.

Χρησιμοποιήστε το γραμματοσειρά() μέθοδος για να καθορίσετε την απαιτούμενη γραμματοσειρά σας. Απλώς περάστε το αντίστοιχο όνομα γραμματοσειράς ως συμβολοσειρά:

doc.font(«Times-Roman»)
 .κείμενο('Η κωδικοποίηση είναι εύκολη!');

Μπορείτε επίσης να αλλάξετε το μέγεθος της γραμματοσειράς και το χρώμα του κειμένου χρησιμοποιώντας το μέγεθος γραμματοσειράς() και το χρώμα γεμίσματος() μεθόδους, αντίστοιχα.

Για παράδειγμα:

// Αυτό αλλάζει το χρώμα του κειμένου σε κόκκινο και του δίνει μέγεθος γραμματοσειράς 8
doc.fillColor('το κόκκινο')
 .μέγεθος γραμματοσειράς(8)
 .κείμενο('Η κωδικοποίηση είναι εύκολη!');

Προσθήκη εικόνων με το PDFKit

Σε μια εικόνα στο έγγραφο PDF σας, απλώς περάστε τη διαδρομή της στο εικόνα μέθοδος στο παράδειγμα εγγράφου:

doc.image('path/to/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 εξηγεί.

Για να χρησιμοποιήσετε οποιοδήποτε από αυτά τα προκαθορισμένα μεγέθη σελίδας, περάστε ένα αντικείμενο είτε στο PDFDocument κατασκευαστής ή ο προσθήκη σελίδας() μέθοδος. Χρησιμοποιήστε την ιδιότητα size για να καθορίσετε μια συμβολοσειρά που είναι το όνομα του μεγέθους χαρτιού.

Για παράδειγμα:

// κατασκευαστής
συνθ doc = νέος PDFDocument({ Μέγεθος: 'A5' });
// συνάρτηση addPage
doc.addPage({ Μέγεθος: 'A7' });

Η μετάδοση αυτής της επιλογής αντικειμένου στο PDFDocument Ο κατασκευαστής ορίζει το προεπιλεγμένο μέγεθος σελίδας για ολόκληρο το έγγραφο. Στη συνέχεια, μπορείτε να αντικαταστήσετε αυτήν την προεπιλογή περνώντας μια διαφορετική τιμή στο προσθήκη σελίδας μέθοδος.

Μπορείτε να ορίσετε περιθώρια σελίδας περνώντας ένα αντικείμενο στο περιθώρια ιδιοκτησία κατά την προσθήκη σελίδων.

ο περιθώρια ιδιοκτησία παίρνει ένα αντικείμενο με πάνω, κάτω, αριστερά, και σωστά ιδιότητες που αντιπροσωπεύουν κάθε περιθώριο.

Για παράδειγμα:

// Προσθέστε διαφορετικά περιθώρια σε κάθε πλευρά
doc.addPage({
 περιθώρια: {
 μπλουζα: 72,
 κάτω μέρος: 72,
 αριστερά: 50,
 σωστά: 50
 }
});

Αυτός ο κωδικός ορίζει το επάνω και το κάτω περιθώριο σε 72 πόντους και το αριστερό και το δεξί περιθώριο σε 50 σημεία. Σημειώστε ότι το προεπιλεγμένο περιθώριο για έγγραφα που δημιουργούνται από το PDFKit είναι ένα περιθώριο 1 ίντσας (72 σημεία) σε όλες τις πλευρές.

Για να ορίσετε όλα τα επάνω, κάτω, αριστερά και δεξιά περιθώρια στην ίδια τιμή, απλώς περάστε ένα αντικείμενο με a περιθώριο ιδιοκτησία προς το προσθήκη σελίδας μέθοδος:

doc.addPage({ περιθώριο: 60 }) // προσθέστε ένα περιθώριο 60 σημείων σε κάθε πλευρά

Τα πλεονεκτήματα της δημιουργίας αρχείων PDF με το PDFKit στο Node.js

Το PDFKit σάς δίνει τη δυνατότητα να παράγετε τυπικά και υποστηριζόμενα έγγραφα από τις εφαρμογές σας Node.js. Με το PDFKit, μπορείτε να χειρίζεστε πολύπλοκα έγγραφα εύκολα. Επιπλέον, μπορεί να διευκολύνει την παράδοση των εγγράφων στους χρήστες και να τα καταστήσει πιο εύκολα την κοινή χρήση και την εκτύπωση.