【GAS入門#9】Range.setBackgroundでセルの背景色を変える方法!RGB指定やカラーコード・色名指定まで徹底解説

スプレッドシートで大量のデータを管理していると、「特定のデータだけパッと見て目立たせたい」「タスクが完了した行をグレーアウトしたい」「条件に合うセルを自動で色付けしたい」と思う瞬間がたくさんありますよね。

手動で1つずつバケツツールを使って色を塗ることもできますが、データが増えれば増えるほど時間がかかりますし、塗り忘れや塗り間違いの原因にもなってしまいます。

そこで今回は、指定したセルや範囲の背景色(カラー)をプログラムから自動で変更できる「Range.setBackground()」を解説します!

背景色の指定で使われる「色名(カラーネーム)」と「カラーコード(HEX)」の違いや仕組みから、赤・緑・青の数値で直接指定できる「Range.setBackgroundRGB()」、さらには塗った色を綺麗に消去(リセット)する方法まで、初心者の方にもスッキリ理解できるようにどこよりも詳しく解説していきます。

1. そもそも Range.setBackground() とは?

Range.setBackground() は、指定したセル(Rangeオブジェクト)の背景色(カラー)を設定・変更するための命令(メソッド)です。

基本的なコードの構文

// 1. 色を変えたいセル(家具)を指定する
var range = sheet.getRange("A2");

// 2. セルの背景色を変更する
range.setBackground("#d9ead3");

本連載でおなじみの「家・部屋・家具」の例えで整理してみましょう。

  • 【家】 = スプレッドシートファイル全体(SpreadsheetApp.getActiveSpreadsheet())
  • 【部屋】 = 個別のシートタブ(ss.getActiveSheet())
  • 【家具】 = セル・セル範囲(sheet.getRange("A2"))

Range.setBackground() は、まさにこの「家具(セル)」に対してペンキを塗って模様替えをする操作にあたります。

2. セルの背景色を指定する「3つの方法」

GASでセルの背景色を指定する方法には、大きく分けて以下の3つの方法があります。

  1. 色名(カラーネーム)で指定する
  2. カラーコード(HEX / 16進数)で指定する【一番おすすめ!】
  3. RGB(赤・緑・青の数値)で指定する(setBackgroundRGB)

それぞれの特徴と仕組みを順番に詳しく見ていきましょう!

方法①:色名(カラーネーム)で指定する

最も直感的で分かりやすいのが、英語の色名(カラーネーム)をそのまま文字列で指定する方法です。

// 赤色に塗る
range.setBackground("red");

// 黄色に塗る
range.setBackground("yellow");

// 薄い緑色(ライトグリーン)に塗る
range.setBackground("lightgreen");

特徴とメリット・デメリット

  • メリット:"red" や "blue"、"green" など、知っている英語を書くだけなので直感的でコードが読みやすい。
  • デメリット:指定できる色の種類が限られている。また、"red" や "yellow" と書くと鮮やかすぎる原色になりがちで、スプレッドシートの画面が見づらくなってしまうことがある。

ちょっとしたテストや「とにかくパッと赤くしたい」という時にはとても便利ですが、実務や本格的なツール作成では次に紹介する「カラーコード」を使うのが一般的です。

方法②:カラーコード(HEX / 16進数)で指定する【超重要】

GASやWeb制作で最もよく使われるのが、「カラーコード(HEX)」 を使った指定方法です。

// 淡い緑色(パステルグリーン)に塗る
range.setBackground("#d9ead3");

そもそもカラーコード(HEX/16進数)とは?

カラーコードとは、Webの世界やデザインツールで色を正確に表現するための6桁の記号です。頭に #(ハッシュ)を付けて表します。

例:#FF0000(■赤)、#00FF00(■緑)、#0000FF(■青)

この6桁は、光の三原色である 「赤(Red)」「緑(Green)」「青(Blue)」 の3要素を2桁ずつ組み合わせて作られています。

 #  FF  00  00
 │  │   │   └─ 青(Blue)の強さ(00〜FF)
 │  │   └───── 緑(Green)の強さ(00〜FF)
 │  └───────── 赤(Red)の強さ(00〜FF)
 └──────────── カラーコードの目印

なぜ「16進数」を使うの?

普段私たちが使っている数字は「0〜9」の10個で繰り上がる10進数ですが、コンピュータの世界では「0〜9」にアルファベットの「A〜F」を加えた16進数を使って数を数えます。

  • 10進数:0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15…
  • 16進数:0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F, 10…

16進数を使うと、00(一番暗い/光なし)から FF(一番明るい/光最大)までの256段階の明るさを、たったの2桁で表現できます。

  • #000000 ➡ 赤・緑・青がすべて「00」(光が全くない=黒)
  • #FFFFFF ➡ 赤・緑・青がすべて「FF」(すべての光が最大=白)
  • #FF0000 ➡ 赤だけが最大で、緑と青は0(=真ん赤)

スプレッドシートのカラーパレットで使われるパステルカラー(目になじむ優しい色合い)も、このカラーコードを使えばミリ単位で正確に表現できます。

