PDFKit is een Node.js-bibliotheek waarmee ontwikkelaars gemakkelijk PDF-bestanden kunnen maken en ermee kunnen werken. Het biedt een eenvoudige maar effectieve API voor het maken van PDF's en het toevoegen van verschillende soorten inhoud, zoals tekst, afbeeldingen en vormen.
Leer hoe u PDF Kit gebruikt om PDF's te maken in Node.js.
PDFkit opzetten
Je moet hebben Node.js en npm (de Node.js-pakketbeheerder) op uw computer geïnstalleerd mee te volgen.
Zorg ervoor dat u deze hulpprogramma's hebt geïnstalleerd door de volgende terminalopdrachten uit te voeren:
knooppunt -v
npm -v
Om PDFKit in uw Node.js-project te gaan gebruiken, installeert u het door de volgende npm-opdracht uit te voeren:
npm installeer pdfkit
Met deze opdracht wordt PDFKit geïnstalleerd en toegevoegd aan de afhankelijkheden van uw project.
Een PDF-document maken met PDFKit
Om een PDF-document te maken met PDFKit, hebt u het
pdfkit pakket en de fs (bestandssysteem) module in uw scriptbestand:const PDFDocument = vereisen('pdfkit');
const f = vereisen('fs');
Maak vervolgens een nieuw exemplaar van het PDFDocument klas. Deze klasse vertegenwoordigt een PDF-bestand:
const dokter = nieuw PDFDocument();
De gemaakte instantie is een leesbare stream, wat betekent dat u de pijp() methode om de inhoud in een bestand op te slaan.
Om dit te doen, pijpt u de dok bijvoorbeeld in een beschrijfbare stream gemaakt door fs.createWriteStream:
doc.pipe (fs.createWriteStream('MijnPDFDoc.pdf'));
De createWriteStream methode slaat de inhoud van een PDF-bestand op een opgegeven locatie op het lokale bestandssysteem op.
Het bovenstaande codeblok slaat het resulterende PDF-bestand op in uw huidige werkdirectory, met de naam MijnPDFDoc.pdf.
Het is belangrijk om de stream altijd te beëindigen na het toevoegen van inhoud aan de PDF. U kunt dat doen met behulp van deze opdracht:
doc.einde();
Voer nu de node-opdracht uit knooppunt [scriptnaam] om het PDF-bestand te maken MijnPDFDoc.pdf in uw huidige werkdirectory.
Tekst toevoegen met PDFKit
Voordat u uw document doorsluist om het op te slaan, kunt u verschillende wijzigingen aanbrengen. PDFKit maakt het toevoegen van tekst aan documenten eenvoudig en bevat veel opties om de weergave van de uitvoer aan te passen.
Om tekst aan het document toe te voegen, belt u gewoon de tekst() methode en geef de tekst door die u als argument wilt toevoegen:
doc.tekst("Coderen is eenvoudig!")
Terwijl PDFKIT tekst aan het document toevoegt, houdt het de huidige X- en Y-posities van die tekst bij. Dus wanneer u de tekstmethode aanroept, voegt PDFKit een nieuwe regel toe onder de vorige.
Door echter X- en Y-coördinaten aan de tekstmethode achter de tekst zelf toe te voegen, kunt u de positie ervan wijzigen:
doc.tekst('Coderen is eenvoudig!', 100, 100)
Om een regel hoger of lager te gaan, belt u de Naar beneden verplaatsen of moveUp methode met het aantal regels dat de tekst moet verplaatsen:
doc.moveDown(3);
doc.moveUp();
Als u een van beide methoden aanroept zonder een argument door te geven, wordt deze standaard met slechts één regel verplaatst.
PDFKit ondersteunt elk van de 14 standaardlettertypen die zijn gedefinieerd door het PDF-formaat. De PDFKit-tekstdocumentatie heeft een volledige lijst van deze standaardlettertypen.
Gebruik de lettertype() methode om uw vereiste lettertype op te geven. Geef gewoon de corresponderende lettertypenaam door als een tekenreeks:
doc.lettertype('Times-Romeins')
.tekst('Coderen is eenvoudig!');
U kunt ook de lettergrootte en tekstkleur wijzigen met behulp van de lettertypegrootte() en de opvulkleur() methoden, respectievelijk.
Bijvoorbeeld:
// Dit verandert de tekstkleur in rood en geeft het een lettergrootte van 8
doc.fillColor('rood')
.lettertypegrootte(8)
.tekst('Coderen is eenvoudig!');
Afbeeldingen toevoegen met PDFKit
Om een afbeelding naar uw PDF-document te sturen, hoeft u alleen maar het pad naar het afbeelding methode op de documentinstantie:
doc.afbeelding('pad/naar/afbeelding.jpeg')
Met PDFKit kunt u in beide afbeeldingen toevoegen JPEG- of PNG-indeling.
Standaard zal PDFKit de afbeelding in de oorspronkelijke grootte invoegen. U kunt de afmetingen van een afbeelding wijzigen door een object op te geven dat sleutel-waardeparen bevat als argument voor het afbeelding() methode. U kunt een breedte, hoogte en horizontale en verticale uitlijning opgeven.
Bijvoorbeeld:
// Alleen de breedte specificeren
doc.afbeelding('pad/naar/afbeelding.jpg', { breedte: 300 });
// Zowel de breedte als de hoogte specificeren
doc.afbeelding('pad/naar/afbeelding.jpg', { breedte: 300, hoogte:200 })
Pagina's toevoegen met PDFKit
Om nieuwe pagina's aan het PDF-document toe te voegen, roept u gewoon de pagina toevoegen methode op de documentinstantie:
doc.addPage()
Om automatisch inhoud toe te voegen elke keer dat u een nieuwe pagina toevoegt, gebruikt u de paginaToegevoegd gebeurtenis op de documentinstantie.
Bijvoorbeeld:
doc.on('paginaToegevoegd', () => doc.tekst("Coderen is eenvoudig!"));
Met PDFKit kunt u de pagina-afmetingen specificeren bij het maken van een nieuw document of het toevoegen van een nieuwe pagina aan een bestaand document. Er zijn verschillende vooraf gedefinieerde paginaformaten die de PDFKit papieren documentatie legt uit.
Om een van deze vooraf gedefinieerde paginaformaten te gebruiken, geeft u een object door aan de PDFDocument constructeur of de pagina toevoegen() methode. Gebruik de eigenschap size om een tekenreeks op te geven die de naam is van het papierformaat.
Bijvoorbeeld:
// constructeur
const dokter = nieuw PDFDocument({ maat: 'A5' });
// addPage-functie
doc.addPage({ maat: 'A7' });
Dit optie-object doorgeven aan de PDFDocument constructor stelt de standaard paginagrootte in voor het hele document. U kunt deze standaardwaarde dan overschrijven door een andere waarde door te geven aan de pagina toevoegen methode.
U kunt paginamarges instellen door een object aan de pagina door te geven marges eigenschap bij het toevoegen van pagina's.
De marges eigenschap neemt een object mee boven, onder, links, En rechts eigenschappen die elke marge vertegenwoordigen.
Bijvoorbeeld:
// Voeg aan elke kant verschillende marges toe
doc.addPage({
marges: {
bovenkant: 72,
onderkant: 72,
links: 50,
rechts: 50
}
});
Deze code stelt de boven- en ondermarges in op 72 punten en de linker- en rechtermarges op 50 punten. Houd er rekening mee dat de standaardmarge voor door PDFKit gemaakte documenten aan alle zijden een marge van 1 inch (72 punten) is.
Om alle boven-, onder-, linker- en rechtermarges op dezelfde waarde in te stellen, passeert u eenvoudig een object met a marge eigendom aan de pagina toevoegen methode:
doc.addPage({ marge: 60 }) // voeg een marge van 60 punten toe aan elke kant
De voordelen van het maken van pdf's met PDFKit in Node.js
Met PDFKit kunt u standaard en ondersteunde documenten produceren vanuit uw Node.js-applicaties. Met PDFKit kunt u eenvoudig complexe documenten verwerken. Bovendien kan het de levering van documenten aan gebruikers vergemakkelijken en het eenvoudiger maken om ze te delen en af te drukken.