印刷（Print）
ワークシートを紙に出す経路は 2 つ、そしてその両方を支えるページ設定モデルが 1 つあります。このページは全体マップです — 必要な出力に合った経路を選んでください。
注意: 印刷・PDF エクスポート・ページレイアウトはいずれも Pro 版の機能です。
経路を選ぶ
| やりたいこと | 経路 | 1 行で書くと |
|---|---|---|
| いますぐブラウザの印刷ダイアログを開く | HTML で印刷 | printWorksheet(grid.worksheet) |
| 本物の PDF ファイルを生成する | PDF で印刷（PDF出力） | grid.saveAsPdf({ locale: 'ja' }) |
| 用紙サイズ・余白・改ページを設定する | ページレイアウト | ws.setPrintSettings({ paperSize: 'A4' }) |
印刷の手順
ステップ 1 — ページを設定する（任意。複数ページなら必須級）
用紙サイズ・印刷方向・余白・倍率はワークシートが保持し、画面上の改ページプレビューがページの切れ目をそのまま表示します。どちらの出力経路もこのモデルを再利用できるため、一度設定しておけば画面・印刷ダイアログ・PDF のページ割りが一致します。
const ws = grid.worksheet
ws.setPrintSettings({ paperSize: 'A4', orientation: 'landscape', scale: 1 })
ws.setShowPageBreaks(true) // Excel スタイルの改ページプレビューを表示
ws.insertRowPageBreak(40) // 40 行目から新しいページにする→ 詳細： ページレイアウト
ステップ 2 — 出力方法を選ぶ
A. HTML で印刷 — シートをスタイル付き HTML テーブルに変換し、ブラウザの標準印刷ダイアログに渡します。追加インストールもフォント読み込みも不要で、ダイアログ内で「PDF に保存」を選ぶこともできます。
import { printWorksheet } from '@reogrid/pro'
printWorksheet(grid.worksheet, { usePageBreaks: true })→ オプションと詳細： HTML で印刷
B. PDF で印刷 — 自社エンジンでシートを本物のベクター PDF に描画します。文字・罫線・背景・セル結合・セル配置画像に対応し、TrueType フォントを埋め込みます。ダイアログもサーバーも外部ライブラリも不要です。
import { preloadPdfFont } from '@reogrid/pro'
await preloadPdfFont('ja') // 一度だけ。フォントは必須で、エクスポートは同期のまま
grid.saveAsPdf({ locale: 'ja', usePageBreaks: true, filename: 'report.pdf' })→ オプションと詳細： PDFエクスポート
どちらを使うべきか
| HTML で印刷 | PDF で印刷 | |
|---|---|---|
| 出力 | ブラウザの印刷ダイアログ | .pdf ファイル（またはバイト列） |
| 入口 | printWorksheet(ws, options) | grid.saveAsPdf(options) / grid.exportPdf(options) |
| ユーザー操作 | ダイアログが表示され、ユーザーが確定 | 無音 — ダウンロードまたはバイト列を返す |
| フォント | ブラウザのフォント | ロケールのフォント、または自分で渡すバイト列（必須） |
| ページ割り | usePageBreaks: true、または 1 枚の長いテーブル | usePageBreaks: true、またはオプション指定 |
| セル配置画像 | 描画されない | 描画される（showImages） |
| カスタムセルタイプ | renderHTML() 実装時のみ | PDF エンジンが描画 |
| サーバー通信 | なし | なし |
| 向いている用途 | その場での印刷、「とりあえず印刷」ボタン | 請求書・台帳、保管・メール添付する帳票 |
目安：保管・添付・送付する帳票なら PDF。目の前のプリンタから紙を出したいだけなら、HTML 経路は 1 行で済みフォントも不要です。
ブラウザの印刷ダイアログから「PDF に保存」するのは、PDF エクスポートとは別物です。ブラウザが HTML テーブルを再レイアウトし、独自のヘッダー・フッターを付けたりフォントを置き換えたりします。出力を厳密に一致させたい場合は PDFエクスポート を使ってください。
関連サンプル
- PDF・ページレイアウト デモ — 改ページプレビューを表示した複数ページの売上レポートと PDF 出力ボタン（日本語フォント同梱）。
- レシピ：PDFを書き出す — グリッドから PDF ファイルまでの最短経路。
- レシピ：帳票テンプレートを差し込む —
{{token}}セルで様式を設計し、データを差し込んで印刷・出力する。
関連記事
- ReoGrid Web v1.4 を発表 — ページレイアウト、印刷そのままの PDF エクスポート — ページングモデルと PDF エンジンの背景。
- 脱・神Excel ― 方眼紙でつくった帳票を、作り直さずWebアプリにする — 印刷前提の Excel 帳票を、作り直さずブラウザへ。
関連ドキュメント
- ページレイアウト — 用紙サイズ・余白・倍率・手動改ページ・改ページプレビュー。
- PDFエクスポート —
ExportPdfOptionsの全リファレンス。 - HTML で印刷 —
PrintOptionsの全リファレンス。 - XLSXインポート・エクスポート — ページ設定はファイルと一緒に往復するため、Excel でも同じページ割りになります。