前回(第64回)は、Googleスライド上に業績ハイライトなどを表示するための「トピックスカード用図形」をプログラムから自動描画する Slide.insertShape() の使い方を学びましたね!
スライド上に図形(Shape)を配置できるようになると、次にやりたくなるのは「図形の見た目(デザイン)をデータに応じてカッコよく自動装飾すること」です!
たとえば、月次報告プレゼンを作成するとき……
- 業績目標を達成(100%以上)した場合 ➔ カード背景を「目にも優しいパステルグリーン」にし、太い緑色の枠線で囲む!
- 業績目標が未達成(100%未満)の場合 ➔ カード背景を「警告のパステルレッド」にし、赤色の破線(ダッシュ線)枠で注意を促す!
手作業で毎月スライドの図形の色をポチポチ塗り替えるのは大変ですが、GASを使えば数字の達成率を見るだけで一瞬で完璧なデザインに自動変身させることができます。
第65回となる今回は、図形の塗りつぶし色をコントロールする Shape.getFill() と、枠線の色や太さ・種類をコントロールする Shape.getBorder() の使い方を、基礎から応用まで徹底的に噛み砕いて解説します!
今回も「札幌オフィスの月次業績レポート」を題材に、初心者の方が100%つまずく「2重の階層構造(オブジェクト指向)」の罠までしっかりカバーしていきますよ!
1. そもそも Shape.getFill() と Shape.getBorder() とは?
Googleスライドの図形(Shape)は、単一のパーツではなくいくつかの専門パーツ(オブジェクト)が合体して構成されています。
GASで図形の「中身の色」や「枠線」を変更したいとき、図形本体に直接「赤くなれ!」と命じるのではなく、各専門パーツを呼び出して命令する仕組みになっています。
【図形(Shape)】
├── ① 塗りつぶし担当 ➔ Fill オブジェクト(getFill() で取得)
└── ② 枠線装飾担当 ➔ Border オブジェクト(getBorder() で取得)
「家・部屋・家具」と「専門スタッフ」の例えでイメージしよう!
本連載(第2回〜第4回など)でおなじみの階層構造の例えで整理してみましょう。
- 【家】 = プレゼンテーション全体(
SlidesApp.getActivePresentation()) - 【部屋】 = 1枚のスライド(
presentation.getSlides()[0]) - 【家具】 = 配置された図形(
slide.getShapes()[0])
そして今回の家具(図形)の中には、2人の専門スタッフが常駐しています。
getFill()(ゲット・フィル)- 役割:「塗りつぶし担当スタッフ」を呼び出します。
- 背景色を「パステルグリーンにする」「透明にする」といった指示はこのスタッフ(
Fillオブジェクト)に頼みます。
getBorder()(ゲット・ボーダー)- 役割:「枠線担当スタッフ」を呼び出します。
- 枠線の太さを「3ポイントにする」、線を「破線にする」、枠線の色を「深緑色にする」といった指示はこのスタッフ(
Borderオブジェクト)に頼みます。
このように、「図形から専門スタッフを一度呼び出してから、色の設定メソッドを実行する」 という2段階のステップを踏むのが、Google Slides APIの基本ルールです!
2. STEP1:準備!「札幌オフィス月次業績レポート」スライドを用意しよう
まずは、今回GASからデザインを変更するための練習用スライドを作成しましょう。
手順
- Googleドライブで新しい「Googleスライド」を作成します。
- プレゼンテーションのタイトルを 「札幌オフィス月次業績レポート」 に変更します。
- 1枚目のスライド上に、テスト用の四角形(カード)を1つ配置します。
- メニューバーの 「挿入」 > 「図形」 > 「図形」 > 「長方形」 を選び、スライド中央に四角形を描きます。
- (※第64回で作成した
Slide.insertShape()のコードを使って自動作成した図形でもOKです!)
- スライドを開いたまま、上部メニューの 「拡張機能」 > 「Apps Script」 をクリックしてエディタを開きます。
これで準備は完了です!
3. STEP2:【実践】図形の「塗りつぶし色」と「枠線」を変更してみよう!
それでは、実際にGASを使って、スライド上の四角形の色を「パステルグリーン(#D4EDDA)」に変え、枠線を「太さ3ptの深緑色(#155724)」に装飾する基本コードを動かしてみましょう!
1. コードを入力する
エディタ画面のコードをすべて消去し、以下のコードをそのままコピー&ペーストしてください。
function formatCardDesign() {
// ①「家(プレゼンテーション)」と「部屋(1枚目のスライド)」を取得する
var presentation = SlidesApp.getActivePresentation();
var slide = presentation.getSlides()[0];
// ② スライド上にある1つ目の図形(家具)を取得する
var shapes = slide.getShapes();
if (shapes.length === 0) {
Logger.log("スライド上に図形が見つかりません!図形を配置してください。");
return;
}
var card = shapes[0];
// ----------------------------------------------------
// ③ 塗りつぶし色(Fill)の設定
// ----------------------------------------------------
var fill = card.getFill();
fill.setSolidFill("#D4EDDA"); // パステルグリーンに設定
// ----------------------------------------------------
// ④ 枠線(Border)の設定
// ----------------------------------------------------
var border = card.getBorder();
border.setWeight(3); // 枠線の太さを 3ポイント に設定
border.getLineFill().setSolidFill("#155724"); // 枠線の色を深緑色に設定
border.setDashStyle(SlidesApp.DashStyle.SOLID); // 枠線を「実線」に設定
// ⑤ 実行完了ログ
Logger.log("札幌オフィスのカードデザインを変更しました!");
}
2. コードを1行ずつ徹底解説!
var fill = card.getFill();- 図形
cardから「塗りつぶし担当(Fillオブジェクト)」を取り出します。
- 図形
fill.setSolidFill("#D4EDDA");- 単色塗りつぶしを設定するメソッドです。カラーコード(HEX表記の
"#D4EDDA")を指定して優しいライトグリーンに変更しています。
- 単色塗りつぶしを設定するメソッドです。カラーコード(HEX表記の
var border = card.getBorder();- 図形
cardから「枠線担当(Borderオブジェクト)」を取り出します。
- 図形
border.setWeight(3);- 枠線の太さをポイント数(数値)で指定します。今回はしっかり目立つ
3pt に設定しています。
- 枠線の太さをポイント数(数値)で指定します。今回はしっかり目立つ
border.getLineFill().setSolidFill("#155724");- ★ここが最大の注意ポイント! 枠線の「色」を変えるには、さらに
border.getLineFill()という「線の塗り担当」を呼んでからsetSolidFill()を実行します。
- ★ここが最大の注意ポイント! 枠線の「色」を変えるには、さらに
border.setDashStyle(SlidesApp.DashStyle.SOLID);- 線のスタイルを「実線(SOLID)」に指定しています。
3. 保存して実行する
- エディタ上部の 「保存(フロッピーアイコン)」 をクリックします。
- 「実行」 ボタンをクリックします。(初回は第2回で解説した「アクセス許可(承認プロセス)」画面が出るので許可してください)。
- Googleスライドの画面に戻って確認してみましょう!
【実行結果の確認】
スライド上の四角形が、綺麗なパステルグリーンの背景&太い深緑色の枠線に一瞬で変身していれば大成功です!
4. STEP3:【応用の極意】業績達成率に応じて「緑/赤」と枠線を自動切替!
基礎が理解できたら、実際の業務で大活躍する「条件分岐(if文)」を使った自動装飾ロジックを作ってみましょう!
「札幌オフィスの月次売上達成率」の数値データを判定し、カードの色と枠線デザインを自動切り替えします。
実践スクリプト:達成率連動カード更新
function updateCardByAchievement() {
var presentation = SlidesApp.getActivePresentation();
var slide = presentation.getSlides()[0];
var card = slide.getShapes()[0]; // 1つ目の図形を取得
// 札幌オフィスの目標達成率(実務ではスプレッドシートやAPIから自動取得する値)
var achievementRate = 120; // 例: 120%達成!
// var achievementRate = 85; // 例: 85%(未達成)で試したい場合はこちらコメント解除
// FillとBorderを取得
var fill = card.getFill();
var border = card.getBorder();
if (achievementRate >= 100) {
// ====================================================
// 【目標達成(100%以上)】緑色の達成デザイン!
// ====================================================
fill.setSolidFill("#D4EDDA"); // 淡い緑背景
border.getLineFill().setSolidFill("#28A745"); // 鮮やかな緑枠線
border.setWeight(4); // 太めの4pt
border.setDashStyle(SlidesApp.DashStyle.SOLID); // くっきり実線
Logger.log("【達成】達成率 " + achievementRate + "% ➔ 緑色カードを設定しました。");
} else {
// ====================================================
// 【目標未達成(100%未満)】赤色の警告デザイン!
// ====================================================
fill.setSolidFill("#F8D7DA"); // 淡い赤背景
border.getLineFill().setSolidFill("#DC3545"); // 警告の赤枠線
border.setWeight(3); // 3pt
border.setDashStyle(SlidesApp.DashStyle.DASH); // 注意を促す破線(ダッシュ)
Logger.log("【未達成】達成率 " + achievementRate + "% ➔ 赤色破線カードを設定しました。");
}
}
動作確認のポイント!
var achievementRate = 120;の状態で実行すると ➔ 緑色のカード&実線枠 になります。- コードの数字を
var achievementRate = 85;に書き換えて実行すると ➔ 一瞬で 赤色のカード&赤色破線枠 に切り替わります!
スプレッドシート連携(第13回 getValues() など)と組み合わせれば、毎月データを読み込んでプレゼンスライドのカード色を全自動で切り替えるシステムが作れますね!
5. 塗りつぶし(Fill)と枠線(Border)で使える主要メソッド一覧
実務でデザインをカスタマイズする際に役立つ設定メソッドを一覧表にまとめました!
① 塗りつぶし(Fill)の主要メソッド
| メソッド | 役割 | コード例 |
setSolidFill(color) | 単色で塗りつぶす(HEX / RGB / 色名) | fill.setSolidFill("#FF0000"); |
setSolidFill(r, g, b) | 赤・緑・青の数値(0〜255)で塗りつぶす | fill.setSolidFill(212, 237, 218); |
setTransparent() | 背景を「透明(無色)」にする | fill.setTransparent(); |
getFillType() | 現在の塗りつぶしタイプを取得する | var type = fill.getFillType(); |
② 枠線(Border)の主要メソッド
| メソッド | 役割 | コード例 |
setWeight(points) | 枠線の太さを指定する(pt単位) | border.setWeight(3); |
getLineFill() | 枠線の色を設定する LineFill を取得 | border.getLineFill().setSolidFill("#155724"); |
setDashStyle(style) | 線のスタイル(実線・点線・破線)を指定 | border.setDashStyle(SlidesApp.DashStyle.DASH); |
setTransparent() | 枠線自体を消して透明(線なし)にする | border.setTransparent(); |
💡 枠線の種類(SlidesApp.DashStyle)の指定バリエーション
SlidesApp.DashStyle.SOLID➔ 通常の実線(デフォルト)SlidesApp.DashStyle.DASH➔ 破線(—-)SlidesApp.DashStyle.DOT➔ 点線(・・・・)SlidesApp.DashStyle.DASH_DOT➔ 一点鎖線(-・-・-)
6. 初心者が絶対につまずく!5大トラップと完全対処法
図形の色や枠線変更で、初心者が必ず直面するエラーとハマりポイントをまとめました!
トラップ1:shape.setFillColor() と書いて TypeError になる
// ✕ 間違った書き方(Shapeに直でsetFillColorしようとする)
card.setFillColor("#D4EDDA");
// ➔ エラー: card.setFillColor is not a function
【原因と解決策】
図形(Shape)本体には setFillColor というメソッドは存在しません!
必ず card.getFill().setSolidFill("#D4EDDA") のように、getFill() を挟んでから呼び出しましょう。
トラップ2:border.setColor() と書いて TypeError になる
// ✕ 間違った書き方
border.setColor("#155724");
// ➔ エラー: border.setColor is not a function
【原因と解決策】
枠線(Border)の色設定も直観的な setColor ではありません。
枠線も塗りつぶしの一種という扱いのため、border.getLineFill().setSolidFill("#155724") という階層を辿る必要があります。
トラップ3:太さを設定したのに枠線が表示されない!?
// 太さは設定したのに線が出ない...
border.setWeight(3);
【原因と解決策】
元々の図形の枠線が「透明(線なし)」に設定されている場合、太さを変えるだけでは画面に表示されないことがあります。
必ず border.getLineFill().setSolidFill(...) で枠線の色をセットするか、border.setDashStyle(...) を指定して線が存在することを明示しましょう!
トラップ4:カラーコードの #(ハッシュ)をつけ忘れる
// ✕ エラーまたは予期せぬ色になる
fill.setSolidFill("D4EDDA");
// ◯ 正しい書き方(先頭に半角の # をつける)
fill.setSolidFill("#D4EDDA");
カラーコード(16進数)を文字列で指定する際は、必ず頭に半角の # をつける必要があります。忘れると正しく色が反映されません。(※第9回 setBackground() の解説もぜひおさらいしてみてくださいね!)
トラップ5:スライド上のテキストボックスや画像まで色が変わってしまう
// スライド上のすべての要素(PageElement)を一括取得した場合
var elements = slide.getPageElements();
【原因と解決策】
スライド上には「図形(Shape)」のほかに、「テキストボックス」「画像(Image)」「表(Table)」など様々な要素が混在しています。
画像や表に対して getFill() を呼び出すとエラーになる場合があるため、図形だけを操作したい場合は本稿のように slide.getShapes() を使って「図形のみ」を絞り込んで取得するのが安全です!
7. 今回のまとめ&次回予告
今回は、Googleスライドの図形デザインを自在に操る Shape.getFill() と Shape.getBorder() について解説しました!
今日の重要ポイントおさらい
- 図形の色設定は「専門スタッフ」を呼び出す2段階構造!
- 塗りつぶし ➔
card.getFill().setSolidFill(...) - 枠線の色 ➔
card.getBorder().getLineFill().setSolidFill(...)
- 塗りつぶし ➔
Border.setWeight()で太さ、setDashStyle()で破線や実線をコントロール!- 達成率などの数値条件(
if文)と組み合わせれば、業績カードを自動で「緑/赤」に切り替えられる!
図形の背景色と枠線が完璧にコントロールできるようになると、レポートスライドの見栄えがグッと洗練されますね!
さて、カードの枠組みができあがったら、次はいよいよカードの中に「今月の業績トピックスや総括テキスト」を自動挿入したくなりますよね!
次回(第66回)は、スライド内の指定位置に文字入力用エリアを自由に配置できる Slide.insertTextBox() を解説します!
