ng-hub-ui-spreadsheet 22.4.0 → 22.6.0

package/README.md

@@ -179,6 +179,14 @@ A column says what it is called and how to get a cell out of a row:
 
 **Why two names.** Make the visible name the key and renaming a column means rewriting every reference to it — the mistake Excel made, and the reason a renamed column there breaks formulas across the workbook. Keep them apart and a rename is a rename.
 
+A column can also **hint at an empty cell**: `placeholder` is shown while the pointer rests on a cell that holds nothing, never in place of a value. A **cell can carry one of its own**, for the row where the column's hint would not tell the truth:
+
+```typescript
+cell: (row) => ({ value: row.due, editable: true, placeholder: row.id === 'c' ? 'after the cabling' : null })
+```
+
+Left out or `null`, the column's placeholder is used.
+
 Read the sheet back as plain data keyed by alias:
 
 ```typescript
@@ -205,6 +213,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