PDFKit je knjižnica Node.js, ki razvijalcem olajša ustvarjanje in delo z datotekami PDF. Ponuja preprost, a učinkovit API za ustvarjanje datotek PDF in dodajanje različnih vrst vsebine, kot so besedilo, slike in oblike.
Naučite se uporabljati PDF Kit za ustvarjanje PDF-jev v Node.js.
Nastavitev PDFkita
Morate imeti Node.js in npm (upravitelj paketov Node.js), nameščen na vašem računalniku slediti.
Prepričajte se, da imate nameščena ta orodja, tako da zaženete naslednje terminalske ukaze:
vozlišče -v
npm -v
Če želite začeti uporabljati PDFKit v svojem projektu Node.js, ga namestite tako, da zaženete naslednji ukaz npm:
npm namestite pdfkit
Ta ukaz bo namestil PDFKit in ga dodal v odvisnosti vašega projekta.
Ustvarjanje dokumenta PDF s programom PDFKit
Če želite ustvariti dokument PDF z uporabo PDFKit, zahtevajte pdfkit paket in fs (datotečni sistem) modul v vaši skriptni datoteki:
konst PDFDokument = zahtevati('pdfkit');
konst fs = zahtevati('fs');
Nato ustvarite nov primerek PDFDokument razred. Ta razred predstavlja datoteko PDF:
konst doc = novo PDFDokument();
Ustvarjeni primerek je berljiv tok, kar pomeni, da lahko uporabite cev () način za shranjevanje njegove vsebine v datoteko.
Če želite to narediti, napeljite doc primerek v zapisljiv tok, ki ga ustvari fs.createWriteStream:
doc.pipe (fs.createWriteStream('MojPDFDoc.pdf'));
The createWriteStream shrani vsebino datoteke PDF na določeno mesto v lokalnem datotečnem sistemu.
Zgornji blok kode bo shranil nastalo datoteko PDF v vaš trenutni delovni imenik z imenom MojPDFDoc.pdf.
Pomembno je, da po dodajanju vsebine v PDF vedno končate tok. To lahko storite s tem ukazom:
doc.end();
Zdaj zaženite ukaz vozlišča vozlišče [ime skripta] da ustvarite datoteko PDF MojPDFDoc.pdf v vašem trenutnem delovnem imeniku.
Dodajanje besedila s PDFKit
Preden pošljete dokument, da ga shranite, lahko naredite različne spremembe. PDFKit poenostavi dodajanje besedila v dokumente in vključuje številne možnosti za prilagoditev prikaza izpisa.
Če želite dokumentu dodati besedilo, preprosto pokličite besedilo() in posredujte besedilo, ki ga želite dodati kot argument:
doc.text("Kodiranje je enostavno!")
Ko PDFKIT dokumentu doda besedilo, spremlja trenutne položaje X in Y tega besedila. Torej, kadar koli pokličete besedilno metodo, bo PDFKit dodal novo vrstico pod prejšnjo.
Če pa besedilni metodi posredujete koordinate X in Y za samim besedilom, lahko spremenite njegov položaj:
doc.text('Kodiranje je enostavno!', 100, 100)
Za premikanje po vrsti navzgor ali navzdol pokličite premik navzdol oz Pomakni se navzgor metoda s številom vrstic, za katere naj se premakne besedilo:
doc.moveDown(3);
doc.moveUp();
Privzeto bo klic katere koli metode brez posredovanja argumenta povzročil, da se premakne le za eno vrstico.
PDFKit podpira vsako od 14 standardnih pisav, ki jih določa format PDF. The Besedilna dokumentacija PDFKit ima popoln seznam teh standardnih pisav.
Uporabi pisava () način za določitev zahtevane pisave. Samo vnesite ustrezno ime pisave kot niz:
doc.font("Times-Roman")
.text('Kodiranje je enostavno!');Prav tako lahko spremenite velikost pisave in barvo besedila z velikost pisave() in fillColor() metode oz.
Na primer:
// To spremeni barvo besedila v rdečo in mu dodeli velikost pisave 8
doc.fillColor('rdeča')
.velikost pisave(8)
.text('Kodiranje je enostavno!');
Dodajanje slik s PDFKit
Za sliko v dokumentu PDF preprosto posredujte njeno pot do slika metoda na primerku dokumenta:
doc.image('pot/do/slike.jpeg')
PDFKit vam omogoča dodajanje slik v obeh Format JPEG ali PNG.
PDFKit bo privzeto vstavil sliko v izvorni velikosti. Mere slike lahko spremenite tako, da kot argument podate objekt, ki vsebuje pare ključ-vrednost. slika() metoda. Določite lahko širino, višino ter vodoravno in navpično poravnavo.
Na primer:
// Določanje samo širine
doc.image('pot/do/slike.jpg', { premer: 300 });
// Podajanje širine in višine
doc.image('pot/do/slike.jpg', { premer: 300, višina:200 })
Dodajanje strani s PDFKit
Če želite dokumentu PDF dodati nove strani, preprosto pokličite addPage metoda na primerku dokumenta:
doc.addPage()
Za samodejno dodajanje vsebine vsakič, ko dodate novo stran, uporabite pageAdded dogodek na primerku dokumenta.
Na primer:
doc.on('pageAdded', () => doc.text("Kodiranje je enostavno!"));
PDFKit vam omogoča, da določite dimenzije strani, ko izdelujete nov dokument ali dodajate novo stran obstoječi. Obstaja več vnaprej določenih velikosti strani, ki jih Papirna dokumentacija PDFKit pojasnjuje.
Če želite uporabiti katero koli od teh vnaprej določenih velikosti strani, posredujte predmet bodisi v PDFDokument konstruktor oz addPage() metoda. Z lastnostjo velikosti določite niz, ki je ime velikosti papirja.
Na primer:
// konstruktor
konst doc = novo PDFDokument({ velikost: 'A5' });
// funkcija addPage
doc.addPage({ velikost: 'A7' });
Posredovanje tega predmeta možnosti v PDFDokument konstruktor nastavi privzeto velikost strani za celoten dokument. To privzeto vrednost lahko nato prepišete tako, da posredujete drugo vrednost v addPage metoda.
Robove strani lahko nastavite tako, da posredujete predmet v marže lastnosti pri dodajanju strani.
The marže lastnina vzame predmet s zgoraj, spodaj, levo, in prav lastnosti, ki predstavljajo vsak rob.
Na primer:
// Dodajte različne robove na vsaki strani
doc.addPage({
robovi: {
vrh: 72,
spodaj: 72,
levo: 50,
prav: 50
}
});
Ta koda nastavi zgornji in spodnji rob na 72 točk, levi in desni rob pa na 50 točk. Upoštevajte, da je privzeti rob za dokumente, ustvarjene s programom PDFKit, 1-palčni (72-točkovni) rob na vseh straneh.
Če želite nastaviti vse zgornje, spodnje, leve in desne robove na isto vrednost, preprosto posredujte predmet z a marža premoženje do addPage metoda:
doc.addPage({ marža: 60 }) // dodajte rob za 60 točk na vsako stran
Prednosti ustvarjanja PDF-jev s PDFKit v Node.js
PDFKit vam omogoča izdelavo standardnih in podprtih dokumentov iz vaših aplikacij Node.js. S PDFKitom lahko enostavno upravljate z zapletenimi dokumenti. Poleg tega lahko olajša dostavo dokumentov uporabnikom ter jih poenostavi za skupno rabo in tiskanje.
