You need to enable JavaScript to run this app. 如何使用JavaScript和HTML实现PDF笔记功能 代码排查及存储方案咨询
优惠活动
大模型
产品
解决方案
定价
更多

如何使用JavaScript和HTML实现PDF笔记功能 代码排查及存储方案咨询

PDF手写笔记功能实现方案

原有代码失效原因

你当前的实现逻辑无法适配PDF场景,核心问题有两个:

  1. iframe加载的PDF是浏览器原生渲染的控件,层级高于普通DOM元素,你放在下方的canvas根本接收不到鼠标事件,无法触发手写逻辑
  2. 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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 12:03:00