オートフィル（フィルハンドル）

オートフィルは Excel でおなじみのフィルハンドル機能です。アクティブな選択範囲の右下に表示される小さな四角を下・上・左・右にドラッグすると、元セルから推測した値で選択範囲を拡張できます。

検出されるパターン：

undo（元に戻す）で、以前に異なるデータが入っていたセルも含めて元の値に戻ります。

有効化・無効化

オートフィルはデフォルトで有効です。

import { createReogrid } from '@reogrid/lite'

// 初期化時に無効化
const { worksheet } = createReogrid('#grid', {
  autoFill: false,
})

// 実行時に切り替え
worksheet.setAutoFillEnabled(true)
worksheet.setAutoFillEnabled(false)

React / Vue では、フィルハンドルを使わない場合に <Reogrid> コンポーネントへ options={{ autoFill: false }} を渡してください。

プログラムからのフィル

ツールやテスト用途のため、値推測ロジックは副作用のない純粋関数として公開されています。UI と同じ計算結果を取得できます。

import { computeAutoFillValues, type AutoFillSourceCell } from '@reogrid/pro'

const source: AutoFillSourceCell[][] = [
  [{ input: '1', isFormula: false }],
  [{ input: '2', isFormula: false }],
]

const result = computeAutoFillValues(source, 'down', 5)
// result -> [{ input: '3' }, { input: '4' }, { input: '5' }, { input: '6' }, { input: '7' }]

標準の undo/redo パイプライン経由でフィルを実行したい場合は AutoFillAction を組み合わせて使えます。

import { AutoFillAction } from '@reogrid/pro'

const action = new AutoFillAction(/* ... */)
worksheet.doAction(action)

補足

• フィルハンドルは選択範囲のクロームとして描画されるため、アクティブな選択範囲に自動的に追従します。
• 曜日（Mon, Tue, ...）や月名のようなカスタムシリーズは本リリースでは検出されません — 代わりにタイルコピーされます。
• フィルハンドルのダブルクリックによる下方向への自動延長は現状未対応です。