MENU

問い合わせ

    お問い合わせ


    【Nuxtで作るPDF管理システム 第8回】注釈・スタンプ・署名画像を貼る

    (2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)

    「届いた書類に『確認しました』と一言書き込みたい」「承認欄に日付入りの印を押したい」「紙に印刷してサインしてスキャンし直す手間をなくしたい」。PDFで書類を回している職場では、こうした要望が必ず出てきます。今回は、PDFのプレビュー上でクリックした位置に、日本語のテキスト・日付印・手書き署名の画像を書き込み、新しい版として保存する機能を作ります。

    前回の第7回:PDFの結合と分割では、pdf-lib で結合・分割を行い、元のPDFを上書きしない版管理を作りました。今回もその仕組みに乗せて、「書き込んだら新しい版」にします。

    「PDFに文字や印を入れるだけなら簡単そう。何か難しいところがあるの?」

    結論から言うと、難しいのは「画面の座標とPDFの座標の変換」と「日本語フォントの埋め込み」の2点です。画面は左上が原点、PDFは左下が原点で、単位も違います。さらに、PDF編集ライブラリの標準フォントは日本語を描けないため、日本語フォントを自分で用意して埋め込む必要があります。今回はこの2点を実際に検証した結果とあわせて説明します。

    目次

    今回作る書き込み機能の全体像

    できるようになること

    種類内容置き方
    テキスト日本語の文字(最大200文字・改行可)。大きさ9〜24pt、色は黒・赤・青クリックした位置が1行目の左上
    日付印丸枠の中に「承認」「確認」「受領」「却下」、日付、押した人の名前クリックした位置が印の中心
    署名画面上の枠に指やマウスで書いたサインを PNG 画像にして貼るクリックした位置が画像の左上

    複数の書き込みを「予定」として画面上に並べ、最後にまとめて保存します。保存すると、書き込みがページの内容として焼き込まれた(=ページの一部として描き込まれた)新しい版ができます。

    画面とサーバーの役割分担

    処理場所使うもの
    プレビュー表示、クリック位置 → PDFの座標への変換ブラウザpdfjs-dist(第6回のビューア)
    手書き署名の入力 → PNG 化ブラウザCanvas
    権限確認、文字・印・画像の焼き込み、新しい版の保存サーバーpdf-lib、@pdf-lib/fontkit(日本語フォント)

    第7回と同じく、画面からは「どのページの・どの座標に・何を書くか」だけを送り、PDFの加工はサーバーで行います。日付印の日付と名前も、画面から送らせずにサーバー側で入れます。画面から名前を送れる作りにすると、他人の名前の印を押せてしまうからです。

    「注釈」と「焼き込み」の違い

    PDFには、ビューアの機能で付け外しできる「注釈(コメント・付箋など)」という仕組みもあります。今回はそれを使わず、ページの内容として描き込む「焼き込み」にしました。焼き込んだ文字や印は、一般的なPDFビューアの注釈機能では消せません。消したいときは、第7回の版の履歴から書き込む前の版を取り出します。

    画面の座標をPDFの座標に変換する

    原点Y軸の向き単位
    画面(Canvas)左上下向きに増えるCSS ピクセル(拡大率で変わる)
    PDF左下上向きに増えるポイント(1/72インチ)

    この変換は、pdfjs-dist がページを描くときに使う viewport(表示の設定)が持っている convertToPdfPoint で行えます。逆向きの convertToViewportPoint を使うと、PDFの座標から画面上の位置を求められます。拡大縮小しても、ページに切り抜き範囲(CropBox)が設定されていても、同じ関数で正しく変換できます。

    📰 出典:PDF.js ソースコード page_viewport.js(convertToPdfPoint / convertToViewportPoint)

    第6回のビューア部品に、クリック位置を知らせる機能と、予定の位置に番号を重ねる機能を足します。

    app/components/PdfViewer.client.vue に次の変更を加えます(+ が追加、- が削除)。

    --- a/app/components/PdfViewer.client.vue
    +++ b/app/components/PdfViewer.client.vue
    @@ -2,13 +2,27 @@
     // PDF.js(pdfjs-dist)でPDFをCanvasに描画するビューア。
     // .client.vue なのでブラウザでだけ動く(サーバー描画では空のまま)
     import { GlobalWorkerOptions, getDocument } from 'pdfjs-dist'
    -import type { PDFDocumentLoadingTask, PDFDocumentProxy, RenderTask } from 'pdfjs-dist'
    +import type { PDFDocumentLoadingTask, PDFDocumentProxy, PageViewport, RenderTask } from 'pdfjs-dist'
     // ?url … Vite の機能。ワーカーのファイルをビルド成果物に含め、その URL を受け取る
     import workerUrl from 'pdfjs-dist/build/pdf.worker.min.mjs?url'
     
    +/** ページ上に重ねて表示する印(PDFの座標で指定。第8回) */
    +interface ViewerMarker {
    +  page: number
    +  x: number
    +  y: number
    +  label: string
    +}
    +
     const props = defineProps<{
       /** PDFのURL(同じオリジンのAPI。Cookie が送られ、サーバー側で認可される) */
       src: string
    +  /** true のとき、クリックした位置をPDFの座標に変換して pick イベントで知らせる */
    +  pickable?: boolean
    +  markers?: ViewerMarker[]
    +}>()
    +const emit = defineEmits<{
    +  pick: [point: { page: number, x: number, y: number }]
     }>()
     
     // PDF.js の重い処理(解析)はワーカー(別スレッド)で行う
    @@ -31,6 +45,8 @@ let pdf: PDFDocumentProxy | null = null
     let renderTask: RenderTask | null = null
     /** 描画の呼び出し番号。ページ送りの連打で古い描画が後から始まらないようにする */
     let renderSeq = 0
    +/** 表示中のページの viewport(画面の座標 ⇔ PDFの座標の変換に使う) */
    +const viewport = shallowRef<PageViewport | null>(null)
     
     async function load() {
       loading.value = true
    @@ -70,18 +86,19 @@ async function render() {
       // 前の描画が終わっていなければ取り消す(同じCanvasに同時に描くとエラーになる)
       renderTask?.cancel()
     
    -  const viewport = page.getViewport({ scale: scale.value })
    +  const vp = page.getViewport({ scale: scale.value })
    +  viewport.value = vp
       // 高解像度ディスプレイではCanvasを実寸より大きく描いてにじみを防ぐ
       const outputScale = window.devicePixelRatio || 1
       const el = canvas.value
    -  el.width = Math.floor(viewport.width * outputScale)
    -  el.height = Math.floor(viewport.height * outputScale)
    -  el.style.width = `${Math.floor(viewport.width)}px`
    -  el.style.height = `${Math.floor(viewport.height)}px`
    +  el.width = Math.floor(vp.width * outputScale)
    +  el.height = Math.floor(vp.height * outputScale)
    +  el.style.width = `${Math.floor(vp.width)}px`
    +  el.style.height = `${Math.floor(vp.height)}px`
     
       renderTask = page.render({
         canvas: el,
    -    viewport,
    +    viewport: vp,
         transform: outputScale !== 1 ? [outputScale, 0, 0, outputScale, 0, 0] : undefined,
       })
       try {
    @@ -100,6 +117,23 @@ function zoom(delta: number) {
       scale.value = Math.min(MAX_SCALE, Math.max(MIN_SCALE, Math.round((scale.value + delta) * 100) / 100))
     }
     
    +// クリック位置(Canvas 左上からの CSS ピクセル)→ PDFの座標(左下が原点・単位ポイント)
    +function onCanvasClick(e: MouseEvent) {
    +  if (!props.pickable || !viewport.value) return
    +  const [x, y] = viewport.value.convertToPdfPoint(e.offsetX, e.offsetY) as [number, number]
    +  emit('pick', { page: pageNumber.value, x, y })
    +}
    +
    +// 表示中のページの印を、PDFの座標 → 画面の座標に変換して重ねる(拡大縮小しても位置が合う)
    +const visibleMarkers = computed(() => {
    +  const vp = viewport.value
    +  if (!vp) return []
    +  return (props.markers ?? []).filter((m) => m.page === pageNumber.value).map((m) => {
    +    const [left, top] = vp.convertToViewportPoint(m.x, m.y) as [number, number]
    +    return { ...m, left, top }
    +  })
    +})
    +
     watch([pageNumber, scale], () => {
       render()
     })
    @@ -133,7 +167,15 @@ onBeforeUnmount(destroy)
         <p v-if="loading">読み込み中…</p>
         <p v-if="errorMessage" class="viewer__error">{{ errorMessage }}</p>
         <div v-show="!errorMessage" class="viewer__page">
    -      <canvas ref="canvas" />
    +      <div class="viewer__sheet">
    +        <canvas ref="canvas" :class="{ 'viewer__canvas--pick': pickable }" @click="onCanvasClick" />
    +        <span
    +          v-for="(m, i) in visibleMarkers"
    +          :key="i"
    +          class="viewer__marker"
    +          :style="{ left: `${m.left}px`, top: `${m.top}px` }"
    +        >{{ m.label }}</span>
    +      </div>
         </div>
       </div>
     </template>
    @@ -141,6 +183,9 @@ onBeforeUnmount(destroy)
     <style scoped>
     .viewer__toolbar { display: flex; gap: 8px; align-items: center; margin-bottom: 8px; }
     .viewer__page { overflow: auto; max-height: 80vh; background: #f3f4f6; padding: 8px; }
    +.viewer__sheet { position: relative; width: fit-content; margin: 0 auto; }
     .viewer__page canvas { display: block; box-shadow: 0 1px 4px rgba(0, 0, 0, 0.2); }
    +.viewer__canvas--pick { cursor: crosshair; }
    +.viewer__marker { position: absolute; transform: translate(-50%, -50%); pointer-events: none; padding: 0 4px; border-radius: 9px; background: rgba(37, 99, 235, 0.85); color: #fff; font-size: 12px; }
     .viewer__error { color: #b91c1c; }
     </style>

    座標の計算に使うのは、Canvas の実寸(高解像度ディスプレイ向けに大きく描いている)ではなく、CSS 上の大きさです。第6回で Canvas を devicePixelRatio 倍で描いていても、offsetX・offsetY と viewport はどちらも CSS ピクセルなので、そのまま変換できます。

    日本語フォントを埋め込む:subset の実測結果

    pdf-lib の標準フォントはラテン文字だけに対応しており、日本語を書くにはフォントファイルを用意し、公式のアドオン @pdf-lib/fontkit を登録して埋め込みます。埋め込みには、使った文字だけを入れる「サブセット」(subset: true)と、フォント全体を入れる方法があります。

    📰 出典:pdf-lib README(Embed Font and Measure Text、fontkit)

    サブセットには「文字が化ける」という話があるため、pdf-lib 1 系+ @pdf-lib/fontkit 1 系で、日本語の文章を実際に書き込み、2種類のビューア(pdf.js と MuPDF)で表示して確かめました(2026年9月、筆者環境)。

    フォント(形式)subset: truesubset: false
    Noto Sans JP(OpenType/CFF)文字が欠ける・別の字になるpdf.js では正常、MuPDF では別の字になる。約4MB 増
    Noto Sans JP(Google Fonts 配布の可変フォント)文字が欠ける正常。ただし最も細い太さ(Thin)で描かれる。約6MB 増
    BIZ UDPゴシック(TrueType)文字が欠ける正常。約3MB 増
    IPAexゴシック(TrueType)正常。約1〜3万バイト正常。約4MB 増
    IPA明朝(TrueType)正常正常。約6MB 増

    どのフォントでも、ファイルの読み込み自体はエラーになりません。保存は成功するのに、開くと文字が抜けているという、気づきにくい壊れ方をします。サブセットで問題なく表示できたのは、試した中では IPAexゴシックと IPA明朝(同じ系統のフォント)だけでした。

    そこでこの連載では、IPAexゴシック(IPAフォントライセンス v1.0)をサブセットで使います。フォント全体を埋め込むと、書き込むたびに版が4MBずつ増え、アップロードの上限(20MB)にすぐ届いてしまうためです。ライセンスでは、PDFに埋め込んで配布することが認められています。フォントファイルは、配布元から各自で入手して fonts/ フォルダに置きます。

    pdf-lib でフォントを埋め込むためのアドオンと、フォントを入れます。フォントは IPAexゴシック(IPAexフォント Ver.004.01)の配布ファイルから ipaexg.ttf だけを取り出します(unzip が無い場合は、配布ページから zip をダウンロードして展開し、ipaexg.ttf を fonts/ に置いてください)。

    npm install --save-exact @pdf-lib/fontkit@1.1.1
    mkdir -p fonts
    curl -L -o ipaexg00401.zip https://moji.or.jp/wp-content/ipafont/IPAexfont/ipaexg00401.zip
    unzip -j ipaexg00401.zip ipaexg00401/ipaexg.ttf -d fonts/
    rm ipaexg00401.zip
    touch fonts/.gitkeep   # フォルダだけを Git に残すための空ファイル

    フォントは各自で入手するものなので、Git には入れません。.gitignore に次の変更を加えます(+ が追加、- が削除)。

    --- a/.gitignore
    +++ b/.gitignore
    @@ -29,5 +29,9 @@ uploads
     # SQLite データベース(開発用)
     /data
     
    +# 日本語フォント(ライセンスに従い各自で入手して配置する)
    +/fonts/*
    +!/fonts/.gitkeep
    +
     # 動作確認用のファイル(scripts/make-test-pdfs.mjs で作る)
     /test-files

    📰 出典:IPAフォントライセンスv1.0(文字情報技術促進協議会)

    📰 出典:IPAexフォント Ver.004.01 の配布ページ(文字情報技術促進協議会)

    server/utils/pdf/font.ts を新しく作ります。

    // server/utils/pdf/font.ts
    import { readFile } from 'node:fs/promises'
    import { resolve } from 'node:path'
    import fontkit from '@pdf-lib/fontkit'
    import type { PDFDocument, PDFFont } from 'pdf-lib'
    
    /** フォントファイルの中身(プロセス内で1回だけ読み込む) */
    let fontBytes: Promise<Uint8Array> | undefined
    
    function loadFontBytes(path: string): Promise<Uint8Array> {
      fontBytes ??= readFile(resolve(path)).then((b) => new Uint8Array(b)).catch((err: unknown) => {
        fontBytes = undefined
        // 設定ミスは利用者のせいではないので 500。パスは応答に含めず、ログにだけ出す
        console.error('日本語フォントを読み込めません:', path, err)
        throw createError({ statusCode: 500, statusMessage: '日本語フォントが設定されていません' })
      })
      return fontBytes
    }
    
    /**
     * PDFに日本語フォントを埋め込む(pdf-lib の標準フォントは日本語を描けないため)。
     * 設定:runtimeConfig.pdfFont.path(NUXT_PDF_FONT_PATH)、subset(NUXT_PDF_FONT_SUBSET)
     * subset: true は使った文字だけを埋め込むので小さいが、フォントによっては文字が欠ける(第8回で実測)。
     */
    export async function embedJapaneseFont(doc: PDFDocument): Promise<PDFFont> {
      const { path, subset } = useRuntimeConfig().pdfFont
      doc.registerFontkit(fontkit)
      return doc.embedFont(await loadFontBytes(path), { subset })
    }
    
    /** フォントに無い文字(外字・一部の絵文字など)を返す。描くと空白や豆腐(□)になるため事前に弾く */
    export function findUnsupportedChars(font: PDFFont, text: string): string[] {
      const supported = new Set(font.getCharacterSet())
      const missing = new Set<string>()
      for (const ch of text) {
        if (ch === '\n') continue
        if (!supported.has(ch.codePointAt(0)!)) missing.add(ch)
      }
      return [...missing]
    }

    フォントの場所とサブセットの有無は nuxt.config.ts の runtimeConfig.pdfFont(環境変数 NUXT_PDF_FONT_PATH・NUXT_PDF_FONT_SUBSET)で変えられます。別のフォントに替える場合は、必ず実際のPDFを複数のビューアで開いて確認してください。

    nuxt.config.ts に次の変更を加えます(+ が追加、- が削除)。

    --- a/nuxt.config.ts
    +++ b/nuxt.config.ts
    @@ -35,6 +35,12 @@ export default defineNuxtConfig({
         uploadDir: './uploads',
         databasePath: './data/app.db',
         maxUploadBytes: MAX_UPLOAD_BYTES,
    +    // PDFに書き込む日本語フォント(第8回)。フォントファイルはリポジトリに含めず、各自で入手して配置する
    +    pdfFont: {
    +      path: './fonts/ipaexg.ttf',
    +      // 使った文字だけを埋め込む。false にするとフォント全体(数MB)を毎回埋め込む
    +      subset: true,
    +    },
         // 最初の管理者(users テーブルが空のときだけ、起動時に作成する)
         initialAdminLoginId: '',
         initialAdminPassword: '',

    .env.example に次の変更を加えます(+ が追加、- が削除)。

    --- a/.env.example
    +++ b/.env.example
    @@ -18,3 +18,8 @@ NUXT_SESSION_PASSWORD=
     # 作成できたら値を消してよい
     NUXT_INITIAL_ADMIN_LOGIN_ID=
     NUXT_INITIAL_ADMIN_PASSWORD=
    +
    +# PDFに書き込む日本語フォント(第8回)。IPAexゴシックの ipaexg.ttf を fonts/ に配置する
    +# NUXT_PDF_FONT_PATH=./fonts/ipaexg.ttf
    +# 使った文字だけを埋め込む(true)か、フォント全体を埋め込む(false)か
    +# NUXT_PDF_FONT_SUBSET=true

    サーバー側:注釈を焼き込むAPI

    入力の検証

    画面とサーバーで共通に使う注釈の型と選択肢を shared/utils/annotation.ts に置きます。shared/utils/annotation.ts を新しく作ります。

    // shared/utils/annotation.ts
    /**
     * 注釈(PDFに焼き込む書き込み)の種類と選択肢。画面(app/)とサーバー(server/)の両方で使う。
     * 座標 x, y は「PDFの座標」(左下が原点、単位ポイント=1/72インチ)。
     */
    export const ANNOTATION_COLORS = {
      black: { label: '黒', rgb: [0, 0, 0] },
      red: { label: '赤', rgb: [0.8, 0.1, 0.1] },
      blue: { label: '青', rgb: [0.1, 0.25, 0.75] },
    } as const
    export type AnnotationColor = keyof typeof ANNOTATION_COLORS
    
    /** スタンプの文言(印面の上段に入る) */
    export const STAMP_LABELS = ['承認', '確認', '受領', '却下'] as const
    export type StampLabel = (typeof STAMP_LABELS)[number]
    
    interface Point {
      /** 1 始まりのページ番号 */
      page: number
      x: number
      y: number
    }
    
    /** テキスト:クリックした位置が1行目の左上 */
    export interface TextAnnotation extends Point {
      type: 'text'
      text: string
      size: number
      color: AnnotationColor
    }
    /** スタンプ(日付印):クリックした位置が印の中心。日付と押した人の名前はサーバーで入れる */
    export interface StampAnnotation extends Point {
      type: 'stamp'
      label: StampLabel
    }
    /** 署名画像(PNG):クリックした位置が画像の左上 */
    export interface SignatureAnnotation extends Point {
      type: 'signature'
      /** data:image/png;base64,... */
      image: string
      /** 表示幅(ポイント)。高さは画像の縦横比から決める */
      width: number
    }
    export type Annotation = TextAnnotation | StampAnnotation | SignatureAnnotation
    
    /** 1回に送れる注釈の数 */
    export const MAX_ANNOTATIONS = 30

    server/utils/annotate-input.ts を新しく作ります。

    // server/utils/annotate-input.ts
    import { z } from 'zod'
    
    const point = {
      page: z.number().int().min(1).max(10000),
      x: z.number().finite(),
      y: z.number().finite(),
    }
    const color = z.enum(Object.keys(ANNOTATION_COLORS) as [AnnotationColor, ...AnnotationColor[]])
    
    /** 署名画像は PNG の data URL だけ受け付ける(base64 で最大約 300KB) */
    const PNG_DATA_URL = /^data:image\/png;base64,[A-Za-z0-9+/]+={0,2}$/
    
    export const annotateBodySchema = z.object({
      items: z.array(z.discriminatedUnion('type', [
        z.object({
          type: z.literal('text'),
          ...point,
          text: z.string().trim().min(1).max(200),
          size: z.number().min(6).max(48),
          color,
        }),
        z.object({
          type: z.literal('stamp'),
          ...point,
          label: z.enum(STAMP_LABELS),
        }),
        z.object({
          type: z.literal('signature'),
          ...point,
          image: z.string().max(400_000).regex(PNG_DATA_URL),
          width: z.number().min(20).max(300),
        }),
      ])).min(1).max(MAX_ANNOTATIONS),
    })

    書き込みの種類ごとに項目が違うため、zod の discriminatedUnion(type の値で形を切り替える検証)を使いました。色と印の文言は、画面と共通の定数(shared/utils/annotation.ts)から選ぶ形にし、自由な値は受け付けません。

    文字・日付印・署名を描く

    server/utils/pdf/annotate.ts を新しく作ります。

    server/utils/pdf/annotate.ts の全文(112行)
    // server/utils/pdf/annotate.ts
    import { PDFDocument, rgb, type PDFFont, type PDFImage, type PDFPage } from 'pdf-lib'
    
    const PNG_MAGIC = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])
    const STAMP_RADIUS = 28
    const STAMP_COLOR = rgb(0.8, 0.1, 0.1)
    
    function badRequest(message: string): never {
      throw createError({ statusCode: 400, statusMessage: message })
    }
    
    /** 書き込む位置がページ(表示範囲=CropBox)の中にあるかを確認する */
    function assertInside(page: PDFPage, pageNo: number, x: number, y: number, w = 0, h = 0): void {
      const box = page.getCropBox()
      const inside = x >= box.x && y - h >= box.y && x + w <= box.x + box.width && y <= box.y + box.height
      if (!inside) badRequest(`${pageNo}ページ目:書き込む位置がページの外にはみ出しています`)
    }
    
    /** 日付印の日付(日本時間) */
    function stampDate(now: Date): string {
      return new Intl.DateTimeFormat('ja-JP', { timeZone: 'Asia/Tokyo', year: 'numeric', month: '2-digit', day: '2-digit' }).format(now)
    }
    
    /** 幅 maxWidth に収まる文字サイズを探す(名前が長いときに小さくする) */
    function fitSize(font: PDFFont, text: string, size: number, maxWidth: number): number {
      let s = size
      while (s > 4 && font.widthOfTextAtSize(text, s) > maxWidth) s -= 0.5
      return s
    }
    
    /** 日付印:外枠の円、上段に文言、中段に日付、下段に押した人の名前 */
    function drawStamp(page: PDFPage, font: PDFFont, cx: number, cy: number, label: string, date: string, name: string): void {
      const r = STAMP_RADIUS
      page.drawCircle({ x: cx, y: cy, size: r, borderColor: STAMP_COLOR, borderWidth: 1.5 })
      const half = Math.sqrt(r * r - 8 * 8) // 横線(y = ±8)と円の交点までの長さ
      for (const dy of [8, -8]) {
        page.drawLine({ start: { x: cx - half, y: cy + dy }, end: { x: cx + half, y: cy + dy }, color: STAMP_COLOR, thickness: 0.8 })
      }
      const center = (text: string, size: number, baseline: number) => {
        page.drawText(text, { x: cx - font.widthOfTextAtSize(text, size) / 2, y: baseline, size, font, color: STAMP_COLOR })
      }
      center(label, 11, cy + 11)
      center(date, fitSize(font, date, 7.5, r * 1.9), cy - 2.5)
      center(name, fitSize(font, name, 9, r * 1.4), cy - 19)
    }
    
    /**
     * 注釈(テキスト・日付印・署名画像)をページの内容として焼き込み、新しいPDFを返す。
     * 焼き込んだものは、PDFビューアの注釈機能では消せない(本文の一部になる)。
     */
    export async function applyAnnotations(
      data: Uint8Array,
      items: Annotation[],
      stamper: { displayName: string, now: Date },
    ): Promise<Uint8Array> {
      let doc: PDFDocument
      try {
        doc = await PDFDocument.load(data, { updateMetadata: false })
      } catch {
        badRequest('このPDFは編集できません(パスワード付き、または壊れている可能性があります)')
      }
    
      // 文字を書くときだけ日本語フォントを埋め込む
      const needsFont = items.some((i) => i.type !== 'signature')
      const font = needsFont ? await embedJapaneseFont(doc) : undefined
      const images = new Map<string, PDFImage>()
      const date = stampDate(stamper.now)
    
      for (const item of items) {
        if (item.page > doc.getPageCount()) badRequest(`${item.page}ページ目はありません`)
        const page = doc.getPage(item.page - 1)
        if (page.getRotation().angle % 360 !== 0) {
          badRequest(`${item.page}ページ目は回転しているため、このサンプルでは書き込めません`)
        }
    
        if (item.type === 'text') {
          const missing = findUnsupportedChars(font!, item.text)
          if (missing.length > 0) badRequest(`フォントに無い文字が含まれています:${missing.join(' ')}`)
          const lineHeight = item.size * 1.3
          const lines = item.text.split('\n')
          const width = Math.max(...lines.map((l) => font!.widthOfTextAtSize(l, item.size)))
          assertInside(page, item.page, item.x, item.y, width, lineHeight * lines.length)
          const [r, g, b] = ANNOTATION_COLORS[item.color].rgb
          // drawText の y は1行目の文字の下端(ベースライン)。クリック位置を左上にするため文字の高さ分下げる
          const ascent = font!.heightAtSize(item.size, { descender: false })
          page.drawText(item.text, { x: item.x, y: item.y - ascent, size: item.size, font, color: rgb(r, g, b), lineHeight })
        } else if (item.type === 'stamp') {
          const r = STAMP_RADIUS
          assertInside(page, item.page, item.x - r, item.y + r, r * 2, r * 2)
          // 名前にフォントに無い文字があれば「?」に置き換える(印は押せるようにする)
          const missing = findUnsupportedChars(font!, stamper.displayName)
          const name = [...stamper.displayName].map((ch) => (missing.includes(ch) ? '?' : ch)).join('')
          drawStamp(page, font!, item.x, item.y, item.label, date, name)
        } else {
          let image = images.get(item.image)
          if (!image) {
            const bytes = Buffer.from(item.image.slice(item.image.indexOf(',') + 1), 'base64')
            if (!bytes.subarray(0, PNG_MAGIC.length).equals(PNG_MAGIC)) badRequest('署名画像がPNG形式ではありません')
            try {
              image = await doc.embedPng(bytes)
            } catch {
              badRequest('署名画像を読み込めませんでした')
            }
            images.set(item.image, image)
          }
          const height = item.width * (image.height / image.width)
          assertInside(page, item.page, item.x, item.y, item.width, height)
          // drawImage の y は画像の下端。クリック位置を左上にするため高さ分下げる
          page.drawImage(image, { x: item.x, y: item.y - height, width: item.width, height })
        }
      }
      return doc.save()
    }

    ポイントは3つです。

    • 基準点のずれ:pdf-lib の drawText は文字の下端(ベースライン)、drawImage は画像の下端を基準に描きます。クリックした位置を左上にしたいので、文字の高さ・画像の高さの分だけ下にずらしています。
    • はみ出しの確認:書き込み全体がページの表示範囲(CropBox)に収まるかを assertInside で確かめ、外なら 400 にします。範囲外に描いても保存は成功しますが、画面には何も出ず、利用者が混乱するためです。
    • フォントに無い文字:外字や一部の絵文字は、描くと空白や「□」になります。保存前に getCharacterSet() で調べて、どの文字が使えないかをエラーで返します。

    日付印(drawStamp)は、drawCircle で丸枠、drawLine で2本の横線を引き、上段に文言、中段に日本時間の日付、下段に名前を中央ぞろえで描いています。名前が長いときは、枠に収まるまで文字を小さくします。

    📰 出典:pdf-lib API ドキュメント PDFPage(drawText / drawImage / drawCircle / getCropBox / getRotation)

    APIの本体

    server/api/files/[id]/annotate.post.ts を新しく作ります。

    // server/api/files/[id]/annotate.post.ts
    /**
     * 注釈(テキスト・日付印・署名画像)を焼き込み、「新しい版」として保存する。editor 以上。
     * 画面から送るのは「どのページの・どの座標に・何を」だけで、PDFの加工はサーバーで行う
     */
    export default defineEventHandler(async (event) => {
      const user = await requireRole(event, 'editor')
      const id = await getFileIdParam(event)
    
      // 署名画像(base64)を含むため本文は大きめ。上限を超える送信は読み込む前に断る
      const length = Number(getRequestHeader(event, 'content-length') ?? 0)
      if (length > 2 * 1024 * 1024) {
        throw createError({ statusCode: 413, statusMessage: '送信内容が大きすぎます' })
      }
      const body = await readValidatedBody(event, (b) => annotateBodySchema.safeParse(b))
      if (!body.success) {
        throw createError({ statusCode: 400, statusMessage: '書き込む内容が正しくありません' })
      }
      const { items } = body.data
    
      const file = getEditableFile(id)
      const data = await readCurrentPdf(file)
      const result = await applyAnnotations(data, items, { displayName: user.displayName, now: new Date() })
      assertResultSize(result)
    
      // 履歴に残す内容:「注釈:テキスト2件・印1件(1, 3ページ)」
      const count = (type: Annotation['type']) => items.filter((i) => i.type === type).length
      const kinds = [['text', 'テキスト'], ['stamp', '印'], ['signature', '署名']] as const
      const summary = kinds.filter(([t]) => count(t) > 0).map(([t, label]) => `${label}${count(t)}件`).join('・')
      const pages = [...new Set(items.map((i) => i.page))].sort((a, b) => a - b).join(', ')
      const { versionNo } = await addVersion({
        fileId: id,
        data: result,
        pageCount: file.pageCount,
        operation: 'annotate',
        note: `注釈:${summary}(${pages}ページ)`,
        userId: user.id,
      })
      return { id, versionNo }
    })

    印に入れる名前は、第5回で作った requireRole が DB から読んだ最新の表示名です。版の種類(VERSION_OPERATIONS)に 'annotate' を足します。SQLite では文字列の列なので、マイグレーションは要りません(npm run db:generate を実行しても「No schema changes」と表示されます)。

    --- a/server/db/schema.ts
    +++ b/server/db/schema.ts
    @@ -30,7 +30,7 @@ export const files = sqliteTable('files', {
     ])
     
     /** 版の作られ方 */
    -export const VERSION_OPERATIONS = ['upload', 'merge', 'split'] as const
    +export const VERSION_OPERATIONS = ['upload', 'merge', 'split', 'annotate'] as const
     export type VersionOperation = (typeof VERSION_OPERATIONS)[number]
     
     /**

    画面:書き込みパネルと署名欄

    editor 以上の人には、第6回のプレビューの代わりに、書き込みパネル付きの部品(app/components/PdfAnnotator.client.vue)を表示します。種類(テキスト・日付印・署名)を選んで内容を決め、プレビューをクリックすると、その位置に番号付きの目印が出て「予定」の一覧に加わります。

    app/components/PdfAnnotator.client.vue を新しく作ります。要所は、プレビューのクリックを受けて「予定」に加える onPick です。

    function onPick(p: { page: number, x: number, y: number }) {
      message.value = ''
      if (items.value.length >= MAX_ANNOTATIONS) {
        message.value = `一度に置けるのは${MAX_ANNOTATIONS}件までです。先に保存してください`
        return
      }
      // 座標は小数第2位まで(1ポイント=約0.35mm なので十分)
      const point = { page: p.page, x: Math.round(p.x * 100) / 100, y: Math.round(p.y * 100) / 100 }
      if (tool.value === 'text') {
        if (!text.value.trim()) {
          message.value = '書き込む文字を入力してから、ページをクリックしてください'
          return
        }
        items.value.push({ type: 'text', ...point, text: text.value, size: size.value, color: color.value })
      } else if (tool.value === 'stamp') {
        items.value.push({ type: 'stamp', ...point, label: stampLabel.value })
      } else {
        if (!signature.value) {
          message.value = '署名を書いてから、ページをクリックしてください'
          return
        }
        items.value.push({ type: 'signature', ...point, image: signature.value, width: signatureWidth.value })
      }
    }
    app/components/PdfAnnotator.client.vue の全文(139行)
    <!-- app/components/PdfAnnotator.client.vue -->
    <script setup lang="ts">
    // 注釈の入力:プレビュー上をクリックした位置に、テキスト・日付印・署名を「予定」として置き、
    // まとめてサーバーへ送って焼き込む(新しい版になる)。editor 以上に表示する
    const props = defineProps<{
      fileId: string
      src: string
    }>()
    const emit = defineEmits<{
      /** 注釈を焼き込んだ新しい版ができた */
      saved: []
    }>()
    
    type Tool = Annotation['type']
    const tool = ref<Tool>('text')
    const text = ref('')
    const size = ref(12)
    const color = ref<AnnotationColor>('red')
    const stampLabel = ref<StampLabel>('承認')
    const signature = ref<string | null>(null)
    const signatureWidth = ref(120)
    
    /** まだ保存していない注釈 */
    const items = ref<Annotation[]>([])
    const message = ref('')
    const saving = ref(false)
    
    // プレビューに重ねる番号(何をどこに置いたか分かるように)
    const markers = computed(() => items.value.map((item, i) => ({ page: item.page, x: item.x, y: item.y, label: String(i + 1) })))
    
    function onPick(p: { page: number, x: number, y: number }) {
      message.value = ''
      if (items.value.length >= MAX_ANNOTATIONS) {
        message.value = `一度に置けるのは${MAX_ANNOTATIONS}件までです。先に保存してください`
        return
      }
      // 座標は小数第2位まで(1ポイント=約0.35mm なので十分)
      const point = { page: p.page, x: Math.round(p.x * 100) / 100, y: Math.round(p.y * 100) / 100 }
      if (tool.value === 'text') {
        if (!text.value.trim()) {
          message.value = '書き込む文字を入力してから、ページをクリックしてください'
          return
        }
        items.value.push({ type: 'text', ...point, text: text.value, size: size.value, color: color.value })
      } else if (tool.value === 'stamp') {
        items.value.push({ type: 'stamp', ...point, label: stampLabel.value })
      } else {
        if (!signature.value) {
          message.value = '署名を書いてから、ページをクリックしてください'
          return
        }
        items.value.push({ type: 'signature', ...point, image: signature.value, width: signatureWidth.value })
      }
    }
    
    function describe(item: Annotation): string {
      if (item.type === 'text') return `テキスト「${item.text}」`
      if (item.type === 'stamp') return `日付印(${item.label})`
      return '署名'
    }
    
    async function save() {
      saving.value = true
      message.value = ''
      try {
        const res = await $fetch(`/api/files/${props.fileId}/annotate`, {
          method: 'POST',
          body: { items: items.value },
        })
        message.value = `第${res.versionNo}版として保存しました`
        items.value = []
        emit('saved')
      } catch (err) {
        message.value = (err as { data?: { statusMessage?: string } }).data?.statusMessage ?? '保存に失敗しました'
      } finally {
        saving.value = false
      }
    }
    </script>
    
    <template>
      <div class="annotator">
        <div class="annotator__panel">
          <h2>書き込み(注釈・印・署名)</h2>
          <p class="annotator__help">種類を選んで内容を決め、プレビューの書き込みたい位置をクリックします。</p>
          <div class="annotator__tools">
            <label><input v-model="tool" type="radio" value="text"> テキスト</label>
            <label><input v-model="tool" type="radio" value="stamp"> 日付印</label>
            <label><input v-model="tool" type="radio" value="signature"> 署名</label>
          </div>
    
          <div v-if="tool === 'text'" class="annotator__row">
            <textarea v-model="text" rows="2" maxlength="200" placeholder="例:確認しました(山田)" />
            <select v-model.number="size">
              <option v-for="s in [9, 10, 12, 14, 18, 24]" :key="s" :value="s">{{ s }}pt</option>
            </select>
            <select v-model="color">
              <option v-for="(c, key) in ANNOTATION_COLORS" :key="key" :value="key">{{ c.label }}</option>
            </select>
          </div>
          <div v-else-if="tool === 'stamp'" class="annotator__row">
            <select v-model="stampLabel">
              <option v-for="l in STAMP_LABELS" :key="l" :value="l">{{ l }}</option>
            </select>
            <span>日付と名前(ログイン中の利用者)はサーバーで入れます。クリック位置が印の中心です。</span>
          </div>
          <div v-else class="annotator__row">
            <SignaturePad @change="signature = $event" />
            <label>幅
              <select v-model.number="signatureWidth">
                <option v-for="w in [80, 120, 160, 200]" :key="w" :value="w">{{ w }}pt</option>
              </select>
            </label>
          </div>
    
          <ol v-if="items.length > 0" class="annotator__items">
            <li v-for="(item, i) in items" :key="i">
              {{ describe(item) }}({{ item.page }}ページ)
              <button type="button" @click="items.splice(i, 1)">取り消す</button>
            </li>
          </ol>
          <button type="button" :disabled="items.length === 0 || saving" @click="save">
            {{ saving ? '保存中…' : `${items.length}件を書き込んで新しい版を作る` }}
          </button>
          <p v-if="message" class="annotator__message">{{ message }}</p>
        </div>
    
        <PdfViewer :src="src" pickable :markers="markers" @pick="onPick" />
      </div>
    </template>
    
    <style scoped>
    .annotator__panel { border: 1px solid #e5e7eb; border-radius: 6px; padding: 12px; margin-bottom: 12px; }
    .annotator__panel h2 { font-size: 1.05em; margin: 0 0 4px; }
    .annotator__help { color: #4b5563; margin: 0 0 8px; }
    .annotator__tools { display: flex; gap: 16px; margin-bottom: 8px; }
    .annotator__row { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; margin-bottom: 8px; }
    .annotator__row textarea { flex: 1; min-width: 240px; }
    .annotator__message { color: #1d4ed8; }
    </style>

    手書き署名の入力欄(app/components/SignaturePad.client.vue)は、Canvas にポインターイベント(マウス・ペン・指の操作をまとめて扱うイベント)で線を引き、書き終わるたびに toDataURL('image/png') で透明背景の PNG にします。スマホで署名中に画面がスクロールしないよう、CSS で touch-action: none を指定しています。

    app/components/SignaturePad.client.vue を新しく作ります。

    <!-- app/components/SignaturePad.client.vue -->
    <script setup lang="ts">
    // 手書き署名の入力欄。マウス・ペン・指でなぞった線を PNG(透明背景)にする
    const emit = defineEmits<{
      /** 署名の PNG(data URL)。消したときは null */
      change: [dataUrl: string | null]
    }>()
    
    const WIDTH = 320
    const HEIGHT = 120
    const canvas = ref<HTMLCanvasElement | null>(null)
    let drawing = false
    let hasInk = false
    
    function ctx(): CanvasRenderingContext2D | null {
      return canvas.value?.getContext('2d') ?? null
    }
    
    function start(e: PointerEvent) {
      const c = ctx()
      if (!c || !canvas.value) return
      drawing = true
      // 指を枠の外に出しても線が途切れないように、ポインターを捕まえておく
      canvas.value.setPointerCapture(e.pointerId)
      c.beginPath()
      c.moveTo(e.offsetX, e.offsetY)
    }
    function move(e: PointerEvent) {
      const c = ctx()
      if (!drawing || !c) return
      c.lineTo(e.offsetX, e.offsetY)
      c.stroke()
      hasInk = true
    }
    function end() {
      if (!drawing) return
      drawing = false
      emit('change', hasInk ? canvas.value!.toDataURL('image/png') : null)
    }
    function clear() {
      const c = ctx()
      if (!c) return
      c.clearRect(0, 0, WIDTH, HEIGHT)
      hasInk = false
      emit('change', null)
    }
    
    onMounted(() => {
      const c = ctx()
      if (!c) return
      c.lineWidth = 2.5
      c.lineCap = 'round'
      c.lineJoin = 'round'
      c.strokeStyle = '#111827'
    })
    </script>
    
    <template>
      <div class="signature">
        <canvas
          ref="canvas"
          :width="WIDTH"
          :height="HEIGHT"
          class="signature__canvas"
          @pointerdown="start"
          @pointermove="move"
          @pointerup="end"
          @pointercancel="end"
        />
        <button type="button" @click="clear">書き直す</button>
      </div>
    </template>
    
    <style scoped>
    .signature { display: flex; gap: 8px; align-items: flex-end; }
    /* touch-action: none … スマホで署名中に画面がスクロールしないようにする */
    .signature__canvas { border: 1px dashed #9ca3af; background: #fff; touch-action: none; }
    </style>

    app/pages/files/[id].vue に次の変更を加えます(+ が追加、- が削除)。

    --- a/app/pages/files/[id].vue
    +++ b/app/pages/files/[id].vue
    @@ -13,7 +13,7 @@ const downloadUrl = computed(() => `/api/files/${id.value}/download`)
     
     const canEdit = computed(() => !!user.value && hasRole(user.value.role, 'editor') && !file.value?.isEncrypted)
     
    -const OPERATION_LABELS: Record<string, string> = { upload: 'アップロード', merge: '結合', split: '分割' }
    +const OPERATION_LABELS: Record<string, string> = { upload: 'アップロード', merge: '結合', split: '分割', annotate: '書き込み' }
     const dateFormatter = new Intl.DateTimeFormat('ja-JP', { dateStyle: 'medium', timeStyle: 'short', timeZone: 'Asia/Tokyo' })
     
     function formatSize(bytes: number): string {
    @@ -34,7 +34,9 @@ function formatSize(bytes: number): string {
           </p>
           <p><a :href="downloadUrl">ダウンロード</a></p>
           <p v-if="file.isEncrypted">パスワード付きのPDFのため、プレビューできない場合があります。</p>
    -      <PdfViewer :src="previewUrl" />
    +      <!-- editor 以上は書き込みパネル付きのプレビュー(第8回)、それ以外は表示だけ -->
    +      <PdfAnnotator v-if="canEdit" :file-id="file.id" :src="previewUrl" @saved="refresh()" />
    +      <PdfViewer v-else :src="previewUrl" />
     
           <PdfPageTools v-if="canEdit" :file-id="file.id" :page-count="file.pageCount" @merged="refresh()" />
     

    動作確認の方法

    # fonts/ipaexg.ttf を置いたことを確認してから
    npm run build
    node --env-file=.env .output/server/index.mjs

    本番ビルドを起動し、curl と自動操作のブラウザ(ヘッドレスの Chrome)で確認しました。出来上がったPDFは、pdf.js と MuPDF の2種類で開いて見た目とテキストを確かめています。

    操作結果
    テキスト2件(改行・「髙﨑」を含む)、日付印、署名を送る第2版ができ、2種類のビューアで同じ位置に表示。テキストとして検索・コピーもできる
    切り抜き範囲(CropBox)がずれているページに書き込む画面でクリックした位置どおりに書き込まれる
    回転したページ/存在しないページ/ページの外/右端をはみ出す長い文字いずれも 400
    「つちよし」(吉の上が土の字)や絵文字を含むテキスト400「フォントに無い文字が含まれています」
    PNG でない画像・壊れた PNG・印の文言や色が一覧にない値・31件以上いずれも 400
    viewer で送信/未ログイン/パスワード付きPDF/2MB 超の送信403/401/400/413
    第1版をダウンロードアップロードした元のPDFとバイト単位で一致
    フォントのパスを誤って起動500「日本語フォントが設定されていません」(パスはログのみ)
    サブセットを切って(NUXT_PDF_FONT_SUBSET=false)書き込む1行の書き込みで版の大きさが約1.9万バイトから約420万バイトに増える
    画面:テキスト・日付印・署名を置いて保存「第N版として保存しました」、プレビューが新しい版に更新、履歴に「書き込み」
    画面:予定を置いたまま125%→150%に拡大目印の位置も1.2倍に移動し、ページ上の同じ場所を指す

    Acrobat Reader など、ほかのPDFビューアでの表示は確認できていません。

    つまずきやすい点・注意点

    • フォントとサブセットは組み合わせで結果が変わる:上の実測のとおり、同じ設定でもフォントによって壊れ方が違います。帳票に使うフォントを決めたら、必ず実データで確認します。
    • 回転したページ:スキャンしたPDFには、ページに「90度回転」の設定が付いていることがよくあります。回転を考慮して座標と文字の向きを合わせる処理は、このサンプルでは入れずに 400 で断っています。
    • 版が増えるたびにフォントも増える:書き込むたびに、使った文字のサブセットが新しく埋め込まれます(前の版のフォントも残る)。サブセットなら1回あたり数万バイトですが、全体埋め込みでは数MBずつ増えます。
    • 同時編集:2人が同じファイルに同時に書き込むと、後から保存した人の版には、先の人の書き込みが入りません(どちらも元の版に書き込むため)。本番では、画面で開いた版の番号を送り、現在の版と違えば保存を断る仕組みを検討します。
    • 署名画像の扱い:署名の PNG は本人の筆跡そのものです。ログやエラー通知に本文をそのまま出さないようにします。

    発注者向けメモ:「署名画像」と「電子署名」は別物

    画面でサインを書いてPDFに貼る機能は、見た目は署名ですが、「誰が署名したか」「署名後に改ざんされていないか」を技術的に証明する電子署名とは別物です。画像は誰でもコピーでき、PDFを編集すれば差し替えもできます。社内の確認・回覧の記録には十分役立ちますが、契約書など法的な効力が必要な書類に使えるかは、社内の法務部門や専門家に確認してください。必要な場合は、電子署名に対応したサービスとの連携を検討します。

    • 目的を分ける:社内の確認印・回覧の記録が目的か、取引先との契約の証拠が目的かで、必要な仕組みが変わります。
    • 印の仕様を決める:文言(承認・確認など)、日付の形式、名前の出し方、色と大きさ。紙の運用に合わせたい場合は、サンプルの印影を用意すると話が早く進みます。
    • 対象のPDFを渡す:スキャンした書類(回転付きのものが多い)、フォームのある申請書など、実際に書き込むPDFを数種類用意してもらうと、見積もりの精度が上がります。
    • フォントの選定とライセンス:日本語フォントは、PDFへの埋め込みが許されているか、表示の不具合がないかを確認して選びます。

    打ち合わせでは、次のように聞いてみてください。

    • 「この署名機能は、電子署名(改ざん検知・本人確認)にあたりますか?契約書に使ってよいですか?」
    • 「書き込みを間違えたとき、どうやって元に戻しますか?」
    • 「スキャンした(回転している)PDFにも、クリックした位置どおりに書き込めますか?」
    • 「使う日本語フォントとライセンス、文字化けの確認方法を教えてください」
    • 「2人が同時に同じPDFに書き込んだ場合はどうなりますか?」

    まとめと次回予告

    第8回では、プレビュー上でクリックした位置に、日本語テキスト・日付印・署名画像を焼き込む機能を作りました。

    • 画面の座標とPDFの座標の変換は、pdfjs-dist の viewport(convertToPdfPoint/convertToViewportPoint)で行う
    • 日本語は @pdf-lib/fontkit でフォントを埋め込む。サブセットで文字が欠けるかはフォント次第で、試した中では IPAexゴシック・IPA明朝だけが正常だった
    • 日付と名前はサーバーで入れ、書き込みは新しい版として保存する
    • 署名画像は、電子署名(改ざん検知・本人確認)とは別物

    次回は「PDFフォーム(AcroForm)に入力する」です。入力欄が定義された申請書PDFから項目の一覧を取り出し、画面から日本語で入力して、入力欄をなくした(フラット化した)PDFとして保存します。

    この連載の記事一覧

    この記事は連載「Nuxtで作るPDF管理システム」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。

    システム制作・運用・保守のお問い合わせはこちら

      お問い合わせ


      よかったらシェアしてね!
      • URLをコピーしました!
      • URLをコピーしました!

      この記事を書いた人

      株式会社THIRD HERO代表取締役 朝野貴朗
      Webシステム開発を中心に、toC向けサービスサイトの運営、ツール開発などを行ってまいりました。

      コメント

      コメント一覧 (1件)

      目次