メインコンテンツへスキップ
見出し画像

帳票あるある③ー帳票の印刷余白と用紙サイズで1日溶かした話

    前回の続きから

    前回は、Excel の台帳と帳票テンプレートが二か所に分かれていて、どちらが正なのか分からなくなっていく話を書きました。

    今回は、その先の段階でぶつかる話です。テンプレートの構造が整っても、次に待っているのが印刷余白と用紙サイズの問題でした。

    「A4 縦で、余白は 10mm」という指定が出た

    ある現場で、帳票を HTML と CSS で出力する仕組みを試していたときのことです。

    お客様からの要件シートに、こう書いてありました。

    「A4 縦、上下左右の余白はすべて 10mm。フォントは 10pt。」

    この時点では、なにかが難しいとは思っていませんでした。CSS に @page { size: A4; margin: 10mm; } と書けばいいだろう、という認識でした。

    実際に書いてみると、ブラウザのプレビューでは確かに A4 っぽく見えます。印刷ダイアログを開くと、用紙サイズも A4 が選ばれています。

    「よし、動いた」と思いながら、実際にプリンターで一枚出してみました。

    出てきた紙と、画面の見た目が違う

    出力された紙を見て、少し止まりました。

    余白が、明らかに 10mm より広い。左端の項目が、画面で見た位置から内側に寄っています。ヘッダーの位置も、想定から数ミリ低い。

    最初は自分の CSS の書き方が悪いのかと思って、何度か書き直しました。margin の単位を mm から cm に変えてみる。@page の書き方を変えてみる。それでも、出てくる紙の余白は狭くなりません。

    しばらくしてから気づいたのですが、問題はブラウザの側にありました。

    ブラウザには「印刷時の独自余白」がある

    ブラウザには、印刷時にページ番号やURLなどのヘッダー・フッターを自動的に付け加える機能があります。そのためのスペースが、余白の外側にさらに積み上がっています。

    CSS で margin: 10mm と書いても、それはページの内側のコンテンツ余白の指定であって、ブラウザが印刷時に追加する余白とは別の層として扱われます。

    ブラウザごとに、この挙動が違います。

    あるブラウザでは、印刷プレビューで「余白なし」を選ばないと CSS で指定した余白が反映されません。別のブラウザでは、@page { margin: 0 } と書いた上でコンテンツ側のパディングで余白を制御しないと、余計な空白が残ります。さらに別のブラウザでは、用紙サイズの解釈自体が少しずれていて、印刷ダイアログを開くと「A4」が選ばれているのに、実際の出力が微妙にはみ出すことがあります。

    「CSS で余白を書いた」だけでは、どのブラウザでも同じ結果にはなりません。

    mm で書いた数字が、画面では別の大きさになる

    もうひとつ、別の問題が重なっていました。

    mm や cm という単位は、本来は物理的な長さです。ところが、ブラウザの画面表示では、これが「1mm = 3.78px」として処理されます。そして、画面の解像度やズーム設定によって、この換算が実際の物理的な大きさとずれることがあります。

    つまり、CSS に margin-top: 10mm と書いても、それが画面で見えているのは「だいたいそのくらいの大きさに見えるもの」であって、プリンターで紙に出したときの 10mm と同じとは限りません。

    画面上のプレビューは正確ではない、という前提で動かないと、ズレは繰り返しになります。

    1日、ここで止まった

    この問題に気づくまでに、かなりの時間を使いました。

    最初は CSS の書き方の問題だと思っていたので、同じような試行錯誤を繰り返していました。@page の書き方を変える、margin の指定場所を変える、padding との組み合わせを変える。

    途中で、ブラウザ側の印刷設定の問題だと気づいてから、今度はブラウザごとの挙動の違いを調べ始めました。あるブラウザでは動くが、別のブラウザでは動かない、という状態になります。どのブラウザで確認するかによって、見え方が変わります。

    お客様が何のブラウザを使っているかは、こちらでは決められません。

    「背景色と画像を印刷に含める」設定の問題も出てきた

    余白の問題と並行して、もう一点気になる挙動がありました。

    帳票のデザインで、特定のセルに背景色を付けて強調する、ということがよくあります。合計行の背景をグレーにする、ヘッダー行を薄い色で塗る、といった処理です。

    これが印刷すると消えます。

    ブラウザには、デフォルトで「印刷時に背景色と背景画像を省略する」という設定があります。インクの節約が目的のようですが、帳票の場合はこれが問題になります。デザイン上の意味がある背景色が、印刷物では出力されないからです。

    この問題を調べていく中で、print-color-adjust: exact というプロパティにたどり着きました。これをセレクタに指定すると、印刷時にもブラウザが背景色と背景画像を省略しないようになります。

    ただ、このプロパティを知っていないと、どこを調べればいいのかすら分かりません。「背景色 印刷 消える CSS」といったキーワードで検索を繰り返して、ようやく名前がわかる、という流れでした。

    precision モードで余白とカラーの制御をまとめた

    このあたりの問題を整理していく中で、gkReport に precision モードという仕組みを作りました。

    CSS の @page による余白指定、print-color-adjust: exact の適用、ブラウザ独自余白のリセット処理を、ひとつのオプションとしてまとめて有効にできるようにしています。帳票の出力で mm 単位の精度が必要な場合に、この設定を有効にすることで、ブラウザ依存の調整を都度手書きしなくて済むようになりました。

    「仕様書の余白 10mm」の重さは、やってみないと分からない

    振り返ってみると、要件シートに書いてあった「上下左右の余白はすべて 10mm」という一行は、かなり重い指定でした。

    HTML と CSS で帳票を作る場合、この 10mm を実現するには、CSS の余白指定だけでなく、ブラウザの印刷設定、ブラウザごとの挙動の違い、画面と印刷の換算のズレ、背景色の印刷可否、という複数の要素を同時に扱う必要があります。

    仕様書を書いた方も、それを受け取った方も、最初の時点ではそれが一行の重さだとは思っていませんでした。私も思っていませんでした。

    「仕様書の記述」と「実装時の実態」の間にある距離は、帳票の話では特に広がりやすい気がしています。

    次回

    次回は、帳票の「フォント」にまつわる話を書こうと思っています。OS によってフォントの見え方が変わる問題、明朝体の指定がどこまで通るか、印刷環境が変わったときにレイアウトが崩れる場面。帳票のフォント指定は、余白と並んで「やってみないと分からない」がたくさん出てくる領域です。

    帳票の話は続きます。気になる方はフォローから覗いてみてください。

     
     
    昼はサラリーマン。夜はAIとコードを書く。 休みは子供と過ごす。 SIer 17 年の現場感覚を、AI Agent と株自動売買で再現してみた実録です。 教科書ではなく、現場の生データ。 失敗も成功も、隠さずに。

    あなたへのおすすめ