@tectra-ng/ui 0.0.0-stage → 0.1.0

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.
Files changed (317) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +26 -2
  3. package/amount/README.md +28 -0
  4. package/autocomplete/README.md +82 -0
  5. package/avatar/README.md +43 -0
  6. package/badge/README.md +19 -0
  7. package/button/README.md +46 -0
  8. package/button-group/README.md +8 -0
  9. package/card/README.md +30 -0
  10. package/cascade-select/README.md +49 -0
  11. package/checkbox/README.md +64 -0
  12. package/chip/README.md +38 -0
  13. package/chips-input/README.md +47 -0
  14. package/color-picker/README.md +43 -0
  15. package/confirm/README.md +46 -0
  16. package/country/README.md +23 -0
  17. package/country-select/README.md +39 -0
  18. package/dialog/README.md +84 -0
  19. package/divider/README.md +24 -0
  20. package/drawer/README.md +54 -0
  21. package/email-suggestion/README.md +20 -0
  22. package/fesm2022/tectra-ng-ui-amount.mjs +415 -0
  23. package/fesm2022/tectra-ng-ui-amount.mjs.map +1 -0
  24. package/fesm2022/tectra-ng-ui-autocomplete.mjs +730 -0
  25. package/fesm2022/tectra-ng-ui-autocomplete.mjs.map +1 -0
  26. package/fesm2022/tectra-ng-ui-avatar.mjs +670 -0
  27. package/fesm2022/tectra-ng-ui-avatar.mjs.map +1 -0
  28. package/fesm2022/tectra-ng-ui-badge.mjs +191 -0
  29. package/fesm2022/tectra-ng-ui-badge.mjs.map +1 -0
  30. package/fesm2022/tectra-ng-ui-button-group.mjs +50 -0
  31. package/fesm2022/tectra-ng-ui-button-group.mjs.map +1 -0
  32. package/fesm2022/tectra-ng-ui-button.mjs +725 -0
  33. package/fesm2022/tectra-ng-ui-button.mjs.map +1 -0
  34. package/fesm2022/tectra-ng-ui-card.mjs +210 -0
  35. package/fesm2022/tectra-ng-ui-card.mjs.map +1 -0
  36. package/fesm2022/tectra-ng-ui-cascade-select.mjs +887 -0
  37. package/fesm2022/tectra-ng-ui-cascade-select.mjs.map +1 -0
  38. package/fesm2022/tectra-ng-ui-checkbox.mjs +1150 -0
  39. package/fesm2022/tectra-ng-ui-checkbox.mjs.map +1 -0
  40. package/fesm2022/tectra-ng-ui-chip.mjs +344 -0
  41. package/fesm2022/tectra-ng-ui-chip.mjs.map +1 -0
  42. package/fesm2022/tectra-ng-ui-chips-input.mjs +649 -0
  43. package/fesm2022/tectra-ng-ui-chips-input.mjs.map +1 -0
  44. package/fesm2022/tectra-ng-ui-color-picker.mjs +828 -0
  45. package/fesm2022/tectra-ng-ui-color-picker.mjs.map +1 -0
  46. package/fesm2022/tectra-ng-ui-confirm.mjs +489 -0
  47. package/fesm2022/tectra-ng-ui-confirm.mjs.map +1 -0
  48. package/fesm2022/tectra-ng-ui-country-select.mjs +545 -0
  49. package/fesm2022/tectra-ng-ui-country-select.mjs.map +1 -0
  50. package/fesm2022/tectra-ng-ui-country.mjs +313 -0
  51. package/fesm2022/tectra-ng-ui-country.mjs.map +1 -0
  52. package/fesm2022/tectra-ng-ui-dialog.mjs +1539 -0
  53. package/fesm2022/tectra-ng-ui-dialog.mjs.map +1 -0
  54. package/fesm2022/tectra-ng-ui-divider.mjs +194 -0
  55. package/fesm2022/tectra-ng-ui-divider.mjs.map +1 -0
  56. package/fesm2022/tectra-ng-ui-drawer.mjs +540 -0
  57. package/fesm2022/tectra-ng-ui-drawer.mjs.map +1 -0
  58. package/fesm2022/tectra-ng-ui-email-suggestion.mjs +341 -0
  59. package/fesm2022/tectra-ng-ui-email-suggestion.mjs.map +1 -0
  60. package/fesm2022/tectra-ng-ui-field.mjs +492 -0
  61. package/fesm2022/tectra-ng-ui-field.mjs.map +1 -0
  62. package/fesm2022/tectra-ng-ui-fieldset.mjs +258 -0
  63. package/fesm2022/tectra-ng-ui-fieldset.mjs.map +1 -0
  64. package/fesm2022/tectra-ng-ui-highlight-text.mjs +246 -0
  65. package/fesm2022/tectra-ng-ui-highlight-text.mjs.map +1 -0
  66. package/fesm2022/tectra-ng-ui-icon-field.mjs +478 -0
  67. package/fesm2022/tectra-ng-ui-icon-field.mjs.map +1 -0
  68. package/fesm2022/tectra-ng-ui-input-group.mjs +113 -0
  69. package/fesm2022/tectra-ng-ui-input-group.mjs.map +1 -0
  70. package/fesm2022/tectra-ng-ui-input-mask.mjs +413 -0
  71. package/fesm2022/tectra-ng-ui-input-mask.mjs.map +1 -0
  72. package/fesm2022/tectra-ng-ui-input-number.mjs +1045 -0
  73. package/fesm2022/tectra-ng-ui-input-number.mjs.map +1 -0
  74. package/fesm2022/tectra-ng-ui-input-otp.mjs +553 -0
  75. package/fesm2022/tectra-ng-ui-input-otp.mjs.map +1 -0
  76. package/fesm2022/tectra-ng-ui-input.mjs +260 -0
  77. package/fesm2022/tectra-ng-ui-input.mjs.map +1 -0
  78. package/fesm2022/tectra-ng-ui-key-filter.mjs +185 -0
  79. package/fesm2022/tectra-ng-ui-key-filter.mjs.map +1 -0
  80. package/fesm2022/tectra-ng-ui-knob.mjs +630 -0
  81. package/fesm2022/tectra-ng-ui-knob.mjs.map +1 -0
  82. package/fesm2022/tectra-ng-ui-label.mjs +271 -0
  83. package/fesm2022/tectra-ng-ui-label.mjs.map +1 -0
  84. package/fesm2022/tectra-ng-ui-link.mjs +699 -0
  85. package/fesm2022/tectra-ng-ui-link.mjs.map +1 -0
  86. package/fesm2022/tectra-ng-ui-listbox.mjs +484 -0
  87. package/fesm2022/tectra-ng-ui-listbox.mjs.map +1 -0
  88. package/fesm2022/tectra-ng-ui-mention-textarea.mjs +717 -0
  89. package/fesm2022/tectra-ng-ui-mention-textarea.mjs.map +1 -0
  90. package/fesm2022/tectra-ng-ui-menu.mjs +1484 -0
  91. package/fesm2022/tectra-ng-ui-menu.mjs.map +1 -0
  92. package/fesm2022/tectra-ng-ui-message.mjs +975 -0
  93. package/fesm2022/tectra-ng-ui-message.mjs.map +1 -0
  94. package/fesm2022/tectra-ng-ui-multiselect.mjs +569 -0
  95. package/fesm2022/tectra-ng-ui-multiselect.mjs.map +1 -0
  96. package/fesm2022/tectra-ng-ui-overlay-badge.mjs +345 -0
  97. package/fesm2022/tectra-ng-ui-overlay-badge.mjs.map +1 -0
  98. package/fesm2022/tectra-ng-ui-paginator.mjs +849 -0
  99. package/fesm2022/tectra-ng-ui-paginator.mjs.map +1 -0
  100. package/fesm2022/tectra-ng-ui-panel.mjs +317 -0
  101. package/fesm2022/tectra-ng-ui-panel.mjs.map +1 -0
  102. package/fesm2022/tectra-ng-ui-password-generator.mjs +292 -0
  103. package/fesm2022/tectra-ng-ui-password-generator.mjs.map +1 -0
  104. package/fesm2022/tectra-ng-ui-password.mjs +871 -0
  105. package/fesm2022/tectra-ng-ui-password.mjs.map +1 -0
  106. package/fesm2022/tectra-ng-ui-pill.mjs +361 -0
  107. package/fesm2022/tectra-ng-ui-pill.mjs.map +1 -0
  108. package/fesm2022/tectra-ng-ui-popover.mjs +742 -0
  109. package/fesm2022/tectra-ng-ui-popover.mjs.map +1 -0
  110. package/fesm2022/tectra-ng-ui-progress-bar.mjs +440 -0
  111. package/fesm2022/tectra-ng-ui-progress-bar.mjs.map +1 -0
  112. package/fesm2022/tectra-ng-ui-progress-spinner.mjs +265 -0
  113. package/fesm2022/tectra-ng-ui-progress-spinner.mjs.map +1 -0
  114. package/fesm2022/tectra-ng-ui-radio-button.mjs +817 -0
  115. package/fesm2022/tectra-ng-ui-radio-button.mjs.map +1 -0
  116. package/fesm2022/tectra-ng-ui-rating.mjs +584 -0
  117. package/fesm2022/tectra-ng-ui-rating.mjs.map +1 -0
  118. package/fesm2022/tectra-ng-ui-select.mjs +2478 -0
  119. package/fesm2022/tectra-ng-ui-select.mjs.map +1 -0
  120. package/fesm2022/tectra-ng-ui-skeleton.mjs +548 -0
  121. package/fesm2022/tectra-ng-ui-skeleton.mjs.map +1 -0
  122. package/fesm2022/tectra-ng-ui-slider.mjs +630 -0
  123. package/fesm2022/tectra-ng-ui-slider.mjs.map +1 -0
  124. package/fesm2022/tectra-ng-ui-speed-dial.mjs +669 -0
  125. package/fesm2022/tectra-ng-ui-speed-dial.mjs.map +1 -0
  126. package/fesm2022/tectra-ng-ui-split-button.mjs +614 -0
  127. package/fesm2022/tectra-ng-ui-split-button.mjs.map +1 -0
  128. package/fesm2022/tectra-ng-ui-status-icon.mjs +295 -0
  129. package/fesm2022/tectra-ng-ui-status-icon.mjs.map +1 -0
  130. package/fesm2022/tectra-ng-ui-table.mjs +5997 -0
  131. package/fesm2022/tectra-ng-ui-table.mjs.map +1 -0
  132. package/fesm2022/tectra-ng-ui-tag.mjs +422 -0
  133. package/fesm2022/tectra-ng-ui-tag.mjs.map +1 -0
  134. package/fesm2022/tectra-ng-ui-textarea.mjs +482 -0
  135. package/fesm2022/tectra-ng-ui-textarea.mjs.map +1 -0
  136. package/fesm2022/tectra-ng-ui-toast.mjs +668 -0
  137. package/fesm2022/tectra-ng-ui-toast.mjs.map +1 -0
  138. package/fesm2022/tectra-ng-ui-toggle-button.mjs +416 -0
  139. package/fesm2022/tectra-ng-ui-toggle-button.mjs.map +1 -0
  140. package/fesm2022/tectra-ng-ui-toggle-switch.mjs +560 -0
  141. package/fesm2022/tectra-ng-ui-toggle-switch.mjs.map +1 -0
  142. package/fesm2022/tectra-ng-ui-tooltip.mjs +835 -0
  143. package/fesm2022/tectra-ng-ui-tooltip.mjs.map +1 -0
  144. package/fesm2022/tectra-ng-ui-tree-select.mjs +986 -0
  145. package/fesm2022/tectra-ng-ui-tree-select.mjs.map +1 -0
  146. package/fesm2022/tectra-ng-ui.mjs +4 -0
  147. package/fesm2022/tectra-ng-ui.mjs.map +1 -0
  148. package/field/README.md +43 -0
  149. package/fieldset/README.md +36 -0
  150. package/highlight-text/README.md +20 -0
  151. package/icon-field/README.md +30 -0
  152. package/input/README.md +22 -0
  153. package/input-group/README.md +21 -0
  154. package/input-mask/README.md +30 -0
  155. package/input-number/README.md +61 -0
  156. package/input-otp/README.md +44 -0
  157. package/key-filter/README.md +31 -0
  158. package/knob/README.md +50 -0
  159. package/label/README.md +29 -0
  160. package/link/README.md +47 -0
  161. package/listbox/README.md +68 -0
  162. package/mention-textarea/README.md +47 -0
  163. package/menu/README.md +65 -0
  164. package/message/README.md +58 -0
  165. package/multiselect/README.md +85 -0
  166. package/overlay-badge/README.md +30 -0
  167. package/package.json +301 -3
  168. package/paginator/README.md +60 -0
  169. package/panel/README.md +45 -0
  170. package/password/README.md +60 -0
  171. package/password-generator/README.md +34 -0
  172. package/pill/README.md +42 -0
  173. package/popover/README.md +67 -0
  174. package/progress-bar/README.md +32 -0
  175. package/progress-spinner/README.md +22 -0
  176. package/radio-button/README.md +54 -0
  177. package/rating/README.md +49 -0
  178. package/select/README.md +78 -0
  179. package/skeleton/README.md +27 -0
  180. package/slider/README.md +48 -0
  181. package/speed-dial/README.md +49 -0
  182. package/split-button/README.md +45 -0
  183. package/status-icon/README.md +22 -0
  184. package/table/README.md +178 -0
  185. package/tag/README.md +42 -0
  186. package/textarea/README.md +37 -0
  187. package/toast/README.md +52 -0
  188. package/toggle-button/README.md +34 -0
  189. package/toggle-switch/README.md +49 -0
  190. package/tooltip/README.md +60 -0
  191. package/tree-select/README.md +49 -0
  192. package/types/tectra-ng-ui-amount.d.ts +135 -0
  193. package/types/tectra-ng-ui-amount.d.ts.map +1 -0
  194. package/types/tectra-ng-ui-autocomplete.d.ts +250 -0
  195. package/types/tectra-ng-ui-autocomplete.d.ts.map +1 -0
  196. package/types/tectra-ng-ui-avatar.d.ts +289 -0
  197. package/types/tectra-ng-ui-avatar.d.ts.map +1 -0
  198. package/types/tectra-ng-ui-badge.d.ts +119 -0
  199. package/types/tectra-ng-ui-badge.d.ts.map +1 -0
  200. package/types/tectra-ng-ui-button-group.d.ts +6 -0
  201. package/types/tectra-ng-ui-button-group.d.ts.map +1 -0
  202. package/types/tectra-ng-ui-button.d.ts +466 -0
  203. package/types/tectra-ng-ui-button.d.ts.map +1 -0
  204. package/types/tectra-ng-ui-card.d.ts +71 -0
  205. package/types/tectra-ng-ui-card.d.ts.map +1 -0
  206. package/types/tectra-ng-ui-cascade-select.d.ts +244 -0
  207. package/types/tectra-ng-ui-cascade-select.d.ts.map +1 -0
  208. package/types/tectra-ng-ui-checkbox.d.ts +450 -0
  209. package/types/tectra-ng-ui-checkbox.d.ts.map +1 -0
  210. package/types/tectra-ng-ui-chip.d.ts +106 -0
  211. package/types/tectra-ng-ui-chip.d.ts.map +1 -0
  212. package/types/tectra-ng-ui-chips-input.d.ts +187 -0
  213. package/types/tectra-ng-ui-chips-input.d.ts.map +1 -0
  214. package/types/tectra-ng-ui-color-picker.d.ts +237 -0
  215. package/types/tectra-ng-ui-color-picker.d.ts.map +1 -0
  216. package/types/tectra-ng-ui-confirm.d.ts +80 -0
  217. package/types/tectra-ng-ui-confirm.d.ts.map +1 -0
  218. package/types/tectra-ng-ui-country-select.d.ts +235 -0
  219. package/types/tectra-ng-ui-country-select.d.ts.map +1 -0
  220. package/types/tectra-ng-ui-country.d.ts +105 -0
  221. package/types/tectra-ng-ui-country.d.ts.map +1 -0
  222. package/types/tectra-ng-ui-dialog.d.ts +453 -0
  223. package/types/tectra-ng-ui-dialog.d.ts.map +1 -0
  224. package/types/tectra-ng-ui-divider.d.ts +70 -0
  225. package/types/tectra-ng-ui-divider.d.ts.map +1 -0
  226. package/types/tectra-ng-ui-drawer.d.ts +188 -0
  227. package/types/tectra-ng-ui-drawer.d.ts.map +1 -0
  228. package/types/tectra-ng-ui-email-suggestion.d.ts +84 -0
  229. package/types/tectra-ng-ui-email-suggestion.d.ts.map +1 -0
  230. package/types/tectra-ng-ui-field.d.ts +139 -0
  231. package/types/tectra-ng-ui-field.d.ts.map +1 -0
  232. package/types/tectra-ng-ui-fieldset.d.ts +74 -0
  233. package/types/tectra-ng-ui-fieldset.d.ts.map +1 -0
  234. package/types/tectra-ng-ui-highlight-text.d.ts +75 -0
  235. package/types/tectra-ng-ui-highlight-text.d.ts.map +1 -0
  236. package/types/tectra-ng-ui-icon-field.d.ts +77 -0
  237. package/types/tectra-ng-ui-icon-field.d.ts.map +1 -0
  238. package/types/tectra-ng-ui-input-group.d.ts +18 -0
  239. package/types/tectra-ng-ui-input-group.d.ts.map +1 -0
  240. package/types/tectra-ng-ui-input-mask.d.ts +91 -0
  241. package/types/tectra-ng-ui-input-mask.d.ts.map +1 -0
  242. package/types/tectra-ng-ui-input-number.d.ts +326 -0
  243. package/types/tectra-ng-ui-input-number.d.ts.map +1 -0
  244. package/types/tectra-ng-ui-input-otp.d.ts +173 -0
  245. package/types/tectra-ng-ui-input-otp.d.ts.map +1 -0
  246. package/types/tectra-ng-ui-input.d.ts +113 -0
  247. package/types/tectra-ng-ui-input.d.ts.map +1 -0
  248. package/types/tectra-ng-ui-key-filter.d.ts +43 -0
  249. package/types/tectra-ng-ui-key-filter.d.ts.map +1 -0
  250. package/types/tectra-ng-ui-knob.d.ts +207 -0
  251. package/types/tectra-ng-ui-knob.d.ts.map +1 -0
  252. package/types/tectra-ng-ui-label.d.ts +53 -0
  253. package/types/tectra-ng-ui-label.d.ts.map +1 -0
  254. package/types/tectra-ng-ui-link.d.ts +223 -0
  255. package/types/tectra-ng-ui-link.d.ts.map +1 -0
  256. package/types/tectra-ng-ui-listbox.d.ts +131 -0
  257. package/types/tectra-ng-ui-listbox.d.ts.map +1 -0
  258. package/types/tectra-ng-ui-mention-textarea.d.ts +169 -0
  259. package/types/tectra-ng-ui-mention-textarea.d.ts.map +1 -0
  260. package/types/tectra-ng-ui-menu.d.ts +512 -0
  261. package/types/tectra-ng-ui-menu.d.ts.map +1 -0
  262. package/types/tectra-ng-ui-message.d.ts +390 -0
  263. package/types/tectra-ng-ui-message.d.ts.map +1 -0
  264. package/types/tectra-ng-ui-multiselect.d.ts +216 -0
  265. package/types/tectra-ng-ui-multiselect.d.ts.map +1 -0
  266. package/types/tectra-ng-ui-overlay-badge.d.ts +104 -0
  267. package/types/tectra-ng-ui-overlay-badge.d.ts.map +1 -0
  268. package/types/tectra-ng-ui-paginator.d.ts +293 -0
  269. package/types/tectra-ng-ui-paginator.d.ts.map +1 -0
  270. package/types/tectra-ng-ui-panel.d.ts +133 -0
  271. package/types/tectra-ng-ui-panel.d.ts.map +1 -0
  272. package/types/tectra-ng-ui-password-generator.d.ts +80 -0
  273. package/types/tectra-ng-ui-password-generator.d.ts.map +1 -0
  274. package/types/tectra-ng-ui-password.d.ts +271 -0
  275. package/types/tectra-ng-ui-password.d.ts.map +1 -0
  276. package/types/tectra-ng-ui-pill.d.ts +167 -0
  277. package/types/tectra-ng-ui-pill.d.ts.map +1 -0
  278. package/types/tectra-ng-ui-popover.d.ts +244 -0
  279. package/types/tectra-ng-ui-popover.d.ts.map +1 -0
  280. package/types/tectra-ng-ui-progress-bar.d.ts +151 -0
  281. package/types/tectra-ng-ui-progress-bar.d.ts.map +1 -0
  282. package/types/tectra-ng-ui-progress-spinner.d.ts +95 -0
  283. package/types/tectra-ng-ui-progress-spinner.d.ts.map +1 -0
  284. package/types/tectra-ng-ui-radio-button.d.ts +380 -0
  285. package/types/tectra-ng-ui-radio-button.d.ts.map +1 -0
  286. package/types/tectra-ng-ui-rating.d.ts +195 -0
  287. package/types/tectra-ng-ui-rating.d.ts.map +1 -0
  288. package/types/tectra-ng-ui-select.d.ts +761 -0
  289. package/types/tectra-ng-ui-select.d.ts.map +1 -0
  290. package/types/tectra-ng-ui-skeleton.d.ts +182 -0
  291. package/types/tectra-ng-ui-skeleton.d.ts.map +1 -0
  292. package/types/tectra-ng-ui-slider.d.ts +220 -0
  293. package/types/tectra-ng-ui-slider.d.ts.map +1 -0
  294. package/types/tectra-ng-ui-speed-dial.d.ts +175 -0
  295. package/types/tectra-ng-ui-speed-dial.d.ts.map +1 -0
  296. package/types/tectra-ng-ui-split-button.d.ts +139 -0
  297. package/types/tectra-ng-ui-split-button.d.ts.map +1 -0
  298. package/types/tectra-ng-ui-status-icon.d.ts +105 -0
  299. package/types/tectra-ng-ui-status-icon.d.ts.map +1 -0
  300. package/types/tectra-ng-ui-table.d.ts +1301 -0
  301. package/types/tectra-ng-ui-table.d.ts.map +1 -0
  302. package/types/tectra-ng-ui-tag.d.ts +157 -0
  303. package/types/tectra-ng-ui-tag.d.ts.map +1 -0
  304. package/types/tectra-ng-ui-textarea.d.ts +146 -0
  305. package/types/tectra-ng-ui-textarea.d.ts.map +1 -0
  306. package/types/tectra-ng-ui-toast.d.ts +268 -0
  307. package/types/tectra-ng-ui-toast.d.ts.map +1 -0
  308. package/types/tectra-ng-ui-toggle-button.d.ts +184 -0
  309. package/types/tectra-ng-ui-toggle-button.d.ts.map +1 -0
  310. package/types/tectra-ng-ui-toggle-switch.d.ts +226 -0
  311. package/types/tectra-ng-ui-toggle-switch.d.ts.map +1 -0
  312. package/types/tectra-ng-ui-tooltip.d.ts +275 -0
  313. package/types/tectra-ng-ui-tooltip.d.ts.map +1 -0
  314. package/types/tectra-ng-ui-tree-select.d.ts +339 -0
  315. package/types/tectra-ng-ui-tree-select.d.ts.map +1 -0
  316. package/types/tectra-ng-ui.d.ts +2 -0
  317. package/types/tectra-ng-ui.d.ts.map +1 -0
