如何使用JavaScript和HTML实现PDF笔记功能 代码排查及存储方案咨询
PDF手写笔记功能实现方案
原有代码失效原因
你当前的实现逻辑无法适配PDF场景,核心问题有两个:
- iframe加载的PDF是浏览器原生渲染的控件,层级高于普通DOM元素,你放在下方的canvas根本接收不到鼠标事件,无法触发手写逻辑
- PDF的滚动、缩放操作和canvas坐标完全没有同步,即使能书写,笔迹也会和PDF内容错位,完全无法使用
替代实现方案
采用Mozilla开源的PDF.js渲染PDF文件,直接在页面上渲染PDF的每一页内容,每页对应叠加一个同尺寸的canvas手写层,PDF滚动、缩放时同步调整手写层的坐标和尺寸,保证笔迹和PDF内容对齐。
核心功能支持说明
- 手写笔记可以导出合并为PDF:通过jsPDF库,先将原始PDF页绘制到新PDF实例,再将对应页的手写笔迹绘制到相同坐标,即可导出带笔记的完整PDF
- WebView场景下可通过本地IndexedDB存储笔记:WebView原生支持IndexedDB接口,可存储笔迹的路径、颜色、粗细、对应页码等元数据,也可直接存储手写canvas的序列化数据,所有数据存在应用本地沙箱,无需依赖后端服务
适配WebView的核心示例代码
1. 引入依赖
在HTML头部引入PDF.js和jsPDF的本地资源(不要用线上CDN,把资源下载到本地包内,适配WebView离线场景)
<!-- 本地引入PDF.js相关资源 --> <script src="./libs/pdf.min.js"></script> <script src="./libs/jspdf.umd.min.js"></script>
2. 核心页面结构
<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title>PDF手写笔记</title> <style> #pdf-container { position: relative; width: 100%; height: calc(100vh - 60px); overflow-y: auto; } .pdf-page { position: relative; margin: 10px auto; box-shadow: 0 0 5px rgba(0,0,0,0.3); } .canvas-layer { position: absolute; top: 0; left: 0; z-index: 10; } .toolbar { height: 60px; display: flex; align-items: center; gap: 10px; padding: 0 10px; background: #f5f5f5; } </style> </head> <body> <div class="toolbar"> <label>颜色:<input id="color" type="color" value="#ff0000"></label> <label>粗细:<input id="width" type="number" min="1" max="30" value="2"></label> <button id="clear-btn">清空当前页笔记</button> <button id="save-btn">保存笔记到本地</button> <button id="export-btn">导出带笔记PDF</button> </div> <div id="pdf-container"></div> <script src="./app.js"></script> </body> </html>
3. 核心逻辑(app.js)
const pdfjsLib = window['pdfjs-dist/build/pdf']; pdfjsLib.GlobalWorkerOptions.workerSrc = './libs/pdf.worker.min.js'; // 全局状态 let currentPdf = null; let pageCount = 0; let drawing = false; let beforeX = 0; let beforeY = 0; let activeCanvas = null; let activeCtx = null; const dbName = "PdfNoteDB"; const storeName = "notes"; // 初始化IndexedDB function initDB() { return new Promise((resolve, reject) => { const request = indexedDB.open(dbName, 1); request.onupgradeneeded = e => { const db = e.target.result; if (!db.objectStoreNames.contains(storeName)) { db.createObjectStore(storeName, { keyPath: "pdfPageId" }); } }; request.onsuccess = e => resolve(e.target.result); request.onerror = e => reject(e.target.error); }); } // 加载PDF async function loadPdf(url) { const pdf = await pdfjsLib.getDocument(url).promise; currentPdf = pdf; pageCount = pdf.numPages; for (let i = 1; i <= pageCount; i++) { const page = await pdf.getPage(i); const viewport = page.getViewport({ scale: 1.5 }); const pageDiv = document.createElement("div"); pageDiv.className = "pdf-page"; pageDiv.style.width = `${viewport.width}px`; pageDiv.style.height = `${viewport.height}px`; pageDiv.dataset.pageNum = i; // PDF渲染层 const pdfCanvas = document.createElement("canvas"); pdfCanvas.width = viewport.width; pdfCanvas.height = viewport.height; pageDiv.appendChild(pdfCanvas); // 手写层 const handCanvas = document.createElement("canvas"); handCanvas.className = "canvas-layer"; handCanvas.width = viewport.width; handCanvas.height = viewport.height; handCanvas.dataset.pageNum = i; pageDiv.appendChild(handCanvas); document.getElementById("pdf-container").appendChild(pageDiv); // 渲染PDF内容 const renderContext = { canvasContext: pdfCanvas.getContext("2d"), viewport: viewport }; await page.render(renderContext).promise; // 绑定手写事件 bindCanvasEvent(handCanvas); // 加载已保存的笔记 loadNote(i, handCanvas.getContext("2d")); } } // 绑定手写事件 function bindCanvasEvent(canvas) { const ctx = canvas.getContext("2d"); canvas.addEventListener("mousedown", e => { drawing = true; activeCanvas = canvas; activeCtx = ctx; const rect = canvas.getBoundingClientRect(); beforeX = e.clientX - rect.left; beforeY = e.clientY - rect.top; }); canvas.addEventListener("mousemove", draw); canvas.addEventListener("mouseup", () => drawing = false); canvas.addEventListener("mouseleave", () => drawing = false); // 兼容移动端触摸事件 canvas.addEventListener("touchstart", e => { e.preventDefault(); const touch = e.touches[0]; const rect = canvas.getBoundingClientRect(); drawing = true; activeCanvas = canvas; activeCtx = ctx; beforeX = touch.clientX - rect.left; beforeY = touch.clientY - rect.top; }); canvas.addEventListener("touchmove", e => { e.preventDefault(); const touch = e.touches[0]; const rect = canvas.getBoundingClientRect(); draw({clientX: touch.clientX, clientY: touch.clientY, target: canvas}); }); canvas.addEventListener("touchend", () => drawing = false); } // 绘制逻辑 function draw(e) { if (!drawing || !activeCtx) return; const rect = e.target.getBoundingClientRect(); const x = e.clientX - rect.left; const y = e.clientY - rect.top; const w = document.getElementById("width").value; const color = document.getElementById("color").value; activeCtx.lineCap = "round"; activeCtx.strokeStyle = color; activeCtx.lineWidth = w; activeCtx.beginPath(); activeCtx.moveTo(beforeX, beforeY); activeCtx.lineTo(x, y); activeCtx.stroke(); activeCtx.closePath(); beforeX = x; beforeY = y; } // 保存笔记到IndexedDB async function saveNote(pageNum, ctx) { const db = await initDB(); const tx = db.transaction(storeName, "readwrite"); const store = tx.objectStore(storeName); const noteData = { pdfPageId: `test_pdf_${pageNum}`, // 实际使用替换为对应PDF的唯一标识+页码 pageNum: pageNum, canvasData: ctx.canvas.toDataURL("image/png") }; await store.put(noteData); db.close(); alert("笔记已保存到本地"); } // 加载已保存的笔记 async function loadNote(pageNum, ctx) { const db = await initDB(); const tx = db.transaction(storeName, "readonly"); const store = tx.objectStore(storeName); const result = await store.get(`test_pdf_${pageNum}`); if (result) { const img = new Image(); img.onload = () => ctx.drawImage(img, 0, 0); img.src = result.canvasData; } db.close(); } // 导出带笔记的PDF async function exportPdf() { const { jsPDF } = window.jspdf; const firstPage = document.querySelector(".pdf-page canvas"); const pdf = new jsPDF("p", "px", [firstPage.width, firstPage.height]); for (let i = 1; i <= pageCount; i++) { if (i > 1) pdf.addPage([firstPage.width, firstPage.height]); const pageDiv = document.querySelector(`.pdf-page[data-page-num="${i}"]`); const pdfCanvas = pageDiv.querySelector("canvas:first-child"); const handCanvas = pageDiv.querySelector(".canvas-layer"); // 先绘制PDF原内容 pdf.addImage(pdfCanvas.toDataURL("image/png"), "PNG", 0, 0, firstPage.width, firstPage.height); // 再绘制手写笔记 pdf.addImage(handCanvas.toDataURL("image/png"), "PNG", 0, 0, firstPage.width, firstPage.height); } pdf.save("带笔记的文档.pdf"); } // 事件绑定 document.getElementById("clear-btn").addEventListener("click", () => { if (activeCtx && confirm("确认清空当前页笔记?")) { activeCtx.clearRect(0, 0, activeCanvas.width, activeCanvas.height); } }); document.getElementById("save-btn").addEventListener("click", () => { if (activeCanvas) { saveNote(activeCanvas.dataset.pageNum, activeCtx); } }); document.getElementById("export-btn").addEventListener("click", exportPdf); // 初始化加载本地PDF loadPdf("./src/krlang.pdf");
WebView对接说明
- Android/iOS的WebView默认都支持IndexedDB,不需要额外配置,数据会存在应用的私有目录下,不会被其他应用访问
- 如果需要原生侧读取笔记数据,可以通过JSBridge接口,将IndexedDB中存储的canvas base64数据传递给原生层做进一步处理
- 所有依赖资源都要打包到应用安装包内,不要用线上资源,保证离线可用
内容的提问来源于stack exchange,提问作者GangFlowerGam
相关产品推荐
相关产品推荐

