PDFKit to biblioteka Node.js, która ułatwia programistom tworzenie i pracę z plikami PDF. Oferuje prosty, ale skuteczny interfejs API do tworzenia plików PDF i dodawania do nich różnego rodzaju treści, takich jak tekst, obrazy i kształty.
Dowiedz się, jak używać narzędzia PDF Kit do tworzenia plików PDF w Node.js.
Konfigurowanie PDFkita
Ty musisz mieć Node.js i npm (menedżer pakietów Node.js) zainstalowane na twoim komputerze podążać za sobą.
Upewnij się, że masz zainstalowane te narzędzia, uruchamiając następujące polecenia terminala:
węzeł -v
npm -v
Aby rozpocząć korzystanie z PDFKit w projekcie Node.js, zainstaluj go, uruchamiając następujące polecenie npm:
npm zainstaluj pdfkit
To polecenie zainstaluje PDFKit i doda go do zależności twojego projektu.
Tworzenie dokumentu PDF za pomocą PDFKit
Aby utworzyć dokument PDF za pomocą PDFKit, wymagaj pdfkit pakiet i fs (system plików) w pliku skryptu:
konst PDFDokument = wymagać(„pdfkit”);
konst fs = wymagać(„FS”);
Następnie utwórz nową instancję pliku PDFDokument klasa. Ta klasa reprezentuje plik PDF:
konst dokument = nowy PDFDokument();
Utworzona instancja jest czytelnym strumieniem, co oznacza, że można użyć rura() sposób zapisania jego zawartości do pliku.
Aby to zrobić, wykonaj rurkę doktor instancję w zapisywalny strumień utworzony przez fs.createWriteStream:
doc.pipe (fs.createWriteStream(„Mój PDFDoc.pdf”));
The utwórz strumień zapisu Metoda zapisuje zawartość pliku PDF w określonej lokalizacji w lokalnym systemie plików.
Powyższy blok kodu zapisze wynikowy plik PDF w bieżącym katalogu roboczym z nazwą Mój PDFDoc.pdf.
Ważne jest, aby zawsze kończyć strumień po dodaniu treści do pliku PDF. Możesz to zrobić za pomocą tego polecenia:
dok.end();
Teraz uruchom polecenie węzła węzeł [nazwa skryptu] aby utworzyć plik PDF Mój PDFDoc.pdf w bieżącym katalogu roboczym.
Dodawanie tekstu za pomocą PDFKit
Zanim potokujesz dokument, aby go zapisać, możesz wprowadzić różne zmiany. PDFKit ułatwia dodawanie tekstu do dokumentów i zawiera wiele opcji dostosowywania wyświetlania wyników.
Aby dodać tekst do dokumentu, po prostu zadzwoń pod numer tekst() metodę i przekaż tekst, który chcesz dodać jako argument:
dok.tekst(„Kodowanie jest łatwe!”)
Gdy PDFKIT dodaje tekst do dokumentu, śledzi bieżące pozycje X i Y tego tekstu. Tak więc za każdym razem, gdy wywołasz metodę tekstową, PDFKit doda nową linię pod poprzednią.
Jednak podając współrzędne X i Y do metody tekstowej po samym tekście, możesz zmienić jego położenie:
dok.tekst(„Kodowanie jest łatwe!”, 100, 100)
Aby przejść w górę lub w dół linii, wywołaj padnij Lub ruch w górę metoda z liczbą wierszy, o które tekst ma się przesunąć:
doc.moveDown(3);
doc.moveUp();
Domyślnie wywołanie którejkolwiek z metod bez podania argumentu spowoduje, że przesunie się ona tylko o jedną linię.
PDFKit obsługuje każdą z 14 standardowych czcionek zdefiniowanych w formacie PDF. The Dokumentacja tekstowa PDFKit zawiera pełną listę tych standardowych czcionek.
Użyj czcionka() metodę określenia wymaganej czcionki. Po prostu podaj odpowiednią nazwę czcionki jako ciąg znaków:
doc.font(„Times-Roman”)
.tekst(„Kodowanie jest łatwe!”);Możesz także zmienić rozmiar czcionki i kolor tekstu za pomocą rozmiar czcionki() i wypełnijKolor() odpowiednio metody.
Na przykład:
// To zmienia kolor tekstu na czerwony i nadaje mu rozmiar czcionki 8
doc.fillColor('czerwony')
.rozmiar czcionki(8)
.tekst(„Kodowanie jest łatwe!”);
Dodawanie obrazów za pomocą PDFKit
Aby obraz znalazł się w dokumencie PDF, po prostu przekaż jego ścieżkę do pliku obraz metoda w instancji dokumentu:
dok.obraz(„ścieżka/do/obrazu.jpeg”)
PDFKit umożliwia dodawanie obrazów w obu formacie JPEG lub PNG.
Domyślnie PDFKit wstawi obraz w jego natywnym rozmiarze. Możesz zmienić wymiary obrazu, podając jako argument obiekt zawierający pary klucz-wartość obraz() metoda. Można określić szerokość, wysokość oraz wyrównanie w poziomie i w pionie.
Na przykład:
// Samo określenie szerokości
dok.obraz(„ścieżka/do/obrazu.jpg”, { szerokość: 300 });
// Określenie szerokości i wysokości
dok.obraz(„ścieżka/do/obrazu.jpg”, { szerokość: 300, wysokość:200 })
Dodawanie stron za pomocą PDFKit
Aby dodać nowe strony do dokumentu PDF, po prostu zadzwoń pod numer Dodaj stronę metoda w instancji dokumentu:
doc.addPage()
Aby automatycznie dodawać zawartość za każdym razem, gdy dodajesz nową stronę, użyj stronaDodana zdarzenie w instancji dokumentu.
Na przykład:
dok.on(„strona dodana”, () => dok.tekst(„Kodowanie jest łatwe!”));
PDFKit pozwala określić wymiary strony podczas tworzenia nowego dokumentu lub dodawania nowej strony do istniejącego. Istnieje kilka predefiniowanych rozmiarów stron, które Dokumentacja papierowa PDFKit wyjaśnia.
Aby użyć dowolnego z tych predefiniowanych rozmiarów stron, przekaż obiekt do PDFDokument konstruktor lub Dodaj stronę() metoda. Użyj właściwości size, aby określić ciąg, który jest nazwą rozmiaru papieru.
Na przykład:
// konstruktor
konst dokument = nowy PDFDokument({ rozmiar: „A5” });
// dodaj funkcję strony
doc.addPage({ rozmiar: „A7” });
Przekazanie tego obiektu opcji do PDFDokument konstruktor ustawia domyślny rozmiar strony dla całego dokumentu. Następnie możesz zastąpić tę wartość domyślną, przekazując inną wartość do pliku Dodaj stronę metoda.
Możesz ustawić marginesy strony, przekazując obiekt do marginesy właściwość podczas dodawania stron.
The marginesy właściwość zabiera obiekt z góra, dół, lewa, I Prawidłowy właściwości reprezentujące każdy margines.
Na przykład:
// Dodaj różne marginesy z każdej strony
doc.addPage({
marginesy: {
szczyt: 72,
spód: 72,
lewy: 50,
Prawidłowy: 50
}
});
Ten kod ustawia górny i dolny margines na 72 punkty, a lewy i prawy margines na 50 punktów. Należy pamiętać, że domyślnym marginesem dla dokumentów tworzonych w PDFKit jest 1-calowy (72-punktowy) margines ze wszystkich stron.
Aby ustawić wszystkie górne, dolne, lewe i prawe marginesy na tę samą wartość, po prostu przekaż obiekt z a margines nieruchomość do Dodaj stronę metoda:
doc.addPage({ margines: 60 }) // dodaj 60-punktowy margines z każdej strony
Zalety tworzenia plików PDF za pomocą PDFKit w Node.js
PDFKit umożliwia tworzenie standardowych i obsługiwanych dokumentów z aplikacji Node.js. Dzięki PDFKit możesz łatwo obsługiwać złożone dokumenty. Dodatkowo może ułatwić dostarczanie dokumentów użytkownikom oraz uprościć ich udostępnianie i drukowanie.