@tectra-ng/ui 0.1.3 → 0.1.5
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/accordion/README.md +61 -0
- package/breadcrumb/README.md +57 -0
- package/carousel/README.md +53 -0
- package/fesm2022/tectra-ng-ui-accordion.mjs +980 -0
- package/fesm2022/tectra-ng-ui-accordion.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-autocomplete.mjs +2 -2
- package/fesm2022/tectra-ng-ui-autocomplete.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-breadcrumb.mjs +382 -0
- package/fesm2022/tectra-ng-ui-breadcrumb.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-carousel.mjs +939 -0
- package/fesm2022/tectra-ng-ui-carousel.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-cascade-select.mjs +2 -2
- package/fesm2022/tectra-ng-ui-cascade-select.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-chips-input.mjs +2 -2
- package/fesm2022/tectra-ng-ui-chips-input.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-color-picker.mjs +2 -2
- package/fesm2022/tectra-ng-ui-color-picker.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-field.mjs +1 -1
- package/fesm2022/tectra-ng-ui-field.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-file-upload.mjs +1452 -0
- package/fesm2022/tectra-ng-ui-file-upload.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-galleria.mjs +1140 -0
- package/fesm2022/tectra-ng-ui-galleria.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-image.mjs +759 -0
- package/fesm2022/tectra-ng-ui-image.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-input-group.mjs +2 -2
- package/fesm2022/tectra-ng-ui-input-group.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-input.mjs +2 -2
- package/fesm2022/tectra-ng-ui-input.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-listbox.mjs +2 -2
- package/fesm2022/tectra-ng-ui-listbox.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-menubar.mjs +742 -0
- package/fesm2022/tectra-ng-ui-menubar.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-multiselect.mjs +2 -2
- package/fesm2022/tectra-ng-ui-multiselect.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-panel-menu.mjs +610 -0
- package/fesm2022/tectra-ng-ui-panel-menu.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-scroll-panel.mjs +319 -0
- package/fesm2022/tectra-ng-ui-scroll-panel.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-select.mjs +2 -2
- package/fesm2022/tectra-ng-ui-select.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-splitter.mjs +750 -0
- package/fesm2022/tectra-ng-ui-splitter.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-stepper.mjs +1166 -0
- package/fesm2022/tectra-ng-ui-stepper.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-table.mjs +194 -50
- package/fesm2022/tectra-ng-ui-table.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-tabs.mjs +1218 -0
- package/fesm2022/tectra-ng-ui-tabs.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-textarea.mjs +4 -1
- package/fesm2022/tectra-ng-ui-textarea.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-toolbar.mjs +348 -0
- package/fesm2022/tectra-ng-ui-toolbar.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-tree-select.mjs +2 -2
- package/fesm2022/tectra-ng-ui-tree-select.mjs.map +1 -1
- package/fesm2022/tectra-ng-ui-tree-table.mjs +80 -2
- package/fesm2022/tectra-ng-ui-tree-table.mjs.map +1 -1
- package/field/README.md +1 -1
- package/file-upload/README.md +85 -0
- package/galleria/README.md +62 -0
- package/image/README.md +54 -0
- package/menubar/README.md +51 -0
- package/package.json +56 -4
- package/panel-menu/README.md +45 -0
- package/scroll-panel/README.md +35 -0
- package/splitter/README.md +62 -0
- package/stepper/README.md +66 -0
- package/table/README.md +1 -1
- package/tabs/README.md +69 -0
- package/toolbar/README.md +35 -0
- package/types/tectra-ng-ui-accordion.d.ts +304 -0
- package/types/tectra-ng-ui-accordion.d.ts.map +1 -0
- package/types/tectra-ng-ui-breadcrumb.d.ts +157 -0
- package/types/tectra-ng-ui-breadcrumb.d.ts.map +1 -0
- package/types/tectra-ng-ui-carousel.d.ts +263 -0
- package/types/tectra-ng-ui-carousel.d.ts.map +1 -0
- package/types/tectra-ng-ui-file-upload.d.ts +527 -0
- package/types/tectra-ng-ui-file-upload.d.ts.map +1 -0
- package/types/tectra-ng-ui-galleria.d.ts +407 -0
- package/types/tectra-ng-ui-galleria.d.ts.map +1 -0
- package/types/tectra-ng-ui-image.d.ts +259 -0
- package/types/tectra-ng-ui-image.d.ts.map +1 -0
- package/types/tectra-ng-ui-menubar.d.ts +201 -0
- package/types/tectra-ng-ui-menubar.d.ts.map +1 -0
- package/types/tectra-ng-ui-panel-menu.d.ts +244 -0
- package/types/tectra-ng-ui-panel-menu.d.ts.map +1 -0
- package/types/tectra-ng-ui-scroll-panel.d.ts +94 -0
- package/types/tectra-ng-ui-scroll-panel.d.ts.map +1 -0
- package/types/tectra-ng-ui-splitter.d.ts +226 -0
- package/types/tectra-ng-ui-splitter.d.ts.map +1 -0
- package/types/tectra-ng-ui-stepper.d.ts +446 -0
- package/types/tectra-ng-ui-stepper.d.ts.map +1 -0
- package/types/tectra-ng-ui-table.d.ts +2 -4
- package/types/tectra-ng-ui-table.d.ts.map +1 -1
- package/types/tectra-ng-ui-tabs.d.ts +420 -0
- package/types/tectra-ng-ui-tabs.d.ts.map +1 -0
- package/types/tectra-ng-ui-textarea.d.ts +1 -0
- package/types/tectra-ng-ui-textarea.d.ts.map +1 -1
- package/types/tectra-ng-ui-toolbar.d.ts +85 -0
- package/types/tectra-ng-ui-toolbar.d.ts.map +1 -0
- package/types/tectra-ng-ui-tree-table.d.ts.map +1 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tectra-ng/ui",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.5",
|
|
4
4
|
"description": "Angular UI components for tectra: signals, OnPush, accessible and themable, one entry point per component.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"homepage": "https://tectra-ng.com",
|
|
@@ -25,9 +25,9 @@
|
|
|
25
25
|
"@angular/forms": "^22.0.0",
|
|
26
26
|
"@angular/router": "^22.0.0",
|
|
27
27
|
"rxjs": "^7.8.0",
|
|
28
|
-
"@tectra-ng/core": "^0.1.
|
|
29
|
-
"@tectra-ng/icons": "^0.1.
|
|
30
|
-
"@tectra-ng/themes": "^0.1.
|
|
28
|
+
"@tectra-ng/core": "^0.1.5",
|
|
29
|
+
"@tectra-ng/icons": "^0.1.5",
|
|
30
|
+
"@tectra-ng/themes": "^0.1.5"
|
|
31
31
|
},
|
|
32
32
|
"peerDependenciesMeta": {
|
|
33
33
|
"@angular/router": {
|
|
@@ -47,6 +47,10 @@
|
|
|
47
47
|
"types": "./types/tectra-ng-ui.d.ts",
|
|
48
48
|
"default": "./fesm2022/tectra-ng-ui.mjs"
|
|
49
49
|
},
|
|
50
|
+
"./accordion": {
|
|
51
|
+
"types": "./types/tectra-ng-ui-accordion.d.ts",
|
|
52
|
+
"default": "./fesm2022/tectra-ng-ui-accordion.mjs"
|
|
53
|
+
},
|
|
50
54
|
"./amount": {
|
|
51
55
|
"types": "./types/tectra-ng-ui-amount.d.ts",
|
|
52
56
|
"default": "./fesm2022/tectra-ng-ui-amount.mjs"
|
|
@@ -67,6 +71,10 @@
|
|
|
67
71
|
"types": "./types/tectra-ng-ui-badge.d.ts",
|
|
68
72
|
"default": "./fesm2022/tectra-ng-ui-badge.mjs"
|
|
69
73
|
},
|
|
74
|
+
"./breadcrumb": {
|
|
75
|
+
"types": "./types/tectra-ng-ui-breadcrumb.d.ts",
|
|
76
|
+
"default": "./fesm2022/tectra-ng-ui-breadcrumb.mjs"
|
|
77
|
+
},
|
|
70
78
|
"./button": {
|
|
71
79
|
"types": "./types/tectra-ng-ui-button.d.ts",
|
|
72
80
|
"default": "./fesm2022/tectra-ng-ui-button.mjs"
|
|
@@ -79,6 +87,10 @@
|
|
|
79
87
|
"types": "./types/tectra-ng-ui-card.d.ts",
|
|
80
88
|
"default": "./fesm2022/tectra-ng-ui-card.mjs"
|
|
81
89
|
},
|
|
90
|
+
"./carousel": {
|
|
91
|
+
"types": "./types/tectra-ng-ui-carousel.d.ts",
|
|
92
|
+
"default": "./fesm2022/tectra-ng-ui-carousel.mjs"
|
|
93
|
+
},
|
|
82
94
|
"./cascade-select": {
|
|
83
95
|
"types": "./types/tectra-ng-ui-cascade-select.d.ts",
|
|
84
96
|
"default": "./fesm2022/tectra-ng-ui-cascade-select.mjs"
|
|
@@ -155,6 +167,14 @@
|
|
|
155
167
|
"types": "./types/tectra-ng-ui-fieldset.d.ts",
|
|
156
168
|
"default": "./fesm2022/tectra-ng-ui-fieldset.mjs"
|
|
157
169
|
},
|
|
170
|
+
"./file-upload": {
|
|
171
|
+
"types": "./types/tectra-ng-ui-file-upload.d.ts",
|
|
172
|
+
"default": "./fesm2022/tectra-ng-ui-file-upload.mjs"
|
|
173
|
+
},
|
|
174
|
+
"./galleria": {
|
|
175
|
+
"types": "./types/tectra-ng-ui-galleria.d.ts",
|
|
176
|
+
"default": "./fesm2022/tectra-ng-ui-galleria.mjs"
|
|
177
|
+
},
|
|
158
178
|
"./highlight-text": {
|
|
159
179
|
"types": "./types/tectra-ng-ui-highlight-text.d.ts",
|
|
160
180
|
"default": "./fesm2022/tectra-ng-ui-highlight-text.mjs"
|
|
@@ -163,6 +183,10 @@
|
|
|
163
183
|
"types": "./types/tectra-ng-ui-icon-field.d.ts",
|
|
164
184
|
"default": "./fesm2022/tectra-ng-ui-icon-field.mjs"
|
|
165
185
|
},
|
|
186
|
+
"./image": {
|
|
187
|
+
"types": "./types/tectra-ng-ui-image.d.ts",
|
|
188
|
+
"default": "./fesm2022/tectra-ng-ui-image.mjs"
|
|
189
|
+
},
|
|
166
190
|
"./input": {
|
|
167
191
|
"types": "./types/tectra-ng-ui-input.d.ts",
|
|
168
192
|
"default": "./fesm2022/tectra-ng-ui-input.mjs"
|
|
@@ -211,6 +235,10 @@
|
|
|
211
235
|
"types": "./types/tectra-ng-ui-menu.d.ts",
|
|
212
236
|
"default": "./fesm2022/tectra-ng-ui-menu.mjs"
|
|
213
237
|
},
|
|
238
|
+
"./menubar": {
|
|
239
|
+
"types": "./types/tectra-ng-ui-menubar.d.ts",
|
|
240
|
+
"default": "./fesm2022/tectra-ng-ui-menubar.mjs"
|
|
241
|
+
},
|
|
214
242
|
"./message": {
|
|
215
243
|
"types": "./types/tectra-ng-ui-message.d.ts",
|
|
216
244
|
"default": "./fesm2022/tectra-ng-ui-message.mjs"
|
|
@@ -235,6 +263,10 @@
|
|
|
235
263
|
"types": "./types/tectra-ng-ui-panel.d.ts",
|
|
236
264
|
"default": "./fesm2022/tectra-ng-ui-panel.mjs"
|
|
237
265
|
},
|
|
266
|
+
"./panel-menu": {
|
|
267
|
+
"types": "./types/tectra-ng-ui-panel-menu.d.ts",
|
|
268
|
+
"default": "./fesm2022/tectra-ng-ui-panel-menu.mjs"
|
|
269
|
+
},
|
|
238
270
|
"./password": {
|
|
239
271
|
"types": "./types/tectra-ng-ui-password.d.ts",
|
|
240
272
|
"default": "./fesm2022/tectra-ng-ui-password.mjs"
|
|
@@ -267,6 +299,10 @@
|
|
|
267
299
|
"types": "./types/tectra-ng-ui-rating.d.ts",
|
|
268
300
|
"default": "./fesm2022/tectra-ng-ui-rating.mjs"
|
|
269
301
|
},
|
|
302
|
+
"./scroll-panel": {
|
|
303
|
+
"types": "./types/tectra-ng-ui-scroll-panel.d.ts",
|
|
304
|
+
"default": "./fesm2022/tectra-ng-ui-scroll-panel.mjs"
|
|
305
|
+
},
|
|
270
306
|
"./select": {
|
|
271
307
|
"types": "./types/tectra-ng-ui-select.d.ts",
|
|
272
308
|
"default": "./fesm2022/tectra-ng-ui-select.mjs"
|
|
@@ -291,6 +327,10 @@
|
|
|
291
327
|
"types": "./types/tectra-ng-ui-split-button.d.ts",
|
|
292
328
|
"default": "./fesm2022/tectra-ng-ui-split-button.mjs"
|
|
293
329
|
},
|
|
330
|
+
"./splitter": {
|
|
331
|
+
"types": "./types/tectra-ng-ui-splitter.d.ts",
|
|
332
|
+
"default": "./fesm2022/tectra-ng-ui-splitter.mjs"
|
|
333
|
+
},
|
|
294
334
|
"./stat-tiles": {
|
|
295
335
|
"types": "./types/tectra-ng-ui-stat-tiles.d.ts",
|
|
296
336
|
"default": "./fesm2022/tectra-ng-ui-stat-tiles.mjs"
|
|
@@ -299,10 +339,18 @@
|
|
|
299
339
|
"types": "./types/tectra-ng-ui-status-icon.d.ts",
|
|
300
340
|
"default": "./fesm2022/tectra-ng-ui-status-icon.mjs"
|
|
301
341
|
},
|
|
342
|
+
"./stepper": {
|
|
343
|
+
"types": "./types/tectra-ng-ui-stepper.d.ts",
|
|
344
|
+
"default": "./fesm2022/tectra-ng-ui-stepper.mjs"
|
|
345
|
+
},
|
|
302
346
|
"./table": {
|
|
303
347
|
"types": "./types/tectra-ng-ui-table.d.ts",
|
|
304
348
|
"default": "./fesm2022/tectra-ng-ui-table.mjs"
|
|
305
349
|
},
|
|
350
|
+
"./tabs": {
|
|
351
|
+
"types": "./types/tectra-ng-ui-tabs.d.ts",
|
|
352
|
+
"default": "./fesm2022/tectra-ng-ui-tabs.mjs"
|
|
353
|
+
},
|
|
306
354
|
"./tag": {
|
|
307
355
|
"types": "./types/tectra-ng-ui-tag.d.ts",
|
|
308
356
|
"default": "./fesm2022/tectra-ng-ui-tag.mjs"
|
|
@@ -327,6 +375,10 @@
|
|
|
327
375
|
"types": "./types/tectra-ng-ui-toggle-switch.d.ts",
|
|
328
376
|
"default": "./fesm2022/tectra-ng-ui-toggle-switch.mjs"
|
|
329
377
|
},
|
|
378
|
+
"./toolbar": {
|
|
379
|
+
"types": "./types/tectra-ng-ui-toolbar.d.ts",
|
|
380
|
+
"default": "./fesm2022/tectra-ng-ui-toolbar.mjs"
|
|
381
|
+
},
|
|
330
382
|
"./tooltip": {
|
|
331
383
|
"types": "./types/tectra-ng-ui-tooltip.d.ts",
|
|
332
384
|
"default": "./fesm2022/tectra-ng-ui-tooltip.mjs"
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# Panel menu
|
|
2
|
+
|
|
3
|
+
A vertical menu of collapsible sections for app navigation. Two looks: `panel` (each root item is a bordered panel with a toggle header) and `sidebar` (root items are section titles above their links — the app sidebar). Nested items open in place with an animation; the item of the current route is highlighted and its parents open.
|
|
4
|
+
|
|
5
|
+
```html
|
|
6
|
+
<tx-panel-menu [model]="items" />
|
|
7
|
+
<tx-panel-menu variant="sidebar" ariaLabel="Main" [model]="navigation" [(expandedKeys)]="open" />
|
|
8
|
+
```
|
|
9
|
+
|
|
10
|
+
Items are `TxPanelMenuItem` — the kit menu item (`label`, `icon`, `routerLink`, `queryParams`, `fragment`, `url`, `target`, `command`, `disabled`, `visible`, `separator`, `badge`, `title`, `items`, `id`) plus `expanded` (open at the start) and `routerLinkActiveOptions` (`{ exact: true }` or router match options; a subset match by default).
|
|
11
|
+
|
|
12
|
+
## Inputs
|
|
13
|
+
| Name | Description |
|
|
14
|
+
|---|---|
|
|
15
|
+
| model | The items, `TxPanelMenuItem[]` |
|
|
16
|
+
| variant | `panel` or `sidebar` |
|
|
17
|
+
| multiple | Several branches can be open at once; off, opening one closes its siblings (root panels in `panel`, every level in `sidebar`) |
|
|
18
|
+
| expandedKeys | Two-way: the open items, `{ [key]: boolean }`; a key is the item `id` or its index path (`0-1-2`) |
|
|
19
|
+
| badgeMax | `sidebar`: numbers above it show as `99+` (zero and less are hidden) |
|
|
20
|
+
| ariaLabel | Makes the menu a `navigation` landmark with this name |
|
|
21
|
+
| dt | Design tokens of this instance (`panelMenu`) |
|
|
22
|
+
| pt | Classes and styles of the parts: `root`, `panel`, `header`, `section`, `tree`, `item`, `icon`, `label`, `badge`, `lock`, `submenuIcon`, `separator` |
|
|
23
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
24
|
+
| unstyled | Removes the tectra styles |
|
|
25
|
+
|
|
26
|
+
## Outputs
|
|
27
|
+
| Name | Description |
|
|
28
|
+
|---|---|
|
|
29
|
+
| expandedKeysChange | An item was opened or closed, or the route opened its parents |
|
|
30
|
+
| itemClick | An item was clicked: `{ item, originalEvent }` (after its `command`) |
|
|
31
|
+
|
|
32
|
+
## Slots
|
|
33
|
+
| Name | Description |
|
|
34
|
+
|---|---|
|
|
35
|
+
| txPanelMenuItem | `<ng-template txPanelMenuItem let-item let-level="level" let-active="active" let-expanded="expanded" let-hasSubmenu="hasSubmenu">` — content of every header and item |
|
|
36
|
+
|
|
37
|
+
## Keyboard
|
|
38
|
+
| Key | Action |
|
|
39
|
+
|---|---|
|
|
40
|
+
| Tab | Moves between the panel headers and into each menu |
|
|
41
|
+
| Down / Up arrow | Next / previous header, or next / previous visible item; disabled items are skipped |
|
|
42
|
+
| Home / End | First / last header or item |
|
|
43
|
+
| Right arrow | Opens a closed item, or moves into an open one |
|
|
44
|
+
| Left arrow | Closes an open item, or moves to its parent |
|
|
45
|
+
| Enter / Space | Opens or closes an item with children, follows a link or runs the command |
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Scroll panel
|
|
2
|
+
|
|
3
|
+
A scroll area with slim, themed scroll bars in place of the native ones. The bars appear while the pointer is over the panel, follow the content as it scrolls or resizes and can be dragged. Give the panel a `height` or a `max-height`.
|
|
4
|
+
|
|
5
|
+
```html
|
|
6
|
+
<tx-scroll-panel ariaLabel="Release notes" style="height: 240px">
|
|
7
|
+
<article>…</article>
|
|
8
|
+
</tx-scroll-panel>
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Inputs
|
|
12
|
+
| Name | Description |
|
|
13
|
+
|---|---|
|
|
14
|
+
| step | Pixels an arrow key scrolls while a bar has focus |
|
|
15
|
+
| ariaLabel | Accessible name; makes the content a named `region` |
|
|
16
|
+
| dt | Design tokens of this instance (`scrollPanel`) |
|
|
17
|
+
| pt | Classes and styles of the parts: `root`, `content`, `barX`, `barY` |
|
|
18
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
19
|
+
| unstyled | Removes the tectra styles |
|
|
20
|
+
|
|
21
|
+
`scrollTop(value)` and `scrollLeft(value)` scroll to a position; `refresh()` measures the bars again (they update by themselves on scroll and size changes).
|
|
22
|
+
|
|
23
|
+
## Slots
|
|
24
|
+
| Name | Description |
|
|
25
|
+
|---|---|
|
|
26
|
+
| default | The content to scroll |
|
|
27
|
+
|
|
28
|
+
## Keyboard
|
|
29
|
+
| Key | Action |
|
|
30
|
+
|---|---|
|
|
31
|
+
| Tab | Moves focus to the content (it is focusable, so the native keys scroll it) |
|
|
32
|
+
| Arrows / Page Up / Page Down / Home / End | Scroll the focused content |
|
|
33
|
+
| Arrows | On a clicked bar: scroll by `step` pixels along its axis |
|
|
34
|
+
| Page Up / Page Down | On a clicked bar: scroll by one view |
|
|
35
|
+
| Home / End | On a clicked bar: scroll to the start / end |
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Splitter
|
|
2
|
+
|
|
3
|
+
Two or more panels side by side or stacked, with a gutter between them that the user drags (or moves with the keyboard) to share the space. Sizes are percentages; panels can have a minimum and a maximum, snap shut when collapsible, nest, and keep their sizes in the browser storage.
|
|
4
|
+
|
|
5
|
+
```html
|
|
6
|
+
<tx-splitter stateKey="editor-layout" (resizeEnd)="save($event.sizes)">
|
|
7
|
+
<tx-splitter-panel [size]="25" [minSize]="15" collapsible>Files</tx-splitter-panel>
|
|
8
|
+
<tx-splitter-panel [size]="75">
|
|
9
|
+
<tx-splitter layout="vertical">
|
|
10
|
+
<tx-splitter-panel>Editor</tx-splitter-panel>
|
|
11
|
+
<tx-splitter-panel [size]="30">Terminal</tx-splitter-panel>
|
|
12
|
+
</tx-splitter>
|
|
13
|
+
</tx-splitter-panel>
|
|
14
|
+
</tx-splitter>
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Inputs
|
|
18
|
+
| Name | Description |
|
|
19
|
+
|---|---|
|
|
20
|
+
| layout | `horizontal` (panels side by side) or `vertical` (stacked) |
|
|
21
|
+
| panelSizes | Sizes of the panels in percent; win over the panels' own `size` |
|
|
22
|
+
| minSizes | Minimum sizes in percent for panels without their own `minSize` |
|
|
23
|
+
| gutterSize | Thickness of the gutter in pixels |
|
|
24
|
+
| step | Pixels an arrow key moves the gutter |
|
|
25
|
+
| disabled | The gutters cannot be moved |
|
|
26
|
+
| stateKey | Storage key; the sizes are saved after every resize and restored on the next visit |
|
|
27
|
+
| stateStorage | `session` or `local` storage for `stateKey` |
|
|
28
|
+
| gutterAriaLabel | Accessible name of the gutters (translated "Resize panels" by default) |
|
|
29
|
+
| size | `tx-splitter-panel`: initial size in percent (the panels share the space evenly without it) |
|
|
30
|
+
| minSize | `tx-splitter-panel`: smallest size in percent |
|
|
31
|
+
| maxSize | `tx-splitter-panel`: largest size in percent |
|
|
32
|
+
| collapsible | `tx-splitter-panel`: a drag below `minSize` snaps the panel shut, a drag back opens it at `minSize` |
|
|
33
|
+
| collapsedSize | `tx-splitter-panel`: size of the panel while shut |
|
|
34
|
+
| dt | Design tokens of this instance (`splitter`) |
|
|
35
|
+
| pt | Classes and styles of the parts: `root`, `panel`, `gutter`, `handle` |
|
|
36
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
37
|
+
| unstyled | Removes the tectra styles |
|
|
38
|
+
|
|
39
|
+
`sizes()` and `collapsed()` read the current state; `resetState()` goes back to the stored or initial sizes.
|
|
40
|
+
|
|
41
|
+
## Outputs
|
|
42
|
+
| Name | Description |
|
|
43
|
+
|---|---|
|
|
44
|
+
| resizeStart | A drag or a key press started a resize: `{ originalEvent, sizes }` |
|
|
45
|
+
| resizing | The sizes changed during the resize: `{ originalEvent, sizes }` |
|
|
46
|
+
| resizeEnd | The pointer or the key was released: `{ originalEvent, sizes }` |
|
|
47
|
+
| collapsedChange | A collapsible panel snapped shut or opened: `{ index, collapsed, sizes }` |
|
|
48
|
+
|
|
49
|
+
## Slots
|
|
50
|
+
| Name | Description |
|
|
51
|
+
|---|---|
|
|
52
|
+
| tx-splitter-panel | One panel; its content can be another `tx-splitter` |
|
|
53
|
+
|
|
54
|
+
## Keyboard
|
|
55
|
+
| Key | Action |
|
|
56
|
+
|---|---|
|
|
57
|
+
| Tab | Moves focus to the next gutter |
|
|
58
|
+
| Left / Right arrow | Moves the gutter of a horizontal splitter by `step` pixels |
|
|
59
|
+
| Up / Down arrow | Moves the gutter of a vertical splitter by `step` pixels |
|
|
60
|
+
| Home | Shrinks the panel before the gutter to its minimum (shut when collapsible) |
|
|
61
|
+
| End | Grows the panel before the gutter as far as the others allow |
|
|
62
|
+
| Enter | Collapses or restores the collapsible panel next to the gutter |
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# Stepper
|
|
2
|
+
|
|
3
|
+
Two step indicators for multi-step flows.
|
|
4
|
+
|
|
5
|
+
- `tx-stepper` — a stepper with its own panels: a row of numbered steps above the panels (`tx-step-list` + `tx-step-panels`) or vertical items whose panels open under each step (`tx-step-item`). `linear` lets the panels' own buttons move on only.
|
|
6
|
+
- `tx-steps` — a step indicator built from an `items` array, without panels: numbers above the labels (`default`) or a compact track of markers with labels and descriptions (`track`) that stacks in a column when it is narrower than 560px.
|
|
7
|
+
|
|
8
|
+
```html
|
|
9
|
+
<tx-stepper [(value)]="step">
|
|
10
|
+
<tx-step-list>
|
|
11
|
+
<tx-step [value]="1">Account</tx-step>
|
|
12
|
+
<tx-step [value]="2">Profile</tx-step>
|
|
13
|
+
</tx-step-list>
|
|
14
|
+
<tx-step-panels>
|
|
15
|
+
<tx-step-panel [value]="1">
|
|
16
|
+
<ng-template txStepPanelContent let-activate>
|
|
17
|
+
…
|
|
18
|
+
<button txButton (click)="activate(2)">Next</button>
|
|
19
|
+
</ng-template>
|
|
20
|
+
</tx-step-panel>
|
|
21
|
+
<tx-step-panel [value]="2">…</tx-step-panel>
|
|
22
|
+
</tx-step-panels>
|
|
23
|
+
</tx-stepper>
|
|
24
|
+
|
|
25
|
+
<tx-steps variant="track" [items]="steps" [(activeIndex)]="current" />
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Inputs
|
|
29
|
+
| Name | Description |
|
|
30
|
+
|---|---|
|
|
31
|
+
| value | `tx-stepper`, two-way: the value of the active step. On `tx-step`, `tx-step-panel` and `tx-step-item`: the value of that step (a step and a panel inside a `tx-step-item` take the item's value) |
|
|
32
|
+
| linear | `tx-stepper`: steps cannot be picked in the header; only the panels move on through `activate` |
|
|
33
|
+
| disabled | `tx-step`: the step cannot be picked |
|
|
34
|
+
| items | `tx-steps`: the steps, `TxStepsItem[]` — `label`, `icon`, `description` (track), `disabled`, `command` (runs with `{ originalEvent, item, index }` when the step is clicked) |
|
|
35
|
+
| activeIndex | `tx-steps`, two-way: index of the current step; the steps before it are done. Set it to `items.length` to mark every step done |
|
|
36
|
+
| readonly | `tx-steps`: the steps cannot be clicked (default `true`). Off, an enabled step with a `command` can be clicked: it becomes current and runs its `command` |
|
|
37
|
+
| variant | `tx-steps`: `default` (numbers above the labels) or `track` (markers with labels and descriptions, a check on done steps) |
|
|
38
|
+
| ariaLabel | `tx-steps`: accessible name of the list |
|
|
39
|
+
| ariaLabelledBy | `tx-steps`: id of the element that names the list |
|
|
40
|
+
| dt | Design tokens of this instance (`stepper` on `tx-stepper`, `steps` on `tx-steps`) |
|
|
41
|
+
| pt | Classes and styles of the parts. `tx-stepper`: `root`, `list`, `step`, `header`, `number`, `title`, `separator`, `panels`, `panel`, `item`. `tx-steps`: `root`, `list`, `item`, `link`, `number`, `label`, `description`, `line` |
|
|
42
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
43
|
+
| unstyled | Removes the tectra styles |
|
|
44
|
+
|
|
45
|
+
## Outputs
|
|
46
|
+
| Name | Description |
|
|
47
|
+
|---|---|
|
|
48
|
+
| valueChange | `tx-stepper`: another step became active |
|
|
49
|
+
| activeIndexChange | `tx-steps`: a step was clicked (only when not `readonly`) |
|
|
50
|
+
|
|
51
|
+
## Slots
|
|
52
|
+
| Name | Description |
|
|
53
|
+
|---|---|
|
|
54
|
+
| default | `tx-step`: the step title. `tx-step-panel`: content that is always rendered |
|
|
55
|
+
| txStepPanelContent | `<ng-template txStepPanelContent let-activate let-value="value" let-index="index" let-active="active">` — panel content, rendered when the step is first opened; `activate(value)` moves to a step |
|
|
56
|
+
| txStepContent | `<ng-template txStepContent let-value let-active="active" let-completed="completed" let-index="index" let-activate="activate">` — own step header instead of the number and the title |
|
|
57
|
+
| txStepsItem | `<ng-template txStepsItem let-item let-index="index" let-active="active" let-done="done">` — own content of a `tx-steps` step |
|
|
58
|
+
|
|
59
|
+
## Keyboard
|
|
60
|
+
| Key | Action |
|
|
61
|
+
|---|---|
|
|
62
|
+
| Tab | Moves to the active step of a step list, then into the panel; in vertical items every step header is a tab stop |
|
|
63
|
+
| Arrow Right / Arrow Down | Next step of a step list (or next clickable step of `tx-steps`), wraps around |
|
|
64
|
+
| Arrow Left / Arrow Up | Previous step, wraps around |
|
|
65
|
+
| Home / End | First / last step |
|
|
66
|
+
| Enter / Space | Opens the focused step |
|
package/table/README.md
CHANGED
|
@@ -10,7 +10,7 @@ Data table for lists: sorting, pagination, server data, selection, row actions w
|
|
|
10
10
|
</tx-table>
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
Columns are `TxTableColumn` objects: `field` (a dot reads a nested value, `team.name`), `header`, `sortable` (on unless `false`), `sortField`, `reorderable`, `resizable`, `hideable`, `hidden`, `width` (fixed, no resize), `initialWidth`, `minWidth`, `maxWidth` (CSS lengths; columns are 100px until resized), `frozen` (`start` / `end`), `align` (`start` / `center` / `end`), `headerClass`, `cellClass`, `footer`, `cardTitle` (this column is the title of the card), `hideInCard`; filters: `filter`, `filterField`, `filterType` (`text`, `numeric`, `date
|
|
13
|
+
Columns are `TxTableColumn` objects: `field` (a dot reads a nested value, `team.name`), `header`, `sortable` (on unless `false`), `sortField`, `reorderable`, `resizable`, `hideable`, `hidden`, `width` (fixed, no resize), `initialWidth`, `minWidth`, `maxWidth` (CSS lengths; columns are 100px until resized), `frozen` (`start` / `end`), `align` (`start` / `center` / `end`), `headerClass`, `cellClass`, `footer`, `cardTitle` (this column is the title of the card), `hideInCard`; filters: `filter`, `filterField`, `filterType` (`text`, `numeric`, `date` — a date picker, `boolean`), `filterMatchModes`, `filterOptions` (`{ label, value }[]` — a multi select with the `in` match mode), `filterPlaceholder`; editing: `editable`, `editType` (`text`, `numeric`, `date` — a date picker, `boolean`), `editOptions` (a select).
|
|
14
14
|
|
|
15
15
|
A cell shows the value of its field as text; `<ng-template txTableCell="field">` replaces it. Text that does not fit is cut with an ellipsis.
|
|
16
16
|
|
package/tabs/README.md
ADDED
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# Tabs
|
|
2
|
+
|
|
3
|
+
Switch between views, modes or filters. Three looks: `segmented` (equal items in a track, the default), `pills` (content-width items) and `line` (an underline under the active tab). Pass an array of tabs, or build the list and the panels from parts.
|
|
4
|
+
|
|
5
|
+
```html
|
|
6
|
+
<tx-tabs [tabs]="tabs" [(value)]="active" (tabChange)="load($event)" />
|
|
7
|
+
|
|
8
|
+
<tx-tabs variant="line" [(value)]="active">
|
|
9
|
+
<tx-tab-list ariaLabel="Project">
|
|
10
|
+
<tx-tab value="summary">Summary</tx-tab>
|
|
11
|
+
<tx-tab value="members" [badge]="4">Members</tx-tab>
|
|
12
|
+
</tx-tab-list>
|
|
13
|
+
<tx-tab-panels>
|
|
14
|
+
<tx-tab-panel value="summary">…</tx-tab-panel>
|
|
15
|
+
<tx-tab-panel value="members">
|
|
16
|
+
<ng-template txTabPanelContent>…</ng-template>
|
|
17
|
+
</tx-tab-panel>
|
|
18
|
+
</tx-tab-panels>
|
|
19
|
+
</tx-tabs>
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
`TxTabItem`: `value`, `label`, `icon`, `tooltip`, `description` (hint under the control while the tab is active), `badge` (counter after the label, `0` is shown), `disabled`.
|
|
23
|
+
|
|
24
|
+
## Inputs
|
|
25
|
+
| Name | Description |
|
|
26
|
+
|---|---|
|
|
27
|
+
| value | Two-way: the value of the active tab |
|
|
28
|
+
| tabs | Tabs as an array of `TxTabItem`; the list is rendered for you |
|
|
29
|
+
| variant | `segmented`, `pills` or `line` |
|
|
30
|
+
| size | `small` or `medium` (segmented) |
|
|
31
|
+
| orientation | `horizontal` or `vertical` (full-width tabs in a column) |
|
|
32
|
+
| raised | Card background, ring and shadow — for tabs on the page background |
|
|
33
|
+
| scrollable | Previous / next buttons when the tabs do not fit |
|
|
34
|
+
| showNavigators | Shows the previous / next buttons of a scrollable list |
|
|
35
|
+
| lazy | Renders only the active panel |
|
|
36
|
+
| selectOnFocus | The arrow keys pick the tab at once |
|
|
37
|
+
| ariaLabel | Accessible name of the tab list — on `tx-tabs` with `tabs`, or on `tx-tab-list` |
|
|
38
|
+
| ariaLabelledBy | Id of the element that names the tab list — on `tx-tabs` with `tabs`, or on `tx-tab-list` |
|
|
39
|
+
| icon | `tx-tab`: icon before the label |
|
|
40
|
+
| badge | `tx-tab`: counter after the label |
|
|
41
|
+
| description | `tx-tab`: hint under the control while the tab is active |
|
|
42
|
+
| disabled | `tx-tab`: the tab cannot be picked |
|
|
43
|
+
| dt | Design tokens of this instance (`tabs`) |
|
|
44
|
+
| pt | Classes and styles of the parts: `root`, `list`, `track`, `content`, `tab`, `icon`, `label`, `badge`, `activeBar`, `previousButton`, `nextButton`, `description`, `panels`, `panel` |
|
|
45
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
46
|
+
| unstyled | Removes the tectra styles |
|
|
47
|
+
|
|
48
|
+
`tx-tab` and `tx-tab-panel` take a required `value`. A tab can also be a link: `a[txTab]` (with `routerLink`) or `button[txTab]`.
|
|
49
|
+
|
|
50
|
+
## Outputs
|
|
51
|
+
| Name | Description |
|
|
52
|
+
|---|---|
|
|
53
|
+
| valueChange | The active tab changed |
|
|
54
|
+
| tabChange | The user picked another tab; emits its value |
|
|
55
|
+
|
|
56
|
+
## Slots
|
|
57
|
+
| Name | Description |
|
|
58
|
+
|---|---|
|
|
59
|
+
| tx-tab-list | The list of `tx-tab` |
|
|
60
|
+
| tx-tab-panels | The panels, one `tx-tab-panel` per value |
|
|
61
|
+
| txTabPanelContent | `<ng-template txTabPanelContent>` in a panel — created on the first visit (only while active with `lazy`) |
|
|
62
|
+
|
|
63
|
+
## Keyboard
|
|
64
|
+
| Key | Action |
|
|
65
|
+
|---|---|
|
|
66
|
+
| Tab | Moves focus to the active tab, then into the panel |
|
|
67
|
+
| Right / Left arrow | Next / previous tab (Down / Up when vertical); disabled tabs are skipped |
|
|
68
|
+
| Home / End | First / last tab |
|
|
69
|
+
| Enter / Space | Picks the focused tab |
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Toolbar
|
|
2
|
+
|
|
3
|
+
A bar that groups actions and controls: content at the start, in the centre and at the end. Wraps onto more lines when the space runs out.
|
|
4
|
+
|
|
5
|
+
```html
|
|
6
|
+
<tx-toolbar ariaLabel="Document">
|
|
7
|
+
<button txButton txToolbarStart icon="plus">New</button>
|
|
8
|
+
<tx-icon-field txToolbarCenter>…</tx-icon-field>
|
|
9
|
+
<button txButton txToolbarEnd icon="save">Save</button>
|
|
10
|
+
</tx-toolbar>
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Inputs
|
|
14
|
+
| Name | Description |
|
|
15
|
+
|---|---|
|
|
16
|
+
| ariaLabel | Accessible name of the toolbar |
|
|
17
|
+
| ariaLabelledBy | Id of the element that names the toolbar |
|
|
18
|
+
| orientation | `horizontal` or `vertical`: the direction of the groups and `aria-orientation` |
|
|
19
|
+
| dt | Design tokens of this instance (`toolbar`) |
|
|
20
|
+
| pt | Classes and styles of the parts: `root`, `start`, `center`, `end` |
|
|
21
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
22
|
+
| unstyled | Removes the tectra styles |
|
|
23
|
+
|
|
24
|
+
## Slots
|
|
25
|
+
| Name | Description |
|
|
26
|
+
|---|---|
|
|
27
|
+
| txToolbarStart | Content of the start group |
|
|
28
|
+
| txToolbarCenter | Content of the centre group |
|
|
29
|
+
| txToolbarEnd | Content of the end group |
|
|
30
|
+
| default | Free content before the groups |
|
|
31
|
+
|
|
32
|
+
## Keyboard
|
|
33
|
+
| Key | Action |
|
|
34
|
+
|---|---|
|
|
35
|
+
| Tab / Shift + Tab | Moves through the controls of the toolbar in order |
|