(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 ピクセル(拡大率で変わる) |
| 左下 | 上向きに増える | ポイント(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: true | subset: 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回です。連載のほかの回は次のとおりです(連載の一覧ページ)。
- 【Nuxtで作るPDF管理システム 第0回】全体像とNuxt 4プロジェクトの土台づくり
- 【Nuxtで作るPDF管理システム 第1回】PDFをアップロードして安全に保存する
- 【Nuxtで作るPDF管理システム 第2回】ファイル情報をDBに持ち、一覧を表示する
- 【Nuxtで作るPDF管理システム 第3回】検索・絞り込み・ページングをつける
- 【Nuxtで作るPDF管理システム 第4回】ログイン機能を入れる
- 【Nuxtで作るPDF管理システム 第5回】権限管理と「認可つきダウンロード」
- 【Nuxtで作るPDF管理システム 第6回】ブラウザでPDFをプレビューする
- 【Nuxtで作るPDF管理システム 第7回】PDFの結合と分割
- 【Nuxtで作るPDF管理システム 第8回】注釈・スタンプ・署名画像を貼る(この記事)
- 【Nuxtで作るPDF管理システム 第9回】PDFフォーム(AcroForm)に入力する
- 【Nuxtで作るPDF管理システム 第10回】見積書・請求書をデータから生成する
- 【Nuxtで作るPDF管理システム 第11回】本番運用へ:S3への切り替えとデプロイ










コメント
コメント一覧 (1件)
[…] 前回の第8回:注釈・スタンプ・署名画像を貼るでは、クリックした位置に日本語のテキストや日付印を焼き込みました。今回は「位置」ではなく、PDFがあらかじめ用意している「入力欄」に値を入れます。 […]