グループ化（アウトライン）

行や列をグループ化して折りたたみ・展開する方法を説明します。Excel のアウトライン機能に相当します。

グループ化はPro版で利用可能です。

行のグループ化

const ws = grid.worksheet

// 行2〜5をグループ化（0始まり）
ws.groupRows(1, 4)

// グループ解除
ws.ungroupRows(1, 4)

列のグループ化

// 列B〜Dをグループ化
ws.groupColumns(1, 3)

// グループ解除
ws.ungroupColumns(1, 3)

レベルの切替

アウトラインにはレベルがあり、ネストされたグループを一括で折りたたむ・展開できます。

// レベル1まですべてのグループを折りたたむ
ws.collapseRowsToLevel(1)
ws.collapseColumnsToLevel(1)

// 個別のグループを折りたたみ/展開（レベル, 開始インデックス）
ws.collapseRowOutline(1, 2)
ws.expandRowOutline(1, 2)

アウトラインマネージャー

const rowOutlines = ws.getRowOutlines()
const colOutlines = ws.getColumnOutlines()

// アウトラインパネルのサイズ
const panelWidth = ws.getOutlinePanelWidth()    // 行アウトラインパネルの幅（行ヘッダーの左側）
const panelHeight = ws.getOutlinePanelHeight()  // 列アウトラインパネルの高さ（列ヘッダーの上側）

ActionManager によるグループ化

Undo / Redo 対応でグループ化する場合は ActionManager を使用します。

import {
  GroupRowsAction,
  UngroupRowsAction,
  GroupColumnsAction,
  ToggleOutlineAction,
  CollapseToLevelAction,
} from '@reogrid/pro'

// グループ化（Undo 可能）
grid.actionManager.execute(new GroupRowsAction(1, 4))

// グループ解除（Undo 可能）
grid.actionManager.execute(new UngroupRowsAction(1, 4))

// 列のグループ化
grid.actionManager.execute(new GroupColumnsAction(1, 3))

// アウトラインの折りたたみ/展開（方向, レベル, 開始インデックス）
grid.actionManager.execute(new ToggleOutlineAction('row', 1, 2))

// レベルごとの折りたたみ（方向, レベル）
grid.actionManager.execute(new CollapseToLevelAction('row', 1))

使用例：月次レポート

const ws = grid.worksheet

ws.suspendRender()

// ヘッダー
ws.cell('A1').setValue('カテゴリ').setStyle({ bold: true })
ws.cell('B1').setValue('金額').setStyle({ bold: true })

// Q1
ws.cell('A2').setValue('Q1 合計').setStyle({ bold: true })
ws.cell('A3').value = '1月'
ws.cell('A4').value = '2月'
ws.cell('A5').value = '3月'
ws.cell('B2').value = '=SUM(B3:B5)'
ws.cell('B3').value = '100000'
ws.cell('B4').value = '120000'
ws.cell('B5').value = '110000'

// Q2
ws.cell('A6').setValue('Q2 合計').setStyle({ bold: true })
ws.cell('A7').value = '4月'
ws.cell('A8').value = '5月'
ws.cell('A9').value = '6月'
ws.cell('B6').value = '=SUM(B7:B9)'
ws.cell('B7').value = '130000'
ws.cell('B8').value = '140000'
ws.cell('B9').value = '125000'

// 月の行をグループ化（折りたたむと四半期合計のみ表示）
ws.groupRows(2, 4)  // 1月〜3月
ws.groupRows(6, 8)  // 4月〜6月

ws.resumeRender()

注意事項

• グループは最大 9 レベルまでネストできます。
• グループ化するとシートの左側（行）または上側（列）にアウトラインパネルが表示されます。
• + / - ボタンでグループの折りたたみ・展開ができます。