【コピペで使える】GASでスプレッドシートのリッチテキストルールを作成

2021 6/16

2020年11月4日 2021年6月16日

URLをコピーする

URLをコピーしました！

スプレッドシートでデータ入力や資料などを作成していく中で、URLリンクを貼り付けすることもあるかと思います。

また見た目にインパクトをつけるために特定の文章の一部を太字にするなどするなどの装飾加工をするときもあります。

一度しか使わない資料や同じURLリンクを貼り付けるだけであれば手動で入力することも可能です。

しかしながら大量のデータを扱ったり、都度内容を変える資料を手動で変更することは大変ですね。

そこで今回は作成者によってURLデータを変更したりする際に使用できるnewRichTextValueメソッドをサンプルスクリプトを使ってご紹介します。

newRichTextValue()　：リッチテキスト作成

スプレッドシート内にリッチテキスト（リンクの設定や一部文字のテキストスタイルの変更など）を作成できます。

このメソッドに続けて設定条件、設定する内容を設定することができます。

スプレッドシートの機能作成メソッドは他にも

newConditionalFormatRuleメソッド（条件付き書式）

newDataValidation()メソッド（入力規則）

newFilterCriteria()メソッド（フィルタ作成）

newRichTextValue() メソッド（リッチテキスト）このブログ

newTextStyle()メソッド（テキストスタイル）

などがあります。（各リンクに詳しい説明があるのでご覧ください。）

クラス：SpreadsheetApp

注意：初めてコードを実行する際にアクセス権限の許可を求められますが許可をしてください。アクセス権限についての詳細は以下の記事に詳しく載っています。

無料のGmailアカウントでGASに初回の実行許可を与える方法

構造

  SpreadsheetApp.newRichTextValue().設定文字.設定環境.build()

こちらがリッチテキストビルダーを作成するための基本メソッドです。

newRichTextValue()の後に条件となるトリガーをスクリプトで記入をし最後にbuild()でビルダーを構築させます。

サンプルスクリプト１（リンクの設定）

スプレッドシート内のスクリプトで作成してください。

function newRichTextValue1(){
  var cell = SpreadsheetApp.getActive().getRange('A1');
  var value = SpreadsheetApp.newRichTextValue()
      .setText("HPリンク")
      .setLinkUrl("https://for-dummies.net/gas-noobs/")
      .build();
  cell.setRichTextValue(value);
}

newRichTextValueメソッド以降のビルダー作成では以下のメソッドを使用しています。

.setText("テキスト")メソッド　:挿入するテキストを設定する（今回はHPリンク）
.setLinkUrl("URL")メソッド　：URLを設定する（今回はこのブログのURL）
.build()　：ビルダーを実行する際に必要

このメソッドでは

HPリンクというテキストにこのブログのHPをリンクとして設定

変数valueに格納を行う

そしてsetRichTextValueメソッドでリッチテキストを設定しています。

このスクリプトを実行するとスプレッドシートのA1セルにHPリンクというリンクが挿入されます。

サンプルスクリプト２（文字の装飾の設定）

では次に文の一部に太字などの装飾ができるスクリプトをご紹介します。

function newRichTextValue２(){
  var cell = SpreadsheetApp.getActive().getRange('B1');
  var bold = SpreadsheetApp.newTextStyle().setBold(true).build();
  var italic = SpreadsheetApp.newTextStyle().setItalic(true).build();
  var value = SpreadsheetApp.newRichTextValue()
    .setText("HelloWorld")
    .setTextStyle(0, 5, bold)
    .setTextStyle(5, 10, italic)
    .build();
  cell.setRichTextValue(value);

}

３行目と４行目のnewTextStyleメソッドについては後日紹介するこちらの記事で詳しく説明していきます。
今回は太字とイタリックのテキストスタイルを設定するためのビルダーを作成しています。

newRichTextValueメソッド以降のビルダー作成では以下のメソッドを使用しています。

.setText("HelloWorld")　：挿入するテキストを設定する（今回はHPリンク）
.setTextStyle(開始文字,終了文字,テキストスタイル)　：対象のテキストスタイルを適用する文字数を設定

＊開始文字は0からスタートします。（０が１文字目となります。）　
そして終了文字は文字数を使用してカウントされるので注意が必要です。

例：
今回の HelloWorldという文字のHelloの部分のみ設定を変更したい場合　
setTextSylte(０,５,bold)
開始のHは１文字目なので開始文字は０になります
終了文字はHelloのoまでなので５文字分ですので５となります。
.build()　：ビルダーを実行する際に必要