PDFKit on Node.js-kirjasto, jonka avulla kehittäjien on helppo luoda ja käsitellä PDF-tiedostoja. Se tarjoaa yksinkertaisen mutta tehokkaan API: n PDF-tiedostojen tuottamiseen ja erityyppisen sisällön, kuten tekstin, kuvien ja muotojen, lisäämiseen niihin.
Opi käyttämään PDF Kitiä PDF-tiedostojen luomiseen Node.js: ssä.
PDFkitin määrittäminen
Sinulla täytyy olla Node.js ja npm (Node.js-paketinhallinta) asennettuna koneellesi seurata mukana.
Varmista, että sinulla on nämä työkalut asennettuna suorittamalla seuraavat päätekomennot:
solmu -v
npm -v
Aloita PDFKitin käyttö Node.js-projektissasi asentamalla se suorittamalla seuraava npm-komento:
npm asentaa pdfkit
Tämä komento asentaa PDFKitin ja lisää sen projektisi riippuvuuksiin.
PDF-dokumentin luominen PDFKitillä
Jos haluat luoda PDF-dokumentin PDFKitillä, vaadi pdfkit paketti ja fs (tiedostojärjestelmä) -moduuli komentosarjatiedostossasi:
konst PDFDocument = vaatia('pdfkit');
konst fs = vaatia('fs');
Luo seuraavaksi uusi esiintymä PDF-dokumentti luokkaa. Tämä luokka edustaa PDF-tiedostoa:
konst doc = Uusi PDFDocument();
Luotu ilmentymä on luettava tietovirta, mikä tarkoittaa, että voit käyttää putki() tapa tallentaa sen sisältö tiedostoon.
Tee tämä putkella doc instanssin luomaan kirjoitettavaan virtaan fs.createWriteStream:
doc.pipe (fs.createWriteStream("MyPDFDoc.pdf"));
The luodaWriteStream menetelmä tallentaa PDF-tiedoston sisällön määritettyyn paikkaan paikallisessa tiedostojärjestelmässä.
Yllä oleva koodilohko tallentaa tuloksena olevan PDF-tiedoston nykyiseen työhakemistoosi nimellä MyPDFDoc.pdf.
On tärkeää aina lopettaa stream, kun olet lisännyt sisältöä PDF-tiedostoon. Voit tehdä sen tällä komennolla:
doc.end();
Suorita nyt node-komento solmu [skriptin nimi] PDF-tiedoston luomiseen MyPDFDoc.pdf nykyisessä työhakemistossasi.
Tekstin lisääminen PDFKitillä
Ennen kuin tallennat asiakirjan, voit tehdä erilaisia muutoksia. PDFKit tekee tekstin lisäämisestä asiakirjoihin helppoa ja sisältää monia vaihtoehtoja tulosteen näytön mukauttamiseen.
Voit lisätä tekstiä asiakirjaan soittamalla numeroon teksti() menetelmä ja välitä teksti, jonka haluat lisätä argumentiksi:
doc.text("Koodaus on helppoa!")
Kun PDFKIT lisää tekstiä dokumenttiin, se pitää kirjaa tekstin nykyisistä X- ja Y-paikoista. Joten aina kun kutsut tekstimenetelmää, PDFKit lisää uuden rivin edellisen alle.
Kuitenkin antamalla X- ja Y-koordinaatit tekstimenetelmälle itse tekstin jälkeen, voit muuttaa sen sijaintia:
doc.text("Koodaus on helppoa!", 100, 100)
Voit siirtyä riviä ylöspäin tai alaspäin soittamalla numeroon siirrä alas tai liiku ylös menetelmällä, kuinka monta riviä tekstiä pitäisi siirtää:
doc.moveDown(3);
doc.moveUp();
Oletusarvoisesti kumman tahansa menetelmän kutsuminen ilman argumenttia saa sen liikkumaan vain yhden rivin verran.
PDFKit tukee jokaista 14:stä PDF-muodossa määritellystä vakiofontista. The PDFKit-tekstidokumentaatio on täydellinen luettelo näistä vakiofonteista.
Käytä font() tapa määrittää haluamasi fontti. Syötä vain vastaava kirjasimen nimi merkkijonona:
doc.font("Times-Roman")
.teksti("Koodaus on helppoa!");
Voit myös muuttaa fontin kokoa ja tekstin väriä käyttämällä Fonttikoko() ja täyttöväri() menetelmiä.
Esimerkiksi:
// Tämä muuttaa tekstin värin punaiseksi ja antaa kirjasinkooksi 8
doc.fillColor('punainen')
.Fonttikoko(8)
.teksti("Koodaus on helppoa!");
Kuvien lisääminen PDFKitillä
Jos haluat kuvan PDF-dokumenttiin, välitä sen polku tiedostoon kuva menetelmä asiakirjainstanssissa:
doc.image('polku/kuvaan.jpeg')
PDFKit mahdollistaa kuvien lisäämisen kumpaan tahansa JPEG- tai PNG-muodossa.
Oletusarvoisesti PDFKit lisää kuvan alkuperäisessä koossa. Voit muuttaa kuvan mittoja antamalla avainarvo-pareja sisältävän objektin argumenttina kuva() menetelmä. Voit määrittää leveyden, korkeuden sekä vaaka- ja pystysuuntauksen.
Esimerkiksi:
// Pelkän leveyden määrittäminen
doc.image('polku/kuvaan.jpg', { leveys: 300 });
// Sekä leveyden että korkeuden määrittäminen
doc.image('polku/kuvaan.jpg', { leveys: 300, korkeus:200 })
Sivujen lisääminen PDFKitillä
Voit lisätä uusia sivuja PDF-dokumenttiin soittamalla numeroon lisäyssivu menetelmä asiakirjainstanssissa:
doc.addPage()
Jos haluat lisätä sisältöä automaattisesti aina, kun lisäät uuden sivun, käytä sivu lisätty tapahtuma asiakirjainstanssissa.
Esimerkiksi:
doc.on('sivu lisätty', () => doc.text("Koodaus on helppoa!"));
PDFKit antaa sinun määrittää sivun mitat, kun luot uutta asiakirjaa tai lisäät uuden sivun olemassa olevaan. On olemassa useita ennalta määritettyjä sivukokoja PDFKit paperidokumentaatio selittää.
Jos haluat käyttää jotakin näistä ennalta määritetyistä sivukooista, välitä objekti joko PDF-dokumentti rakentaja tai addPage() menetelmä. Käytä koko-ominaisuutta määrittääksesi merkkijonon, joka on paperikoon nimi.
Esimerkiksi:
// rakentaja
konst doc = Uusi PDFDocument({ koko: "A5" });
// AddPage-funktio
doc.addPage({ koko: "A7" });
Tämän optio-objektin välittäminen PDF-dokumentti constructor määrittää koko asiakirjan oletussivukoon. Voit sitten korvata tämän oletusarvon välittämällä eri arvon lisäyssivu menetelmä.
Voit asettaa sivun marginaalit välittämällä objektin marginaalit ominaisuutta sivuja lisättäessä.
The marginaalit omaisuus vie mukanaan esineen ylhäällä, alhaalla, vasemmalla, ja oikein kutakin marginaalia edustavat ominaisuudet.
Esimerkiksi:
// Lisää eri marginaalit kummallekin puolelle
doc.addPage({
marginaalit: {
alkuun: 72,
pohja: 72,
vasemmalle: 50,
oikein: 50
}
});
Tämä koodi asettaa ylä- ja alamarginaaliin 72 pistettä ja vasemman ja oikean marginaalin 50 pisteeseen. Huomaa, että PDFKitillä luotujen asiakirjojen oletusmarginaali on 1 tuuman (72 pisteen) marginaali kaikilla sivuilla.
Jos haluat asettaa kaikki ylä-, ala-, vasen- ja oikea marginaalit samaan arvoon, ohita objekti a: lla marginaali omaisuutta lisäyssivu menetelmä:
doc.addPage({ marginaali: 60 }) // lisää 60 pisteen marginaali molemmille puolille
PDF-tiedostojen luomisen edut PDFKitillä Node.js: ssa
PDFKitin avulla voit tuottaa vakiomuotoisia ja tuettuja asiakirjoja Node.js-sovelluksistasi. PDFKitin avulla voit käsitellä monimutkaisia asiakirjoja helposti. Lisäksi se voi helpottaa asiakirjojen toimittamista käyttäjille ja helpottaa niiden jakamista ja tulostamista.