GASでスプレッドシートのグループ化された行・列を一括で折りたたむ方法

Google Apps Script（GAS）のcollapseGroups()メソッドって、スプレッドシートを効率的に管理するのにめっちゃ便利なツールばい。特に、グループ化した行や列を一気に折りたたむことで、視覚的に整理整頓できるんよ。でも、使い方を知らんと結構難しく感じるけど、しっかり理解すればめっちゃ簡単に活用できるけ。

この記事では、collapseGroups()メソッドを使う方法をわかりやすく解説するけ、グループ管理を楽にしたい人にピッタリやけ。さらに、実際にどう使うかを具体例を交えて紹介するけ、ぜひ最後まで読んでいってな！

詳解！Ｇｏｏｇｌｅ　Ａｐｐｓ　Ｓｃｒｉｐｔ完全入門ＧｏｏｇｌｅアプリケーションとＧｏｏｇｌｅ　Ｗｏｒ第３版/秀和システム/高橋宣成

posted with カエレバ

楽天市場

Amazon

Yahooショッピング

collapseGroups()メソッドとは？
1. 基本の使い方
実装例と活用方法
1. 1. グループを作ったら即折りたたみ
2. 2. 特定の条件で折りたたみ
応用事例
1. 大きなデータセットの管理
トラブルシューティング
1. よくあるエラー
2. デバッグ方法
結論

collapseGroups()メソッドとは？

collapseGroups()は、Google Apps ScriptのRangeクラスにあるメソッドで、スプレッドシートでグループ化された行や列を折りたたむために使うんよ。このメソッドを使うことで、シートがすっきりして、見やすくなるけ。

基本の使い方

まず、メソッドの基本的な使い方やけど、こんな感じでコードを書くと簡単にグループを折りたためるんよ。

function collapseActiveGroups() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getActiveRange();
  range.collapseGroups();
}

これで、ユーザーが選んだ範囲にあるグループを折りたたむことができるんよ。

実装例と活用方法

1. グループを作ったら即折りたたみ

例えば、グループを作ったらすぐに折りたたむ処理も簡単にできるんよ。こんな感じでコードを書けば、グループ化して即座に折りたたむことができるけ。

function createAndCollapseGroup() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const targetRange = sheet.getRange("B2:D5");
  
  // 行グループを作成
  targetRange.shiftRowGroupDepth(1);
  
  // 列グループを作成
  targetRange.shiftColumnGroupDepth(1);
  
  // グループを折りたたみ
  targetRange.collapseGroups();
}

これで、B2からD5の範囲をグループ化した後、自動的に折りたたむことができるけ。

2. 特定の条件で折りたたみ

もっと高度な使い方として、条件に合わせてグループを折りたたむ方法もあるんよ。例えば、A列に「非表示」と書かれた行だけを折りたたむコードはこんな感じ。

function conditionalCollapse() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getDataRange();
  const values = dataRange.getValues();

  values.forEach((row, index) => {
    if (row[0] === "非表示") {
      const targetRange = sheet.getRange(index + 1, 1);
      if (targetRange.getRowGroupDepth() > 0) {
        targetRange.collapseGroups();
      }
    }
  });
}

これで、A列に「非表示」と書かれている行のグループを折りたたむことができるんよ。便利じゃろ？

応用事例

大きなデータセットの管理

大量のデータがある場合、最初から詳細なデータを折りたたんで、必要な部分だけ表示することでシートがスッキリするけ。例えば、次のようにして、特定のセクションを折りたたむことができるんよ。

function initializeReportView() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("年度レポート");
  const detailSections = ["B8:B20", "D8:D15", "F5:F30"];
  
  detailSections.forEach(rangeAddress => {
    const range = sheet.getRange(rangeAddress);
    range.shiftRowGroupDepth(1);
    range.collapseGroups();
  });
}

これを使えば、レポートを開いたときに補助データが非表示になって、主要なデータに集中できる環境が整うんよ。