Inserting barcodes into PDF documents can significantly streamline document management, tracking, and data processing workflows. Barcodes serve as unique identifiers, enabling automated data entry, quick retrieval, and enhanced security. In this article, we'll demonstrate how to leverage HTML5, JavaScript, and the Dynamsoft Document Viewer SDK to generate and embed barcodes into PDF documents.
Web PDF Editor Demo Video
Online Demo
https://yushulx.me/web-document-annotation/
Prerequisites
Dynamsoft Document Viewer: This JavaScript SDK allows for seamless viewing and annotation of various document formats, including PDFs and common image files such as JPEG, PNG, TIFF, and BMP. With its robust feature set, you can render PDFs, navigate pages, enhance image quality, and save annotated documents. Install the package from npm to get started.
Dynamsoft Capture Vision Trial License: To access the full capabilities of the Dynamsoft SDKs, sign up for a 30-day free trial license. This trial offers complete access to all features, enabling you to explore the SDKs in-depth.
Steps to Implement a PDF Document Editor in HTML5 and JavaScript
In the following paragraphs, we'll walk you through the process of creating a web-based PDF document editor with barcode insertion capabilities. The editor will enable users to load PDF documents, insert barcodes as annotations, and save the modified PDF files locally.
Step 1: Include the Dynamsoft Document Viewer SDK
In the <head>
section of your HTML file, add the following script tags to include the Dynamsoft Document Viewer SDK:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/dynamsoft-document-viewer@2.0.0/dist/ddv.css">
<script src="https://cdn.jsdelivr.net/npm/dynamsoft-document-viewer@2.0.0/dist/ddv.js"></script>
Step 2: Activate Dynamsoft Document Viewer
-
In
index.html
, create an input element for the license key and a button to activate the SDK:
<input type="text" placeholder="LICENSE-KEY" id="licensekey"> <button id="activateButton">Activate SDK</button>
-
Implement the activation logic in
main.js
:
async function activate(license) { try { Dynamsoft.DDV.Core.license = license; Dynamsoft.DDV.Core.engineResourcePath = "https://cdn.jsdelivr.net/npm/dynamsoft-document-viewer@2.0.0/dist/engine"; await Dynamsoft.DDV.Core.init(); Dynamsoft.DDV.setProcessingHandler("imageFilter", new Dynamsoft.DDV.ImageFilter()); docManager = Dynamsoft.DDV.documentManager; } catch (error) { console.error(error); toggleLoading(false); } }
Explanation
- The
engineResourcePath
must point to the location of the Dynamsoft Document Viewer engine files. -
setProcessingHandler
sets the image filter for enhancing image quality. - The
documentManager
object is used to manage the document viewer and editor.
- The
Step 3: Create a Web PDF Viewer with Ready-to-Use Components
The Dynamsoft Document Viewer SDK provides a built-in document editor that requires minimal code to construct a web PDF viewer application.
-
Create a container element for the document viewer in
index.html
:
<div class="document-viewer"> <div id="edit-viewer"></div> </div>
-
Initialize the document viewer in
main.js
:
async function showViewer() { if (!docManager) return; let editContainer = document.getElementById("edit-viewer"); editContainer.parentNode.style.display = "block"; editViewer = new Dynamsoft.DDV.EditViewer({ container: editContainer, uiConfig: DDV.getDefaultUiConfig("editViewer", { includeAnnotationSet: true }) }); }
The
uiConfig
parameter specifies the default UI configuration for the document viewer, including annotation tools.
Step 4: Add a Custom Button to Insert Barcodes into the PDF Document
Dynamsoft Document Viewer allows for customization of UI elements and event handlers. According to the official documentation, you can add custom buttons.
A Custom Barcode Button with Google's Material Icons
Define a custom button object in main.js
:
const qrButton = {
type: Dynamsoft.DDV.Elements.Button,
className: "material-icons icon-qr_code",
tooltip: "Add a QR code. Ctrl+Q",
events: {
click: "addQr",
},
};
The className
points to Google fonts. Use the material-icons
class to display the qr_code
icon in the button.
<link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
<style>
.icon-qr_code::before {
content: "qr_code";
}
.icon-qr_code {
display: flex;
font-size: 1.5em;
}
</style>
Add the Barcode Button to the Toolbar
To add the button to the toolbar, modify the uiConfig
parameter in the showViewer
function:
const pcEditViewerUiConfig = {
type: Dynamsoft.DDV.Elements.Layout,
flexDirection: "column",
className: "ddv-edit-viewer-desktop",
children: [
{
type: Dynamsoft.DDV.Elements.Layout,
className: "ddv-edit-viewer-header-desktop",
children: [
{
type: Dynamsoft.DDV.Elements.Layout,
children: [
Dynamsoft.DDV.Elements.ThumbnailSwitch,
Dynamsoft.DDV.Elements.Zoom,
Dynamsoft.DDV.Elements.FitMode,
Dynamsoft.DDV.Elements.DisplayMode,
Dynamsoft.DDV.Elements.RotateLeft,
Dynamsoft.DDV.Elements.RotateRight,
Dynamsoft.DDV.Elements.Crop,
Dynamsoft.DDV.Elements.Filter,
Dynamsoft.DDV.Elements.Undo,
Dynamsoft.DDV.Elements.Redo,
Dynamsoft.DDV.Elements.DeleteCurrent,
Dynamsoft.DDV.Elements.DeleteAll,
Dynamsoft.DDV.Elements.Pan,
Dynamsoft.DDV.Elements.AnnotationSet,
qrButton,
],
},
{
type: Dynamsoft.DDV.Elements.Layout,
children: [
{
type: Dynamsoft.DDV.Elements.Pagination,
className: "ddv-edit-viewer-pagination-desktop",
},
Dynamsoft.DDV.Elements.Load,
{
type: Dynamsoft.DDV.Elements.Button,
className: "ddv-button ddv-button-download",
events: {
click: "download",
}
}
],
},
],
},
Dynamsoft.DDV.Elements.MainView,
],
};
editViewer = new Dynamsoft.DDV.EditViewer({
container: editContainer,
uiConfig: pcEditViewerUiConfig
});
Press the Button to Pop Up a Barcode Generation Dialog
When the barcode button is clicked, a pop-up dialog will appear for users to input the barcode content and select the barcode type:
editViewer.on("addQr", addQr);
The dialog contains the following elements:
- A dropdown list for selecting barcode types.
- An input field for entering barcode content.
- An
OK
button to submit the data. - A
Cancel
button to close the pop-up without submitting.
Here's the full code:
<style>
.popup {
background: #fff;
padding: 20px;
border-radius: 8px;
width: 300px;
box-shadow: 0 2px 10px rgba(0, 0, 0, 0.3);
text-align: center;
}
.popup button {
margin: 10px 5px;
padding: 8px 16px;
border: none;
border-radius: 4px;
cursor: pointer;
}
.popup .return-btn {
background-color: #4CAF50;
color: white;
}
.popup .cancel-btn {
background-color: #f44336;
color: white;
}
</style>
<div id="popupOverlay" class="overlay">
<div class="popup">
<div>
<label for="barcodeType">Barcode Type:</label>
<!-- Dropdown for Barcode Types -->
<select id="barcodeType">
<option value="qrcode">QR Code</option>
<option value="pdf417">PDF417</option>
<option value="maxicode">MaxiCode</option>
<option value="datamatrix">DataMatrix</option>
<option value="ean13">EAN13</option>
<option value="code128">CODE128</option>
<option value="code39">CODE39</option>
</select>
</div>
<div>
<label for="barcodeContent">Barcode Text:</label>
<input type="text" id="barcodeContent" placeholder="Enter barcode content">
</div>
<div style="margin-top: 10px;">
<label>
<input type="checkbox" id="applyToAllPages"> Auto-generate barcodes on all pages
</label>
</div>
<button class="return-btn" onclick="returnResults()">OK</button>
<button class="cancel-btn" onclick="closePopup()">Cancel</button>
</div>
</div>
<script>
function openPopup() {
let docs = docManager.getAllDocuments();
if (docs.length == 0) {
alert("Please load a document first.");
return;
}
document.getElementById("popupOverlay").style.display = "flex";
}
function closePopup() {
document.getElementById("popupOverlay").style.display = "none";
}
function returnResults() {
const barcodeType = document.getElementById("barcodeType").value;
const barcodeContent = document.getElementById("barcodeContent").value;
const applyToAllPages = document.getElementById("applyToAllPages").checked;
if (!barcodeContent) {
alert("Please enter barcode content.");
return;
}
closePopup();
let docs = docManager.getAllDocuments();
let tempCanvas = document.createElement('canvas');
if (barcodeContent !== null) {
// TODO
}
}
</script>
Step 5: Generate a Barcode and Insert it as Annotation to PDF Document
Include the bwip-js library in index.html
. This library is used to generate barcodes in various formats, such as QR Code, PDF417, and DataMatrix.
<script src="https://cdn.jsdelivr.net/npm/bwip-js@4.1.2"></script>
After retrieving the barcode content and type, use bwipjs
to draw the generated barcode on a canvas. Then, convert the canvas to a blob and insert it as an annotation to the PDF document.
if (barcodeContent !== null) {
try {
bwipjs.toCanvas(tempCanvas, {
bcid: barcodeType,
text: barcodeContent,
scale: 3,
includetext: false,
});
tempCanvas.toBlob(async (blob) => {
if (blob) {
let currentPageId = docs[0].pages[editViewer.getCurrentPageIndex()];
let pageData = await docs[0].getPageData(currentPageId);
const option = {
stamp: blob,
x: pageData.mediaBox.width - 110,
y: 10,
width: 100,
height: 100,
opacity: 1.0,
flags: {
print: false,
noView: false,
readOnly: false,
}
}
if (applyToAllPages) {
for (let i = 0; i < docs[0].pages.length; i++) {
await Dynamsoft.DDV.annotationManager.createAnnotation(docs[0].pages[i], "stamp", option)
}
} else {
await Dynamsoft.DDV.annotationManager.createAnnotation(currentPageId, "stamp", option)
}
}
}, 'image/png');
} catch (e) {
console.log(e);
}
}
Step 6: Save the PDF Document with Barcodes to Local Disk
Create a download()
function and bind it to the download button in the toolbar:
editViewer.on("download", download);
async function download() {
try {
const pdfSettings = {
saveAnnotation: "flatten",
};
let blob = await editViewer.currentDocument.saveToPdf(pdfSettings);
saveBlob(blob, `document_${Date.now()}.pdf`);
} catch (error) {
console.log(error);
}
}
function saveBlob(blob, fileName) {
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = fileName;
document.body.appendChild(a);
a.click();
document.body.removeChild(a);
URL.revokeObjectURL(url);
}
When saving the PDF document, the saveAnnotation
option is set to flatten
, ensuring that annotations, including the barcodes, are embedded in the document.
Running the Web PDF Document Editor
-
Start a web server in the root directory of your project:
python -m http.server
Open
http://localhost:8000
in your web browser.Load a PDF document.
-
Insert a barcode as an annotation into the PDF document.
Reading Barcodes from PDF Documents
Once the PDF document is saved to your local disk, you can verify the barcode content by reading it with the Dynamsoft Barcode Reader.
-
Install
barcode4nodejs
, a Node.js wrapper built with the Dynamsoft C++ Barcode Reader SDK.
npm i barcode4nodejs
-
Create a script file,
test.js
, to read barcodes from the PDF document:
var dbr = require('barcode4nodejs'); var barcodeTypes = dbr.formats.ALL; dbr.initLicense("LICENSE-KEY"); let args = process.argv; if (args.includes('-f')) { let fIndex = args.indexOf('-f'); if (args[fIndex + 1]) { (async function () { try { var result = await dbr.decodeFileAsync(args[fIndex + 1], barcodeTypes, ""); console.log(result); setTimeout(() => { console.log('terminated'); }, 1000); } catch (error) { console.log(error); } })(); } else { console.log('Please add a file.'); } }
Note: You need to replace the
LICENSE-KEY
with your own. -
Run the script with the path to a PDF file:
node test.js -f <pdf file>
The barcode content will be printed in the console.
Source Code
https://github.com/yushulx/web-twain-document-scan-management/tree/main/examples/document_annotation
Top comments (0)