(2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)
PDF管理システムで、ファイルを開くたびにダウンロードして別のアプリで確認するのは手間がかかります。今回は、登録したPDFをシステムの画面内でそのままプレビュー(=中身の確認表示)できるようにします。日本語のPDFを文字化け・文字抜けさせずに表示する設定と、ページ送り・拡大縮小も実装します。
前回の第5回:権限管理と「認可つきダウンロード」では、ロールによる権限管理と、ログイン・権限を確認してからPDFを返すダウンロードAPIを作りました。今回はそのAPIをプレビューの読み込み元として使います。
「PDFってブラウザで普通に開けますよね?わざわざプレビュー機能を作る必要があるの?」
結論から言うと、「見るだけ」ならブラウザ標準の表示で足りますが、PDFの上に注釈やスタンプを置く編集機能まで作るなら、PDFを自前で描画する仕組みが必要です。この連載では第8回で「プレビュー上をクリックした位置に文字や印影を置く」機能を作るため、Mozilla の PDF.js(npm パッケージ名 pdfjs-dist、執筆時点で 6 系)を使って、PDFのページを画面に描画します。
PDFプレビューの仕組み:PDF.js でページを Canvas に描く
ブラウザ標準の表示と PDF.js の違い
| 方式 | 手軽さ | できること | できないこと |
|---|---|---|---|
ブラウザ標準(<iframe> などで表示) | 非常に手軽 | 表示・印刷・ブラウザの機能での検索 | 見た目の統一、ページ上の座標の取得、独自の注釈の重ね合わせ |
| PDF.js で自前描画(今回) | 設定が必要 | 表示を完全に制御、ページ上の座標の取得、注釈の重ね合わせ | 何もしなければ文字の選択・検索もできない(別途テキスト層が必要) |
PDF.js は、Firefox に内蔵されているPDFビューアの中身として開発されているライブラリです。ブラウザの Canvas(=JavaScriptで絵を描ける領域)にPDFのページを1枚の絵として描きます。
今回できるようになること
- 一覧のファイル名をクリックすると詳細画面(
/files/[id])が開き、PDFが表示される - ページ送り(前へ・次へ)と、50%〜300%の拡大縮小
- 日本語のPDF(フォントが埋め込まれていないものを含む)が文字抜けせずに表示される
- パスワード付きPDFは「プレビューできません」と案内する
構成
| 部品 | 役割 | ファイル |
|---|---|---|
| ファイル情報API | 1件分の情報(名前・ページ数・タグ等) | server/api/files/[id].get.ts |
| ダウンロードAPI(第5回) | PDF本体を認可つきで返す。?inline=1 で表示用 | server/api/files/[id]/download.get.ts |
| 補助ファイルの配信 | 日本語用の文字対応表(cMap)などを /pdfjs/ で配信 | nuxt.config.ts |
| ビューア部品 | PDF.js で描画、ページ送り・拡大縮小 | app/components/PdfViewer.client.vue |
| 詳細画面 | ファイル情報とビューアを並べる | app/pages/files/[id].vue |
pdfjs-dist を入れて、補助ファイルを配信する
npm install --save-exact pdfjs-dist@6.3.289
PDF.js は、PDFの解析に使う「ワーカー」(=画面の動きを止めないよう、裏で別に動く処理)のファイルと、日本語の表示などに使う補助ファイルを、実行時にURLで読み込みます。補助ファイルは pdfjs-dist のパッケージに含まれているので、Nitro の publicAssets(=指定したフォルダをそのまま公開する設定)で配信します。
nuxt.config.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/nuxt.config.ts
+++ b/nuxt.config.ts
@@ -1,8 +1,13 @@
// https://nuxt.com/docs/api/configuration/nuxt-config
+import { createRequire } from 'node:module'
+import { dirname, join } from 'node:path'
// アップロード上限(既定 20MB)。サーバー側の判定と画面の表示で同じ値を使う
const MAX_UPLOAD_BYTES = 20 * 1024 * 1024
+// pdfjs-dist のインストール先(cMap・標準フォント・wasm をブラウザに配信するため)
+const pdfjsDir = dirname(createRequire(import.meta.url).resolve('pdfjs-dist/package.json'))
+
export default defineNuxtConfig({
compatibilityDate: '2026-09-27',
devtools: { enabled: true },
@@ -17,6 +22,14 @@ export default defineNuxtConfig({
title: 'PDF管理システム',
},
},
+ nitro: {
+ // PDF.js が実行時に読み込む補助ファイルを /pdfjs/ 以下で配信する(node_modules からコピー)
+ publicAssets: ['cmaps', 'standard_fonts', 'wasm', 'iccs'].map((name) => ({
+ dir: join(pdfjsDir, name),
+ baseURL: `/pdfjs/${name}`,
+ maxAge: 60 * 60 * 24 * 7,
+ })),
+ },
// 秘密情報はここに直書きせず、.env(NUXT_ 接頭辞の環境変数)で上書きする
runtimeConfig: {
uploadDir: './uploads',
📰 出典:Nitro 公式ドキュメント Configuration(publicAssets)
| フォルダ | 中身 | 必要になる場面 |
|---|---|---|
cmaps | 定義済みCMap(=文字コードと文字の対応表)169ファイル | 日本語など、フォントを埋め込まずに作られたPDF |
standard_fonts | 標準フォントの代替データ | Helvetica など、PDFの標準フォントを埋め込んでいないPDF |
wasm | 画像デコーダー(WebAssembly) | JPEG 2000 などの画像を含むPDF |
iccs | 色の定義(ICCプロファイル) | 色空間の指定があるPDF |
ビルドすると .output/public/pdfjs/ にコピーされ(筆者の環境で約4MB)、本番サーバーからそのまま配信されます。これらはPDFの中身ではなく共通の部品なので、ログインなしで取得できても問題ありません。
ビューア部品を作る
app/components/PdfViewer.client.vue を新しく作ります(app/components フォルダも作ります)。まず要所を2つに分けて説明し、全文はこの節の最後に載せます。
app/components/PdfViewer.client.vue(スクリプト部分の抜粋)
<script setup lang="ts">
import { GlobalWorkerOptions, getDocument } from 'pdfjs-dist'
import type { PDFDocumentLoadingTask, PDFDocumentProxy, RenderTask } from 'pdfjs-dist'
// ?url … Vite の機能。ワーカーのファイルをビルド成果物に含め、その URL を受け取る
import workerUrl from 'pdfjs-dist/build/pdf.worker.min.mjs?url'
const props = defineProps<{
/** PDFのURL(同じオリジンのAPI。Cookie が送られ、サーバー側で認可される) */
src: string
}>()
// PDF.js の重い処理(解析)はワーカー(別スレッド)で行う
GlobalWorkerOptions.workerSrc = workerUrl
const canvas = ref<HTMLCanvasElement | null>(null)
const pageNumber = ref(1)
const pageCount = ref(0)
const scale = ref(1.25)
const loading = ref(true)
const errorMessage = ref('')
// PDF.js のオブジェクトは Vue のリアクティブ(Proxy)にしない。
// 内部で private フィールドを使っており、Proxy 越しに触るとエラーになるため
let loadingTask: PDFDocumentLoadingTask | null = null
let pdf: PDFDocumentProxy | null = null
let renderTask: RenderTask | null = null
/** 描画の呼び出し番号。ページ送りの連打で古い描画が後から始まらないようにする */
let renderSeq = 0
async function load() {
loading.value = true
errorMessage.value = ''
try {
loadingTask = getDocument({
url: props.src,
// 日本語PDFで使われる定義済みCMap(文字コード→文字の対応表)の置き場所
cMapUrl: '/pdfjs/cmaps/',
cMapPacked: true,
// PDFに埋め込まれていない標準14フォント(Helvetica 等)の代替フォント
standardFontDataUrl: '/pdfjs/standard_fonts/',
// JPEG 2000 などの画像デコーダー(WebAssembly)
wasmUrl: '/pdfjs/wasm/',
iccUrl: '/pdfjs/iccs/',
})
pdf = await loadingTask.promise
pageCount.value = pdf.numPages
pageNumber.value = 1
await render()
} catch (err: unknown) {
const name = (err as { name?: string }).name
errorMessage.value = name === 'PasswordException'
? 'パスワード付きのPDFはプレビューできません。ダウンロードして開いてください。'
: 'PDFを表示できませんでした。'
} finally {
loading.value = false
}
}
ポイントは3つです。
- ワーカーの指定(
GlobalWorkerOptions.workerSrc):ワーカーのファイルは、Vite の?url付きインポートでURLを受け取っています。?urlを付けると、そのファイルがビルド成果物に含まれ、公開URL(本番では/_nuxt/pdf.worker.min.<ハッシュ>.mjs)が返ります。開発サーバーと本番ビルドの両方で、この書き方でワーカーが読み込まれることを確認しました。 getDocumentの補助ファイル設定:cMapUrl・cMapPacked・standardFontDataUrl・wasmUrlは、インストールした pdfjs-dist 6 の型定義(getDocumentの引数の説明)で名前と意味を確認しました。いずれも末尾の/が必要です。- PDF.js のオブジェクトを
refに入れない:Vue のrefやreactiveはオブジェクトを Proxy(=アクセスを横取りする仕組み)で包みます。JavaScript のプライベートフィールドは Proxy 越しに読めないため、PDF.js のオブジェクトを包むとエラーの原因になります。画面の表示に使う値(ページ番号など)だけをrefにしています。
📰 出典:Vite 公式ドキュメント 静的アセットの取り扱い(Explicit URL Imports)
📰 出典:MDN Proxy(プライベートフィールドは転送されない)
PDFのURLには、第5回のダウンロードAPIを ?inline=1 付きで渡します。同じオリジン(=同じドメイン)への読み込みなので、ログインのCookieが自動で送られ、サーバー側で権限が確認されます。プレビュー用に別の公開URLを作る必要はありません。
ページを描画する
app/components/PdfViewer.client.vue(描画部分)
async function render() {
if (!pdf || !canvas.value) return
const seq = ++renderSeq
const page = await pdf.getPage(pageNumber.value)
// ページの取得を待つ間に次の描画が呼ばれていたら、こちらは描かない
if (seq !== renderSeq) return
// 前の描画が終わっていなければ取り消す(同じCanvasに同時に描くとエラーになる)
renderTask?.cancel()
const viewport = page.getViewport({ scale: scale.value })
// 高解像度ディスプレイでは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`
renderTask = page.render({
canvas: el,
viewport,
transform: outputScale !== 1 ? [outputScale, 0, 0, outputScale, 0, 0] : undefined,
})
try {
await renderTask.promise
} catch (err: unknown) {
// cancel() による中断は正常な動作なので無視する
if ((err as { name?: string }).name !== 'RenderingCancelledException') throw err
}
}
watch([pageNumber, scale], () => {
render()
})
function destroy() {
renderTask?.cancel()
// ワーカー側のメモリも解放する
loadingTask?.destroy()
loadingTask = null
pdf = null
}
onMounted(load)
onBeforeUnmount(destroy)
getViewport({ scale })で、拡大率に応じたページの大きさを求めます。- 高解像度の画面(スマートフォンや高精細ノートPC)では、Canvas を表示サイズより大きく描いて縮小表示することで、文字のにじみを防ぎます。PDF.js 公式のサンプルと同じ考え方です。
- PDF.js は「同じ Canvas に同時に2つの描画をする」とエラーにします。ページ送りを連打したときに備え、古い描画を
cancel()してから次を始めます。 - 画面を離れるときは
loadingTask.destroy()でワーカー側のメモリも解放します。
📰 出典:PDF.js 公式 Examples
テンプレート部分は、ツールバー(前のページ・次のページ・縮小・拡大と現在のページ・倍率)と <canvas> を並べただけです。全文は次のとおりです。
app/components/PdfViewer.client.vue の全文(142行)
<!-- app/components/PdfViewer.client.vue -->
<script setup lang="ts">
// PDF.js(pdfjs-dist)でPDFをCanvasに描画するビューア。
// .client.vue なのでブラウザでだけ動く(サーバー描画では空のまま)
import { GlobalWorkerOptions, getDocument } from 'pdfjs-dist'
import type { PDFDocumentLoadingTask, PDFDocumentProxy, RenderTask } from 'pdfjs-dist'
// ?url … Vite の機能。ワーカーのファイルをビルド成果物に含め、その URL を受け取る
import workerUrl from 'pdfjs-dist/build/pdf.worker.min.mjs?url'
const props = defineProps<{
/** PDFのURL(同じオリジンのAPI。Cookie が送られ、サーバー側で認可される) */
src: string
}>()
// PDF.js の重い処理(解析)はワーカー(別スレッド)で行う
GlobalWorkerOptions.workerSrc = workerUrl
const MIN_SCALE = 0.5
const MAX_SCALE = 3
const canvas = ref<HTMLCanvasElement | null>(null)
const pageNumber = ref(1)
const pageCount = ref(0)
const scale = ref(1.25)
const loading = ref(true)
const errorMessage = ref('')
// PDF.js のオブジェクトは Vue のリアクティブ(Proxy)にしない。
// 内部で private フィールドを使っており、Proxy 越しに触るとエラーになるため
let loadingTask: PDFDocumentLoadingTask | null = null
let pdf: PDFDocumentProxy | null = null
let renderTask: RenderTask | null = null
/** 描画の呼び出し番号。ページ送りの連打で古い描画が後から始まらないようにする */
let renderSeq = 0
async function load() {
loading.value = true
errorMessage.value = ''
try {
loadingTask = getDocument({
url: props.src,
// 日本語PDFで使われる定義済みCMap(文字コード→文字の対応表)の置き場所
cMapUrl: '/pdfjs/cmaps/',
cMapPacked: true,
// PDFに埋め込まれていない標準14フォント(Helvetica 等)の代替フォント
standardFontDataUrl: '/pdfjs/standard_fonts/',
// JPEG 2000 などの画像デコーダー(WebAssembly)
wasmUrl: '/pdfjs/wasm/',
iccUrl: '/pdfjs/iccs/',
})
pdf = await loadingTask.promise
pageCount.value = pdf.numPages
pageNumber.value = 1
await render()
} catch (err: unknown) {
const name = (err as { name?: string }).name
errorMessage.value = name === 'PasswordException'
? 'パスワード付きのPDFはプレビューできません。ダウンロードして開いてください。'
: 'PDFを表示できませんでした。'
} finally {
loading.value = false
}
}
async function render() {
if (!pdf || !canvas.value) return
const seq = ++renderSeq
const page = await pdf.getPage(pageNumber.value)
// ページの取得を待つ間に次の描画が呼ばれていたら、こちらは描かない
if (seq !== renderSeq) return
// 前の描画が終わっていなければ取り消す(同じCanvasに同時に描くとエラーになる)
renderTask?.cancel()
const viewport = page.getViewport({ scale: scale.value })
// 高解像度ディスプレイでは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`
renderTask = page.render({
canvas: el,
viewport,
transform: outputScale !== 1 ? [outputScale, 0, 0, outputScale, 0, 0] : undefined,
})
try {
await renderTask.promise
} catch (err: unknown) {
// cancel() による中断は正常な動作なので無視する
if ((err as { name?: string }).name !== 'RenderingCancelledException') throw err
}
}
function goTo(n: number) {
if (n < 1 || n > pageCount.value) return
pageNumber.value = n
}
function zoom(delta: number) {
scale.value = Math.min(MAX_SCALE, Math.max(MIN_SCALE, Math.round((scale.value + delta) * 100) / 100))
}
watch([pageNumber, scale], () => {
render()
})
function destroy() {
renderTask?.cancel()
// ワーカー側のメモリも解放する
loadingTask?.destroy()
loadingTask = null
pdf = null
}
onMounted(load)
onBeforeUnmount(destroy)
</script>
<template>
<div class="viewer">
<div class="viewer__toolbar">
<button type="button" :disabled="pageNumber <= 1" @click="goTo(pageNumber - 1)">前のページ</button>
<span>{{ pageNumber }} / {{ pageCount || '-' }}</span>
<button type="button" :disabled="pageNumber >= pageCount" @click="goTo(pageNumber + 1)">次のページ</button>
<button type="button" :disabled="scale <= MIN_SCALE" @click="zoom(-0.25)">縮小</button>
<span>{{ Math.round(scale * 100) }}%</span>
<button type="button" :disabled="scale >= MAX_SCALE" @click="zoom(0.25)">拡大</button>
</div>
<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>
</div>
</template>
<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__page canvas { display: block; box-shadow: 0 1px 4px rgba(0, 0, 0, 0.2); }
.viewer__error { color: #b91c1c; }
</style>
ファイル名を .client.vue にする理由
Nuxt はページをサーバーでも描画しますが、サーバーには Canvas もワーカーもありません。ファイル名を PdfViewer.client.vue にすると、この部品はブラウザでだけ描画され、サーバー描画では空の場所だけが確保されます。
📰 出典:Nuxt 公式ドキュメント components ディレクトリ(.client コンポーネント)
詳細画面とファイル情報API
app/pages/files/[id].vue を新しく作ります。
<!-- app/pages/files/[id].vue -->
<script setup lang="ts">
const route = useRoute()
const id = computed(() => String(route.params.id))
const { data: file, error } = await useFetch(() => `/api/files/${id.value}`)
useHead({ title: () => `${file.value?.originalName ?? 'ファイル'} | PDF管理システム` })
// プレビューはダウンロードAPIを inline 指定で読む(認可はダウンロードと同じ)
const previewUrl = computed(() => `/api/files/${id.value}/download?inline=1`)
const downloadUrl = computed(() => `/api/files/${id.value}/download`)
function formatSize(bytes: number): string {
if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`
return `${(bytes / 1024 / 1024).toFixed(1)} MB`
}
</script>
<template>
<section>
<p><NuxtLink to="/files">← ファイル一覧</NuxtLink></p>
<p v-if="error">{{ error.statusCode === 404 ? 'ファイルが見つかりません。' : 'ファイル情報を取得できませんでした。' }}</p>
<template v-else-if="file">
<h1>{{ file.originalName }}</h1>
<p class="meta">
{{ file.pageCount }} ページ / {{ formatSize(file.size) }} / 登録者:{{ file.uploadedBy ?? '—' }}
<span v-for="t in file.tags" :key="t" class="tag">{{ t }}</span>
</p>
<p><a :href="downloadUrl">ダウンロード</a></p>
<p v-if="file.isEncrypted">パスワード付きのPDFのため、プレビューできない場合があります。</p>
<PdfViewer :src="previewUrl" />
</template>
</section>
</template>
<style scoped>
.meta { color: #4b5563; }
.tag { display: inline-block; margin-left: 4px; padding: 0 6px; border-radius: 4px; background: #eef2ff; font-size: 0.85em; }
</style>
ファイル1件分の情報を返す server/api/files/[id].get.ts は、一覧APIと同じく requireRole(event, 'viewer') で権限を確認し、IDを zod で検証したうえで、登録者名・タグ・canDelete を付けて返します。server/api/files/[id].get.ts を新しく作ります。
// server/api/files/[id].get.ts
import { eq } from 'drizzle-orm'
import { files, users } from '../../db/schema'
/** ファイル1件の情報(詳細・プレビュー画面用)。viewer 以上 */
export default defineEventHandler(async (event) => {
const user = await requireRole(event, 'viewer')
const id = await getFileIdParam(event)
const db = useDb()
const row = db
.select({
id: files.id,
originalName: files.originalName,
size: files.size,
pageCount: files.pageCount,
isEncrypted: files.isEncrypted,
uploadedById: files.uploadedBy,
uploadedBy: users.displayName,
createdAt: files.createdAt,
})
.from(files)
.leftJoin(users, eq(users.id, files.uploadedBy))
.where(eq(files.id, id))
.get()
if (!row) {
throw createError({ statusCode: 404, statusMessage: 'ファイルが見つかりません' })
}
const { uploadedById, ...file } = row
return {
...file,
tags: getTagNames(id),
canDelete: canDeleteFile(user, { uploadedBy: uploadedById }),
}
})
タグ名の一覧を取り出す getTagNames は、次回以降も使うので server/utils/tags.ts に置きます。server/utils/tags.ts を新しく作ります。
// server/utils/tags.ts
import { eq } from 'drizzle-orm'
import { fileTags, tags } from '../db/schema'
/** ファイルに付いているタグ名の一覧(名前順) */
export function getTagNames(fileId: string): string[] {
return useDb()
.select({ name: tags.name })
.from(fileTags)
.innerJoin(tags, eq(tags.id, fileTags.tagId))
.where(eq(fileTags.fileId, fileId))
.orderBy(tags.name)
.all()
.map((t) => t.name)
}
一覧画面のファイル名は、この詳細画面へのリンクにします。
app/pages/files/index.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/pages/files/index.vue
+++ b/app/pages/files/index.vue
@@ -79,7 +79,7 @@ function formatDate(value: string): string {
<tbody>
<tr v-for="row in data.items" :key="row.id">
<td>
- {{ row.originalName }}
+ <NuxtLink :to="`/files/${row.id}`">{{ row.originalName }}</NuxtLink>
<small v-if="row.isEncrypted">(パスワード付き)</small>
</td>
<td>
動作確認の方法
確認用に、日本語の文字を「フォントを埋め込まず、定義済みCMap(UniJIS-UCS2-H)で指定する」PDFを作るスクリプトを用意します。scripts/make-japanese-pdf.mjs を新しく作ります。
// scripts/make-japanese-pdf.mjs
// 日本語の文字を「フォントを埋め込まず、定義済みCMap(UniJIS-UCS2-H)で指定する」PDFを作る(追加のパッケージは不要)
// test-files/japanese.pdf … 3ページ。表示には PDF.js の cMap(/pdfjs/cmaps/)が必要
import { mkdirSync, writeFileSync } from 'node:fs'
/** 文字列を UCS-2(UTF-16BE)の16進数にする(UniJIS-UCS2-H で使う形) */
function hex(text) {
return [...text].map((ch) => ch.charCodeAt(0).toString(16).padStart(4, '0')).join('').toUpperCase()
}
const pageCount = 3
const objects = []
const pageIds = Array.from({ length: pageCount }, (_, i) => 6 + i * 2)
objects[1] = '<< /Type /Catalog /Pages 2 0 R >>'
objects[2] = `<< /Type /Pages /Kids [${pageIds.map((id) => `${id} 0 R`).join(' ')}] /Count ${pageCount} >>`
// 日本語:平成角ゴシック(埋め込まない)。英字:Helvetica(埋め込まない)
objects[3] = '<< /Type /Font /Subtype /Type0 /BaseFont /HeiseiKakuGo-W5 /Encoding /UniJIS-UCS2-H /DescendantFonts [4 0 R] >>'
objects[4] = '<< /Type /Font /Subtype /CIDFontType0 /BaseFont /HeiseiKakuGo-W5 /CIDSystemInfo << /Registry (Adobe) /Ordering (Japan1) /Supplement 2 >> /FontDescriptor 5 0 R /DW 1000 >>'
objects[5] = '<< /Type /FontDescriptor /FontName /HeiseiKakuGo-W5 /Flags 4 /FontBBox [-92 -250 1010 922] /ItalicAngle 0 /Ascent 752 /Descent -221 /CapHeight 737 /StemV 50 >>'
const helvetica = pageIds.length * 2 + 6
objects[helvetica] = '<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica >>'
pageIds.forEach((id, i) => {
const content = [
`BT /F1 24 Tf 72 760 Td <${hex(`見積書(${i + 1}ページ目)`)}> Tj ET`,
`BT /F1 14 Tf 72 720 Td <${hex('株式会社サンプル 御中 日本語の本文です。')}> Tj ET`,
`BT /F2 14 Tf 72 690 Td (Page ${i + 1} - Helvetica) Tj ET`,
].join('\n')
objects[id] = `<< /Type /Page /Parent 2 0 R /MediaBox [0 0 595 842] /Resources << /Font << /F1 3 0 R /F2 ${helvetica} 0 R >> >> /Contents ${id + 1} 0 R >>`
objects[id + 1] = `<< /Length ${content.length} >>\nstream\n${content}\nendstream`
})
let out = '%PDF-1.4\n'
const offsets = []
for (let id = 1; id < objects.length; id++) {
offsets[id] = out.length
out += `${id} 0 obj\n${objects[id]}\nendobj\n`
}
const xref = out.length
out += `xref\n0 ${objects.length}\n0000000000 65535 f \n`
for (let id = 1; id < objects.length; id++) out += `${String(offsets[id]).padStart(10, '0')} 00000 n \n`
out += `trailer\n<< /Size ${objects.length} /Root 1 0 R >>\nstartxref\n${xref}\n%%EOF\n`
mkdirSync('test-files', { recursive: true })
writeFileSync('test-files/japanese.pdf', Buffer.from(out, 'latin1'))
console.log('test-files/japanese.pdf を作りました')
node scripts/make-japanese-pdf.mjs # test-files/japanese.pdf(3ページ)ができる
npm run build
node --env-file=.env .output/server/index.mjs
# 別のターミナルで:管理者でログインして、日本語のPDFをアップロードする(返ってきた id を控える)
curl -c admin.txt -H "Content-Type: application/json" -d '{"loginId":"admin","password":"change-this-password-123"}' http://localhost:3000/api/auth/login
curl -b admin.txt -F "file=@test-files/japanese.pdf;filename=日本語見積書.pdf" http://localhost:3000/api/files
ブラウザで http://localhost:3000/files/<id> を開き、ログインするとプレビューが表示されます。
今回は、自動操作できるブラウザ(ヘッドレスの Chrome)を使って、ログインからプレビューまでを画面上で確認しました。確認用のPDFは、上のスクリプトで作った3ページのPDFです。業務で受け取るPDFにもよくある作り方で、cMap の設定がないと正しく表示できない種類です。
| 確認内容 | 結果 |
|---|---|
| 未ログインで詳細画面を開く → ログイン | /login?redirect=/files/… に移動し、ログイン後に詳細画面へ戻る |
| 日本語PDFのプレビュー | 見出し・本文の日本語、埋め込みなしの Helvetica の英字が表示される |
| 読み込まれたファイル | ワーカー(/_nuxt/pdf.worker.min.….mjs)、PDF本体(download?inline=1)、UniJIS-UCS2-H.bcmap と Adobe-Japan1-UCS2.bcmap |
| cMap の配信を止めた状態で同じPDFを表示 | 日本語の行がすべて表示されず、英字の行だけが描画される |
| 次のページ・拡大 | 2 / 3 ページ、150% で再描画 |
| 縮小ボタンの連打 → 前のページ | 50% で止まり、1 / 3 ページをエラーなく再描画 |
| パスワード付きPDF(AES-128で暗号化) | 「パスワード付きのPDFはプレビューできません」と表示 |
/pdfjs/cmaps/UniJIS-UCS2-H.bcmap を直接取得 | 200(ログイン不要の共通部品) |
開発サーバー(npm run dev)で同じ操作 | 本番ビルドと同じくワーカー・cMap が読み込まれて表示される |
確認に使ったのは Chromium 系のブラウザのみで、Firefox・Safari、スマートフォン、スキャンした大容量PDFでの表示は筆者の環境では確認していません。お手元の実際の業務PDFでの確認をおすすめします。
つまずきやすい点・注意点
- 日本語が表示されない・文字化けする:多くは cMap の設定漏れです。
cMapUrlの末尾の/忘れ、配信パスの間違いでも同じ症状になります。ブラウザの開発者ツールで.bcmapの読み込みが 200 になっているかを確認します。 - フォントを埋め込んでいないPDFは、見る側のフォントで表示される:確認用PDFの日本語は、PDFに指定された書体(平成角ゴシック)がないため、端末にある別の日本語フォントで表示されました。端末に日本語フォントがない環境では、見た目が変わったり表示できなかったりする可能性があります。
- ワーカーの読み込みに失敗する:ワーカーのファイルとライブラリ本体のバージョンが食い違うとエラーになります。今回のように同じパッケージからURLを取れば、バージョンは常にそろいます。
- プレビューでは文字を選択・検索できない:Canvas に絵として描いているためです。必要ならPDF.js のテキスト層(文字を透明に重ねる仕組み)を追加しますが、今回は扱っていません。
- 大きなPDFは表示に時間がかかる:スキャンPDFは1ページが大きな画像のため、特にスマートフォンでは重くなります。サムネイルを事前に作る、表示する解像度を抑えるといった工夫が別途必要になることがあります。
- パスワード付きPDF:開くためのパスワードが設定されたPDFは、今回の実装ではプレビューしません。ダウンロードして手元で開く運用にしています。
発注者向けメモ:「表示できる」を確かめるには、実物のPDFが一番
「PDFをブラウザで見られるようにしたい」という要望は簡単そうに見えますが、PDFは作り方(どのソフトで作ったか、スキャンか、フォントを埋め込んでいるか)によって、表示の難しさが大きく変わります。
- 実際の業務PDFをサンプルとして早めに渡す:取引先から届く見積書、社内の申請書、スキャンした契約書など、種類ごとに数ファイルあると、開発側が表示の問題を早い段階で見つけられます。個人情報を含む場合は、黒塗りしたものやダミーデータで作り直したもので構いません。
- 「見るだけ」か「その上で何かするか」を伝える:閲覧だけならブラウザ標準の表示で安く済む場合があります。注釈・スタンプ・署名の位置指定など、PDFの上で操作する予定があるなら、最初からその前提で作る方が手戻りが少なくなります。
- 利用する端末を伝える:スマートフォン・タブレットで大きなPDFを開く必要があるかどうかで、必要な工夫と確認の範囲が変わります。
- 文字の検索・コピーが必要か:プレビュー上で文字を選択・検索したいなら、追加の実装が必要です。
打ち合わせでは、次のように聞いてみてください。
- 「フォントが埋め込まれていない日本語PDFも、文字抜けせずに表示できますか?どのPDFで確認しましたか?」
- 「スキャンした数十ページのPDFを、スマートフォンで開いたときの速さはどのくらいですか?」
- 「プレビューのためにPDFを公開URLに置いていませんか?権限の確認はダウンロードと同じですか?」
- 「プレビュー上で文字の選択や検索はできますか?必要な場合の追加作業はどのくらいですか?」
まとめと次回予告
第6回では、pdfjs-dist を使ってPDFをブラウザ上にプレビューできるようにしました。
- PDF.js はPDFのページを Canvas に描画する。解析はワーカーで行い、URLは Vite の
?urlで取得する - 日本語PDFのために、cMap などの補助ファイルを
publicAssetsで配信し、getDocumentに場所を渡す - PDF.js のオブジェクトは Vue のリアクティブにしない。描画の取り消しと後片付けも忘れずに
- PDF本体は第5回の認可つきAPIから読み込み、プレビュー専用の公開URLは作らない
次回は「PDFの結合と分割」です。pdf-lib を使って複数のPDFを1つにまとめたり、ページ範囲を指定して切り出したりする機能を作ります。元のファイルは上書きせず、結果を「新しい版」として保存する仕組みもここで導入します。
この連載の記事一覧
この記事は連載「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件)
[…] 前回の第6回:ブラウザでPDFをプレビューするでは、pdfjs-dist でPDFを画面上に描画できるようにしました。今回からいよいよ、PDFの中身を変更する機能に入ります。 […]