@threestarsoftware/tssgrid 0.1.9 → 0.1.10

package/CHANGELOG.md

@@ -3,6 +3,11 @@
 TssGrid の各リリースの変更点。日付は JST。形式は [Keep a Changelog](https://keepachangelog.com/ja/1.1.0/) 準拠（ゆるめ）。
 数値は特記なき限り**自社調べ**（headless Chrome / Windows 11・環境差あり）。
 
+## [0.1.10] - 2026-09-16
+
+### 追加
+- **`scrollToRow(r, align?)`（指定行までスクロール＝HTML の `#` アンカー相当）**（コア）— 任意の行を画面の**先頭へ**持ってくる公開メソッド。`align` は `'start'`（既定＝先頭・sticky ヘッダ直下）/ `'center'` / `'end'` / `'nearest'`（可視ならそのまま）。**仮想（均一行高）でも非仮想（実DOM測定・可変行高）でも動く**。範囲外の `r` は自動クランプ。**選択は変えない**（目印が欲しい時は `rowClass` 等を併用）。動く例 `examples/scroll-to-row.html`（1000行・行番号ジャンプ＋align 切替＋rowClass ハイライト）。
+
 ## [0.1.9] - 2026-09-15
 
 ### 追加

package/README.md

@@ -918,7 +918,7 @@ new TssGrid(el, {
 });
 ```
 
-メソッド: `getData()` / `getRows()` / `getRow(r)` / `getColumn(cOrKey)` / `getColumns()` / `setData(rows)` / `appendRows(rows,opts?)`（**背景で"育てる"追記**＝data末尾に足し可視窓だけ再描画。buildTable全再描画せずスクロール位置・選択・編集中エディタを保ち履歴にも積まない。「先頭ページを描く→残りをidleでappendRows」でfirst-paintを早める土台。既存経路は不変のopt-in） / `setRowCount(total)` ＋ `fillRows(start,rows)`（**遅延ロード=on-demand**＝virtual前提。総件数を確保し未取得ぶんは「読込中」行、`onViewportChange(start,end)` で要る範囲を受け `fillRows` で実データを流し込む。sort/filterは遅延中ローカル計算せず `onSortFilterChange` でサーバ委譲、未取得セルは編集不可、export（getData/toCSV）はロード済みのみ＝AG Grid の Infinite Row Model 相当を push で） / `getValue(r,cOrKey)` / `setValue(r,cOrKey,val,force?)` / `setValueRaw(r,cOrKey,val)`（履歴に積まない派生値書き込み・計算列用） / `hideColumn(c)` / `showColumn(c)` / `toggleColumn(c)` / `isColumnHidden(c)` / `getHiddenColumns()` / `setAlignment(align,range?)` / `getAlignment(r,c)` / `setCellReadOnly(flag,range?)` / `autoSizeColumn(c)` / `autoSizeAllColumns()` / `sortBy(cOrKey, dir)` / `sortRows(cmp)` / `addShortcut(s)` / `removeShortcut(name)` / `usePlugin(fn)` / `getPlugin(name)` / `destroy()` / `setActive(r,c)` / `selectRow(r)` / `selectCol(c)` / `selectAll()` / `setColWidth(c,px)` / `setRowHeight(r,px)` / `freezeCols(n)` / `freezeRows(n)` / `moveRow(from,to)` / `moveRows(r0,r1,to)` / `clearSort()` / `toCSV(opts)` / `downloadCSV(name,opts)` / `insertRow(ri,'above'|'below')` / `insertRows(ri,count?,'above'|'below')`（count 行を1回の再描画・1 undo で一括挿入＝大量挿入が O(N)） / `deleteRows(r0,r1?)` / `insertCol(ci,'left'|'right')` / `deleteCols(c0,c1?)` / `redraw()`（列定義変更後の再描画, データ・選択は保持）ほか。
+メソッド: `getData()` / `getRows()` / `getRow(r)` / `getColumn(cOrKey)` / `getColumns()` / `setData(rows)` / `appendRows(rows,opts?)`（**背景で"育てる"追記**＝data末尾に足し可視窓だけ再描画。buildTable全再描画せずスクロール位置・選択・編集中エディタを保ち履歴にも積まない。「先頭ページを描く→残りをidleでappendRows」でfirst-paintを早める土台。既存経路は不変のopt-in） / `setRowCount(total)` ＋ `fillRows(start,rows)`（**遅延ロード=on-demand**＝virtual前提。総件数を確保し未取得ぶんは「読込中」行、`onViewportChange(start,end)` で要る範囲を受け `fillRows` で実データを流し込む。sort/filterは遅延中ローカル計算せず `onSortFilterChange` でサーバ委譲、未取得セルは編集不可、export（getData/toCSV）はロード済みのみ＝AG Grid の Infinite Row Model 相当を push で） / `getValue(r,cOrKey)` / `setValue(r,cOrKey,val,force?)` / `setValueRaw(r,cOrKey,val)`（履歴に積まない派生値書き込み・計算列用） / `hideColumn(c)` / `showColumn(c)` / `toggleColumn(c)` / `isColumnHidden(c)` / `getHiddenColumns()` / `setAlignment(align,range?)` / `getAlignment(r,c)` / `setCellReadOnly(flag,range?)` / `autoSizeColumn(c)` / `autoSizeAllColumns()` / `sortBy(cOrKey, dir)` / `sortRows(cmp)` / `addShortcut(s)` / `removeShortcut(name)` / `usePlugin(fn)` / `getPlugin(name)` / `destroy()` / `setActive(r,c)` / `scrollToRow(r, align?)`（**指定行までスクロール＝HTML の `#` アンカー相当**。`align` は `'start'`〔既定＝先頭・sticky ヘッダ直下〕/`'center'`/`'end'`/`'nearest'`〔可視ならそのまま〕。仮想・非仮想どちらでも動き、範囲外 `r` は自動クランプ。**選択は変えない**ので目印は `rowClass` 等を併用。例 `examples/scroll-to-row.html`） / `selectRow(r)` / `selectCol(c)` / `selectAll()` / `setColWidth(c,px)` / `setRowHeight(r,px)` / `freezeCols(n)` / `freezeRows(n)` / `moveRow(from,to)` / `moveRows(r0,r1,to)` / `clearSort()` / `toCSV(opts)` / `downloadCSV(name,opts)` / `insertRow(ri,'above'|'below')` / `insertRows(ri,count?,'above'|'below')`（count 行を1回の再描画・1 undo で一括挿入＝大量挿入が O(N)） / `deleteRows(r0,r1?)` / `insertCol(ci,'left'|'right')` / `deleteCols(c0,c1?)` / `redraw()`（列定義変更後の再描画, データ・選択は保持）ほか。
 
 ## イベント
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@threestarsoftware/tssgrid",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "軽量・ノービルド・日本語IME堅牢な編集グリッド（vanilla JS / 依存なし / MIT）。Excel ライクな入力画面を <script> タグ1本で。",
   "license": "MIT",
   "author": "ThreeStarSoftware (https://www.threestarsoftware.co.jp/)",

package/src/tssgrid.d.ts

@@ -399,6 +399,12 @@ export declare class TssGrid {
   selectRow(r: number): void;
   selectCol(c: number): void;
   selectAll(): void;
+  /**
+   * 指定行までスクロール（HTML の `#` アンカー相当・選択は変えない）。
+   * `align` は `'start'`（既定＝その行を先頭＝sticky ヘッダ直下へ）/ `'center'` / `'end'` / `'nearest'`（可視ならそのまま）。
+   * 仮想（均一行高）でも非仮想（可変行高・実DOM測定）でも動く。範囲外の `r` は自動でクランプ。
+   */
+  scrollToRow(r: number, align?: 'start' | 'center' | 'end' | 'nearest'): void;
   /** 選択中の列インデックス（Ctrl+ヘッダクリックの飛び飛び選択に対応・昇順）。列選択モードでなければ `[]`。 */
   getSelectedColumns(): number[];
   /** 選択中の行インデックス（Ctrl+行ヘッダクリックの飛び飛び選択に対応・昇順）。行選択モードでなければ `[]`。 */

package/src/tssgrid.js

@@ -1486,6 +1486,35 @@
       if (st !== cur) this.wrap.scrollTop = st;
       this._renderWindow(this._vWindow(), false);   // 窓を即同期（place 前に DOM を確定）
     }
+    // 指定行までスクロール（HTML の # アンカー相当）。align: 'start'(既定=先頭へ)/'center'/'end'/'nearest'。
+    // 仮想（均一行高）でも非仮想（実DOM・可変行高）でも動く。sticky ヘッダの下にちゃんと収める。
+    scrollToRow(r, align = 'start') {
+      if (!this.wrap || !this.ROWS) return;
+      r = Math.max(0, Math.min(this.ROWS - 1, Math.trunc(r || 0)));
+      if (align === 'nearest' && this.virtual) { this._vEnsureVisible(r); return; }   // 最小移動は既存ロジックに委譲
+      const head = this.colHeaders ? (this._theadH || 0) : 0;
+      const viewH = this.wrap.clientHeight || 400;
+      let top, rowH;
+      if (this.virtual) {
+        rowH = this.defRowH; top = r * rowH;   // 均一行高: content-top（sticky thead 直下が基準）
+      } else {
+        const tr = this.table && this.table.querySelector('tbody tr[data-r="' + r + '"]');
+        if (!tr) return;
+        const t = tr.getBoundingClientRect(), w = this.wrap.getBoundingClientRect();
+        rowH = t.height; top = t.top - w.top + this.wrap.scrollTop - head;   // 実DOMから測る（可変行高対応）
+      }
+      let st = top;   // start: 行を先頭（sticky thead 直下）へ
+      if (align === 'center') st = top - Math.max(0, (viewH - head - rowH) / 2);
+      else if (align === 'end') st = top - Math.max(0, viewH - head - rowH);
+      else if (align === 'nearest') {   // 非仮想の nearest: 既に可視なら動かさない
+        const vt = top - this.wrap.scrollTop;
+        if (vt >= 0 && vt + rowH <= viewH - head) return;
+        if (vt > 0) st = top - (viewH - head - rowH);   // 下にはみ出し→下端、上は top のまま
+      }
+      const max = this.wrap.scrollHeight - this.wrap.clientHeight;
+      this.wrap.scrollTop = Math.max(0, Math.min(st, max));
+      if (this.virtual) this._renderWindow(this._vWindow(), false);   // 窓を即同期
+    }
     buildTable() {
       if (this._renderPaused) { this._renderDirty = true; return; }   // バッチ描画中は最後にまとめて1回（_withBatchedRender）
       if (this._customEditor && this._customCancel) this._customCancel();   // 開いているカスタムエディタを閉じる（body直下ポップアップの取り残し防止・_commitActive と同じ扱い）