@tectra-ng/ui 0.0.0-stage → 0.1.1
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/LICENSE +21 -0
- package/README.md +26 -2
- package/amount/README.md +28 -0
- package/autocomplete/README.md +82 -0
- package/avatar/README.md +43 -0
- package/badge/README.md +19 -0
- package/button/README.md +46 -0
- package/button-group/README.md +8 -0
- package/card/README.md +30 -0
- package/cascade-select/README.md +49 -0
- package/checkbox/README.md +64 -0
- package/chip/README.md +38 -0
- package/chips-input/README.md +47 -0
- package/color-picker/README.md +43 -0
- package/confirm/README.md +46 -0
- package/country/README.md +23 -0
- package/country-select/README.md +39 -0
- package/dialog/README.md +84 -0
- package/divider/README.md +24 -0
- package/drawer/README.md +54 -0
- package/email-suggestion/README.md +20 -0
- package/fesm2022/tectra-ng-ui-amount.mjs +415 -0
- package/fesm2022/tectra-ng-ui-amount.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-autocomplete.mjs +730 -0
- package/fesm2022/tectra-ng-ui-autocomplete.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-avatar.mjs +670 -0
- package/fesm2022/tectra-ng-ui-avatar.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-badge.mjs +191 -0
- package/fesm2022/tectra-ng-ui-badge.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-button-group.mjs +50 -0
- package/fesm2022/tectra-ng-ui-button-group.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-button.mjs +725 -0
- package/fesm2022/tectra-ng-ui-button.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-card.mjs +210 -0
- package/fesm2022/tectra-ng-ui-card.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-cascade-select.mjs +887 -0
- package/fesm2022/tectra-ng-ui-cascade-select.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-checkbox.mjs +1150 -0
- package/fesm2022/tectra-ng-ui-checkbox.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-chip.mjs +344 -0
- package/fesm2022/tectra-ng-ui-chip.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-chips-input.mjs +649 -0
- package/fesm2022/tectra-ng-ui-chips-input.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-color-picker.mjs +828 -0
- package/fesm2022/tectra-ng-ui-color-picker.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-confirm.mjs +489 -0
- package/fesm2022/tectra-ng-ui-confirm.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-country-select.mjs +545 -0
- package/fesm2022/tectra-ng-ui-country-select.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-country.mjs +313 -0
- package/fesm2022/tectra-ng-ui-country.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-dialog.mjs +1539 -0
- package/fesm2022/tectra-ng-ui-dialog.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-divider.mjs +194 -0
- package/fesm2022/tectra-ng-ui-divider.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-drawer.mjs +540 -0
- package/fesm2022/tectra-ng-ui-drawer.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-email-suggestion.mjs +341 -0
- package/fesm2022/tectra-ng-ui-email-suggestion.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-field.mjs +492 -0
- package/fesm2022/tectra-ng-ui-field.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-fieldset.mjs +258 -0
- package/fesm2022/tectra-ng-ui-fieldset.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-highlight-text.mjs +246 -0
- package/fesm2022/tectra-ng-ui-highlight-text.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-icon-field.mjs +478 -0
- package/fesm2022/tectra-ng-ui-icon-field.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-input-group.mjs +113 -0
- package/fesm2022/tectra-ng-ui-input-group.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-input-mask.mjs +413 -0
- package/fesm2022/tectra-ng-ui-input-mask.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-input-number.mjs +1045 -0
- package/fesm2022/tectra-ng-ui-input-number.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-input-otp.mjs +553 -0
- package/fesm2022/tectra-ng-ui-input-otp.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-input.mjs +260 -0
- package/fesm2022/tectra-ng-ui-input.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-key-filter.mjs +185 -0
- package/fesm2022/tectra-ng-ui-key-filter.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-knob.mjs +630 -0
- package/fesm2022/tectra-ng-ui-knob.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-label.mjs +271 -0
- package/fesm2022/tectra-ng-ui-label.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-link.mjs +699 -0
- package/fesm2022/tectra-ng-ui-link.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-listbox.mjs +484 -0
- package/fesm2022/tectra-ng-ui-listbox.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-mention-textarea.mjs +717 -0
- package/fesm2022/tectra-ng-ui-mention-textarea.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-menu.mjs +1484 -0
- package/fesm2022/tectra-ng-ui-menu.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-message.mjs +975 -0
- package/fesm2022/tectra-ng-ui-message.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-multiselect.mjs +569 -0
- package/fesm2022/tectra-ng-ui-multiselect.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-overlay-badge.mjs +345 -0
- package/fesm2022/tectra-ng-ui-overlay-badge.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-paginator.mjs +849 -0
- package/fesm2022/tectra-ng-ui-paginator.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-panel.mjs +317 -0
- package/fesm2022/tectra-ng-ui-panel.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-password-generator.mjs +292 -0
- package/fesm2022/tectra-ng-ui-password-generator.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-password.mjs +871 -0
- package/fesm2022/tectra-ng-ui-password.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-pill.mjs +361 -0
- package/fesm2022/tectra-ng-ui-pill.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-popover.mjs +742 -0
- package/fesm2022/tectra-ng-ui-popover.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-progress-bar.mjs +440 -0
- package/fesm2022/tectra-ng-ui-progress-bar.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-progress-spinner.mjs +265 -0
- package/fesm2022/tectra-ng-ui-progress-spinner.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-radio-button.mjs +817 -0
- package/fesm2022/tectra-ng-ui-radio-button.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-rating.mjs +584 -0
- package/fesm2022/tectra-ng-ui-rating.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-select.mjs +2478 -0
- package/fesm2022/tectra-ng-ui-select.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-skeleton.mjs +548 -0
- package/fesm2022/tectra-ng-ui-skeleton.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-slider.mjs +630 -0
- package/fesm2022/tectra-ng-ui-slider.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-speed-dial.mjs +669 -0
- package/fesm2022/tectra-ng-ui-speed-dial.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-split-button.mjs +614 -0
- package/fesm2022/tectra-ng-ui-split-button.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-status-icon.mjs +295 -0
- package/fesm2022/tectra-ng-ui-status-icon.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-table.mjs +5997 -0
- package/fesm2022/tectra-ng-ui-table.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-tag.mjs +422 -0
- package/fesm2022/tectra-ng-ui-tag.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-textarea.mjs +482 -0
- package/fesm2022/tectra-ng-ui-textarea.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-toast.mjs +668 -0
- package/fesm2022/tectra-ng-ui-toast.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-toggle-button.mjs +416 -0
- package/fesm2022/tectra-ng-ui-toggle-button.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-toggle-switch.mjs +560 -0
- package/fesm2022/tectra-ng-ui-toggle-switch.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-tooltip.mjs +835 -0
- package/fesm2022/tectra-ng-ui-tooltip.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui-tree-select.mjs +986 -0
- package/fesm2022/tectra-ng-ui-tree-select.mjs.map +1 -0
- package/fesm2022/tectra-ng-ui.mjs +4 -0
- package/fesm2022/tectra-ng-ui.mjs.map +1 -0
- package/field/README.md +43 -0
- package/fieldset/README.md +36 -0
- package/highlight-text/README.md +20 -0
- package/icon-field/README.md +30 -0
- package/input/README.md +22 -0
- package/input-group/README.md +21 -0
- package/input-mask/README.md +30 -0
- package/input-number/README.md +61 -0
- package/input-otp/README.md +44 -0
- package/key-filter/README.md +31 -0
- package/knob/README.md +50 -0
- package/label/README.md +29 -0
- package/link/README.md +47 -0
- package/listbox/README.md +68 -0
- package/mention-textarea/README.md +47 -0
- package/menu/README.md +65 -0
- package/message/README.md +58 -0
- package/multiselect/README.md +85 -0
- package/overlay-badge/README.md +30 -0
- package/package.json +301 -3
- package/paginator/README.md +60 -0
- package/panel/README.md +45 -0
- package/password/README.md +60 -0
- package/password-generator/README.md +34 -0
- package/pill/README.md +42 -0
- package/popover/README.md +67 -0
- package/progress-bar/README.md +32 -0
- package/progress-spinner/README.md +22 -0
- package/radio-button/README.md +54 -0
- package/rating/README.md +49 -0
- package/select/README.md +78 -0
- package/skeleton/README.md +27 -0
- package/slider/README.md +48 -0
- package/speed-dial/README.md +49 -0
- package/split-button/README.md +45 -0
- package/status-icon/README.md +22 -0
- package/table/README.md +178 -0
- package/tag/README.md +42 -0
- package/textarea/README.md +37 -0
- package/toast/README.md +52 -0
- package/toggle-button/README.md +34 -0
- package/toggle-switch/README.md +49 -0
- package/tooltip/README.md +60 -0
- package/tree-select/README.md +49 -0
- package/types/tectra-ng-ui-amount.d.ts +135 -0
- package/types/tectra-ng-ui-amount.d.ts.map +1 -0
- package/types/tectra-ng-ui-autocomplete.d.ts +250 -0
- package/types/tectra-ng-ui-autocomplete.d.ts.map +1 -0
- package/types/tectra-ng-ui-avatar.d.ts +289 -0
- package/types/tectra-ng-ui-avatar.d.ts.map +1 -0
- package/types/tectra-ng-ui-badge.d.ts +119 -0
- package/types/tectra-ng-ui-badge.d.ts.map +1 -0
- package/types/tectra-ng-ui-button-group.d.ts +6 -0
- package/types/tectra-ng-ui-button-group.d.ts.map +1 -0
- package/types/tectra-ng-ui-button.d.ts +466 -0
- package/types/tectra-ng-ui-button.d.ts.map +1 -0
- package/types/tectra-ng-ui-card.d.ts +71 -0
- package/types/tectra-ng-ui-card.d.ts.map +1 -0
- package/types/tectra-ng-ui-cascade-select.d.ts +244 -0
- package/types/tectra-ng-ui-cascade-select.d.ts.map +1 -0
- package/types/tectra-ng-ui-checkbox.d.ts +450 -0
- package/types/tectra-ng-ui-checkbox.d.ts.map +1 -0
- package/types/tectra-ng-ui-chip.d.ts +106 -0
- package/types/tectra-ng-ui-chip.d.ts.map +1 -0
- package/types/tectra-ng-ui-chips-input.d.ts +187 -0
- package/types/tectra-ng-ui-chips-input.d.ts.map +1 -0
- package/types/tectra-ng-ui-color-picker.d.ts +237 -0
- package/types/tectra-ng-ui-color-picker.d.ts.map +1 -0
- package/types/tectra-ng-ui-confirm.d.ts +80 -0
- package/types/tectra-ng-ui-confirm.d.ts.map +1 -0
- package/types/tectra-ng-ui-country-select.d.ts +235 -0
- package/types/tectra-ng-ui-country-select.d.ts.map +1 -0
- package/types/tectra-ng-ui-country.d.ts +105 -0
- package/types/tectra-ng-ui-country.d.ts.map +1 -0
- package/types/tectra-ng-ui-dialog.d.ts +453 -0
- package/types/tectra-ng-ui-dialog.d.ts.map +1 -0
- package/types/tectra-ng-ui-divider.d.ts +70 -0
- package/types/tectra-ng-ui-divider.d.ts.map +1 -0
- package/types/tectra-ng-ui-drawer.d.ts +188 -0
- package/types/tectra-ng-ui-drawer.d.ts.map +1 -0
- package/types/tectra-ng-ui-email-suggestion.d.ts +84 -0
- package/types/tectra-ng-ui-email-suggestion.d.ts.map +1 -0
- package/types/tectra-ng-ui-field.d.ts +139 -0
- package/types/tectra-ng-ui-field.d.ts.map +1 -0
- package/types/tectra-ng-ui-fieldset.d.ts +74 -0
- package/types/tectra-ng-ui-fieldset.d.ts.map +1 -0
- package/types/tectra-ng-ui-highlight-text.d.ts +75 -0
- package/types/tectra-ng-ui-highlight-text.d.ts.map +1 -0
- package/types/tectra-ng-ui-icon-field.d.ts +77 -0
- package/types/tectra-ng-ui-icon-field.d.ts.map +1 -0
- package/types/tectra-ng-ui-input-group.d.ts +18 -0
- package/types/tectra-ng-ui-input-group.d.ts.map +1 -0
- package/types/tectra-ng-ui-input-mask.d.ts +91 -0
- package/types/tectra-ng-ui-input-mask.d.ts.map +1 -0
- package/types/tectra-ng-ui-input-number.d.ts +326 -0
- package/types/tectra-ng-ui-input-number.d.ts.map +1 -0
- package/types/tectra-ng-ui-input-otp.d.ts +173 -0
- package/types/tectra-ng-ui-input-otp.d.ts.map +1 -0
- package/types/tectra-ng-ui-input.d.ts +113 -0
- package/types/tectra-ng-ui-input.d.ts.map +1 -0
- package/types/tectra-ng-ui-key-filter.d.ts +43 -0
- package/types/tectra-ng-ui-key-filter.d.ts.map +1 -0
- package/types/tectra-ng-ui-knob.d.ts +207 -0
- package/types/tectra-ng-ui-knob.d.ts.map +1 -0
- package/types/tectra-ng-ui-label.d.ts +53 -0
- package/types/tectra-ng-ui-label.d.ts.map +1 -0
- package/types/tectra-ng-ui-link.d.ts +223 -0
- package/types/tectra-ng-ui-link.d.ts.map +1 -0
- package/types/tectra-ng-ui-listbox.d.ts +131 -0
- package/types/tectra-ng-ui-listbox.d.ts.map +1 -0
- package/types/tectra-ng-ui-mention-textarea.d.ts +169 -0
- package/types/tectra-ng-ui-mention-textarea.d.ts.map +1 -0
- package/types/tectra-ng-ui-menu.d.ts +512 -0
- package/types/tectra-ng-ui-menu.d.ts.map +1 -0
- package/types/tectra-ng-ui-message.d.ts +390 -0
- package/types/tectra-ng-ui-message.d.ts.map +1 -0
- package/types/tectra-ng-ui-multiselect.d.ts +216 -0
- package/types/tectra-ng-ui-multiselect.d.ts.map +1 -0
- package/types/tectra-ng-ui-overlay-badge.d.ts +104 -0
- package/types/tectra-ng-ui-overlay-badge.d.ts.map +1 -0
- package/types/tectra-ng-ui-paginator.d.ts +293 -0
- package/types/tectra-ng-ui-paginator.d.ts.map +1 -0
- package/types/tectra-ng-ui-panel.d.ts +133 -0
- package/types/tectra-ng-ui-panel.d.ts.map +1 -0
- package/types/tectra-ng-ui-password-generator.d.ts +80 -0
- package/types/tectra-ng-ui-password-generator.d.ts.map +1 -0
- package/types/tectra-ng-ui-password.d.ts +271 -0
- package/types/tectra-ng-ui-password.d.ts.map +1 -0
- package/types/tectra-ng-ui-pill.d.ts +167 -0
- package/types/tectra-ng-ui-pill.d.ts.map +1 -0
- package/types/tectra-ng-ui-popover.d.ts +244 -0
- package/types/tectra-ng-ui-popover.d.ts.map +1 -0
- package/types/tectra-ng-ui-progress-bar.d.ts +151 -0
- package/types/tectra-ng-ui-progress-bar.d.ts.map +1 -0
- package/types/tectra-ng-ui-progress-spinner.d.ts +95 -0
- package/types/tectra-ng-ui-progress-spinner.d.ts.map +1 -0
- package/types/tectra-ng-ui-radio-button.d.ts +380 -0
- package/types/tectra-ng-ui-radio-button.d.ts.map +1 -0
- package/types/tectra-ng-ui-rating.d.ts +195 -0
- package/types/tectra-ng-ui-rating.d.ts.map +1 -0
- package/types/tectra-ng-ui-select.d.ts +761 -0
- package/types/tectra-ng-ui-select.d.ts.map +1 -0
- package/types/tectra-ng-ui-skeleton.d.ts +182 -0
- package/types/tectra-ng-ui-skeleton.d.ts.map +1 -0
- package/types/tectra-ng-ui-slider.d.ts +220 -0
- package/types/tectra-ng-ui-slider.d.ts.map +1 -0
- package/types/tectra-ng-ui-speed-dial.d.ts +175 -0
- package/types/tectra-ng-ui-speed-dial.d.ts.map +1 -0
- package/types/tectra-ng-ui-split-button.d.ts +139 -0
- package/types/tectra-ng-ui-split-button.d.ts.map +1 -0
- package/types/tectra-ng-ui-status-icon.d.ts +105 -0
- package/types/tectra-ng-ui-status-icon.d.ts.map +1 -0
- package/types/tectra-ng-ui-table.d.ts +1301 -0
- package/types/tectra-ng-ui-table.d.ts.map +1 -0
- package/types/tectra-ng-ui-tag.d.ts +157 -0
- package/types/tectra-ng-ui-tag.d.ts.map +1 -0
- package/types/tectra-ng-ui-textarea.d.ts +146 -0
- package/types/tectra-ng-ui-textarea.d.ts.map +1 -0
- package/types/tectra-ng-ui-toast.d.ts +268 -0
- package/types/tectra-ng-ui-toast.d.ts.map +1 -0
- package/types/tectra-ng-ui-toggle-button.d.ts +184 -0
- package/types/tectra-ng-ui-toggle-button.d.ts.map +1 -0
- package/types/tectra-ng-ui-toggle-switch.d.ts +226 -0
- package/types/tectra-ng-ui-toggle-switch.d.ts.map +1 -0
- package/types/tectra-ng-ui-tooltip.d.ts +275 -0
- package/types/tectra-ng-ui-tooltip.d.ts.map +1 -0
- package/types/tectra-ng-ui-tree-select.d.ts +339 -0
- package/types/tectra-ng-ui-tree-select.d.ts.map +1 -0
- package/types/tectra-ng-ui.d.ts +2 -0
- package/types/tectra-ng-ui.d.ts.map +1 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Tectra contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,27 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @tectra-ng/ui
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
ONE npm package, one entry point per component: `import { TxSelect } from '@tectra-ng/ui/select'` — only the select lands in the bundle.
|
|
4
|
+
|
|
5
|
+
Every component folder looks the same (see `select/`):
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
select/
|
|
9
|
+
src/
|
|
10
|
+
select.component.ts|html|scss the component (styles use only --tx-* variables)
|
|
11
|
+
select.component.spec.ts unit tests
|
|
12
|
+
select-option.directive.ts template slots (#option, #empty, …)
|
|
13
|
+
select.tokens.ts component tokens → docs "Theming" tab
|
|
14
|
+
select.types.ts public types
|
|
15
|
+
index.ts public API of the entry point
|
|
16
|
+
ng-package.json makes it @tectra-ng/ui/select
|
|
17
|
+
README.md descriptions → docs "API" tab
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Planned (~70): button, input, textarea, checkbox, radio, switch, input-number, input-mask, input-otp, password, slider, rating,
|
|
21
|
+
tooltip, popover, dialog, drawer, toast, menu, context-menu, confirm-popup,
|
|
22
|
+
select, multiselect, autocomplete, listbox, tree-select, chips, color-picker,
|
|
23
|
+
paginator, table, tree, tree-table, data-view, virtual-scroller, timeline,
|
|
24
|
+
datepicker, tabs, accordion, stepper, breadcrumb, menubar, splitter, card, toolbar, divider,
|
|
25
|
+
file-upload, image, carousel, avatar, badge, tag, progress, skeleton, spinner, editor …
|
|
26
|
+
|
|
27
|
+
Depends on: `@tectra-ng/core`, `@tectra-ng/icons`.
|
package/amount/README.md
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Amount
|
|
2
|
+
|
|
3
|
+
A number or a sum of money formatted for the current locale — grouping, decimals, currency symbol and its position come from `Intl`. Empty values show a dash, zero is muted.
|
|
4
|
+
|
|
5
|
+
```html
|
|
6
|
+
<tx-amount [amount]="1234.5" currency="USD" />
|
|
7
|
+
<tx-amount [amount]="delta" [signColor]="true" [showSign]="true" />
|
|
8
|
+
```
|
|
9
|
+
|
|
10
|
+
`format` uses the digits notation `minInteger.minFraction-maxFraction`: `1.0-2` (default, up to two decimals), `1.2-2` (always two), `1.0-0` (whole numbers). `formatAmount(value, options)` returns the formatted parts for own markup.
|
|
11
|
+
|
|
12
|
+
## Inputs
|
|
13
|
+
| Name | Description |
|
|
14
|
+
|---|---|
|
|
15
|
+
| amount | The number; `null` or `undefined` shows `emptyText` |
|
|
16
|
+
| currency | ISO 4217 code (`USD`, `EUR`, `UAH`); an unknown code is shown after the number as is |
|
|
17
|
+
| format | Digits: `minInteger.minFraction-maxFraction` |
|
|
18
|
+
| notation | `standard` or `compact` (`1.2K`, `3.4M`) |
|
|
19
|
+
| currencyDisplay | `narrowSymbol` ($), `symbol` (US$), `code` (USD) or `name` (US dollars) |
|
|
20
|
+
| showSign | Adds `+` to positive numbers |
|
|
21
|
+
| signColor | Positive numbers green, negative red |
|
|
22
|
+
| strong | Bolder number |
|
|
23
|
+
| locale | Own `Intl` locale instead of the current tectra locale |
|
|
24
|
+
| emptyText | Shown when there is no number |
|
|
25
|
+
| dt | Design tokens of this instance (`amount`) |
|
|
26
|
+
| pt | Classes and styles of the parts: `root`, `value`, `currency` |
|
|
27
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
28
|
+
| unstyled | Removes the tectra styles |
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# Autocomplete
|
|
2
|
+
|
|
3
|
+
A text field that suggests values while you type. Free text, or only a suggestion with `forceSelection`; one value or several as chips. You load the suggestions in `completed` (from a server or a local list), or let the field search a fixed list with `localSearch`. Works with `[formControl]`, `ngModel` and signal forms.
|
|
4
|
+
|
|
5
|
+
## Inputs
|
|
6
|
+
| Name | Description |
|
|
7
|
+
|---|---|
|
|
8
|
+
| suggestions | Items to suggest — objects, or plain strings / numbers |
|
|
9
|
+
| optionLabel | Field of an item shown as its text and written into the field |
|
|
10
|
+
| optionValue | Field of an item written into the value; empty string = the whole item |
|
|
11
|
+
| optionDisabled | Field that disables an item |
|
|
12
|
+
| group | `suggestions` are groups with their own items |
|
|
13
|
+
| optionGroupLabel | Field of a group shown as its header |
|
|
14
|
+
| optionGroupChildren | Field of a group that holds its items |
|
|
15
|
+
| dataKey | Field that identifies an object value |
|
|
16
|
+
| multiple | Several values shown as chips; the value is an array |
|
|
17
|
+
| dropdown | Button that shows suggestions without typing |
|
|
18
|
+
| dropdownMode | `blank` (asks with an empty query) or `current` (with the typed text) |
|
|
19
|
+
| dropdownIcon | Icon name of the dropdown button |
|
|
20
|
+
| forceSelection | Only a suggestion can be the value; other text is cleared when the field is left |
|
|
21
|
+
| localSearch | Filters `suggestions` by the typed text itself (use `filterMatchMode`, `filterBy`) |
|
|
22
|
+
| filterBy | Fields to search in with `localSearch`, comma separated |
|
|
23
|
+
| filterMatchMode | `contains`, `startsWith`, `endsWith` or `equals` with `localSearch` |
|
|
24
|
+
| delay | Milliseconds to wait after typing before `completed` |
|
|
25
|
+
| minLength | Characters needed before `completed` |
|
|
26
|
+
| completeOnFocus | Asks for suggestions as soon as the field gets focus |
|
|
27
|
+
| autoOptionFocus | Makes the first suggestion active, so Enter takes it |
|
|
28
|
+
| showEmptyMessage | Shows "No results" when there are no suggestions (on by default) |
|
|
29
|
+
| maxlength | Maximum length of the typed text |
|
|
30
|
+
| placeholder | Text shown in an empty field |
|
|
31
|
+
| showClear | Shows a button that clears the field |
|
|
32
|
+
| loading | Spinner in the field and "Loading" in an empty panel |
|
|
33
|
+
| lazy | Suggestions come page by page: `lazyLoad` asks for missing rows |
|
|
34
|
+
| virtualScroll | Renders only the visible rows |
|
|
35
|
+
| virtualScrollItemSize | Height of a row in px with `virtualScroll` |
|
|
36
|
+
| scrollHeight | Maximum height of the list |
|
|
37
|
+
| emptyMessage | Text when there are no suggestions |
|
|
38
|
+
| emptyFilterMessage | Text when the typed text found nothing |
|
|
39
|
+
| inputId | Id of the input for a `<label for>` |
|
|
40
|
+
| ariaLabel | Accessible name of the field |
|
|
41
|
+
| ariaLabelledBy | Id of the element that labels the field |
|
|
42
|
+
| size | `small`, `medium`, `large` |
|
|
43
|
+
| variant | `outlined` or `filled` |
|
|
44
|
+
| invalid | Red border and `aria-invalid`; follows the form control by default |
|
|
45
|
+
| readonly | Shows the value, cannot be changed |
|
|
46
|
+
| resetFilterOnHide | Clears the typed text when the panel closes |
|
|
47
|
+
| dt | Design tokens of this instance (`select`) |
|
|
48
|
+
| pt | Classes and styles of the parts: the select parts plus `input`, `chip`, `dropdownButton` |
|
|
49
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
50
|
+
| unstyled | Removes the tectra styles |
|
|
51
|
+
|
|
52
|
+
## Outputs
|
|
53
|
+
| Name | Description |
|
|
54
|
+
|---|---|
|
|
55
|
+
| completed | Load suggestions for `{ query }` |
|
|
56
|
+
| changed | The value changed: `{ value, option, selected }` |
|
|
57
|
+
| cleared | The clear button was used |
|
|
58
|
+
| lazyLoad | Rows without data came into view: `{ first, last, query }` |
|
|
59
|
+
| opened | The panel was opened |
|
|
60
|
+
| closed | The panel was closed (the control is marked as touched) |
|
|
61
|
+
|
|
62
|
+
## Slots
|
|
63
|
+
| Name | Description |
|
|
64
|
+
|---|---|
|
|
65
|
+
| txSelectOption | `<ng-template txSelectOption let-option>` — own markup of a suggestion and of a chip |
|
|
66
|
+
| txSelectGroup | `<ng-template txSelectGroup let-group>` — own group header |
|
|
67
|
+
| txSelectHeader | `<ng-template txSelectHeader>` — content above the list |
|
|
68
|
+
| txSelectFooter | `<ng-template txSelectFooter>` — content below the list |
|
|
69
|
+
| txSelectEmpty | `<ng-template txSelectEmpty>` — shown when there are no suggestions |
|
|
70
|
+
| txSelectEmptyFilter | `<ng-template txSelectEmptyFilter let-query>` — shown when the typed text found nothing |
|
|
71
|
+
|
|
72
|
+
## Keyboard
|
|
73
|
+
| Key | Action |
|
|
74
|
+
|---|---|
|
|
75
|
+
| Letters | Type; suggestions are asked for after `delay` |
|
|
76
|
+
| ArrowDown / ArrowUp | Opens the suggestions, moves the active one |
|
|
77
|
+
| Enter | Takes the active suggestion; without one, keeps the typed text |
|
|
78
|
+
| PageDown / PageUp | Ten suggestions down / up |
|
|
79
|
+
| Home / End | Move the caret in the field |
|
|
80
|
+
| Backspace | With `multiple` in an empty field, removes the last chip |
|
|
81
|
+
| Escape | Closes the suggestions |
|
|
82
|
+
| Tab | Closes the suggestions and moves on; with `forceSelection` text that is not a suggestion is cleared |
|
package/avatar/README.md
ADDED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Avatar
|
|
2
|
+
|
|
3
|
+
A person or an item as a small picture: a photo, otherwise initials from the name on a colour picked from the name, otherwise an icon. A broken photo falls back on its own. `tx-avatar-group` stacks several with an overlap and a `+N`.
|
|
4
|
+
|
|
5
|
+
```html
|
|
6
|
+
<tx-avatar [image]="user.photo" [name]="user.name" />
|
|
7
|
+
|
|
8
|
+
<tx-avatar-group [max]="3" ariaLabel="Project members">
|
|
9
|
+
@for (member of members; track member.id) {
|
|
10
|
+
<tx-avatar [image]="member.photo" [name]="member.name" />
|
|
11
|
+
}
|
|
12
|
+
<button txAvatarGroupEnd txButton icon="plus" [rounded]="true" aria-label="Invite"></button>
|
|
13
|
+
</tx-avatar-group>
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## Inputs
|
|
17
|
+
| Name | Description |
|
|
18
|
+
|---|---|
|
|
19
|
+
| image | Photo URL; when it is empty or fails to load, initials or the icon show instead |
|
|
20
|
+
| name | Person's name: initials, colour, accessible name and title |
|
|
21
|
+
| label | Own text instead of initials, e.g. `+3` or `AI` |
|
|
22
|
+
| icon | Icon when there is no photo and no name |
|
|
23
|
+
| size | `small`, `medium`, `large`, `xlarge` or a number of px (inherits the group) |
|
|
24
|
+
| shape | `circle` or `square` (inherits the group) |
|
|
25
|
+
| tone | Own colour instead of the one picked from the name: `blue`, `green`, `sky`, `orange`, `purple`, `red` |
|
|
26
|
+
| ariaLabel | Accessible name instead of `name`; without both the avatar is decorative |
|
|
27
|
+
| max | `tx-avatar-group`: shows this many avatars and a `+N` |
|
|
28
|
+
| moreLabel | `tx-avatar-group`: accessible name of `+N` ("N more", translated, by default) |
|
|
29
|
+
| dt | Design tokens of this instance (`avatar`) |
|
|
30
|
+
| pt | Classes and styles of the parts: `root`, `image`, `label`, `icon`; group: `root`, `more` |
|
|
31
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
32
|
+
| unstyled | Removes the tectra styles |
|
|
33
|
+
|
|
34
|
+
## Outputs
|
|
35
|
+
| Name | Description |
|
|
36
|
+
|---|---|
|
|
37
|
+
| imageError | The photo failed to load (the fallback is already shown) |
|
|
38
|
+
|
|
39
|
+
## Slots
|
|
40
|
+
| Name | Description |
|
|
41
|
+
|---|---|
|
|
42
|
+
| default | Avatar: extra content, e.g. a badge; group: the avatars |
|
|
43
|
+
| txAvatarGroupEnd | `tx-avatar-group`: an element after the avatars, e.g. an add button |
|
package/badge/README.md
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Badge
|
|
2
|
+
|
|
3
|
+
A small status or counter. Without a `value` it renders as a dot.
|
|
4
|
+
|
|
5
|
+
## Inputs
|
|
6
|
+
| Name | Description |
|
|
7
|
+
|---|---|
|
|
8
|
+
| value | Text or number inside; empty = a dot |
|
|
9
|
+
| severity | Colour: `primary`, `secondary`, `success`, `info`, `warn`, `danger`, `help`, `contrast` |
|
|
10
|
+
| size | `small`, `medium`, `large`, `xlarge` |
|
|
11
|
+
| dt | Design tokens of this one badge, e.g. `{ primary: { background: '#0d9488' } }` |
|
|
12
|
+
| pt | Extra `class` / `style` for the `root` part — an object or a function `({ instance }) => ({ class, style })` |
|
|
13
|
+
| ptOptions | How this `pt` meets the global one from `provideTectra({ pt })`: `mergeSections` (default `true` — keep global parts this `pt` does not mention), `mergeProps` (default `false` — a local part replaces the global one; `true` joins classes and styles) |
|
|
14
|
+
| unstyled | Drops all tectra styles; classes stay for your own CSS |
|
|
15
|
+
|
|
16
|
+
## Keyboard
|
|
17
|
+
| Key | Action |
|
|
18
|
+
|---|---|
|
|
19
|
+
| — | Not focusable |
|
package/button/README.md
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# Button
|
|
2
|
+
|
|
3
|
+
Triggers an action. The text goes into `label` or inside the button. An attribute on a native `button` or `a`, so the native behaviour stays: `type`, `href`, `aria-label`, `autofocus`, `(click)`, `(focus)`, `(blur)`, `class`, `style`. Every visual value comes from the `button` design tokens of the preset (see the Theming tab).
|
|
4
|
+
|
|
5
|
+
## Inputs
|
|
6
|
+
| Name | Description |
|
|
7
|
+
|---|---|
|
|
8
|
+
| label | Text of the button; the same as text placed inside the button (both can be combined) |
|
|
9
|
+
| severity | Meaning of the action: `primary` main, `secondary` neutral, `success`, `info`, `warn`, `danger` destructive, `help`, `contrast` |
|
|
10
|
+
| size | `small`, `medium`, `large` |
|
|
11
|
+
| variant | `outlined`, `text` or `link`; wins over the boolean shortcuts below |
|
|
12
|
+
| outlined | Shortcut for `variant="outlined"` — border, no fill |
|
|
13
|
+
| text | Shortcut for `variant="text"` — no border, no fill |
|
|
14
|
+
| link | Shortcut for `variant="link"` — looks like a link |
|
|
15
|
+
| rounded | Fully rounded corners |
|
|
16
|
+
| raised | Adds a shadow |
|
|
17
|
+
| plain | Grey colours for an outlined or text button |
|
|
18
|
+
| fluid | Takes the full width of its container; without the input it follows a parent `<tx-fluid>` |
|
|
19
|
+
| disabled | Blocks the button: the native `disabled` on a `button`, `aria-disabled` + no tab stop on an `a` |
|
|
20
|
+
| tabindex | Tab order; an `a` that is disabled always gets `-1` |
|
|
21
|
+
| icon | A `@tectra-ng/icons` name (`'plus'`), an icon registered with `provideTxIcons` (brand logos from `@tectra-ng/brand-icons`: `'github'`), or any icon class (`'pi pi-check'`) |
|
|
22
|
+
| iconPos | Where the icon sits: `left`, `right`, `top`, `bottom` |
|
|
23
|
+
| iconOnly | Square button with only the icon. Not needed in most cases: a button with an icon and no text becomes square by itself. Give it an `aria-label` |
|
|
24
|
+
| loading | Shows a spinning icon, disables the button and sets `aria-busy` |
|
|
25
|
+
| loadingIcon | Icon shown while loading — a `@tectra-ng/icons` name or any icon class |
|
|
26
|
+
| badge | Counter after the text, rendered with `<tx-badge>` |
|
|
27
|
+
| badgeSeverity | Colour of the badge |
|
|
28
|
+
| ripple | Click wave for this button; without it the global `provideTectra({ ripple })` decides |
|
|
29
|
+
| rippleCentered | The wave always starts from the centre (handy for round icon buttons) |
|
|
30
|
+
| rippleColor | Colour of the wave; by default the text colour of the button |
|
|
31
|
+
| dt | Design tokens of this one button, e.g. `{ root: { primary: { background: '#0d9488' } } }` — same shape as the preset tokens |
|
|
32
|
+
| pt | Extra `class` / `style` for the parts `root`, `icon`, `loadingIcon`, `label`, `badge` — an object or a function `({ instance }) => ({ class, style })` that reacts to the button state |
|
|
33
|
+
| ptOptions | How this `pt` meets the global one from `provideTectra({ pt })`: `mergeSections` (default `true` — keep global parts this `pt` does not mention), `mergeProps` (default `false` — a local part replaces the global one; `true` joins classes and styles) |
|
|
34
|
+
| unstyled | Drops all tectra styles, the classes stay for your own CSS; default from `provideTectra({ unstyled })` |
|
|
35
|
+
|
|
36
|
+
## Slots
|
|
37
|
+
| Name | Description |
|
|
38
|
+
|---|---|
|
|
39
|
+
| txButtonIcon | `<ng-template txButtonIcon>` — own markup of the icon (any icon set, an image) |
|
|
40
|
+
| txButtonLoadingIcon | `<ng-template txButtonLoadingIcon>` — own markup of the loading indicator |
|
|
41
|
+
|
|
42
|
+
## Keyboard
|
|
43
|
+
| Key | Action |
|
|
44
|
+
|---|---|
|
|
45
|
+
| Enter / Space | Triggers the button (native behaviour) |
|
|
46
|
+
| Tab | Moves focus to the button; a disabled `button` or `a` is skipped |
|
package/card/README.md
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# Card
|
|
2
|
+
|
|
3
|
+
A box for one piece of content — media on top, a title, text and actions at the bottom.
|
|
4
|
+
|
|
5
|
+
```html
|
|
6
|
+
<tx-card title="Weekly report" subtitle="Nov 3 – 9">
|
|
7
|
+
<img txCardHeader src="/chart.png" alt="Visitors by day" />
|
|
8
|
+
Visitors grew 12% compared with last week.
|
|
9
|
+
<div txCardFooter><button txButton>Open</button></div>
|
|
10
|
+
</tx-card>
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Inputs
|
|
14
|
+
| Name | Description |
|
|
15
|
+
|---|---|
|
|
16
|
+
| title | Title of the card (a heading) |
|
|
17
|
+
| subtitle | Muted line under the title |
|
|
18
|
+
| headingLevel | Heading level of the title, 3 by default |
|
|
19
|
+
| dt | Design tokens of this instance (`card`) |
|
|
20
|
+
| pt | Classes and styles of the parts: `root`, `header`, `body`, `title`, `subtitle`, `content`, `footer` |
|
|
21
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
22
|
+
| unstyled | Removes the tectra styles |
|
|
23
|
+
|
|
24
|
+
## Slots
|
|
25
|
+
| Name | Description |
|
|
26
|
+
|---|---|
|
|
27
|
+
| default | The content |
|
|
28
|
+
| txCardHeader | Full-width media on top, e.g. an image |
|
|
29
|
+
| txCardTitle | Own title markup instead of `title` |
|
|
30
|
+
| txCardFooter | Actions at the bottom |
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Cascade select
|
|
2
|
+
|
|
3
|
+
Pick a value through nested groups shown as columns — country → region → city, category → subcategory → item. The next column opens on hover or with ArrowRight; only leaves are values. Works with `[formControl]`, `ngModel` and signal forms.
|
|
4
|
+
|
|
5
|
+
## Inputs
|
|
6
|
+
| Name | Description |
|
|
7
|
+
|---|---|
|
|
8
|
+
| options | Top-level groups (or items) |
|
|
9
|
+
| optionLabel | Field of a leaf shown as its text |
|
|
10
|
+
| optionValue | Field of a leaf written into the value; empty string = the whole leaf |
|
|
11
|
+
| optionDisabled | Field that disables an item or a group |
|
|
12
|
+
| optionGroupLabel | Field of a group shown as its text |
|
|
13
|
+
| optionGroupChildren | Field with the children of a group, or one field per level (`['regions', 'cities']`) |
|
|
14
|
+
| dataKey | Field that identifies an object value |
|
|
15
|
+
| showPath | The field shows the whole path, e.g. "Poland / Masovia / Warsaw" |
|
|
16
|
+
| pathSeparator | Text between the parts of the path |
|
|
17
|
+
| placeholder | Text shown while nothing is selected |
|
|
18
|
+
| showClear | Button that clears the value |
|
|
19
|
+
| emptyMessage | Text of an empty list |
|
|
20
|
+
| inputId | Id of the field for a `<label for>` |
|
|
21
|
+
| ariaLabel | Accessible name of the field and the tree |
|
|
22
|
+
| ariaLabelledBy | Id of the element that labels the field |
|
|
23
|
+
| size | `small`, `medium`, `large` |
|
|
24
|
+
| variant | `outlined` or `filled` |
|
|
25
|
+
| invalid | Red border and `aria-invalid`; follows the form control by default |
|
|
26
|
+
| readonly | Shows the value, does not open |
|
|
27
|
+
| dt | Design tokens of this instance (`cascadeSelect`; options use the `select` tokens) |
|
|
28
|
+
| pt | Classes and styles of the parts: `root`, `box`, `trigger`, `value`, `clear`, `dropdown`, `panel`, `column`, `option`, `empty` |
|
|
29
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
30
|
+
| unstyled | Removes the tectra styles |
|
|
31
|
+
|
|
32
|
+
## Outputs
|
|
33
|
+
| Name | Description |
|
|
34
|
+
|---|---|
|
|
35
|
+
| changed | A leaf was picked or the value cleared: `{ value, option, path }` (`path` holds the groups and the leaf) |
|
|
36
|
+
| opened | The panel was opened |
|
|
37
|
+
| closed | The panel was closed (the control is marked as touched) |
|
|
38
|
+
|
|
39
|
+
## Keyboard
|
|
40
|
+
| Key | Action |
|
|
41
|
+
|---|---|
|
|
42
|
+
| Enter / Space / ArrowDown | Opens the panel at the current value |
|
|
43
|
+
| ArrowDown / ArrowUp | Next / previous item in the column, skipping disabled ones |
|
|
44
|
+
| ArrowRight / Enter | Opens a group and moves into it |
|
|
45
|
+
| ArrowLeft | Back to the parent column |
|
|
46
|
+
| Home / End | First / last item of the column |
|
|
47
|
+
| Enter / Space | Picks a leaf and closes |
|
|
48
|
+
| Letters | Jump to the item that starts with the typed text |
|
|
49
|
+
| Escape | Closes the panel |
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# Checkbox
|
|
2
|
+
|
|
3
|
+
A checkbox on a native `<input type="checkbox">`: one boolean, a value in an array, or a group with "select all". Space toggles, the label toggles, screen readers hear the native control.
|
|
4
|
+
|
|
5
|
+
```html
|
|
6
|
+
<tx-checkbox label="Send me the weekly report" formControlName="report" />
|
|
7
|
+
|
|
8
|
+
<tx-checkbox-group formControlName="permissions" [selectAll]="true" ariaLabel="Permissions">
|
|
9
|
+
<tx-checkbox value="read" label="Read" />
|
|
10
|
+
<tx-checkbox value="write" label="Write" />
|
|
11
|
+
</tx-checkbox-group>
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
Without `value` the checkbox is binary (`trueValue` / `falseValue`). With `value` it adds or removes that value in an array — its own form control, or the one of `tx-checkbox-group`.
|
|
15
|
+
|
|
16
|
+
## Inputs
|
|
17
|
+
| Name | Description |
|
|
18
|
+
|---|---|
|
|
19
|
+
| label | Text of the label; content inside the tag is added after it |
|
|
20
|
+
| description | Muted text under the label, linked with `aria-describedby` |
|
|
21
|
+
| value | Value added to the array when checked (group / array mode) |
|
|
22
|
+
| binary | Forces binary mode even with a `value` |
|
|
23
|
+
| trueValue | Binary mode: model value when checked |
|
|
24
|
+
| falseValue | Binary mode: model value when not checked |
|
|
25
|
+
| indeterminate | Mixed state (`aria-checked="mixed"`); clears on the next click |
|
|
26
|
+
| icon | Icon of the checked state |
|
|
27
|
+
| indeterminateIcon | Icon of the mixed state |
|
|
28
|
+
| size | `small`, `medium`, `large` (inherits the group) |
|
|
29
|
+
| variant | `outlined` or `filled` (inherits the group) |
|
|
30
|
+
| tile | Option tile look: the whole card toggles, with a border and a checked background |
|
|
31
|
+
| invalid | Red border; without it the checkbox follows its form control |
|
|
32
|
+
| disabled | Disables the checkbox (also from the form control or the group) |
|
|
33
|
+
| readonly | Shows the value, ignores clicks |
|
|
34
|
+
| required | Native `required` |
|
|
35
|
+
| name | Native `name` (inherits the group) |
|
|
36
|
+
| inputId | Id of the native input, for an outside `<label for>` |
|
|
37
|
+
| ariaLabel | Accessible name when there is no visible label |
|
|
38
|
+
| ariaLabelledBy | Id of the element that names the checkbox |
|
|
39
|
+
| tabindex | Tab order of the native input |
|
|
40
|
+
| selectAll | `tx-checkbox-group`: adds a "select all" checkbox above, mixed when some are checked |
|
|
41
|
+
| selectAllLabel | `tx-checkbox-group`: text of "select all" (translated by default) |
|
|
42
|
+
| orientation | `tx-checkbox-group`: `vertical` or `horizontal` |
|
|
43
|
+
| dt | Design tokens of this instance (`checkbox`) |
|
|
44
|
+
| pt | Classes and styles of the parts: `root`, `box`, `input`, `icon`, `label`, `description`; group: `root`, `selectAll`, `items` |
|
|
45
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
46
|
+
| unstyled | Removes the tectra styles, keeps the native input |
|
|
47
|
+
|
|
48
|
+
## Outputs
|
|
49
|
+
| Name | Description |
|
|
50
|
+
|---|---|
|
|
51
|
+
| changed | Checkbox: `{ checked, value, originalEvent }` after a toggle; group: the new array |
|
|
52
|
+
| indeterminateChange | The mixed state was cleared by a click |
|
|
53
|
+
|
|
54
|
+
## Slots
|
|
55
|
+
| Name | Description |
|
|
56
|
+
|---|---|
|
|
57
|
+
| default | Checkbox: extra label content; group: the checkboxes |
|
|
58
|
+
| txCheckboxIcon | `<ng-template txCheckboxIcon let-checked let-indeterminate="indeterminate">` — own indicator icon |
|
|
59
|
+
|
|
60
|
+
## Keyboard
|
|
61
|
+
| Key | Action |
|
|
62
|
+
|---|---|
|
|
63
|
+
| Space | Toggles the focused checkbox |
|
|
64
|
+
| Tab | Moves to the next checkbox |
|
package/chip/README.md
ADDED
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# Chip
|
|
2
|
+
|
|
3
|
+
A compact item a person picked or entered — a recipient, a filter, a person with a photo. A label, an icon or an image, and a remove button.
|
|
4
|
+
|
|
5
|
+
```html
|
|
6
|
+
<tx-chip label="Olena Kovalenko" image="/avatars/olena.jpg" alt="" [removable]="true" (removed)="drop(person)" />
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
## Inputs
|
|
10
|
+
| Name | Description |
|
|
11
|
+
|---|---|
|
|
12
|
+
| label | Text of the chip; content inside the tag is added after it |
|
|
13
|
+
| icon | Icon before the text: tectra name, `pi-` name or icon class |
|
|
14
|
+
| image | Round image before the text, e.g. an avatar |
|
|
15
|
+
| alt | Alternative text of the image (empty when the label already says it) |
|
|
16
|
+
| removable | Adds a remove button |
|
|
17
|
+
| removeIcon | Icon of the remove button |
|
|
18
|
+
| removeLabel | Label of the remove button (translated "Remove" by default) |
|
|
19
|
+
| dt | Design tokens of this instance (`chip`) |
|
|
20
|
+
| pt | Classes and styles of the parts: `root`, `image`, `icon`, `label`, `remove` |
|
|
21
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
22
|
+
| unstyled | Removes the tectra styles |
|
|
23
|
+
|
|
24
|
+
## Outputs
|
|
25
|
+
| Name | Description |
|
|
26
|
+
|---|---|
|
|
27
|
+
| removed | The remove button was pressed |
|
|
28
|
+
|
|
29
|
+
## Slots
|
|
30
|
+
| Name | Description |
|
|
31
|
+
|---|---|
|
|
32
|
+
| default | The text |
|
|
33
|
+
|
|
34
|
+
## Keyboard
|
|
35
|
+
| Key | Action |
|
|
36
|
+
|---|---|
|
|
37
|
+
| Tab | Reaches the remove button |
|
|
38
|
+
| Enter / Space / Delete / Backspace | Removes the chip from its remove button |
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# Chips input
|
|
2
|
+
|
|
3
|
+
A text field that turns what you type into chips — keywords, tags, emails, domains. The value is an array of strings; works with `[formControl]`, `ngModel` and signal forms.
|
|
4
|
+
|
|
5
|
+
## Inputs
|
|
6
|
+
| Name | Description |
|
|
7
|
+
|---|---|
|
|
8
|
+
| placeholder | Text shown while the field is empty |
|
|
9
|
+
| separator | Text or pattern that ends a chip while typing and splits pasted text (`,` by default); Enter always adds |
|
|
10
|
+
| addOnBlur | Adds the typed text when the field loses focus (on by default) |
|
|
11
|
+
| allowDuplicate | Allows the same value twice |
|
|
12
|
+
| caseSensitive | Compares values with case when looking for duplicates |
|
|
13
|
+
| max | Maximum number of chips; the field becomes read-only when full |
|
|
14
|
+
| maxLength | Maximum length of one chip |
|
|
15
|
+
| itemPattern | Values that do not match are rejected (`rejected` output) |
|
|
16
|
+
| showClear | Shows a button that removes all chips |
|
|
17
|
+
| inputId | Id of the text field for a `<label for>` |
|
|
18
|
+
| ariaLabel | Accessible name of the text field |
|
|
19
|
+
| ariaLabelledBy | Id of the element that labels the field |
|
|
20
|
+
| size | `small`, `medium`, `large` |
|
|
21
|
+
| variant | `outlined` or `filled` |
|
|
22
|
+
| invalid | Red border and `aria-invalid`; follows the form control by default |
|
|
23
|
+
| readonly | Shows the chips, cannot change them |
|
|
24
|
+
| dt | Design tokens of this instance (`chipsInput`) |
|
|
25
|
+
| pt | Classes and styles of the parts: `root`, `list`, `chip`, `input`, `clear` |
|
|
26
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
27
|
+
| unstyled | Removes the tectra styles |
|
|
28
|
+
|
|
29
|
+
## Outputs
|
|
30
|
+
| Name | Description |
|
|
31
|
+
|---|---|
|
|
32
|
+
| added | A chip was added: `{ value, values }` |
|
|
33
|
+
| removed | A chip was removed: `{ value, values }` |
|
|
34
|
+
| rejected | A value was not added — duplicate, over `max` or not matching `itemPattern`: `{ value, values }` |
|
|
35
|
+
|
|
36
|
+
## Slots
|
|
37
|
+
| Name | Description |
|
|
38
|
+
|---|---|
|
|
39
|
+
| txChipsInputItem | `<ng-template txChipsInputItem let-item let-index="index">` — own content of a chip |
|
|
40
|
+
|
|
41
|
+
## Keyboard
|
|
42
|
+
| Key | Action |
|
|
43
|
+
|---|---|
|
|
44
|
+
| Enter / separator | Adds the typed text as a chip |
|
|
45
|
+
| Backspace | In an empty field, removes the last chip |
|
|
46
|
+
| Tab | Moves to the remove buttons of the chips; Delete / Backspace or Enter there removes the chip |
|
|
47
|
+
| Ctrl / ⌘ + V | Pasted text is split into chips by lines and the separator |
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Color picker
|
|
2
|
+
|
|
3
|
+
Pick a colour in a popover or inline: a saturation / brightness area, a hue slider, a hex field and preset swatches. Every part works from the keyboard. The value is a hex string by default (`#3366cc`), or an `{ r, g, b }` / `{ h, s, b }` object; works with `[formControl]`, `ngModel` and signal forms. Also exports `parseHex`, `rgbToHex`, `rgbToHsb`, `hsbToRgb`.
|
|
4
|
+
|
|
5
|
+
## Inputs
|
|
6
|
+
| Name | Description |
|
|
7
|
+
|---|---|
|
|
8
|
+
| format | `hex`, `rgb` or `hsb` — the type of the value |
|
|
9
|
+
| inline | Shows the panel in place instead of a button with a popover |
|
|
10
|
+
| presets | Hex colours shown as swatches |
|
|
11
|
+
| showClear | Button that removes the colour (`null`) |
|
|
12
|
+
| showInput | Hex field in the panel (on by default) |
|
|
13
|
+
| showValue | Hex text next to the swatch on the button (on by default) |
|
|
14
|
+
| placeholder | Text on the button without a colour |
|
|
15
|
+
| inputId | Id of the button for a `<label for>` |
|
|
16
|
+
| ariaLabel | Accessible name of the button and the panel |
|
|
17
|
+
| ariaLabelledBy | Id of the element that labels the button |
|
|
18
|
+
| size | `small`, `medium`, `large` |
|
|
19
|
+
| invalid | Red border and `aria-invalid`; follows the form control by default |
|
|
20
|
+
| readonly | Shows the colour, cannot change it |
|
|
21
|
+
| dt | Design tokens of this instance (`colorPicker`) |
|
|
22
|
+
| pt | Classes and styles of the parts: `root`, `trigger`, `swatch`, `panel`, `area`, `hue`, `input`, `presets`, `preset`, `clear` |
|
|
23
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
24
|
+
| unstyled | Removes the tectra styles |
|
|
25
|
+
|
|
26
|
+
## Outputs
|
|
27
|
+
| Name | Description |
|
|
28
|
+
|---|---|
|
|
29
|
+
| changed | The user changed the colour (`null` when cleared) |
|
|
30
|
+
| opened | The popover was opened |
|
|
31
|
+
| closed | The popover was closed (the control is marked as touched) |
|
|
32
|
+
|
|
33
|
+
## Keyboard
|
|
34
|
+
| Key | Action |
|
|
35
|
+
|---|---|
|
|
36
|
+
| Enter / Space | On the button: opens the popover, focus goes to the area |
|
|
37
|
+
| ArrowLeft / ArrowRight | Area: saturation − / +; hue slider: hue − / + |
|
|
38
|
+
| ArrowUp / ArrowDown | Area: brightness + / −; hue slider: hue + / − |
|
|
39
|
+
| Shift + arrows | Steps of 10 |
|
|
40
|
+
| PageUp / PageDown | Brightness or hue by 10 |
|
|
41
|
+
| Home / End | Area: no / full saturation; hue slider: 0 / 360 |
|
|
42
|
+
| Tab | Moves between the area, the hue slider, the hex field and the presets; leaving the popover closes it |
|
|
43
|
+
| Escape | Closes the popover and returns focus to the button |
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# Confirm
|
|
2
|
+
|
|
3
|
+
Asks the user to confirm an action before it happens — delete, archive, revoke, leave. `TxConfirmService.dialog()` asks in a small alert dialog, `popup()` right next to the button; both resolve to `true` or `false`.
|
|
4
|
+
|
|
5
|
+
```ts
|
|
6
|
+
private confirm = inject(TxConfirmService);
|
|
7
|
+
|
|
8
|
+
async remove(file: StoredFile): Promise<void> {
|
|
9
|
+
const ok = await this.confirm.dialog({
|
|
10
|
+
title: `Delete “${file.name}”?`,
|
|
11
|
+
message: 'The file and its history will be gone.',
|
|
12
|
+
severity: 'danger',
|
|
13
|
+
});
|
|
14
|
+
if (ok) {
|
|
15
|
+
this.files.remove(file);
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
```html
|
|
21
|
+
<button txButton icon="trash" (click)="confirm.popup($event, { message: 'Remove this member?', severity: 'danger', acceptLabel: 'Remove' })"></button>
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
An `accept` function runs before the answer: the accept button shows a spinner, the dialog cannot be dismissed meanwhile, and when the promise rejects the dialog stays open so the user can try again.
|
|
25
|
+
|
|
26
|
+
## Options
|
|
27
|
+
| Name | Description |
|
|
28
|
+
|---|---|
|
|
29
|
+
| title | Question in bold; "Are you sure?" by default (translated) |
|
|
30
|
+
| message | Details under it; also describes the dialog |
|
|
31
|
+
| severity | `primary` (default), `info`, `success`, `warn`, `danger` — colour of the icon and the accept button |
|
|
32
|
+
| icon | Own icon name, or `false` for none; by default it follows the severity |
|
|
33
|
+
| acceptLabel | Text of the accept button; "Confirm", or "Delete" for `danger` (translated) |
|
|
34
|
+
| rejectLabel | Text of the reject button; "Cancel" (translated) |
|
|
35
|
+
| acceptIcon | Icon on the accept button; a trash can for `danger` |
|
|
36
|
+
| defaultFocus | `reject` (default — the safe choice) or `accept` |
|
|
37
|
+
| accept | Runs on accept; may return a promise — the button waits, a rejection keeps the dialog open |
|
|
38
|
+
| placement | Popup only: one of the 12 placements, `bottom` by default |
|
|
39
|
+
| dt | Design tokens (`confirm`) |
|
|
40
|
+
|
|
41
|
+
## Keyboard
|
|
42
|
+
| Key | Action |
|
|
43
|
+
|---|---|
|
|
44
|
+
| Tab / Shift + Tab | Moves between the two buttons; focus stays inside |
|
|
45
|
+
| Enter / Space | Runs the focused button |
|
|
46
|
+
| Escape | Answers `false` |
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Country
|
|
2
|
+
|
|
3
|
+
A country as a flag and its name. The name comes from `Intl.DisplayNames` in the current tectra locale, so it follows `setLocale`. Unknown values are shown as plain text. Also exports the ISO 3166-1 code list (`TX_COUNTRY_CODES`), `countryName`, `countryEmoji` and `isCountryCode`.
|
|
4
|
+
|
|
5
|
+
Flags are emoji by default — no assets to load. To draw them with a flag set, provide a resolver once:
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
provideTxFlags(txFlagIcons) // CSS classes of the flag-icons package: fi fi-ua (+ fis for circles)
|
|
9
|
+
provideTxFlags(txFlagImages((code) => `/assets/flags/${code}.svg`)) // your own images
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Inputs
|
|
13
|
+
| Name | Description |
|
|
14
|
+
|---|---|
|
|
15
|
+
| country | ISO 3166-1 alpha-2 code, any case (`ua`, `PL`); other text is shown as it is |
|
|
16
|
+
| name | Own name instead of the localized one |
|
|
17
|
+
| showName | Shows the name next to the flag (on by default); without it the flag is an image named by the country |
|
|
18
|
+
| size | `small` (16px), `medium` (20px), `large` (24px) |
|
|
19
|
+
| shape | `rectangle` or `circle` (image and class flags) |
|
|
20
|
+
| dt | Design tokens of this instance (`country`) |
|
|
21
|
+
| pt | Classes and styles of the parts: `root`, `flag`, `name` |
|
|
22
|
+
| ptOptions | How `pt` merges with the global pass-through |
|
|
23
|
+
| unstyled | Removes the tectra styles |
|