@@ -0,0 +1,60 @@
1
+ # Paginator
2
+
3
+ Page navigation for long lists: first / previous / page / next / last buttons, a page size select, a page report, jump to page and a "Total: N" label.
4
+
5
+ ```html
6
+ <tx-paginator [(first)]="first" [rows]="10" [totalRecords]="total()" (pageChange)="load($event)" />
7
+ ```
8
+
9
+ `pageChange` gets `TxPageState` — `page` (0-based), `first`, `rows`, `pageCount`. Below 40rem the paginator is compact: fewer page links and no first / last buttons, so it fits one line on a phone.
10
+
11
+ For requests and responses of paginated lists use `TxPaginationParams` (`page` is 1-based, `limit` is the page size, `total` the number of records) and the helpers `pageToFirst`, `firstToPage`, `pageCountOf`.
12
+
13
+ ## Inputs
14
+ | Name | Description |
15
+ |---|---|
16
+ | first | Index of the first record on the current page. Two-way: `[(first)]` |
17
+ | rows | Records per page. Two-way: `[(rows)]` — the page size select writes it |
18
+ | totalRecords | Number of records in the whole list |
19
+ | pageLinkSize | How many page buttons are shown around the current page |
20
+ | compactPageLinkSize | Page buttons in compact mode |
21
+ | compactBreakpoint | Width below which the paginator is compact, e.g. `40rem`; `null` turns compact mode off |
22
+ | rowsPerPageOptions | Page sizes for the select — numbers, or `{ showAll: 'All' }` for every record. The current `rows` is added when missing; empty hides the select |
23
+ | alwaysShow | Shows the paginator also when there is only one page |
24
+ | showFirstLastIcon | Shows the first and last page buttons |
25
+ | showPageLinks | Shows the page number buttons |
26
+ | showCurrentPageReport | Shows the page report, "3 of 12" by default (translated) |
27
+ | currentPageReportTemplate | Own report text with `{currentPage}`, `{totalPages}`, `{first}`, `{last}`, `{rows}`, `{totalRecords}` |
28
+ | showJumpToPageDropdown | Shows a select with every page number |
29
+ | showJumpToPageInput | Shows a field for a page number — Enter or leaving the field goes there |
30
+ | showTotal | Shows "Total: N" (translated) at the start; above the paginator on narrow screens |
31
+ | disabled | Disables every control |
32
+ | locale | Locale of the numbers, e.g. `uk-UA`; the tectra locale by default |
33
+ | dropdownScrollHeight | Maximum height of the select lists |
34
+ | firstPageIcon | Icon of the first page button |
35
+ | previousPageIcon | Icon of the previous page button |
36
+ | nextPageIcon | Icon of the next page button |
37
+ | lastPageIcon | Icon of the last page button |
38
+ | ariaLabel | Name of the navigation; "Pagination" by default (translated) |
39
+ | dt | Design tokens (`paginator`) |
40
+ | pt | Classes and styles of the parts: `root`, `total`, `bar`, `start`, `end`, `currentPageReport`, `first`, `previous`, `pages`, `page`, `next`, `last`, `jumpToPageDropdown`, `jumpToPageInput`, `rowsPerPageDropdown` |
41
+ | ptOptions | How `pt` merges with the global pass-through |
42
+ | unstyled | Removes the tectra styles |
43
+
44
+ ## Outputs
45
+ | Name | Description |
46
+ |---|---|
47
+ | pageChange | The page or the page size changed (`TxPageState`) |
48
+
49
+ ## Slots
50
+ | Name | Description |
51
+ |---|---|
52
+ | txPaginatorStart | `<ng-template txPaginatorStart let-state>` — content at the start of the bar, gets `TxPageState` |
53
+ | txPaginatorEnd | `<ng-template txPaginatorEnd let-state>` — content at the end of the bar, gets `TxPageState` |
54
+
55
+ ## Keyboard
56
+ | Key | Action |
57
+ |---|---|
58
+ | Tab / Shift + Tab | Moves between the buttons, the page field and the selects |
59
+ | Enter / Space | On a button: goes to that page |
60
+ | Enter | In the page field: goes to the typed page |
@@ -0,0 +1,45 @@
1
+ # Panel
2
+
3
+ A titled section of a page: an icon, a title and a subtitle, actions in the header, the content and an optional footer. It can collapse. Three looks: `card` (a bordered box), `inset` (a tinted block inside a card) and `plain` (no box).
4
+
5
+ ```html
6
+ <tx-panel title="Members" subtitle="People who can open this project" icon="users">
7
+ <button txPanelActions txButton size="small">Invite</button>
8
+ …
9
+ </tx-panel>
10
+ ```
11
+
12
+ ## Inputs
13
+ | Name | Description |
14
+ |---|---|
15
+ | title | Title of the panel; also names the panel region |
16
+ | subtitle | Muted line under the title |
17
+ | icon | Icon in a tinted square before the title |
18
+ | variant | `card`, `inset` or `plain` |
19
+ | align | Vertical alignment of the title and the actions: `start`, `center`, `end` |
20
+ | headingLevel | Heading level of the title, 2 by default |
21
+ | toggleable | Adds a button that collapses the content |
22
+ | collapsed | Two-way: the content is collapsed |
23
+ | toggleLabel | Label of the collapse button (the title by default) |
24
+ | dt | Design tokens of this instance (`panel`) |
25
+ | pt | Classes and styles of the parts: `root`, `header`, `icon`, `title`, `subtitle`, `actions`, `toggle`, `body`, `footer` |
26
+ | ptOptions | How `pt` merges with the global pass-through |
27
+ | unstyled | Removes the tectra styles |
28
+
29
+ ## Outputs
30
+ | Name | Description |
31
+ |---|---|
32
+ | collapsedChange | The content was collapsed or expanded |
33
+
34
+ ## Slots
35
+ | Name | Description |
36
+ |---|---|
37
+ | default | The content |
38
+ | txPanelActions | Buttons or links on the right of the header |
39
+ | txPanelHeader | Extra content under the title, e.g. pills |
40
+ | txPanelFooter | Actions at the bottom |
41
+
42
+ ## Keyboard
43
+ | Key | Action |
44
+ |---|---|
45
+ | Enter / Space | Collapses or expands from the toggle button |
@@ -0,0 +1,60 @@
1
+ # Password
2
+
3
+ A password field: show / hide the text, a strength meter while typing, a clear button. The meter's levels, labels and rules are yours to change, and templates add a requirements list.
4
+
5
+ ```html
6
+ <tx-password formControlName="password" [toggleMask]="true" />
7
+ <tx-password formControlName="newPassword" [feedback]="true" [toggleMask]="true" autocomplete="new-password" />
8
+ ```
9
+
10
+ ## Inputs
11
+ | Name | Description |
12
+ |---|---|
13
+ | feedback | Shows the strength meter under the field while it has focus |
14
+ | toggleMask | Adds a button that shows or hides the password |
15
+ | showClear | Adds a clear button when there is text |
16
+ | placeholder | Placeholder of the input |
17
+ | promptLabel | Meter text before typing (translated by default) |
18
+ | weakLabel | Meter text for a weak password |
19
+ | mediumLabel | Meter text for a medium password |
20
+ | strongLabel | Meter text for a strong password |
21
+ | mediumRegex | Rule for a medium password (string or RegExp); default: 6+ characters with two of lower case, upper case, digits |
22
+ | strongRegex | Rule for a strong password; default: 8+ characters with lower case, upper case and a digit |
23
+ | autocomplete | Native `autocomplete`: `current-password` (default) for sign-in, `new-password` for sign-up |
24
+ | size | `small`, `medium`, `large` |
25
+ | variant | `outlined` or `filled` |
26
+ | fluid | Takes the full width of its container; inherits `<tx-fluid>` |
27
+ | invalid | Red border; without it the field follows its form control |
28
+ | disabled | Disables the field (also from the form control) |
29
+ | readonly | Shows the value, no editing |
30
+ | required | Native `required` |
31
+ | maxlength | Native `maxlength` |
32
+ | name | Native `name` |
33
+ | inputId | Id of the input, for an outside `<label for>` or a float label |
34
+ | ariaLabel | Accessible name when there is no visible label |
35
+ | ariaLabelledBy | Id of the element that names the field |
36
+ | tabindex | Tab order of the input |
37
+ | dt | Design tokens of this instance (`password`); the field itself uses `formField` |
38
+ | pt | Classes and styles of the parts: `root`, `input`, `toggle`, `clear`, `panel`, `meter`, `info` |
39
+ | ptOptions | How `pt` merges with the global pass-through |
40
+ | unstyled | Removes the tectra styles |
41
+
42
+ ## Outputs
43
+ | Name | Description |
44
+ |---|---|
45
+ | strengthChange | `weak`, `medium`, `strong`, or `null` when empty |
46
+ | cleared | The clear button emptied the field |
47
+
48
+ ## Slots
49
+ | Name | Description |
50
+ |---|---|
51
+ | txPasswordHeader | `<ng-template txPasswordHeader let-strength let-value="value">` — above the meter |
52
+ | txPasswordContent | `<ng-template txPasswordContent let-strength let-value="value">` — under the meter, e.g. a requirements list |
53
+ | txPasswordFooter | `<ng-template txPasswordFooter let-strength let-value="value">` — at the bottom of the panel |
54
+
55
+ ## Keyboard
56
+ | Key | Action |
57
+ |---|---|
58
+ | Tab | Moves from the field to the show / hide and clear buttons |
59
+ | Enter / Space | Shows or hides the password from the toggle button |
60
+ | Escape | Closes the strength meter |
@@ -0,0 +1,34 @@
1
+ # Password generator
2
+
3
+ Strong random passwords from `crypto.getRandomValues` (no bias, at least one character of every set, shuffled). Use the `TxPasswordGenerator` service, or put `txPasswordGenerate` on a button to fill a `tx-password` (and show it) or any form control.
4
+
5
+ ```html
6
+ <tx-password #password formControlName="password" [toggleMask]="true" autocomplete="new-password" />
7
+ <button txButton icon="refresh" [txPasswordGenerate]="password" [length]="20">Generate</button>
8
+ ```
9
+
10
+ ```ts
11
+ const password = inject(TxPasswordGenerator).generate({ length: 24, symbols: false });
12
+ ```
13
+
14
+ ## Inputs
15
+ | Name | Description |
16
+ |---|---|
17
+ | txPasswordGenerate | What to fill: a `tx-password` (shown after filling) or a form control |
18
+ | length | Number of characters (16 by default) |
19
+ | lowercase | Use a – z |
20
+ | uppercase | Use A – Z |
21
+ | digits | Use 0 – 9 |
22
+ | symbols | Use symbols like `!@#$%` |
23
+ | excludeSimilar | Leave out characters that look alike: `0 O 1 l I \|` |
24
+ | reveal | Shows the generated password in a `tx-password` |
25
+
26
+ ## Outputs
27
+ | Name | Description |
28
+ |---|---|
29
+ | generated | The new password |
30
+
31
+ ## Keyboard
32
+ | Key | Action |
33
+ |---|---|
34
+ | Enter / Space | Generates a password from the focused button |
package/pill/README.md ADDED
@@ -0,0 +1,42 @@
1
+ # Pill
2
+
3
+ A small rounded label for a status, a category or a count — in tables, lists and headers. A tone, three looks, an icon or a dot, and an optional remove button.
4
+
5
+ ```html
6
+ <tx-pill tone="success" icon="check" size="small">Active</tx-pill>
7
+ <tx-pill tone="warn" variant="outline" [dot]="true">Pending review</tx-pill>
8
+ <tx-pill [removable]="true" (removed)="drop(tag)">{{ tag }}</tx-pill>
9
+ ```
10
+
11
+ ## Inputs
12
+ | Name | Description |
13
+ |---|---|
14
+ | value | Text of the pill; content inside the tag is added after it |
15
+ | tone | `neutral`, `primary`, `success`, `info`, `warn`, `danger`, `help`, `contrast` |
16
+ | variant | `soft` (tinted, default), `solid` or `outline` |
17
+ | size | `small`, `medium` (`normal` is the same), `large` |
18
+ | icon | Icon before the text: tectra name, `pi-` name or icon class |
19
+ | dot | A status dot instead of the icon |
20
+ | removable | Adds a remove button |
21
+ | removeLabel | Label of the remove button (translated "Remove" by default) |
22
+ | dt | Design tokens of this instance (`pill`) |
23
+ | pt | Classes and styles of the parts: `root`, `icon`, `label`, `remove` |
24
+ | ptOptions | How `pt` merges with the global pass-through |
25
+ | unstyled | Removes the tectra styles |
26
+
27
+ ## Outputs
28
+ | Name | Description |
29
+ |---|---|
30
+ | removed | The remove button was pressed (click, Enter, Space, Delete or Backspace) |
31
+
32
+ ## Slots
33
+ | Name | Description |
34
+ |---|---|
35
+ | default | The text |
36
+ | txPillLeading | An element before the text, e.g. a flag or a tiny avatar: `<img txPillLeading …>` |
37
+
38
+ ## Keyboard
39
+ | Key | Action |
40
+ |---|---|
41
+ | Tab | Reaches the remove button |
42
+ | Enter / Space / Delete / Backspace | Removes the pill from its remove button |
@@ -0,0 +1,67 @@
1
+ # Popover
2
+
3
+ A panel of content next to an element — a share box, a small form, a list of notifications. It opens from a trigger, moves focus inside, and closes on an outside click, Escape or Tab past its last element.
4
+
5
+ ```html
6
+ <button txButton [txPopoverTrigger]="share">Share</button>
7
+ <tx-popover #share header="Share link" closeButton>
8
+ <input txInput aria-label="Link" value="https://example.com/r/7Q2M" />
9
+ </tx-popover>
10
+ ```
11
+
12
+ `[txPopoverTrigger]` toggles the popover on click and keeps `aria-expanded` / `aria-controls` in sync. Without a trigger, open it from code: `pop.toggle($event)` anchors it to the clicked element, `pop.show(element)` to any element, `[(open)]` to the last or the first registered trigger. Content inside `<tx-popover>` is created with the page; use `<ng-template txPopoverContent>` to create it on open.
13
+
14
+ ## Inputs
15
+ | Name | Description |
16
+ |---|---|
17
+ | placement | `bottom-start` (default) or any of the 12 placements; flips when there is no room |
18
+ | offset | Gap to the element in px (default 10, the arrow fills it) |
19
+ | arrow | Shows the arrow: at the middle of the element for a centred placement, near its start or end for `-start` / `-end` (default on; `[arrow]="false"` hides it) |
20
+ | header | Title text; also names the dialog |
21
+ | closeButton | Shows a close button (translated "Close" label) |
22
+ | dismissable | Closes on a click outside (default on) |
23
+ | closeOnEscape | Closes on Escape (default on) |
24
+ | autoFocus | Where focus goes on open: `first` focusable element (default), the `panel`, or `none` |
25
+ | restoreFocus | Focus returns to the element that opened it (default on) |
26
+ | scroll | What page scrolling does: `reposition` (default, closes once the element scrolls out of view), `close`, `block`, `none` |
27
+ | ariaLabel | Name of the dialog when there is no header |
28
+ | ariaLabelledBy | Id of the element that names the dialog |
29
+ | panelClass | Class added to the overlay pane |
30
+ | open | Two-way open state (`[(open)]`) |
31
+ | dt | Design tokens of this popover (`popover`) |
32
+ | pt | Classes and styles of the parts: `root`, `header`, `title`, `content`, `footer`, `closeButton`, `arrow` |
33
+ | ptOptions | How `pt` merges with the global pass-through |
34
+ | unstyled | Removes the tectra styles |
35
+
36
+ ## Outputs
37
+ | Name | Description |
38
+ |---|---|
39
+ | opened | The popover opened |
40
+ | closed | The popover closed, with the reason: `api`, `escape`, `outside`, `tab`, `scroll`, `detached` |
41
+ | openChange | `open` changed |
42
+
43
+ ## Slots
44
+ | Name | Description |
45
+ |---|---|
46
+ | default | Content of the popover |
47
+ | txPopoverHeader | `<div txPopoverHeader>` — header content after the `header` text |
48
+ | txPopoverFooter | `<div txPopoverFooter>` — actions at the bottom, aligned to the end |
49
+ | txPopoverContent | `<ng-template txPopoverContent let-close>` — content created on open; `close()` hides the popover |
50
+ | txPopoverTrigger | `[txPopoverTrigger]="popover"` on a button — toggles the popover |
51
+
52
+ ## Methods
53
+ | Name | Description |
54
+ |---|---|
55
+ | show(target?) | Opens at an element, at `event.currentTarget`, or at the last / first trigger |
56
+ | hide() | Closes it |
57
+ | toggle(target?) | Closes it when open at that target, otherwise opens there |
58
+ | updatePosition() | Measures again after the content changed size |
59
+ | isOpen | Signal: whether it is open |
60
+
61
+ ## Keyboard
62
+ | Key | Action |
63
+ |---|---|
64
+ | Enter / Space | On the trigger: opens or closes the popover |
65
+ | Tab | Moves through the popover; past the last element it closes and focus moves on after the trigger |
66
+ | Shift + Tab | Before the first element it closes and focus goes back to the trigger |
67
+ | Escape | Closes the popover, focus goes back to the trigger |
@@ -0,0 +1,32 @@
1
+ # Progress bar
2
+
3
+ Shows how far a task got — a known percentage, or a moving bar while the length is unknown. A `progressbar` for screen readers with its value; the label next to the bar is optional.
4
+
5
+ ```html
6
+ <tx-progress-bar [value]="uploaded" [showValue]="true" ariaLabel="Upload" />
7
+ <tx-progress-bar mode="indeterminate" ariaLabel="Loading the report" />
8
+ ```
9
+
10
+ ## Inputs
11
+ | Name | Description |
12
+ |---|---|
13
+ | value | Current value |
14
+ | min | Value of an empty bar |
15
+ | max | Value of a full bar |
16
+ | mode | `determinate` or `indeterminate` (unknown length) |
17
+ | showValue | Shows the value next to the bar |
18
+ | unit | Unit of the label: `%` shows the percentage, anything else the value with that unit, e.g. ` GB` |
19
+ | severity | `primary`, `secondary`, `success`, `info`, `warn`, `danger`, `help`, `contrast` |
20
+ | color | Own colour of the bar (any CSS colour) |
21
+ | size | `small`, `medium` (`normal` is the same), `large` |
22
+ | ariaLabel | What is progressing ("Loading" by default, translated) |
23
+ | ariaLabelledBy | Id of the element that names the bar |
24
+ | dt | Design tokens of this instance (`progressBar`) |
25
+ | pt | Classes and styles of the parts: `root`, `track`, `value`, `label` |
26
+ | ptOptions | How `pt` merges with the global pass-through |
27
+ | unstyled | Removes the tectra styles |
28
+
29
+ ## Slots
30
+ | Name | Description |
31
+ |---|---|
32
+ | txProgressBarValue | `<ng-template txProgressBarValue let-value let-percent="percent">` — own label |
@@ -0,0 +1,22 @@
1
+ # Progress spinner
2
+
3
+ A spinning circle while something loads and its length is unknown. A busy `progressbar` named "Loading" (translated) unless you name it. With reduced motion it turns slowly instead of stopping, so it still reads as loading.
4
+
5
+ ```html
6
+ <tx-progress-spinner size="small" />
7
+ <tx-progress-spinner [size]="64" [strokeWidth]="3" ariaLabel="Loading the dashboard" />
8
+ ```
9
+
10
+ ## Inputs
11
+ | Name | Description |
12
+ |---|---|
13
+ | size | `small`, `medium`, `large` or a number of px |
14
+ | strokeWidth | Thickness of the ring in units of a 50 × 50 box |
15
+ | fill | Fill inside the ring |
16
+ | animationDuration | One turn, e.g. `1.5s` |
17
+ | color | Own colour of the moving arc |
18
+ | ariaLabel | What is loading |
19
+ | dt | Design tokens of this instance (`progressSpinner`) |
20
+ | pt | Classes and styles of the parts: `root`, `svg`, `track`, `circle` |
21
+ | ptOptions | How `pt` merges with the global pass-through |
22
+ | unstyled | Removes the tectra styles |
@@ -0,0 +1,54 @@
1
+ # Radio button
2
+
3
+ One choice out of a few, on native `<input type="radio">`. Put the options in `tx-radio-group` — it holds the value, gives them one `name` and is the `radiogroup` for screen readers; arrow keys move between the options, Tab leaves the group.
4
+
5
+ ```html
6
+ <tx-radio-group formControlName="plan" ariaLabel="Plan">
7
+ <tx-radio-button value="free" label="Free" />
8
+ <tx-radio-button value="team" label="Team" description="Up to 20 people" />
9
+ </tx-radio-group>
10
+ ```
11
+
12
+ A radio button also works alone with a form control: it is checked when the control equals its `value`.
13
+
14
+ ## Inputs
15
+ | Name | Description |
16
+ |---|---|
17
+ | value | Value of this option |
18
+ | label | Text of the label; content inside the tag is added after it |
19
+ | description | Muted text under the label, linked with `aria-describedby` |
20
+ | size | `small`, `medium`, `large` (inherits the group) |
21
+ | variant | `outlined` or `filled` (inherits the group) |
22
+ | tile | Option tile look: the whole card selects |
23
+ | invalid | Red border; without it the radio follows its form control or the group |
24
+ | disabled | Disables the option, or with the group every option |
25
+ | readonly | Shows the value, ignores clicks |
26
+ | required | Native `required` (the group sets it on every option) |
27
+ | name | Native `name`; the group generates one when not set |
28
+ | inputId | Id of the native input, for an outside `<label for>` |
29
+ | ariaLabel | Accessible name when there is no visible label; on the group, its name |
30
+ | ariaLabelledBy | Id of the element that names the option or the group |
31
+ | tabindex | Tab order of the native input |
32
+ | orientation | `tx-radio-group`: `vertical` or `horizontal` |
33
+ | dt | Design tokens of this instance (`radioButton`) |
34
+ | pt | Classes and styles of the parts: `root`, `box`, `input`, `dot`, `label`, `description`; group: `root` |
35
+ | ptOptions | How `pt` merges with the global pass-through |
36
+ | unstyled | Removes the tectra styles, keeps the native inputs |
37
+
38
+ ## Outputs
39
+ | Name | Description |
40
+ |---|---|
41
+ | changed | Radio: `{ value, originalEvent }` when chosen; group: the new value |
42
+
43
+ ## Slots
44
+ | Name | Description |
45
+ |---|---|
46
+ | default | Radio: extra label content; group: the radio buttons |
47
+
48
+ ## Keyboard
49
+ | Key | Action |
50
+ |---|---|
51
+ | Tab | Moves into the group (to the checked option) and out of it |
52
+ | Arrow Down / Right | Checks the next option |
53
+ | Arrow Up / Left | Checks the previous option |
54
+ | Space | Checks the focused option |
@@ -0,0 +1,49 @@
1
+ # Rating
2
+
3
+ A score out of a few stars. Hover to preview, click to rate; half stars with `allowHalf`. One focusable `slider` for screen readers and the keyboard ("3 of 5").
4
+
5
+ ```html
6
+ <tx-rating formControlName="score" [allowHalf]="true" [clearable]="true" ariaLabel="Your rating" />
7
+ ```
8
+
9
+ ## Inputs
10
+ | Name | Description |
11
+ |---|---|
12
+ | stars | Number of stars |
13
+ | allowHalf | Half steps: the left half of a star rates x.5, the arrow keys move by 0.5 |
14
+ | onIcon | Icon of a filled star |
15
+ | offIcon | Icon of an empty star; the same filled star in a muted colour by default, so half stars line up exactly |
16
+ | clearable | Shows a clear button while there is a rating |
17
+ | clearLabel | Text next to the clear icon; without it the button has a translated `aria-label` |
18
+ | size | `small`, `medium`, `large` |
19
+ | invalid | Red stars; without it the rating follows its form control |
20
+ | disabled | Disables the rating (also from the form control) |
21
+ | readonly | Shows the rating, ignores clicks and keys |
22
+ | ariaLabel | Accessible name of the rating |
23
+ | ariaLabelledBy | Id of the element that names the rating |
24
+ | tabindex | Tab order of the stars |
25
+ | dt | Design tokens of this instance (`rating`) |
26
+ | pt | Classes and styles of the parts: `root`, `stars`, `star`, `clear` |
27
+ | ptOptions | How `pt` merges with the global pass-through |
28
+ | unstyled | Removes the tectra styles |
29
+
30
+ ## Outputs
31
+ | Name | Description |
32
+ |---|---|
33
+ | rated | `{ value, originalEvent }` after a click, a key or clearing |
34
+ | cleared | The clear button or a key removed the rating |
35
+
36
+ ## Slots
37
+ | Name | Description |
38
+ |---|---|
39
+ | txRatingOnIcon | `<ng-template txRatingOnIcon let-index>` — own filled star |
40
+ | txRatingOffIcon | `<ng-template txRatingOffIcon let-index>` — own empty star |
41
+
42
+ ## Keyboard
43
+ | Key | Action |
44
+ |---|---|
45
+ | Arrow Right / Up | One star (or half) more |
46
+ | Arrow Left / Down | One star (or half) less; below the first star clears |
47
+ | Home / End | Lowest / highest rating |
48
+ | 1 – 9 | Sets that many stars |
49
+ | Delete / Backspace / 0 | Clears the rating |
@@ -0,0 +1,78 @@
1
+ # Select
2
+
3
+ Pick one value from a list. A `ControlValueAccessor`: works with `[formControl]`, `ngModel` and signal forms. The panel is a CDK overlay, so it is never cut by `overflow: hidden` and flips up at the bottom of the screen. Long lists scroll virtually and can load page by page from a server.
4
+
5
+ The option engine (`buildOptionRows`, `readOptionField`, `foldText`) is exported for other list controls.
6
+
7
+ ## Inputs
8
+ | Name | Description |
9
+ |---|---|
10
+ | options | Items to choose from — objects, or plain strings / numbers. `null` / `undefined` items are rows that are still loading (`lazy`) |
11
+ | optionLabel | Field of an item shown as its text; dots read nested fields (`user.name`) |
12
+ | optionValue | Field of an item written into the form value; empty string = the whole item |
13
+ | optionDisabled | Field that disables an item — keys, typing and clicks skip it |
14
+ | group | `options` are groups with their own items |
15
+ | optionGroupLabel | Field of a group shown as its header |
16
+ | optionGroupChildren | Field of a group that holds its items |
17
+ | dataKey | Field that identifies an object value, so a value that is a copy of an option is still found |
18
+ | placeholder | Text shown while nothing is selected |
19
+ | filter | Shows a search field at the top of the panel |
20
+ | filterBy | Fields to search in, comma separated; the label by default |
21
+ | filterMatchMode | `contains`, `startsWith`, `endsWith` or `equals`; case and accents are ignored |
22
+ | filterPlaceholder | Own placeholder of the search field |
23
+ | filterDelay | Milliseconds to wait after typing before `filtered` is emitted — for server search |
24
+ | resetFilterOnHide | Clears the search when the panel closes |
25
+ | showClear | Shows a button that clears the value |
26
+ | editable | The field is a text input: free text is the value, unless it matches an option |
27
+ | loading | Spinner instead of the dropdown icon, "Loading" in an empty panel |
28
+ | checkmark | Check icon on the selected option (off by default; the selected option is highlighted) |
29
+ | lazy | Options come from a server: `lazyLoad` asks for missing rows and the search is not applied locally |
30
+ | virtualScroll | Renders only the visible rows — for long lists |
31
+ | virtualScrollItemSize | Height of a row in px with `virtualScroll` |
32
+ | scrollHeight | Maximum height of the list, e.g. `320px` |
33
+ | emptyMessage | Text of an empty list |
34
+ | emptyFilterMessage | Text when the search found nothing |
35
+ | dropdownIcon | Icon name of the dropdown indicator |
36
+ | inputId | Id of the field, so a `<label for>` (or `tx-float-label`) names it |
37
+ | ariaLabel | Accessible name of the field; without it and without a label, the placeholder is used |
38
+ | ariaLabelledBy | Id of the element that labels the field (e.g. a `<label>`) |
39
+ | size | `small`, `medium`, `large` |
40
+ | variant | `outlined` (border) or `filled` (tinted background) |
41
+ | invalid | Red border and `aria-invalid`. Without it the select follows its form control: invalid once touched or changed |
42
+ | readonly | Shows the value, does not open |
43
+ | dt | Design tokens of this instance (`select`), also applied to the panel |
44
+ | pt | Classes and styles of the parts: `root`, `box`, `trigger`, `value`, `clear`, `dropdown`, `panel`, `header`, `filter`, `filterInput`, `list`, `group`, `option`, `check`, `empty`, `footer` |
45
+ | ptOptions | How `pt` merges with the global pass-through |
46
+ | unstyled | Removes the tectra styles of the field and the panel |
47
+
48
+ ## Outputs
49
+ | Name | Description |
50
+ |---|---|
51
+ | changed | The user picked, typed or cleared a value: `{ value, option }` |
52
+ | cleared | The clear button was used |
53
+ | filtered | The search text changed: `{ query }` (after `filterDelay`) |
54
+ | lazyLoad | Rows without data came into view: `{ first, last, query }` — load them and replace the items |
55
+ | opened | The panel was opened |
56
+ | closed | The panel was closed (the control is marked as touched) |
57
+
58
+ ## Slots
59
+ | Name | Description |
60
+ |---|---|
61
+ | txSelectOption | `<ng-template txSelectOption let-option let-selected="selected">` — own markup of an option (and of the value, without `txSelectValue`) |
62
+ | txSelectValue | `<ng-template txSelectValue let-option>` — own markup of the selected value in the field |
63
+ | txSelectGroup | `<ng-template txSelectGroup let-group>` — own group header |
64
+ | txSelectHeader | `<ng-template txSelectHeader>` — content above the list |
65
+ | txSelectFooter | `<ng-template txSelectFooter>` — content below the list, e.g. an "Add" button |
66
+ | txSelectEmpty | `<ng-template txSelectEmpty>` — own empty list |
67
+ | txSelectEmptyFilter | `<ng-template txSelectEmptyFilter let-query>` — shown when the search found nothing, e.g. "Create «query»" |
68
+
69
+ ## Keyboard
70
+ | Key | Action |
71
+ |---|---|
72
+ | Enter / Space | Opens the panel, selects the active option (Space types in the search and in an editable field) |
73
+ | ArrowDown / ArrowUp | Opens the panel, moves the active option, skipping disabled ones and group headers |
74
+ | Home / End | First / last option (in a text field they move the caret) |
75
+ | PageDown / PageUp | Ten options down / up |
76
+ | Letters | Jump to the option that starts with the typed text; on a closed select, choose it |
77
+ | Escape | Closes the panel and returns focus to the field |
78
+ | Tab | Closes the panel and moves focus on (to the clear button when it is shown) |
@@ -0,0 +1,27 @@
1
+ # Skeleton
2
+
3
+ A grey placeholder in the shape of content that is still loading — a line, a box, a circle, a paragraph or a whole table. Hidden from screen readers; put `aria-busy="true"` on the region that is loading.
4
+
5
+ ```html
6
+ <tx-skeleton shape="circle" size="48px" />
7
+ <tx-skeleton [lines]="3" />
8
+ <tx-skeleton-table [rows]="6" [columns]="4" />
9
+ ```
10
+
11
+ ## Inputs
12
+ | Name | Description |
13
+ |---|---|
14
+ | shape | `rectangle` or `circle` |
15
+ | size | Width and height at once, e.g. `48px` |
16
+ | width | Width, e.g. `60%` |
17
+ | height | Height, e.g. `120px` |
18
+ | borderRadius | Own corner radius |
19
+ | lines | Draws this many text lines, the last one shorter |
20
+ | animation | `wave` or `none` (off with reduced motion) |
21
+ | rows | `tx-skeleton-table`: number of rows |
22
+ | columns | `tx-skeleton-table`: number of columns |
23
+ | header | `tx-skeleton-table`: draws a header row |
24
+ | dt | Design tokens of this instance (`skeleton`) |
25
+ | pt | Classes and styles of the parts: `root`, `line`; table: `root`, `header`, `row`, `cell` |
26
+ | ptOptions | How `pt` merges with the global pass-through |
27
+ | unstyled | Removes the tectra styles |
@@ -0,0 +1,48 @@
1
+ # Slider
2
+
3
+ Picks a number, or a range of two, by dragging a handle along a track. Each handle is a `slider` for screen readers and the keyboard. Horizontal or vertical, with step marks and labelled marks.
4
+
5
+ ```html
6
+ <tx-slider formControlName="volume" ariaLabel="Volume" />
7
+ <tx-slider formControlName="price" [range]="true" [min]="0" [max]="500" [step]="10" ariaLabel="Price" />
8
+ ```
9
+
10
+ The value is a `number`, or `[start, end]` with `range`.
11
+
12
+ ## Inputs
13
+ | Name | Description |
14
+ |---|---|
15
+ | min | Smallest value |
16
+ | max | Largest value |
17
+ | step | Step of dragging and the arrow keys |
18
+ | range | Two handles; the value is `[start, end]` |
19
+ | orientation | `horizontal` or `vertical` (height from the `verticalHeight` token) |
20
+ | minStepsBetweenHandles | With `range`: how many steps the handles stay apart |
21
+ | showSteps | Shows a dot at every step (up to 100) |
22
+ | marks | Labelled marks: `{ value, label }[]` |
23
+ | animate | Moves smoothly when you click the track |
24
+ | valueTemplate | Text read by screen readers, `{value}` is replaced (formatted for the locale), e.g. `{value} %` |
25
+ | invalid | Red range; without it the slider follows its form control |
26
+ | disabled | Disables the slider (also from the form control) |
27
+ | readonly | Shows the value, ignores dragging and keys |
28
+ | ariaLabel | Accessible name; with `range` each handle adds "from" / "to" (translated) |
29
+ | ariaLabelledBy | Id of the element that names the handles |
30
+ | tabindex | Tab order of the handles |
31
+ | dt | Design tokens of this instance (`slider`) |
32
+ | pt | Classes and styles of the parts: `root`, `track`, `range`, `handle`, `mark`, `label` |
33
+ | ptOptions | How `pt` merges with the global pass-through |
34
+ | unstyled | Removes the tectra styles |
35
+
36
+ ## Outputs
37
+ | Name | Description |
38
+ |---|---|
39
+ | changed | `{ value, originalEvent }` while the value changes |
40
+ | slideEnd | `{ value, originalEvent }` when dragging ends or after a key |
41
+
42
+ ## Keyboard
43
+ | Key | Action |
44
+ |---|---|
45
+ | Arrow Right / Up | Adds `step` to the focused handle |
46
+ | Arrow Left / Down | Subtracts `step` |
47
+ | Page Up / Page Down | Adds / subtracts ten steps |
48
+ | Home / End | Lowest / highest value the handle can take (the other handle limits it in a range) |