方法③:Range.setBackgroundRGB() で数値指定する

背景色を変える命令には、setBackground() のほかに Range.setBackgroundRGB() という専用メソッドも用意されています。

16進数のカラーコードではなく、赤(Red)・緑(Green)・青(Blue)の強さを「0〜255」の10進数の数値で直接指定します。

// 順に (赤の強さ, 緑の強さ, 青の強さ) を 0〜255 の数値で渡す
range.setBackgroundRGB(217, 234, 211);
  • 赤(R):217
  • 緑(G):234
  • 青(B):211

➡ これらを混ぜ合わせると、優しいパステルグリーンになります。

3. STEP1:準備!「札幌ラーメン巡りリスト」を作成しよう

それでは、実際にGASから背景色を変更する練習用スプレッドシートを用意しましょう。

手順

  1. Googleスプレッドシートを1枚新しく開き、ファイル名を 「札幌ラーメン巡りリスト」 にします。
  2. 画面下のシートタブ名を 「中央区エリア」 に変更します。
  3. 以下の通りに表データを入力してください(C列のステータスに応じて、GASでA列〜C列に色を塗っていきます)。
ABC
1店舗名スープの種類訪問ステータス
2麺屋 彩未味噌訪問済み
3えびそば 一幻えびみそ行きたい
4札幌麺屋 菜々兵衛鶏白湯訪問済み

4. STEP2:【実践】色名・カラーコードでセルに色を塗ってみよう!

準備ができたら、GASのエディタを開いてコードを書いていきましょう。

まずは「色名指定」と「カラーコード指定」の両方を試してみます。

1. コードを入力する

スプレッドシートのメニューバーから 「拡張機能」 > 「Apps Script」 を開き、エディタ画面のコードをすべて消して以下を貼り付けます。

function setRamenStatusColor() {
  // ① 「家(ファイル)」と「部屋(シート)」を取得する
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();
  
  // ② 色名(カラーネーム)を使って、A1:C1の見出しを「黄色」にする
  var headerRange = sheet.getRange("A1:C1");
  headerRange.setBackground("yellow");
  
  // ③ カラーコード(HEX)を使って、2行目(麺屋 彩未)を「薄い緑色」にする
  var row2Range = sheet.getRange("A2:C2");
  row2Range.setBackground("#d9ead3");
  
  // ④ 実行ログで確認
  Logger.log("背景色の変更が完了しました!");
}

2. コードを1行ずつ解説!

  • headerRange.setBackground("yellow");
    • 見出し部分(A1:C1)に対して、色名である "yellow" を指定して背景色を黄色にしています。
  • row2Range.setBackground("#d9ead3");
    • 訪問済みの2行目(A2:C2)に対して、カラーコード "#d9ead3" を指定して落ち着いたパステルグリーンにしています。カラーコードは必ず "#"(半角ハッシュ)から始め、ダブルクォーテーションで囲みます。

3. 保存して実行する

  1. エディタ上部の 「保存(フロッピーアイコン)」 をクリックします。
  2. 関数が setRamenStatusColor になっていることを確認し、「実行」 をクリックします。
  3. スプレッドシートの画面に戻り、1行目が黄色に、2行目が薄緑色に変わっているか確認してみましょう!

5. STEP3:【実践】setBackgroundRGB() で色を塗ってみよう!

次に、赤・緑・青の数値を直接渡す setBackgroundRGB() を使ってみましょう。

3行目の「えびそば 一幻(行きたい)」のセル範囲(A3:C3)を、RGB指定を使って優しいパステルイエローに塗ってみます。

1. コードを入力する

function setYellowWithRGB() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();
  
  // 3行目のセル範囲(A3:C3)を取得
  var targetRange = sheet.getRange("A3:C3");
  
  // 赤:255, 緑:242, 青:204 の割合で調合(=パステルイエロー)
  targetRange.setBackgroundRGB(255, 242, 204);
  
  Logger.log("A3:C3の背景色をRGB指定で変更しました!");
}

2. 実行して結果を確認する

実行後、3行目の背景色が優しい黄色に変わっていれば成功です!

6. 各指定方法の比較と使い分けまとめ

3つの背景色指定方法について、メリットや使いどころを一覧表にまとめました。

メソッド / 指定方法コード例メメリット主な使いどころ
色名指定.setBackground("red")わかりやすく、サッと書ける簡単なテスト、デバッグ時の目印
カラーコード(HEX).setBackground("#d9ead3")微妙なニュアンスの色を正確に指定できる実務・Web制作・システム開発の標準
RGB数値指定.setBackgroundRGB(217, 234, 211)プログラムで数値を計算して色を作れるデータの数値に応じてグラデーションを作る時

実務では、デザインツールやスプレッドシートのパレットからコピーしたコードをそのまま貼り付けられる setBackground("#カラーコード") をメインで使うのが最もスムーズです。

7. STEP4:塗った背景色を元に戻す(消す・透明にする)には?

「間違えて色を塗ってしまった」「処理が完了したら元の状態に戻したい」という場合もありますよね。

