【GAS】スプレッドシートのフォント機能まとめ【サンプルソース付】

快速ワーク
スポンサーリンク

GAS開発者向けにスプレッドシートのフォント機能をすべてまとめました。

セルのデータを扱う時、フォントの色を変更したり、お気に入りの字体に変えたり、自由自在にオシャレに装飾できると素敵ですね。

色、字体、太字、斜体、下線、サイズ設定と取得です。配列でまとめて設定することもできます。

シート作成時に簡単に見映えをよくすることができれば、きっと作業が楽しくなりますね。

フォントに関するメソッドをすべて載せてます。少しでも参考になれば幸いです。


スポンサーリンク
  1. Google Apps Script スプレッドシート 基礎 リファレンス
  2. セル範囲クラス[Range]のフォント設定
    1. フォント色設定[setFontColor(色)]
    2. フォント色配列設定[setFontColors(色's)]
    3. フォントファミリー設定[setFontFamily(フォントファミリー)]
    4. フォントファミリー配列設定[setFontFamilies(フォントファミリー’s)]
    5. フォントライン設定[setFontLine(フォントライン)]
    6. フォントライン配列設定[setFontLines(フォントライン's)]
    7. フォントサイズ設定[setFontSize(サイズ)]
    8. フォントサイズ配列設定[setFontSizes(サイズ's)]
    9. フォントスタイル設定[setFontStyle(フォントスタイル)]
    10. フォントスタイル配列設定[setFontStyles(フォントスタイル's)]
    11. フォントの太さ設定[setFontWeight(フォントの太さ)]
    12. フォントの太さ配列設定[setFontWeights(フォントの太さ's)]
  3. セル範囲クラス[Range]のフォント取得
    1. フォント色取得[getFontColor()]
    2. フォント色配列取得[getFontColors()]
    3. フォントファミリー取得[getFontFamily()]
    4. フォントファミリー配列取得[getFontFamilies()]
    5. フォントライン取得[getFontLine()]
    6. フォントライン配列取得[getFontLines()]
    7. フォントサイズ取得[getFontSize()]
    8. フォントサイズ配列取得[getFontSizes()]
    9. フォントスタイル取得[getFontStyle()]
    10. フォントスタイル配列取得[getFontStyles()]
    11. フォントの太さ取得[getFontWeight()]
    12. フォントの太さ配列取得[getFontWeights()]
  4. 最後に

Google Apps Script スプレッドシート 基礎 リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

 

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】
GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知...

 

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】
Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの...

 

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。


セル範囲クラス[Range]のフォント設定

セル範囲のフォント設定メソッドです。

フォント色設定[setFontColor(色)]

setFontColor(color)
フォントの色をCSS表記で設定します( '#ffffff'や 'white'など)。

function setFontColorSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var cell = sheet.getRange("B2");
  cell.setFontColor("red");
}
Parameters
名前タイプ説明
colorStringCSS表記のフォントの色( '#ffffff'や 'white'など)。 null値は色をリセットします。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setFontColor(color)

フォント色配列設定[setFontColors(色's)]

setFontColors(colors)
フォントカラーの2次元配列を設定します(この範囲のサイズと一致する必要があります)。色はCSS表記( '#ffffff'や 'white'など)です。

function setFontColorsSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var colors = [
    ["red", "white", "blue"],
    ["#FF0000", "#FFFFFF", "#0000FF"] // これらは16進数です
  ];

  var cell = sheet.getRange("B5:D6");
  cell.setFontColors(colors);
}
Parameters
名前タイプ説明
colorsObject[][]CSS表記法による色の2次元配列( '#ffffff'や 'white'など)。 null値は色をリセットします。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setFontColors(colors)

フォントファミリー設定[setFontFamily(フォントファミリー)]

setFontFamily(fontFamily)
「Arial」や「Helvetica」などのフォントファミリーを設定します。

function setFontFamilySample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var cell = sheet.getRange("B2");
  cell.setFontFamily("Helvetica");
}
Parameters
名前タイプ説明
fontFamilyString設定するフォントファミリー。 null値はフォントファミリをリセットします。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setFontFamily(fontFamily)

フォントファミリー配列設定[setFontFamilies(フォントファミリー’s)]

setFontFamilies(fontFamilies)
フォントファミリの2次元配列を設定します(この範囲のサイズと一致しなければなりません)。フォントファミリの例は、「Arial」または「Helvetica」です。

function setFontFamiliesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var fonts = [
    ["Arial", "Helvetica", "Verdana"],
    ["Courier New", "Arial", "Helvetica]
  ];

  var cell = sheet.getRange("B2:D3");
  cell.setFontFamilies(fonts);
}
Parameters
名前タイプ説明
fontFamiliesObject[][]フォントファミリーの二次元配列。 null値はフォントファミリをリセットします。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setFontFamilies(fontFamilies)

フォントライン設定[setFontLine(フォントライン)]

setFontLine(fontLine)
与えられた範囲のフォントラインスタイルを設定します( 'underline'、 'line-through'、または 'none')。

function setFontLineSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var cell = sheet.getRange("B2");
  cell.setFontLine("line-through");
}
Parameters
名前タイプ説明
fontLineStringフォントの線のスタイル。 'underline'、 'line-through'、または 'none'。 null値はフォントの線種をリセットします。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setFontLine(fontLine)

フォントライン配列設定[setFontLines(フォントライン's)]

setFontLines(fontLines)
線スタイルの2次元配列を設定します(この範囲のサイズと一致する必要があります)。

function setFontLinesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 2次元配列のサイズは範囲のサイズと一致する必要があります。
  var fontLines = [
    ["underline", "line-through", "none"]
  ];

  var range = sheet.getRange("B2:D2");
  range.setFontLines(fontLines);
}
Parameters
名前タイプ説明
fontLinesObject[][]フォントの線種の2次元配列( 'underline'、 'line-through'、または 'none')。 null値はフォントの線種をリセットします。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setFontLines(fontLines)



フォントサイズ設定[setFontSize(サイズ)]

setFontSize(size)
フォントサイズを設定します。サイズは使用するポイントサイズです。

function setFontSizeSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var cell = sheet.getRange("B2");
  cell.setFontSize(20);
}
Parameters
名前タイプ説明
sizeIntegerポイントサイズで表したフォントサイズ。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setFontSize(size)

フォントサイズ配列設定[setFontSizes(サイズ's)]

setFontSizes(sizes)
フォントサイズの2次元配列を設定します(この範囲のサイズと一致しなければなりません)。サイズはポイントです。

function setFontSizesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 2次元配列のサイズは範囲のサイズと一致する必要があります。
  var fontSizes = [
    [16, 20, 24]
  ];

  var range = sheet.getRange("B2:D2");
  range.setFontSizes(fontSizes);
}
Parameters
名前タイプ説明
sizesObject[][]サイズの二次元配列。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setFontSizes(sizes)

フォントスタイル設定[setFontStyle(フォントスタイル)]

setFontStyle(fontStyle)
指定された範囲のフォントスタイルを設定します( 'italic'または 'normal')。

function setFontStyleSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var cell = sheet.getRange("B2");
  cell.setFontStyle("italic");
}
Parameters
名前タイプ説明
fontStyleStringフォントスタイル。 'italic'または 'normal'のいずれかです。 null値はフォントスタイルをリセットします。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setFontStyle(fontStyle)

フォントスタイル配列設定[setFontStyles(フォントスタイル's)]

setFontStyles(fontStyles)
フォントスタイルの2次元配列を設定します(この範囲のサイズと一致する必要があります)。

function setFontStylesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 2次元配列のサイズは範囲のサイズと一致する必要があります。
  var fontStyles = [
    ["italic", "normal"]
  ];

  var range = sheet.getRange("B2:C2");
  range.setFontStyles(fontStyles);
}
Parameters
名前タイプ説明
fontStylesObject[][]フォントスタイルの2次元配列。 'italic'または 'normal'のいずれかです。 null値はフォントスタイルをリセットします。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setFontStyles(fontStyles)

フォントの太さ設定[setFontWeight(フォントの太さ)]

setFontWeight(fontWeight)
与えられた範囲のフォントの太さを設定します(標準/太字)。

function setFontWeightSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var cell = sheet.getRange("B2");
  cell.setFontWeight("bold");
}
Parameters
名前タイプ説明
fontWeightStringフォントの太さ、 '太字'または '標準'。 null値はフォントの太さをリセットします。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setFontWeight(fontWeight)

フォントの太さ配列設定[setFontWeights(フォントの太さ's)]

setFontWeights(fontWeights)
フォントの太さの長方形のグリッドを設定します(この範囲のサイズと一致している必要があります)。フォントの太さの例は 'bold' です。

function setFontWeightsSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 2次元配列のサイズは範囲のサイズと一致する必要があります。
  var fontStyles = [
    [ "bold", "bold", "normal" ]
  ];

  var range = sheet.getRange("B2:D2");
  range.setFontWeights(fontStyles);
}
Parameters
名前タイプ説明
fontWeightsObject[][]フォントの太さの2次元配列。 'bold'または 'normal'のいずれかです。 null値はフォントの太さをリセットします。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setFontWeights(fontWeights)




セル範囲クラス[Range]のフォント取得

セル範囲のフォント取得メソッドです。

フォント色取得[getFontColor()]

getFontColor()
範囲の左上隅にあるセルのフォント色をCSS表記で返します('#ffffff'や'white'など)。

function getFontColorSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  Logger.log(range.getFontColor());
}

Return
String - CSS表記のフォントの色(「#ffffff」や「white」など)。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getFontColor()

フォント色配列取得[getFontColors()]

getFontColors()
CSS表記の範囲内のセルのフォント色を返します('#ffffff'や 'white'など)。

function getFontColorsSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  var results = range.getFontColors();

  for (var i in results) {
    for (var j in results[i]) {
      Logger.log(results[i][j]);
    }
  }
}

Return
String[][] - 範囲内のセルに関連付けられたフォント色の2次元配列。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getFontColors()

フォントファミリー取得[getFontFamily()]

getFontFamily()
範囲の左上隅にあるセルのフォントファミリを返します。

function getFontFamilySample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  Logger.log(range.getFontFamily());
}

Return
String - セルのフォントファミリ。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getFontFamily()

フォントファミリー配列取得[getFontFamilies()]

getFontFamilies()
範囲内のセルのフォントファミリを返します。

function getFontFamiliesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  var results = range.getFontFamilies();

  for (var i in results) {
    for (var j in results[i]) {
      Logger.log(results[i][j]);
    }
  }
}

Return
String[][] - 範囲内のセルに関連付けられているフォントファミリの2次元配列。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getFontFamilies()

フォントライン取得[getFontLine()]

getFontLine()
範囲の左上隅にあるセルの線スタイルを取得します('underline'、'line-through'、または'none')。

function getFontLineSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  Logger.log(range.getFontLine());
}

Return
String - フォントライン。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getFontLine()

フォントライン配列取得[getFontLines()]

getFontLines()
範囲内のセルの線スタイル( 'underline'、'line-through'、または'none')を取得します。

function getFontLinesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  var results = range.getFontLines();

  for (var i in results) {
    for (var j in results[i]) {
      Logger.log(results[i][j]);
    }
  }
}

Return
String[][] - 範囲内のセルに関連付けられているフォント行の2次元配列。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getFontLines()

フォントサイズ取得[getFontSize()]

getFontSize()
範囲の左上隅にあるセルのフォントサイズをポイントサイズで返します。

function getFontSizeSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  Logger.log(range.getFontSize());
}

Return
Integer - ポイントサイズのフォントサイズ。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getFontSize()

フォントサイズ配列取得[getFontSizes()]

getFontSizes()
範囲内のセルのフォントサイズを返します。

function getFontSizesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  var results = range.getFontSizes();

  for (var i in results) {
    for (var j in results[i]) {
      Logger.log(results[i][j]);
    }
  }
}

Return
Integer[][] - 範囲内のセルに関連付けられているテキストのフォントサイズの2次元配列。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getFontSizes()

フォントスタイル取得[getFontStyle()]

getFontStyle()
範囲の左上隅にあるセルのフォントスタイル('italic'または'normal')を返します。

function getFontStyleSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  Logger.log(range.getFontStyle());
}

Return
String - セル内のテキストのフォントスタイル。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getFontStyle()

フォントスタイル配列取得[getFontStyles()]

getFontStyles()
範囲内のセルのフォントスタイルを返します。

function getFontStylesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  var results = range.getFontStyles();

  for (var i in results) {
    for (var j in results[i]) {
      Logger.log(results[i][j]);
    }
  }
}

Return
String[][] - 範囲内のセルに関連付けられているテキストのフォントスタイルの2次元配列。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getFontStyles()

フォントの太さ取得[getFontWeight()]

getFontWeight()
範囲の左上隅にあるセルのフォントの太さ(標準/太字)を返します。

function getFontWeightSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  Logger.log(range.getFontWeight());
}

Return
String - セル内のテキストのフォントの太さ。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getFontWeight()

フォントの太さ配列取得[getFontWeights()]

getFontWeights()
範囲内のセルのフォントの太さを返します。

function getFontWeightsSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  var results = range.getFontWeights();

  for (var i in results) {
    for (var j in results[i]) {
      Logger.log(results[i][j]);
    }
  }
}

Return
String[][] - 範囲内のセルに関連付けられたテキストのフォントウェイトの2次元配列。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getFontWeights()


最後に

GASフォント機能のまとめをご紹介させていただきました。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの使い方や機能がわかるショートカットキー全まとめ一覧【初心者こそ必見】
表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン...

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。




コメント

//▼2023/04/08追加 //https://lovagelab.com/posts/3406/ //▲2023/04/08追加