@threestarsoftware/tssgrid 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 TssGrid の各リリースの変更点。日付は JST。形式は [Keep a Changelog](https://keepachangelog.com/ja/1.1.0/) 準拠（ゆるめ）。
 数値は特記なき限り**自社調べ**（headless Chrome / Windows 11・環境差あり）。
 
+## [0.1.9] - 2026-09-15
+
+### 追加
+- **`rowClass(r, row, src)`（行ごとに `<tr>` へクラスを付与）**（コア）— 行の状態で**行まるごと色を付ける**のが素直に書けるオプション。`rowClass: (r, row) => row[3] === '欠品' ? 'row-ng' : ''` のように返したクラスが `<tr>` に付く（配列可）。CSS は `.tssgrid tr.row-ng > td { background:#fdecea }` の要領。従来は表全体版 `cellClass` で全 `<td>` に付けて代用していたが、**行単位はこちらが自然**。編集で行の状態が変わっても `_applyRowClass` で即追従。
+
+### 修正
+- **`cellClass` / `cellStyle` の型定義（`.d.ts`）が実装と食い違っていたのを修正**（型のみ・実行時は元から正しい）— (1) **列版**（`columns[c].cellClass`）は第1引数がそのセルの値で `(value, { r, c, row, src }) => クラス`。旧型は `(r, c, value, row) => string` で**引数順が逆**だった。(2) **表全体版**（`TssGridOptions.cellClass` = `(r, c, value, row, src)`）は**そもそも型に無かった**ので追加。`cellStyle` も同様に両方を修正。返り値も `string | string[] | false | null` 等を許容する `ClassValue`/`StyleValue` に。**影響は TypeScript / エディタ補完のみ**（生の JS・README・examples は元から正しい）。
+
 ## [0.1.8] - 2026-09-02
 
 ### 追加

package/README.md

@@ -1089,7 +1089,8 @@ columns: [
 cellClass: (r, c, value, row, src) => src.holiday_kbn === '1' ? 'sat' : '',  // 全体版（src=元レコード＝非表示フィールドも見える）
 // CSS は業務側で: .tssgrid td.tg-neg { color:#c00 } .tssgrid td.tg-row-ng { background:#fdecea }
 ```
-- 列版 `columns[c].cellClass(value, {r,c,row,src})` ／ 全体版 `cellClass(r,c,value,row,src)`。返り値は文字列／配列／空（クラス無し）。
+- 列版 `columns[c].cellClass(value, {r,c,row,src})` ／ 全体版 `cellClass(r,c,value,row,src)`。**引数順が違う**ので注意（列版は第1引数が値・全体版は先頭が r,c）。返り値は文字列／配列／空（クラス無し）。
+- **行に色を付けるなら `rowClass` が簡単**: `rowClass: (r, row, src) => 'row-ng'` で **`<tr>` に直接クラス**が付きます（全 td に付ける全体版 cellClass の代用より素直）。**その行のセルを編集すれば即追従**。CSS は `.tssgrid tr.row-ng > td { background:#fdecea }` のように行単位で当てます。
 - `src` は**元レコード**（オブジェクトデータ時）。**画面に出していない隠しフィールド基準の色付け**（勤怠の `holiday_kbn` で土日祝を色分け等）に使えます → 実例: [`examples/attendance.html`](https://tssgrid.threestarsoftware.co.jp/examples/attendance.html)。
 - **他列に依存する行ルール**（状態で行を色分け等）は、依存先の編集時に `grid.redraw()` で行全体を再評価（`onAfterChange: () => grid.redraw()`）。
 - 同じセルに行ルールとセルルールが両方付く場合は **CSSの記述順（後勝ち）**で優先を決めます（セル個別を後に書く）。

package/package.json

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

package/src/tssgrid.d.ts

@@ -25,6 +25,12 @@ export interface ChangeItem {
 /** 選択範囲。r0/c0=開始、r1/c1=終了（昇順とは限らない）。 */
 export interface SelectionRange { r0: number; c0: number; r1: number; c1: number; }
 export interface CellCoord { r: number; c: number; }
+/** cellClass/cellStyle（列版）が受け取る第2引数。row=その行の値配列, src=元レコード（object モード時・非表示フィールドも見える／配列モードは null）。 */
+export interface CellClassCtx { r: number; c: number; row: any[]; src: Record<string, any> | null; }
+/** cellClass/cellStyle の戻り値のクラス。文字列（空白区切り可）／配列／null 等（＝クラス無し）。 */
+export type ClassValue = string | string[] | null | undefined | false;
+/** cellStyle の戻り値。CSS プロパティのオブジェクト（`{'background':'#fde','--pct':'42%'}`）か文字列（`'background:#fde;--pct:42%'`）。 */
+export type StyleValue = string | Partial<CSSStyleDeclaration> | Record<string, string> | null | undefined;
 export interface SelectionInfo { range: SelectionRange; active: CellCoord; extent: CellCoord; }
 
 /** validator が弾いたセル（onInvalid / getInvalidCells）。 */
@@ -73,10 +79,11 @@ export interface ColumnDef {
   thousands?: boolean;
   /** 数値型: 接頭辞（例 '¥'）。 */
   prefix?: string;
-  /** 値/行を見てセルに付与する CSS クラス（条件付き書式）。 */
-  cellClass?: (r: number, c: number, value: any, row: any) => string;
-  /** セル単位のインラインスタイル（連続色・データバー等）。 */
-  cellStyle?: (r: number, c: number, value: any, row: any) => Partial<CSSStyleDeclaration> | Record<string, string>;
+  /** 値/行を見てセルに付与する CSS クラス（条件付き書式）。**引数は `(value, { r, c, row, src })`**（第1引数がそのセルの値）。
+   *  ＊表全体版は `TssGridOptions.cellClass`（引数順が違う: `(r, c, value, row, src)`）。 */
+  cellClass?: (value: any, cell: CellClassCtx) => ClassValue;
+  /** セル単位のインラインスタイル（連続色・データバー等）。**引数は `(value, { r, c, row, src })`**。 */
+  cellStyle?: (value: any, cell: CellClassCtx) => StyleValue;
   /** true で表示だけ生HTML（値はテキスト保存のまま）。 */
   html?: boolean;
   /** 列単位の折り返し。 */
@@ -105,6 +112,14 @@ export interface TssGridOptions {
   /** 入力フロー制御。Enter/Tab の移動先を上書き（null で既定方向）。入力セルだけ巡回できる。 */
   nextCell?: (a: { r: number; c: number; key: string; shift: boolean }) => { r: number; c: number } | null;
   columns?: ColumnDef[];
+  /** 表全体の条件付きクラス（全セルで呼ばれる）。**引数は `(r, c, value, row, src)`**（先頭が行/列番号・列版と順序が違う）。
+   *  `row`=その行の値配列, `src`=元レコード（object モード時・非表示フィールドも見える）。行に色を付けたいなら `rowClass` の方が簡単。 */
+  cellClass?: (r: number, c: number, value: any, row: any[], src: Record<string, any> | null) => ClassValue;
+  /** 表全体のセル単位インラインスタイル。**引数は `(r, c, value, row, src)`**。返り値は CSS オブジェクト or 文字列。 */
+  cellStyle?: (r: number, c: number, value: any, row: any[], src: Record<string, any> | null) => StyleValue;
+  /** 行ごとに `<tr>` へ付与する CSS クラス（**行に色を付けるならこれ**）。`(r, row, src)` で呼ばれ、文字列/配列を返す。
+   *  編集でセルが再描画されると即追従。CSS は `.tssgrid tr.クラス > td { … }` のように行単位で当てる。 */
+  rowClass?: (r: number, row: any[], src: Record<string, any> | null) => ClassValue;
   /** 検証NG時。'revert'=元に戻す / 'keep'=赤く警告して残す。 */
   invalidMode?: 'revert' | 'keep';
   invalidTitle?: boolean;

package/src/tssgrid.js

@@ -266,6 +266,9 @@
       // セル単位インラインスタイル: cellStyle(r,c,value,row,src)→{CSSプロパティ} or 'k:v;…'。列版 columns[c].cellStyle(value,{r,c,row,src})。
       // クラス（離散）では出せない連続色・データバー幅(CSS変数)向け。例: cellStyle:(r,c,v)=>({background:heat(v)})
       this.cellStyle = opts.cellStyle || null;
+      // 行ごとに <tr> へ付けるクラス（行の色付け向け）。rowClass(r, row, src)→クラス文字列/配列。
+      // 全体版 cellClass でも代用できるが（全 td に付く）、行単位はこちらが素直。編集で再描画時に追従（_applyRowClass）。
+      this.rowClass = opts.rowClass || null;
       // 列の非表示（描画で畳む＋移動/幅/コピーは隠し列をスキップ）。実行時は hideColumn/showColumn。
       this.hiddenCols = new Set((opts.hiddenColumns || []).map(Number));
       // セル単位の可変状態（キー "r,c"）。整列 / 実行時 readOnly。構造変更で _structCmd がキー追従。
@@ -1154,6 +1157,21 @@
       for (const k of next) td.classList.add(k);
       if (next.length) td.dataset.ccls = next.join(' '); else delete td.dataset.ccls;
     }
+    // 行クラス: rowClass(r, row, src) → 空白区切り文字列（配列は join）。無効/例外は ''。
+    _rowClassStr(r) {
+      if (typeof this.rowClass !== 'function') return '';
+      try { const x = this.rowClass(r, this.data[r], this._src ? this._src[r] : null); return x ? (Array.isArray(x) ? x.filter(Boolean).join(' ') : String(x).trim()) : ''; } catch (_) { return ''; }
+    }
+    // <tr> の行クラスを反映（前回分 data-rcls を外して付け直す＝セル再描画で追従）。
+    _applyRowClass(r) {
+      const tr = this.table && this.table.querySelector('tbody tr[data-r="' + r + '"]');
+      if (!tr) return;
+      const prev = tr.dataset.rcls ? tr.dataset.rcls.split(/\s+/) : [];
+      for (const k of prev) if (k) tr.classList.remove(k);
+      const next = this._rowClassStr(r);
+      if (next) { for (const k of next.split(/\s+/)) if (k) tr.classList.add(k); tr.dataset.rcls = next; }
+      else delete tr.dataset.rcls;
+    }
     // セル単位のインラインスタイル: 列版 columns[c].cellStyle(value,{r,c,row,src}) ＋ 全体版 cellStyle(r,c,value,row,src)。
     // 返り値は CSSプロパティのオブジェクト {'background':'#fde','--pct':'42%'} か文字列 'background:#fde;--pct:42%'。
     // cellClass（クラス＝離散）では出せない**連続値の背景色・データバー幅（CSS変数）**などに（プロパティ名は kebab/標準名 or --var）。
@@ -1193,6 +1211,7 @@
       }
       if (this.cellClass || this.colCfg(c).cellClass) this._applyCellClass(td, r, c);   // 条件付き書式
       if (this.cellStyle || this.colCfg(c).cellStyle) this._applyCellStyle(td, r, c);   // セル単位インラインスタイル
+      if (this.rowClass) this._applyRowClass(r);   // 行クラス（編集で行の色付けが即追従）
     }
 
     _colWidth(c) { return this.colW[c] != null ? this.colW[c] : this.defColW; }
@@ -1373,7 +1392,8 @@
       const inner = after ? (lbl + mark) : (mark + lbl);   // ⠿ を番号の前/後に（rowReorderMark）。番号なしは前後どちらでも中央
       const rhCls = (canMove && this.rowReorderWhole) ? ' tg-rowmove-cell' : '';   // 'header'=行ヘッダーセル全体を掴み手に（grab カーソル）。番号/⠿の表示は独立
       const rcls = (r < this.frozenRows) ? (' tg-frozen-row' + (r === this.frozenRows - 1 ? ' tg-frozen-row-edge' : '')) : '';   // 行固定
-      let html = '<tr data-r="' + r + '" class="tg-row' + rcls + '" style="height:' + this._rowHeight(r) + 'px">' + (rh ? '<th class="rowhead' + rhCls + '" data-r="' + r + '">' + inner + rgrip + '</th>' : '');
+      const rowc = this.rowClass ? this._rowClassStr(r) : '';   // 行クラス（rowClass）＝<tr> に付与
+      let html = '<tr data-r="' + r + '" class="tg-row' + rcls + (rowc ? ' ' + rowc : '') + '"' + (rowc ? ' data-rcls="' + TssGrid.esc(rowc) + '"' : '') + ' style="height:' + this._rowHeight(r) + 'px">' + (rh ? '<th class="rowhead' + rhCls + '" data-r="' + r + '">' + inner + rgrip + '</th>' : '');
       for (let c = 0; c < this.COLS; c++) {
         if (this._merges && this._isCovered(r, c)) continue;   // 結合に覆われた従属セルは td を出さない（アンカーが colspan で覆う）
         const cs = this._merges ? this._colspanAt(r, c) : 1;   // 結合アンカーは colspan で従属列ぶんを覆う