背景色をリセットして「無色(透明)」に戻したい時は、カラーコードの代わりに null または ""(空文字) を指定します。

function clearBackgroundColor() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  
  // 2行目(A2:C2)の背景色を無色(透明)にリセットする
  sheet.getRange("A2:C2").setBackground(null);
  
  Logger.log("背景色をクリアしました!");
}

⚠️ 超重要!#ffffff(白色)で消そうとするのはNG!

「背景色を消したいから白(#ffffff)を塗ればいいや!」と考えがちですが、これには大きな落とし穴があります。

  • setBackground("#ffffff") ➡ セルを「白色のペンキ」で塗りつぶすため、スプレッドシート本来のグレーのマス目(グリッド線)まで消えて真っ白になってしまいます。
  • setBackground(null) ➡ セルの背景色を「透明」にするため、マス目のグリッド線を残したまま背景色だけを綺麗にクリアできます。

元の状態に戻したいときは、必ず null を使いましょう!

8. 実務でそのまま使える!おすすめカラーパレット一覧

「色を塗りたいけれど、どのカラーコードを使えば綺麗に見えるかわからない…」という方のために、ビジネス文書やデータ管理表で映えるおすすめのカラーコードをまとめました。

用途・ステータス色名での近い表現カラーコード(HEX)RGB値色のイメージ
完了・正常(緑系)■lightgreen■"#d9ead3"■(217, 234, 211)優しいパステルグリーン。圧迫感なく強調できます
進行中・注意(黄系)■lightyellow■"#fff2cc"■(255, 242, 204)明るいパステルイエロー。要確認の目印に最適
保留・未着手(オレンジ系)■orange■"#fce5cd"■(252, 229, 205)柔らかいパステルオレンジ。急ぎのタスクに
除外・キャンセル(グレー系)■lightgray■"#efefef"■(239, 239, 239)ライトグレー。テキストの邪魔をせずにグレーアウトできます
重要・エラー(赤系)■pink■"#f4ccd1"■(244, 204, 209)淡いピンクレッド。エラー箇所などの警告表示に

9. 初心者が絶対につまずく!5大トラップと解決策

setBackground() を使う際、初心者が直面しやすいトラブルと対処法を5つまとめました。

トラップ1:# の付け忘れや "" の囲み忘れ

// ✕ NG:# がない / ダブルクォーテーションがない
range.setBackground(d9ead3);
range.setBackground("d9ead3");

// ◯ OK:# を含めた文字列として指定する
range.setBackground("#d9ead3");

カラーコードを指定する際は、必ず "#"(半角ハッシュ)を含めた文字列 として " "(ダブルクォーテーション)で囲んでください。

トラップ2:setBackground() と setBackgrounds()(複数形)の混同

GASには、今回学ぶ setBackground()(単数形)のほかに、setBackgrounds()(複数形) という命令が存在します。

  • setBackground()(単数形):指定した範囲全体をすべて同じ1つの色で塗りつぶす。
  • setBackgrounds()(複数形):2次元配列を使って、セルごとにバラバラの色を一度に塗り分ける。

範囲全体を1つの色で塗る場合は、単数形の setBackground() を使いましょう!

トラップ3:setBackgroundRGB() の数値範囲オーバー

setBackgroundRGB() に渡す数値は 0〜255 の範囲で指定する必要があります。

// ✕ NG:256以上の数字を指定している
range.setBackgroundRGB(300, 200, 100); // エラーになります!

トラップ4:Sheetオブジェクトに対して setBackground() を呼んでしまう

// ✕ エラーになる書き方(Sheetに対して直接呼んでいる)
sheet.setBackground("#d9ead3"); 
// TypeError: sheet.setBackground is not a function

setBackground() は Sheet(部屋)ではなく、Range(セル・家具)のメソッドです。必ず sheet.getRange("A2").setBackground("#d9ead3") のようにセルを取得してから呼び出しましょう。

トラップ5:文字色が変わらないと焦ってしまう

setBackground() はあくまで「セルの背景色(下地)」を変える命令です。「文字自体の色(フォントカラー)」を変えたい場合は、今後扱う setFontColor() を使います。

10. まとめ&次回予告

今回は、プログラムからセルの背景色を自由自在に変更する Range.setBackground() と Range.setBackgroundRGB() を解説しました。

  • 背景色の指定方法は「色名」「カラーコード」「RGB数値」の3種類
  • 実務ではカラーコード指定(#+16進数6桁)が一番おすすめ
  • 数値(0〜255)で直感的に指定したい時は setBackgroundRGB(r, g, b) も使える
  • 元の背景なしに戻すときは setBackground(null) を使う(#ffffff はグリッド線が消えるので注意)

条件に合わせて自動で色が切り替わる仕組みを作れるようになると、スプレッドシートの視認性が格段に上がり、チームでのデータ共有もスムーズになりますね!

次回(第10回)は、フェーズ1の締めくくりとして Range.setFontWeight() を解説します!

文字を「太字(ボールド)」にしてさらに強調・見やすく整形するテクニックを学び、単一セル操作の基礎を完成させましょう。お楽しみに!