ng-hub-ui-spreadsheet 22.4.0 → 22.5.0

package/README.md

@@ -205,6 +205,27 @@ what keeps `Enter` for the cell:
 itself. An editable cell keeps `Enter` for editing, and the clipboard still carries the value rather
 than the drawing.
 
+`hubSpreadsheetCellAction` may also be **a function of the row**, for a column where only some cells
+open — a product whose folded row opens its variants while its own row is only read:
+
+```html
+<ng-template
+	hubSpreadsheetCell="name"
+	[hubSpreadsheetCellRows]="products()"
+	[hubSpreadsheetCellAction]="opensItsVariants"
+	let-row="row"
+	let-open="open"
+>
+	@if (opensItsVariants(row)) {
+		<a (click)="open()">{{ row.name }}</a>
+	} @else {
+		{{ row.name }}
+	}
+</ng-template>
+```
+
+Then `Enter` opens the rows the function answers for, and leaves every other cell the sheet's.
+
 For a cell that opens the row's own detail, put the detail in an `expansion` template and let `expandedRow` name the open row:
 
 ```html

package/fesm2022/ng-hub-ui-spreadsheet.mjs

@@ -523,13 +523,17 @@ class HubSpreadsheetCellDirective {
      */
     rows = input([], { ...(ngDevMode ? { debugName: "rows" } : /* istanbul ignore next */ {}), alias: 'hubSpreadsheetCellRows' });
     /**
-     * The accessible name of the way in, when the cells of this column open onto something rather
-     * than being typed into.
+     * Whether the cells of this column open onto something rather than being typed into, and the
+     * accessible name of the way in.
      *
-     * Given, the sheet keeps `Enter` for the cell instead of opening an editor the cell has not
-     * got, and reports the press through `opened`; the template draws the way in itself — a link,
-     * a button — and calls `open()` from its context. Left out, the cell is only read or typed
-     * into, and `Enter` does what the sheet would have done on its own.
+     * A string means the whole column opens. A function answers per row, for a column where only
+     * some cells do — a product whose folded row opens its variants while its own row is typed
+     * into, a figure that opens the tiers behind it while the cells beside it are edited.
+     *
+     * Either way the sheet keeps `Enter` for a cell that opens instead of opening an editor the
+     * cell has not got, and reports the press through `opened`; the template draws the way in
+     * itself — a link, a button — and calls `open()` from its context. Left out, the cell is only
+     * read or typed into, and `Enter` does what the sheet would have done on its own.
      */
     action = input('', { ...(ngDevMode ? { debugName: "action" } : /* istanbul ignore next */ {}), alias: 'hubSpreadsheetCellAction' });
     template = inject(TemplateRef);
@@ -3539,14 +3543,16 @@ class HubSpreadsheetComponent {
         this.expandedRow.set(null);
     }
     /**
-     * Whether this column's cells open onto something rather than being typed into.
+     * Whether a cell opens onto something rather than being typed into.
      *
-     * A cell template says so with `hubSpreadsheetCellAction`, and only the template does: the
-     * sheet draws nothing itself, but it has to know, because it is what keeps `Enter` for the
-     * cell instead of opening an editor the cell has not got.
+     * A cell template says so — with a name for the whole column, or a function that answers per
+     * row — and only the template does: the sheet draws nothing itself, but it has to know,
+     * because it is what keeps `Enter` for the cell instead of opening an editor the cell has not
+     * got.
      */
-    cellOpens(col) {
-        return !!this.cellTemplateFor(col)?.action();
+    cellOpens(row, col) {
+        const action = this.cellTemplateFor(col)?.action();
+        return typeof action === 'function' ? action(this.rows()[row]) : !!action;
     }
     /** Reports that the reader asked to open what a cell points at. */
     openCell(row, col) {
@@ -3667,7 +3673,7 @@ class HubSpreadsheetComponent {
                 // A cell that opens onto something, with no field to write in, answers Enter with
                 // that rather than with an editor it does not have. Typing a character is left
                 // alone: such a cell holds no value to write over.
-                if (!intent.seed && !this.canEdit(active.row, active.col) && this.cellOpens(active.col)) {
+                if (!intent.seed && !this.canEdit(active.row, active.col) && this.cellOpens(active.row, active.col)) {
                     this.openCell(active.row, active.col);
                     break;
                 }