PDFKit je knihovna Node.js, která vývojářům usnadňuje vytváření souborů PDF a práci s nimi. Nabízí jednoduché, ale efektivní API pro vytváření PDF a přidávání různých druhů obsahu do nich, jako je text, obrázky a tvary.
Naučte se používat PDF Kit k vytváření PDF v Node.js.
Nastavení PDFkitu
Musíš mít Node.js a npm (správce balíčků Node.js) nainstalované na vašem počítači následovat.
Ujistěte se, že máte tyto nástroje nainstalované spuštěním následujících příkazů terminálu:
uzel -v
npm -v
Chcete-li začít používat PDFKit ve svém projektu Node.js, nainstalujte jej spuštěním následujícího příkazu npm:
npm nainstalovat pdfkit
Tento příkaz nainstaluje PDFKit a přidá jej do závislostí vašeho projektu.
Vytvoření dokumentu PDF pomocí sady PDFKit
Chcete-li vytvořit dokument PDF pomocí sady PDFKit, požadujte pdfkit balíček a fs (systém souborů) modul ve vašem souboru skriptu:
konst PDFDocument = vyžadovat('pdfkit');
konst fs = vyžadovat('fs');
Dále vytvořte novou instanci souboru Dokument PDF třída. Tato třída představuje soubor PDF:
konst doc = Nový PDFDocument();
Vytvořená instance je čitelný stream, což znamená, že můžete použít trubka() způsob uložení jeho obsahu do souboru.
Chcete-li to provést, potrubí doc instance do zapisovatelného proudu vytvořeného uživatelem fs.createWriteStream:
doc.pipe (fs.createWriteStream('MyPDFDoc.pdf'));
The createWriteStream metoda uloží obsah souboru PDF do určeného umístění v místním systému souborů.
Výše uvedený blok kódu uloží výsledný soubor PDF do vašeho aktuálního pracovního adresáře s názvem MůjPDFDoc.pdf.
Po přidání obsahu do PDF je důležité stream vždy ukončit. Můžete to udělat pomocí tohoto příkazu:
doc.end();
Nyní spusťte příkaz node uzel [název skriptu] k vytvoření souboru PDF MůjPDFDoc.pdf ve vašem aktuálním pracovním adresáři.
Přidání textu pomocí PDFKit
Než dokument uložíte potrubím, můžete provést různé změny. PDFKit usnadňuje přidávání textu do dokumentů a obsahuje mnoho možností pro přizpůsobení zobrazení výstupu.
Chcete-li do dokumentu přidat text, jednoduše zavolejte na text() metodu a předejte text, který chcete přidat jako argument:
doc.text("Kódování je snadné!")
Jak PDFKIT přidává text do dokumentu, sleduje aktuální polohy X a Y tohoto textu. Takže kdykoli zavoláte textovou metodu, PDFKit přidá nový řádek pod předchozí.
Zadáním souřadnic X a Y metodě textu za textem samotným však můžete změnit jeho polohu:
doc.text("Kódování je snadné!", 100, 100)
Chcete-li se posunout o řádek nahoru nebo dolů, zavolejte na posunout dolů nebo moveUp metoda s počtem řádků, o které se má text posunout:
doc.moveDown(3);
doc.moveUp();
Volání kterékoli metody bez předání argumentu ve výchozím nastavení způsobí, že se přesune pouze o jeden řádek.
PDFKit podporuje každé ze 14 standardních písem definovaných formátem PDF. The Textová dokumentace PDFKit má kompletní seznam těchto standardních písem.
Použijte font() způsob, jak určit požadované písmo. Stačí zadat odpovídající název písma jako řetězec:
doc.font('Times-Roman')
.text("Kódování je snadné!");Můžete také změnit velikost písma a barvu textu pomocí velikost písma() a vyplň barvu() metod, resp.
Například:
// Tím se změní barva textu na červenou a písmo bude mít velikost 8
doc.fillColor('Červené')
.velikost písma(8)
.text("Kódování je snadné!");
Přidávání obrázků pomocí sady PDFKit
K obrázku do dokumentu PDF jednoduše předejte jeho cestu do obraz metoda na instanci dokumentu:
doc.image('cesta/k/obrazku.jpeg')
PDFKit umožňuje přidávat obrázky do obou Formát JPEG nebo PNG.
Ve výchozím nastavení PDFKit vloží obrázek v jeho nativní velikosti. Rozměry obrázku můžete změnit poskytnutím objektu obsahujícího páry klíč–hodnota jako argument do obraz() metoda. Můžete určit šířku, výšku a vodorovné a svislé zarovnání.
Například:
// Určení samotné šířky
doc.image('cesta/k/obrazku.jpg', { šířka: 300 });
// Zadání šířky i výšky
doc.image('cesta/k/obrazku.jpg', { šířka: 300, výška:200 })
Přidávání stránek pomocí PDFKit
Chcete-li do dokumentu PDF přidat nové stránky, jednoduše zavolejte na addPage metoda na instanci dokumentu:
doc.addPage()
Chcete-li automaticky přidat obsah pokaždé, když přidáte novou stránku, použijte stránkaPřidáno událost na instanci dokumentu.
Například:
doc.on('pageAdded', () => doc.text("Kódování je snadné!"));
PDFKit vám umožňuje určit rozměry stránky při vytváření nového dokumentu nebo přidávání nové stránky k existujícímu. Existuje několik předdefinovaných velikostí stránek Papírová dokumentace PDFKit vysvětluje.
Chcete-li použít kteroukoli z těchto předdefinovaných velikostí stránky, předejte objekt buď Dokument PDF konstruktor nebo addPage() metoda. Pomocí vlastnosti size zadejte řetězec, který je názvem velikosti papíru.
Například:
// konstruktor
konst doc = Nový PDFDocument({ velikost: 'A5' });
// funkce addPage
doc.addPage({ velikost: 'A7' });
Předání objektu této možnosti do Dokument PDF konstruktor nastaví výchozí velikost stránky pro celý dokument. Toto výchozí nastavení pak můžete přepsat předáním jiné hodnoty do addPage metoda.
Okraje stránky můžete nastavit předáním objektu do okraje vlastnost při přidávání stránek.
The okraje vlastnost bere předmět s nahoře, dole, vlevo, a že jo vlastnosti představující každý okraj.
Například:
// Přidejte různé okraje na každou stranu
doc.addPage({
okraje: {
horní: 72,
dno: 72,
vlevo, odjet: 50,
že jo: 50
}
});
Tento kód nastavuje horní a dolní okraj na 72 bodů a levý a pravý okraj na 50 bodů. Všimněte si, že výchozí okraj pro dokumenty vytvořené pomocí sady PDFKit je 1 palec (72 bodů) na všech stranách.
Chcete-li nastavit všechny horní, dolní, levé a pravé okraje na stejnou hodnotu, jednoduše předejte objekt s a okraj majetek k addPage metoda:
doc.addPage({ okraj: 60 }) // přidat okraj 60 bodů na každou stranu
Výhody vytváření PDF pomocí PDFKit v Node.js
PDFKit vám umožňuje vytvářet standardní a podporované dokumenty z vašich aplikací Node.js. S PDFKit můžete snadno pracovat se složitými dokumenty. Navíc může usnadnit doručování dokumentů uživatelům a usnadnit jejich sdílení a tisk.