PDFKit adalah pustaka Node.js yang memudahkan pengembang untuk membuat dan bekerja dengan file PDF. Ini menawarkan API yang mudah namun efektif untuk menghasilkan PDF dan menambahkan berbagai jenis konten ke dalamnya, seperti teks, gambar, dan bentuk.
Pelajari cara menggunakan PDF Kit untuk membuat PDF di Node.js.
Menyiapkan PDFkit
Anda harus memiliki Node.js dan npm (manajer paket Node.js) diinstal pada mesin Anda untuk mengikuti.
Pastikan Anda telah menginstal alat ini dengan menjalankan perintah terminal berikut:
simpul -v
npm -v
Untuk mulai menggunakan PDFKit di proyek Node.js Anda, instal dengan menjalankan perintah npm berikut:
npm instal pdfkit
Perintah ini akan menginstal PDFKit dan menambahkannya ke dependensi proyek Anda.
Membuat Dokumen PDF Dengan PDFKit
Untuk membuat dokumen PDF menggunakan PDFKit, perlu pdfkit paket dan fs modul (sistem file) dalam file skrip Anda:
const Dokumen PDF = memerlukan('pdfkit');
const fs = memerlukan('fs');
Selanjutnya, buat instance baru dari Dokumen PDF kelas. Kelas ini mewakili file PDF:
const dok = baru Dokumen PDF();
Instance yang dibuat adalah aliran yang dapat dibaca, yang berarti Anda dapat menggunakan pipa() metode untuk menyimpan isinya ke file.
Untuk melakukan ini, pipa dokter instance menjadi aliran yang dapat ditulisi yang dibuat oleh fs.createWriteStream:
doc.pipe (fs.createWriteStream('MyPDFDoc.pdf'));
Itu createWriteStream metode menyimpan konten file PDF ke lokasi yang ditentukan pada sistem file lokal.
Blok kode di atas akan menyimpan file PDF yang dihasilkan ke direktori kerja Anda saat ini, dengan nama MyPDFDoc.pdf.
Penting untuk selalu mengakhiri streaming setelah menambahkan konten ke PDF. Anda dapat melakukannya dengan menggunakan perintah ini:
doc.end();
Sekarang jalankan perintah node simpul [nama skrip] untuk membuat file PDF MyPDFDoc.pdf di direktori kerja Anda saat ini.
Menambahkan Teks Dengan PDFKit
Sebelum Anda mem-pipe dokumen Anda untuk menyimpannya, Anda dapat membuat berbagai perubahan. PDFKit memudahkan penambahan teks ke dokumen dan menyertakan banyak opsi untuk menyesuaikan tampilan output.
Untuk menambahkan teks ke dokumen, cukup panggil teks() metode dan berikan teks yang ingin Anda tambahkan sebagai argumen:
doc.text("Pengodean itu Mudah!")
Saat PDFKIT menambahkan teks ke dokumen, PDFKIT melacak posisi X dan Y teks saat ini. Jadi, setiap kali Anda memanggil metode teks, PDFKit akan menambahkan baris baru di bawah baris sebelumnya.
Namun, dengan memberikan koordinat X dan Y ke metode teks setelah teks itu sendiri, Anda dapat mengubah posisinya:
doc.text('Pengodean itu Mudah!', 100, 100)
Untuk bergerak ke atas atau ke bawah, panggil Turunkan atau moveUp metode dengan jumlah baris teks harus bergerak:
doc.moveDown(3);
doc.moveUp();
Secara default, memanggil salah satu metode tanpa memberikan argumen akan menyebabkannya bergerak hanya dengan satu baris.
PDFKit mendukung masing-masing dari 14 font standar yang ditentukan oleh format PDF. Itu dokumentasi teks PDFKit memiliki daftar lengkap font standar ini.
Menggunakan jenis huruf() metode untuk menentukan font yang diperlukan Anda. Cukup berikan nama font yang sesuai sebagai string:
doc.font('Zaman-Romawi')
.teks('Pengodean itu Mudah!');Anda juga dapat mengubah ukuran font dan warna teks menggunakan ukuran huruf() dan isiWarna() metode, masing-masing.
Misalnya:
// Ini mengubah warna teks menjadi merah dan memberinya ukuran font 8
doc.fillColor('merah')
.ukuran huruf(8)
.teks('Pengodean itu Mudah!');
Menambahkan Gambar Dengan PDFKit
Untuk gambar ke dokumen PDF Anda, cukup lewati jalurnya ke gambar metode pada contoh dokumen:
doc.gambar('jalur/ke/gambar.jpeg')
PDFKit memungkinkan Anda menambahkan gambar format JPEG atau PNG.
Secara default, PDFKit akan menyisipkan gambar dengan ukuran aslinya. Anda dapat mengubah dimensi gambar dengan memberikan objek yang berisi pasangan kunci-nilai sebagai argumen untuk gambar() metode. Anda dapat menentukan lebar, tinggi, dan perataan horizontal dan vertikal.
Misalnya:
// Menentukan lebar saja
doc.gambar('jalur/ke/gambar.jpg', { lebar: 300 });
// Menentukan lebar dan tinggi
doc.gambar('jalur/ke/gambar.jpg', { lebar: 300, tinggi:200 })
Menambahkan Halaman Dengan PDFKit
Untuk menambahkan halaman baru ke dokumen PDF, cukup panggil tambah halaman metode pada contoh dokumen:
doc.addPage()
Untuk menambahkan konten secara otomatis setiap kali Anda menambahkan halaman baru, gunakan halamanDitambahkan acara pada contoh dokumen.
Misalnya:
doc.on('halamanDitambahkan', () => dok.teks("Pengodean itu Mudah!"));
PDFKit memungkinkan Anda menentukan dimensi halaman saat membuat dokumen baru atau menambahkan halaman baru ke halaman yang sudah ada. Ada beberapa ukuran halaman yang telah ditentukan sebelumnya Dokumentasi kertas PDFKit menjelaskan.
Untuk menggunakan salah satu dari ukuran halaman yang telah ditentukan ini, berikan objek ke salah satu Dokumen PDF pembina atau tambah halaman() metode. Gunakan properti ukuran untuk menentukan string yang merupakan nama ukuran kertas.
Misalnya:
// konstruktor
const dok = baru Dokumen PDF({ ukuran: 'A5' });
// fungsi addPage
doc.addPage({ ukuran: 'A7' });
Melewati objek opsi ini ke Dokumen PDF konstruktor menetapkan ukuran halaman default untuk seluruh dokumen. Anda kemudian dapat menimpa default ini dengan meneruskan nilai yang berbeda ke tambah halaman metode.
Anda dapat mengatur margin halaman dengan meneruskan objek ke margin properti saat menambahkan halaman.
Itu margin properti mengambil objek dengan atas, bawah, kiri, Dan Kanan properti yang mewakili setiap margin.
Misalnya:
// Tambahkan margin yang berbeda di setiap sisi
doc.addPage({
margin: {
atas: 72,
dasar: 72,
kiri: 50,
Kanan: 50
}
});
Kode ini mengatur margin atas dan bawah menjadi 72 poin, dan margin kiri dan kanan menjadi 50 poin. Perhatikan bahwa margin default untuk dokumen yang dibuat PDFKit adalah margin 1 inci (72 poin) di semua sisi.
Untuk mengatur semua margin atas, bawah, kiri, dan kanan ke nilai yang sama, cukup berikan objek dengan a batas properti ke tambah halaman metode:
doc.addPage({ batas: 60 }) // tambahkan margin 60 poin ke setiap sisi
Keuntungan Membuat PDF Dengan PDFKit di Node.js
PDFKit memungkinkan Anda menghasilkan dokumen standar dan didukung dari aplikasi Node.js Anda. Dengan PDFKit, Anda dapat menangani dokumen yang rumit dengan mudah. Selain itu, ini dapat memfasilitasi pengiriman dokumen ke pengguna dan membuatnya lebih mudah untuk dibagikan dan dicetak.
