PDFKit — это библиотека Node.js, упрощающая разработчикам создание PDF-файлов и работу с ними. Он предлагает простой, но эффективный API для создания PDF-файлов и добавления в них различного контента, например текста, изображений и фигур.
Узнайте, как использовать PDF Kit для создания PDF-файлов в Node.js.
Настройка PDFKit
Вы должны иметь Node.js и npm (менеджер пакетов Node.js), установленные на вашем компьютере следовать вместе.
Убедитесь, что у вас установлены эти инструменты, выполнив следующие команды терминала:
узел -v
нпм -в
Чтобы начать использовать PDFKit в своем проекте Node.js, установите его, выполнив следующую команду npm:
npm установить pdfkit
Эта команда установит PDFKit и добавит его в зависимости вашего проекта.
Создание PDF-документа с помощью PDFKit
Чтобы создать PDF-документ с помощью PDFKit, требуется pdfkit пакет и фс (файловая система) в вашем файле скрипта:
константа PDFДокумент = требовать('pdfkit');
константа фс = требовать('фс');
Далее создайте новый экземпляр PDFДокумент сорт. Этот класс представляет файл PDF:
константа документ = новый PDFДокумент();
Созданный экземпляр является доступным для чтения потоком, что означает, что вы можете использовать трубка() способ сохранить его содержимое в файл.
Для этого проведите документ экземпляр в доступный для записи поток, созданный fs.createWriteStream:
doc.pipe (fs.createWriteStream('МойPDFDoc.pdf'));
создатьWriteStream метод сохраняет содержимое файла PDF в указанное место в локальной файловой системе.
Приведенный выше блок кода сохранит полученный PDF-файл в ваш текущий рабочий каталог с именем MyPDFDoc.pdf.
Важно всегда завершать поток после добавления контента в PDF. Вы можете сделать это с помощью этой команды:
документ.конец();
Теперь запустите команду узла узел [имя сценария] для создания файла PDF MyPDFDoc.pdf в вашем текущем рабочем каталоге.
Добавление текста с помощью PDFKit
Прежде чем передать документ для его сохранения, вы можете внести различные изменения. PDFKit упрощает добавление текста в документы и включает множество параметров для настройки отображения вывода.
Чтобы добавить текст в документ, просто вызовите текст() и передайте текст, который вы хотите добавить в качестве аргумента:
док.текст("Кодировать легко!")
Когда PDFKIT добавляет текст в документ, он отслеживает текущие позиции этого текста по осям X и Y. Итак, всякий раз, когда вы вызываете текстовый метод, PDFKit добавит новую строку под предыдущей.
Однако, предоставив координаты X и Y текстовому методу после самого текста, вы можете изменить его положение:
док.текст(«Программирование — это просто!», 100, 100)
Чтобы переместиться вверх или вниз по строке, вызовите двигаться вниз или двигаться вверх Метод с количеством строк, на которые должен перемещаться текст:
doc.moveDown(3);
doc.moveUp();
По умолчанию вызов любого метода без передачи аргумента заставит его переместиться всего на одну строку.
PDFKit поддерживает каждый из 14 стандартных шрифтов, определенных форматом PDF. Текстовая документация PDFKit содержит полный список этих стандартных шрифтов.
Использовать шрифт() способ указать требуемый шрифт. Просто передайте соответствующее имя шрифта в виде строки:
док.шрифт(«Таймс-Роман»)
.текст(«Программирование — это просто!»);Вы также можете изменить размер шрифта и цвет текста с помощью размер шрифта() и Цвет заливки() методы соответственно.
Например:
// Это изменяет цвет текста на красный и устанавливает размер шрифта 8
doc.fillColor('красный')
.размер шрифта(8)
.текст(«Программирование — это просто!»);
Добавление изображений с помощью PDFKit
Чтобы изображение было в вашем PDF-документе, просто передайте его путь в изображение метод экземпляра документа:
док.изображение('путь/к/image.jpeg')
PDFKit позволяет добавлять изображения в любой Формат JPEG или PNG.
По умолчанию PDFKit вставит изображение в исходном размере. Вы можете изменить размеры изображения, предоставив объект, содержащий пары ключ-значение, в качестве аргумента функции изображение() метод. Вы можете указать ширину, высоту, горизонтальное и вертикальное выравнивание.
Например:
// Указание только ширины
док.изображение('путь/к/image.jpg', { ширина: 300 });
// Указание ширины и высоты
док.изображение('путь/к/image.jpg', { ширина: 300, высота:200 })
Добавление страниц с помощью PDFKit
Чтобы добавить новые страницы в документ PDF, просто вызовите добавить страницу метод экземпляра документа:
doc.addPage()
Чтобы автоматически добавлять контент каждый раз, когда вы добавляете новую страницу, используйте кнопку страницаДобавлено событие экземпляра документа.
Например:
док.он('страница добавлена', () => док.текст("Кодировать легко!"));
PDFKit позволяет указать размеры страницы при создании нового документа или добавлении новой страницы к существующей. Существует несколько предопределенных размеров страниц, которые Бумажная документация PDFKit объясняет.
Чтобы использовать любой из этих предопределенных размеров страницы, передайте объект либо в PDFДокумент конструктор или добавить страницу() метод. Используйте свойство размера, чтобы указать строку, которая является именем размера бумаги.
Например:
// конструктор
константа документ = новый PDFДокумент({ размер: «А5» });
// функция добавления страницы
doc.addPage({ размер: «А7» });
Передача этого объекта параметров в PDFДокумент конструктор устанавливает размер страницы по умолчанию для всего документа. Затем вы можете перезаписать это значение по умолчанию, передав другое значение в добавить страницу метод.
Вы можете установить поля страницы, передав объект в поля свойство при добавлении страниц.
поля свойство принимает объект с сверху, снизу, слева, и верно свойства, представляющие каждое поле.
Например:
// Добавляем разные поля с каждой стороны
doc.addPage({
поля: {
вершина: 72,
нижний: 72,
левый: 50,
верно: 50
}
});
Этот код устанавливает верхнее и нижнее поля в 72 пункта, а левое и правое поля в 50 пунктов. Обратите внимание, что поле по умолчанию для документов, созданных с помощью PDFKit, составляет 1 дюйм (72 пункта) со всех сторон.
Чтобы установить для всех верхних, нижних, левых и правых полей одно и то же значение, просто передайте объект с помощью допуск собственность на добавить страницу метод:
doc.addPage({ допуск: 60 }) // добавляем отступ в 60 пунктов с каждой стороны
Преимущества создания PDF-файлов с помощью PDFKit в Node.js
PDFKit позволяет создавать стандартные и поддерживаемые документы из приложений Node.js. С PDFKit вы можете легко обрабатывать сложные документы. Кроме того, это может облегчить доставку документов пользователям и упростить их совместное использование и печать.
