@acorex/components 22.1.0-next.15 → 22.1.0-next.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lookup/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @acorex/components/lookup
2
2
 
3
- An advanced drop-down (lookup) component with five modes, `AXDataSource` support, and virtual scrolling.
3
+ An advanced drop-down (lookup) component with six modes, `AXDataSource` support, and virtual scrolling.
4
4
 
5
5
  ## Modes
6
6
 
@@ -11,6 +11,7 @@ An advanced drop-down (lookup) component with five modes, `AXDataSource` support
11
11
  | `drop-down-tree` | A tree-like structure for single item selection. |
12
12
  | `multi-select-tree` | A tree-like structure for multiple item selection. |
13
13
  | `multi-column` | An `ax-data-table` grid; further pages load on scroll. |
14
+ | `multi-column-tree` | A multi-column table with a drop-down tree inside it (expandable rows). |
14
15
 
15
16
  ## Usage
16
17
 
@@ -42,22 +43,32 @@ import { AXDataSource } from '@acorex/cdk/common';
42
43
 
43
44
  <!-- MultiColumnComboBox -->
44
45
  <ax-lookup mode="multi-column" [dataSource]="items" [columns]="columns" [(ngModel)]="selected"></ax-lookup>
46
+
47
+ <!-- MultiColumnTree (table + expandable tree) -->
48
+ <ax-lookup
49
+ mode="multi-column-tree"
50
+ [treeDataSource]="nodes"
51
+ [columns]="columns"
52
+ textField="title"
53
+ [(ngModel)]="selectedNode"
54
+ ></ax-lookup>
45
55
  ```
46
56
 
47
57
  Value binding uses the signal `value` model (`FormValueControl`) — prefer `[(ngModel)]` (or `[(value)]` / signal forms). No `ControlValueAccessor`.
48
58
 
49
- - `dataSource`: `AXDataSource` or a plain array (list and multi-column modes). Supports remote paging, `byKey` value resolution, and server-side filtering.
59
+ - `dataSource`: `AXDataSource` or a plain array (list and multi-column modes). Supports remote paging, `byKey` value resolution, and server-side filtering. Also used by `multi-column-tree` when `treeDataSource` is not set (hierarchical load via `treeParentField`).
50
60
  - `valueItems`: full items that resolve the current `value` key(s) without calling `byKey` (useful when the parent already loaded the selected entity). Missing keys still fall through to `find` / `byKey`. You can also call `seedItems(items)` imperatively.
51
- - `treeDataSource`: node array or lazy children callback (tree modes).
61
+ - `treeDataSource`: node array or lazy children callback (tree modes, including `multi-column-tree`).
52
62
  - `valueField` / `textField` / `disabledField`: field mappings. For tree modes these map to the tree `idField` / `titleField`.
53
- - `columns`: column definitions (`{ field, title, width? }`) for `multi-column` mode (mapped to `ax-text-column`).
54
- - `searchable`: when `true` (default), the trigger accepts typing and filters the list (`drop-down-list`, `multi-select`, `multi-column`). When `false`, the trigger is select-only. Tree modes have no search UI.
63
+ - `columns`: column definitions (`{ field, title, width?, expandHandler? }`) for `multi-column` and `multi-column-tree` (mapped to `ax-text-column`).
64
+ - `treeParentField` / `hasChildrenField`: hierarchy fields for `multi-column-tree` (defaults `parentId` / `hasChild`).
65
+ - `searchable`: when `true` (default), the trigger accepts typing and filters the list (`drop-down-list`, `multi-select`, `multi-column`, `multi-column-tree`). When `false`, the trigger is select-only. `drop-down-tree` / `multi-select-tree` have no search UI.
55
66
  - `adaptivityEnabled`: when `true` (default), the list opens as a bottom actionsheet on small screens instead of a dropdown; set `false` to always use the anchored dropdown.
56
67
  - `caption`: title shown in the actionsheet header (falls back to `placeholder`).
57
- - `alternate`: when `true`, list rows use alternating background colors for easier scanning (`drop-down-list`, `multi-select`, `multi-column`).
68
+ - `alternate`: when `true`, list rows use alternating background colors for easier scanning (`drop-down-list`, `multi-select`, `multi-column`, `multi-column-tree`).
58
69
  - `searchPlaceholder`: placeholder for the multi-select trigger search input when chips are already selected.
59
70
  - `itemHeight` / `maxVisibleItems`: list virtual-scroll sizing, and multi-column table viewport height (multi-column loads more pages on scroll, not via a pager).
60
71
  - `look`: the same editor-container look schemes as other editors like `ax-text-box`.
61
72
  - `ax-prefix` / `ax-suffix`: project decorators into the editor container.
62
73
 
63
- Each mode is rendered by its own internal mini component (`ax-lookup-drop-down-list`, `ax-lookup-multi-select`, `ax-lookup-drop-down-tree`, `ax-lookup-multi-select-tree`, `ax-lookup-multi-column`), all exported for direct use.
74
+ Each mode is rendered by its own internal mini component (`ax-lookup-drop-down-list`, `ax-lookup-multi-select`, `ax-lookup-drop-down-tree`, `ax-lookup-multi-select-tree`, `ax-lookup-multi-column`, `ax-lookup-multi-column-tree`), all exported for direct use.
package/package.json CHANGED
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "name": "@acorex/components",
3
- "version": "22.1.0-next.15",
3
+ "version": "22.1.0-next.16",
4
4
  "peerDependencies": {
5
- "@acorex/core": "22.1.0-next.15",
6
- "@acorex/cdk": "22.1.0-next.15",
5
+ "@acorex/core": "22.1.0-next.16",
6
+ "@acorex/cdk": "22.1.0-next.16",
7
7
  "@angular/aria": ">=22.1.0",
8
8
  "polytype": ">=0.17.0",
9
9
  "angular-imask": ">=7.6.1",