【GAS入門#55】請求金額を劇的見やすく!Paragraph.setFontSize() / setForegroundColor()で文字サイズ拡大とカラー装飾を極める

前回(第54回)は、Paragraph.setHeading() を使って、ドキュメント内の特定テキスト(「ご請求明細」など)を見出し(Heading 2など)に変更し、文書全体の骨組みを整える方法を解説しました。

請求書や見積書などのビジネス文書において、骨組みの次に取り組みたくなるのが「一番伝えたい重要データの視覚的強調(デコレーション)」です!

特に請求書において、クライアントや自社の経理担当者が最も注視するデータは「請求合計金額」ですよね。ここが本文と同じ文字サイズ・同じ黒文字のままだと、他のテキストに埋もれてしまい、確認漏れや振込間違いの原因にもなりかねません。

そこで第55回となる今回は、段落やテキストのフォントサイズを自由に変更する Paragraph.setFontSize() と、文字色を好みのカラーに変更する Paragraph.setForegroundColor() を徹底解説します!

札幌オフィスの請求書自動生成システムを題材に、請求合計金額を「大きく・太く・鮮やかな強調カラー」で目立たせる実践テクニックを学んでいきましょう!

1. そもそも setFontSize() と setForegroundColor() とは?

今回学習する2つの命令は、Google ドキュメント内の文字装飾(リッチテキスト書式)をGASからプログラマチックに変更するための必須メソッドです。

まずはそれぞれの役割と書き方の基本を確認しましょう。

① setFontSize(fontSize)(フォントサイズ変更)

指定した段落(Paragraph)やテキスト(Text)の文字サイズを、ポイント単位(pt)で変更します。

// 段落の文字サイズを 20pt(特大)に設定する
paragraph.setFontSize(20);
  • 引数:数値(Integer)。例:12, 18, 24 など。(※"20" のように文字列で渡すとエラーになるので数値で指定します)

② setForegroundColor(color)(文字色・前景色変更)

指定した段落(Paragraph)やテキスト(Text)の文字色(前景色)を変更します。

// 段落の文字色を鮮やかな赤色(カラーコード: #C00000)に変更する
paragraph.setForegroundColor("#C00000");
  • 引数:カラーコード文字列(CSS表記のHEXコード "#RRGGBB" や "red" などのカラー名)。
  • 💡 前景色(Foreground Color)とは?:背景色(Background Color)の対義語で、「文字自体の色」 のことを指します。

「家・部屋・家具・ペン」の例えで理解する構造

本連載でお馴染みの例えをGoogle ドキュメントにも当てはめてみましょう!

概念ドキュメントの要素GASでのクラス / オブジェクト現実世界での例え
全体ドキュメントファイル全体DocumentApp.openById()一戸建ての家
本文本文エリアDocument.getBody()部屋
段落段落(ブロック)Body.appendParagraph() / Paragraph家具(ソファや棚)
装飾文字サイズや文字色setFontSize() / setForegroundColor()ペンキ塗り・クッション装飾

家具(段落)を配置したあとに、「この家具だけ鮮やかな赤色に塗って、サイズも特大のものに取り替える」という仕上げの装飾作業こそが、今回行う操作です!

2. 2つのアプローチ:段落全体を変える?文字単位で変える?

GASのドキュメント操作において、文字の装飾には大きく分けて2つのアプローチがあります。用途に応じて使い分けられるようになると、プロのコードに一歩近づきます!

【パターン A:段落全体の一括装飾】
 paragraph.setFontSize(20).setForegroundColor("#C00000");
 ➡ 「ご請求金額:¥154,000-(税込)」 の全文字が 20pt & 赤色になる

【パターン B:段落内の特定文字だけのピンポイント装飾】
 paragraph.editAsText().setFontSize(9, 17, 24).setForegroundColor(9, 17, "#C00000");
 ➡ 「ご請求金額:」は通常黒文字、「¥154,000-」の部分だけが 24pt & 赤色になる
  • パターン A(今回メイン):段落全体のオブジェクト(Paragraph)に対して直接メソッドを呼ぶ方法。コードがシンプルで初心者にも扱いやすいです。
  • パターン B(後半の応用):paragraph.editAsText() を使い、文字の開始位置〜終了位置(オフセット)を指定して部分装飾する方法。

本記事では、まず超基本のパターン Aで基本操作をマスターし、最後に発展としてパターン Bのピンポイント装飾テクニックをご紹介します!

3. STEP1:準備!「札幌オフィス請求書ドキュメント」を開こう

まずは、GASから操作するためのGoogle ドキュメントを用意しましょう。第51回〜第54回で作成したドキュメントがある方はそのまま利用していただいて構いません。

手順

  1. Google ドキュメントを新規作成(または過去記事のファイルを開く)
    • ドキュメントのタイトルを 「札幌オフィス請求書テンプレート」 とします。
  2. URLからドキュメント ID を取得する
    • ブラウザのアドレスバーに表示されているURLを確認します。
    • https://docs.google.com/document/d/【ここの英数字がドキュメントID】/edit
    • この ID をメモしておきましょう。

4. STEP2:【実践】請求金額の段落を拡大&赤色で強調表示してみよう!

それでは、実際にGASのエディタを開いてコードを書いていきましょう!

今回は、請求書の下部に「ご請求金額:¥154,000-(税込)」という段落を追加し、その文字サイズを 20pt に拡大、さらに文字色を鮮やかな コーポレートレッド(#C00000) に装飾し、太字(setBold)も追加します。

1. コードを入力する

スプレッドシートやコンソール側のGASエディタ(またはスタンドアロンスクリプト)を開き、以下のコードを貼り付けます。

(※ YOUR_DOCUMENT_ID の部分は、先ほどメモしたご自身のドキュメント ID に書き換えてください。)

function formatInvoiceTotalAmount() {
  // ① ドキュメント ID を指定してファイルを開く(第51回の復習)
  var docId = "YOUR_DOCUMENT_ID"; // ご自身のドキュメントIDを入力
  var doc = DocumentApp.openById(docId);
  var body = doc.getBody();
  
  // ② 請求金額を示す段落を本文に追加(第53回の復習)
  var totalParagraph = body.appendParagraph("ご請求金額:¥154,000-(税込)");
  
  // ③ フォントサイズを 20pt に拡大する
  totalParagraph.setFontSize(20);
  
  // ④ 文字色を赤色(#C00000)に変更する
  totalParagraph.setForegroundColor("#C00000");
  
  // ⑤ さらに太字(Bold)を設定して存在感をアップ!
  totalParagraph.setBold(true);
  
  // ⑥ 変更を保存してログ出力
  Logger.log("請求合計金額の装飾(拡大・カラー変更・太字)が完了しました!");
}

2. コードのポイントを解説!

1行ずつ処理の流れを確認してみましょう。

  • body.appendParagraph("...")
    • 本文(body)の末尾に新しい段落を追加し、その段落オブジェクトを totalParagraph という変数に格納しています。
  • totalParagraph.setFontSize(20)
    • totalParagraph 全体の文字サイズをデフォルト(11pt等)から 20pt へ一括変更しています。
  • totalParagraph.setForegroundColor("#C00000")
    • totalParagraph 全体の文字色を #C00000(濃い赤色・コーポレートレッド) に変更しています。
  • totalParagraph.setBold(true)
    • 文字の太さを「太字(ボールド)」に設定しています。サイズ変更・カラー変更・太字化の3連打によって、圧倒的な視認性が生まれます!

3. 実行結果の確認

コードを保存し、「実行」ボタンを押してGoogle ドキュメントの画面を開いてみましょう。

ドキュメントの末尾に、大きな赤色の太文字で「ご請求金額:¥154,000-(税込)」 とハッキリ表示されていれば大成功です!

これなら、請求書を受け取ったクライアントも一目で支払金額を把握できますね!

5. STEP3:【応用】金額の部分だけをピンポイントで特大赤文字にするプロの技!

「段落全体が赤文字になるのも悪くないけれど、『ご請求金額:』というラベル部分は普通の黒文字(12pt)のままで、数字の『¥154,000-』の部分だけを特大(24pt)&赤色にしたい!」

実務の請求書デザインでは、このようなメリハリのあるレイアウトが非常によく使われます。

これを実現するために使うのが、Paragraph.editAsText() と オフセット指定(文字の範囲指定) です!

オフセット指定の考え方

文字列の先頭を 0 番目として、何文字目から何文字目までを装飾するかを数字でカウントします。

文  字  列  : ご 請 求 金 額 : ¥ 1  5  4  ,  0  0  0  -  ( 税 込 )
インデックス: 0  1  2  3  4  5  6  7  8  9  10 11 12 13 14 15 16 17 18
                                └── 7〜15文字目 ───┘

「¥154,000-」の部分は、インデックス 6(7文字目の『¥』)から 14(15文字目の『-』)になります。

1. 応用コードを入力してみよう

以下の関数をエディタに追加して実行してみましょう。

function formatPartialAmountText() {
  var docId = "YOUR_DOCUMENT_ID"; // ご自身のドキュメントIDを入力
  var doc = DocumentApp.openById(docId);
  var body = doc.getBody();
  
  // 新しい段落を追加
  var p = body.appendParagraph("ご請求金額:¥154,000-(税込)");
  
  // 1. 段落全体を一旦「12pt・黒文字・標準の太さ」に初期設定
  p.setFontSize(12);
  p.setForegroundColor("#000000");
  p.setBold(false);
  
  // 2. 段落を Text オブジェクトとして編集モード(editAsText)にする
  var textObj = p.editAsText();
  
  // 3. インデックス 6 〜 14(「¥154,000-」)の部分だけ装飾!
  var startOffset = 6; // 「¥」の開始位置(0始まりで6番目)
  var endOffset = 14;  // 「-」の終了位置(14番目)
  
  // 指定範囲のサイズを 24pt に拡大
  textObj.setFontSize(startOffset, endOffset, 24);
  
  // 指定範囲の色を赤色(#C00000)に変更
  textObj.setForegroundColor(startOffset, endOffset, "#C00000");
  
  // 指定範囲を太字にする
  textObj.setBold(startOffset, endOffset, true);
  
  Logger.log("金額部分のピンポイント装飾が完了しました!");
}

実行結果

このスクリプトを実行すると:

  • 「ご請求金額:」 ➡ 12pt・黒文字
  • 「¥154,000-」 ➡ 24pt・赤色・太字
  • 「(税込)」 ➡ 12pt・黒文字

という、プロがデザインしたようなメリハリのある美しい請求金額バナーが自動作成されます!

6. 知っておくと役立つ!Webで使えるカラーコード早見表

setForegroundColor() で使える代表的なカラーコード(16進数HEX表記)をまとめました。自社のイメージカラーや文書のトーンに合わせて使い分けてみましょう!

色のイメージカラーコード用途・おすすめシーン
強烈な赤(レッド)"#FF0000"最重要警告、未払い通知など
深みのある赤(コーポレートレッド)"#C00000"請求合計金額の強調(一番おすすめ!)
ダークブルー(ネイビー)"#002060"信頼感を出したい見出しやタイトル
グリーン(フォレストグリーン)"#008000"承認済みステータス、完了メッセージ
シックなダークグレー"#595959"補足説明や「(税込)」などの注記

7. 初心者が絶対にミスる!4大トラップと対処法

setFontSize() や setForegroundColor() を使う際、プログラミング初心者の方が直面しやすいトラブルと解決策をまとめました。

トラップ①:カラーコードの #(シャープ)を忘れてエラーになる

// ✕ NGな書き方(シャープがない)
paragraph.setForegroundColor("C00000");

// ◯ OKな書き方(シャープがついている)
paragraph.setForegroundColor("#C00000");

【症状】 Invalid argument などのエラーが発生するか、色が正しく反映されません。

【解決策】 16進数カラーコードを指定するときは、必ず先頭に半角の # をつけ、全体をダブルクォーテーション "" で囲みましょう!

トラップ②:setFontSize() に数値ではなく文字列を渡してしまう

// ✕ NGな書き方(ダブルクォーテーションで囲んでいる)
paragraph.setFontSize("20");

// ◯ OKな書き方(数値として渡す)
paragraph.setFontSize(20);

【症状】 引数の型不一致エラーが発生します。

【解決策】 フォントサイズを指定するときは、"20" ではなく数字の 20 を直接書きましょう!

トラップ③:オフセット(文字位置)の数え間違いで意図しない文字が変わる

textObj.setFontSize(start, end, size) で範囲指定をする際、インデックスは 0始まり(0-indexed) です。

  • 1文字目 = インデックス 0
  • 7文字目 = インデックス 6

数え間違いを防ぐコツとして、動的に文字の位置を検索する textObj.getText().indexOf("¥") などのJavaScript関数を使うと、文字数が変わっても自動で正しく範囲を取得できるようになります。

トラップ④:ドキュメントを開いたまま実行しても画面が変わらない?

GASでドキュメントの装飾を実行した際、ブラウザで開いているGoogle ドキュメントの画面に即座に変化が反映されないことがあります。

これはブラウザの表示キャッシュによるものです。画面をリロード(F5キーまたはCtrl + R)するか、GASコードの最後に doc.saveAndClose(); を追加して明示的に保存・消去を行うと確実に反映されます。

8. まとめ&次回予告

今回は、Google ドキュメント内の文字を視覚的にアピールする Paragraph.setFontSize() と Paragraph.setForegroundColor() について学びました。

本日の重要ポイント

  • setFontSize(20) で文字サイズを数値(pt)で拡大指定できる
  • setForegroundColor("#C00000") で文字色を16進数カラーコードで鮮やかに装飾できる
  • 段落全体を一括変更することも、editAsText() で特定部分だけをピンポイント装飾することも可能
  • カラーコードの # 忘れや、サイズの文字列指定("20")などの罠に注意!

請求書の合計金額が大きく見やすい赤字で自動出力されるようになり、札幌オフィスの請求書自動生成システムもいよいよ本格的なクオリティになってきましたね!

次回(第56回)は、請求書になくてはならない「明細データ」を綺麗に並べるための Body.appendTable() に挑戦します!

ドキュメント内に美しく整列された表(テーブル)を自動生成する方法をわかりやすく解説しますので、次回もどうぞお楽しみに!