cx 26.1.0 → 26.1.2

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 (540) hide show
  1. package/.mocharc.json +5 -5
  2. package/LICENSE-THIRD-PARTY.md +91 -91
  3. package/LICENSE.md +7 -7
  4. package/README.md +46 -46
  5. package/build/data/ArrayElementView.d.ts +4 -3
  6. package/build/ui/Widget.js +0 -5
  7. package/build/ui/adapter/ArrayAdapter.js +0 -2
  8. package/build/ui/adapter/DataAdapter.d.ts +3 -3
  9. package/build/util/Component.js +5 -0
  10. package/build/util/test/createTestRenderer.d.ts +3 -1
  11. package/build/util/test/createTestRenderer.js +8 -2
  12. package/build/widgets/icons/calendar.js +4 -3
  13. package/build/widgets/icons/check.js +2 -2
  14. package/build/widgets/icons/clear.js +2 -2
  15. package/build/widgets/icons/close.js +2 -2
  16. package/build/widgets/icons/cx.js +2 -2
  17. package/build/widgets/icons/drop-down.js +2 -2
  18. package/build/widgets/icons/file.js +2 -2
  19. package/build/widgets/icons/folder-open.js +2 -2
  20. package/build/widgets/icons/folder.js +2 -2
  21. package/build/widgets/icons/forward.js +2 -2
  22. package/build/widgets/icons/loading.js +2 -2
  23. package/build/widgets/icons/menu.js +2 -2
  24. package/build/widgets/icons/pixel-picker.js +2 -2
  25. package/build/widgets/icons/search.js +2 -2
  26. package/build/widgets/icons/sort-asc.js +2 -2
  27. package/build/widgets/icons/square.js +2 -2
  28. package/build.js +133 -133
  29. package/dist/manifest.js +863 -863
  30. package/dist/ui.js +1 -10
  31. package/dist/util.js +4 -0
  32. package/dist/widgets.js +377 -313
  33. package/package.json +100 -97
  34. package/src/charts/Bar.scss +28 -28
  35. package/src/charts/Bar.ts +114 -114
  36. package/src/charts/BarGraph.scss +28 -28
  37. package/src/charts/BarGraph.tsx +145 -145
  38. package/src/charts/BubbleGraph.scss +31 -31
  39. package/src/charts/BubbleGraph.tsx +165 -165
  40. package/src/charts/Chart.ts +108 -108
  41. package/src/charts/ColorMap.ts +150 -150
  42. package/src/charts/Column.scss +28 -28
  43. package/src/charts/Column.ts +124 -124
  44. package/src/charts/ColumnBarBase.tsx +284 -284
  45. package/src/charts/ColumnBarGraphBase.tsx +229 -229
  46. package/src/charts/ColumnGraph.scss +29 -29
  47. package/src/charts/ColumnGraph.tsx +153 -153
  48. package/src/charts/Grid.ts +5 -5
  49. package/src/charts/Gridlines.scss +24 -24
  50. package/src/charts/Gridlines.tsx +88 -88
  51. package/src/charts/Legend.scss +50 -50
  52. package/src/charts/Legend.tsx +270 -270
  53. package/src/charts/LegendEntry.scss +29 -29
  54. package/src/charts/LegendEntry.tsx +197 -197
  55. package/src/charts/LineGraph.scss +24 -24
  56. package/src/charts/LineGraph.tsx +455 -455
  57. package/src/charts/Marker.scss +43 -43
  58. package/src/charts/Marker.tsx +483 -483
  59. package/src/charts/MarkerLine.scss +19 -19
  60. package/src/charts/MarkerLine.tsx +214 -214
  61. package/src/charts/MouseTracker.tsx +112 -112
  62. package/src/charts/Pie.ts +8 -8
  63. package/src/charts/PieChart.scss +28 -28
  64. package/src/charts/PieChart.tsx +717 -717
  65. package/src/charts/PieLabel.tsx +106 -106
  66. package/src/charts/PieLabelsContainer.ts +68 -68
  67. package/src/charts/Range.scss +19 -19
  68. package/src/charts/Range.tsx +318 -318
  69. package/src/charts/RangeMarker.scss +17 -17
  70. package/src/charts/RangeMarker.tsx +233 -233
  71. package/src/charts/ScatterGraph.scss +23 -23
  72. package/src/charts/ScatterGraph.tsx +245 -245
  73. package/src/charts/Swimlane.scss +16 -16
  74. package/src/charts/Swimlane.tsx +195 -195
  75. package/src/charts/Swimlanes.scss +16 -16
  76. package/src/charts/Swimlanes.tsx +179 -179
  77. package/src/charts/axis/Axis.scss +22 -22
  78. package/src/charts/axis/Axis.tsx +444 -444
  79. package/src/charts/axis/CategoryAxis.scss +34 -34
  80. package/src/charts/axis/CategoryAxis.tsx +313 -313
  81. package/src/charts/axis/NumericAxis.scss +34 -34
  82. package/src/charts/axis/NumericAxis.tsx +437 -437
  83. package/src/charts/axis/Stack.ts +61 -61
  84. package/src/charts/axis/TimeAxis.scss +33 -33
  85. package/src/charts/axis/TimeAxis.tsx +718 -718
  86. package/src/charts/axis/index.scss +5 -5
  87. package/src/charts/axis/index.ts +3 -3
  88. package/src/charts/axis/variables.scss +2 -2
  89. package/src/charts/helpers/MinMaxFinder.ts +66 -66
  90. package/src/charts/helpers/PointReducer.ts +135 -135
  91. package/src/charts/helpers/SnapPointFinder.ts +136 -136
  92. package/src/charts/helpers/ValueAtFinder.ts +72 -72
  93. package/src/charts/helpers/index.ts +4 -4
  94. package/src/charts/index.scss +22 -22
  95. package/src/charts/index.ts +34 -34
  96. package/src/charts/palette.scss +97 -97
  97. package/src/charts/shapes.tsx +86 -86
  98. package/src/charts/variables.scss +22 -22
  99. package/src/data/AggregateFunction.ts +171 -171
  100. package/src/data/ArrayElementView.spec.ts +88 -88
  101. package/src/data/ArrayElementView.ts +4 -3
  102. package/src/data/ArrayRef.ts +34 -34
  103. package/src/data/Binding.spec.ts +69 -69
  104. package/src/data/Expression.spec.ts +229 -229
  105. package/src/data/Expression.ts +233 -233
  106. package/src/data/Grouper.ts +158 -158
  107. package/src/data/Ref.spec.ts +79 -79
  108. package/src/data/Selector.ts +10 -10
  109. package/src/data/Store.spec.ts +22 -22
  110. package/src/data/StoreRef.spec.ts +24 -24
  111. package/src/data/StringTemplate.spec.ts +132 -132
  112. package/src/data/StructuredSelector.ts +146 -146
  113. package/src/data/View.spec.ts +60 -60
  114. package/src/data/View.ts +289 -289
  115. package/src/data/ZoomIntoPropertyView.spec.ts +64 -64
  116. package/src/data/comparer.spec.ts +60 -60
  117. package/src/data/computable.spec.ts +87 -87
  118. package/src/data/computable.ts +69 -69
  119. package/src/data/createAccessorModelProxy.spec.tsx +145 -145
  120. package/src/data/createAccessorModelProxy.ts +66 -66
  121. package/src/data/createStructuredSelector.spec.ts +45 -45
  122. package/src/data/createStructuredSelector.ts +62 -62
  123. package/src/data/defaultCompare.ts +14 -14
  124. package/src/data/diff/diffArrays.ts +49 -49
  125. package/src/data/diff/diffs.spec.ts +49 -49
  126. package/src/data/diff/index.ts +1 -1
  127. package/src/data/enableFatArrowExpansion.ts +6 -6
  128. package/src/data/getAccessor.spec.ts +11 -11
  129. package/src/data/getAccessor.ts +74 -74
  130. package/src/data/getSelector.spec.ts +43 -43
  131. package/src/data/getSelector.ts +66 -66
  132. package/src/data/index.ts +30 -30
  133. package/src/data/isSelector.ts +26 -26
  134. package/src/data/ops/append.spec.ts +28 -28
  135. package/src/data/ops/append.ts +5 -5
  136. package/src/data/ops/filter.spec.ts +35 -35
  137. package/src/data/ops/filter.ts +9 -9
  138. package/src/data/ops/findTreeNode.spec.ts +23 -23
  139. package/src/data/ops/findTreeNode.ts +14 -14
  140. package/src/data/ops/findTreePath.ts +23 -23
  141. package/src/data/ops/index.ts +11 -11
  142. package/src/data/ops/insertElement.ts +3 -3
  143. package/src/data/ops/merge.spec.ts +27 -27
  144. package/src/data/ops/merge.ts +13 -13
  145. package/src/data/ops/moveElement.ts +21 -21
  146. package/src/data/ops/removeTreeNodes.spec.ts +37 -37
  147. package/src/data/ops/removeTreeNodes.ts +15 -15
  148. package/src/data/ops/updateArray.spec.ts +69 -69
  149. package/src/data/ops/updateTree.spec.ts +54 -54
  150. package/src/data/ops/updateTree.ts +23 -23
  151. package/src/data/test-types.ts +7 -7
  152. package/src/global.scss +13 -13
  153. package/src/hooks/createLocalStorageRef.ts +21 -21
  154. package/src/hooks/index.ts +8 -8
  155. package/src/hooks/invokeCallback.spec.tsx +59 -59
  156. package/src/hooks/invokeCallback.ts +8 -8
  157. package/src/hooks/resolveCallback.spec.tsx +71 -71
  158. package/src/hooks/resolveCallback.ts +16 -16
  159. package/src/hooks/store.spec.tsx +67 -67
  160. package/src/hooks/store.ts +46 -46
  161. package/src/hooks/useEffect.ts +14 -14
  162. package/src/hooks/useInterval.ts +8 -8
  163. package/src/hooks/useState.ts +20 -20
  164. package/src/hooks/useTrigger.spec.tsx +105 -99
  165. package/src/hooks/useTrigger.ts +26 -26
  166. package/src/index.ts +7 -7
  167. package/src/jsx-runtime.spec.tsx +431 -431
  168. package/src/locale/de-de.ts +76 -76
  169. package/src/locale/en-us.ts +75 -75
  170. package/src/locale/es-es.ts +76 -76
  171. package/src/locale/fr-fr.ts +76 -76
  172. package/src/locale/nl-nl.ts +76 -76
  173. package/src/locale/pt-pt.ts +76 -76
  174. package/src/locale/sr-latn-ba.ts +76 -76
  175. package/src/svg/BoundedObject.ts +101 -101
  176. package/src/svg/ClipRect.tsx +29 -29
  177. package/src/svg/Ellipse.tsx +68 -68
  178. package/src/svg/Line.tsx +58 -58
  179. package/src/svg/NonOverlappingRect.ts +26 -26
  180. package/src/svg/NonOverlappingRectGroup.ts +49 -49
  181. package/src/svg/Rectangle.tsx +90 -90
  182. package/src/svg/Svg.scss +27 -27
  183. package/src/svg/Svg.tsx +241 -241
  184. package/src/svg/Text.tsx +134 -134
  185. package/src/svg/TextualBoundedObject.ts +35 -35
  186. package/src/svg/index.scss +8 -8
  187. package/src/svg/index.ts +17 -17
  188. package/src/svg/util/Rect.ts +105 -105
  189. package/src/ui/CSSHelper.ts +17 -17
  190. package/src/ui/Container.tsx +216 -216
  191. package/src/ui/ContentResolver.spec.tsx +585 -583
  192. package/src/ui/ContentResolver.ts +132 -132
  193. package/src/ui/Controller.spec.tsx +574 -566
  194. package/src/ui/Controller.ts +202 -202
  195. package/src/ui/Culture.ts +159 -159
  196. package/src/ui/Cx.spec.tsx +210 -208
  197. package/src/ui/Cx.tsx +386 -386
  198. package/src/ui/DataProxy.spec.tsx +337 -337
  199. package/src/ui/DetachedScope.tsx +159 -159
  200. package/src/ui/Format.ts +108 -108
  201. package/src/ui/HoverSync.tsx +189 -189
  202. package/src/ui/Instance.ts +866 -866
  203. package/src/ui/IsolatedScope.spec.tsx +62 -55
  204. package/src/ui/IsolatedScope.ts +50 -50
  205. package/src/ui/Localization.ts +70 -70
  206. package/src/ui/Prop.ts +140 -140
  207. package/src/ui/PureContainer.spec.tsx +232 -230
  208. package/src/ui/PureContainer.tsx +19 -19
  209. package/src/ui/RenderingContext.ts +99 -99
  210. package/src/ui/Repeater.spec.tsx +143 -141
  211. package/src/ui/Repeater.ts +194 -194
  212. package/src/ui/Rescope.spec.tsx +199 -199
  213. package/src/ui/ResizeManager.ts +30 -30
  214. package/src/ui/Restate.spec.tsx +422 -418
  215. package/src/ui/Restate.tsx +217 -217
  216. package/src/ui/StaticText.ts +11 -11
  217. package/src/ui/StructuredInstanceDataAccessor.ts +32 -32
  218. package/src/ui/Text.ts +49 -49
  219. package/src/ui/Widget.spec.tsx +53 -53
  220. package/src/ui/Widget.tsx +301 -308
  221. package/src/ui/ZIndexManager.ts +11 -11
  222. package/src/ui/adapter/ArrayAdapter.ts +229 -229
  223. package/src/ui/adapter/DataAdapter.ts +52 -52
  224. package/src/ui/adapter/GroupAdapter.ts +235 -235
  225. package/src/ui/adapter/TreeAdapter.spec.ts +76 -76
  226. package/src/ui/adapter/TreeAdapter.ts +185 -185
  227. package/src/ui/adapter/index.ts +4 -4
  228. package/src/ui/app/History.ts +133 -133
  229. package/src/ui/app/Url.spec.ts +50 -50
  230. package/src/ui/app/Url.ts +102 -102
  231. package/src/ui/app/index.ts +5 -5
  232. package/src/ui/app/startAppLoop.tsx +71 -71
  233. package/src/ui/app/startHotAppLoop.ts +41 -41
  234. package/src/ui/batchUpdates.ts +77 -77
  235. package/src/ui/bind.ts +10 -10
  236. package/src/ui/createFunctionalComponent.spec.tsx +454 -452
  237. package/src/ui/createFunctionalComponent.ts +86 -86
  238. package/src/ui/expr.ts +47 -47
  239. package/src/ui/exprHelpers.spec.ts +379 -379
  240. package/src/ui/exprHelpers.ts +78 -78
  241. package/src/ui/flattenProps.ts +21 -21
  242. package/src/ui/index.scss +2 -2
  243. package/src/ui/index.ts +47 -47
  244. package/src/ui/keyboardShortcuts.ts +40 -40
  245. package/src/ui/layout/ContentPlaceholder.spec.tsx +599 -587
  246. package/src/ui/layout/ContentPlaceholder.ts +133 -133
  247. package/src/ui/layout/FirstVisibleChildLayout.spec.tsx +207 -195
  248. package/src/ui/layout/FirstVisibleChildLayout.ts +60 -60
  249. package/src/ui/layout/LabelsLeftLayout.scss +46 -46
  250. package/src/ui/layout/LabelsLeftLayout.tsx +76 -76
  251. package/src/ui/layout/LabelsTopLayout.scss +64 -64
  252. package/src/ui/layout/LabelsTopLayout.tsx +156 -156
  253. package/src/ui/layout/UseParentLayout.ts +8 -8
  254. package/src/ui/layout/exploreChildren.ts +38 -38
  255. package/src/ui/layout/index.scss +3 -3
  256. package/src/ui/layout/index.ts +10 -10
  257. package/src/ui/layout/variables.scss +2 -2
  258. package/src/ui/selection/KeySelection.ts +153 -153
  259. package/src/ui/selection/Selection.ts +128 -128
  260. package/src/ui/selection/index.ts +3 -3
  261. package/src/ui/tpl.ts +4 -4
  262. package/src/ui/variables.scss +1 -1
  263. package/src/util/Component.spec.ts +411 -381
  264. package/src/util/Component.ts +301 -296
  265. package/src/util/Console.ts +13 -13
  266. package/src/util/Debug.ts +71 -71
  267. package/src/util/GlobalCacheIdentifier.ts +11 -11
  268. package/src/util/KeyCode.ts +21 -21
  269. package/src/util/SubscriberList.ts +86 -86
  270. package/src/util/Timing.ts +58 -58
  271. package/src/util/TraversalStack.spec.ts +53 -53
  272. package/src/util/TraversalStack.ts +47 -47
  273. package/src/util/calculateNaturalElementHeight.ts +22 -22
  274. package/src/util/call-once.scss +6 -6
  275. package/src/util/capitalize.ts +4 -4
  276. package/src/util/coalesce.ts +6 -6
  277. package/src/util/color/hslToRgb.ts +34 -34
  278. package/src/util/color/index.ts +4 -4
  279. package/src/util/color/parseColor.ts +173 -173
  280. package/src/util/color/rgbToHex.ts +14 -14
  281. package/src/util/date/dateDiff.ts +9 -9
  282. package/src/util/date/diff.ts +13 -13
  283. package/src/util/date/encodeDate.ts +8 -8
  284. package/src/util/date/encodeDateWithTimezoneOffset.ts +18 -18
  285. package/src/util/date/index.ts +11 -11
  286. package/src/util/date/lowerBoundCheck.ts +13 -13
  287. package/src/util/date/maxDate.ts +14 -14
  288. package/src/util/date/minDate.ts +14 -14
  289. package/src/util/date/monthStart.ts +8 -8
  290. package/src/util/date/parseDateInvariant.ts +20 -20
  291. package/src/util/date/sameDate.ts +11 -11
  292. package/src/util/date/upperBoundCheck.spec.ts +30 -30
  293. package/src/util/date/upperBoundCheck.ts +13 -13
  294. package/src/util/date/zeroTime.ts +9 -9
  295. package/src/util/debounce.ts +26 -26
  296. package/src/util/dummyCallback.ts +1 -1
  297. package/src/util/escapeSpecialRegexCharacters.ts +8 -8
  298. package/src/util/eventCallbacks.ts +12 -12
  299. package/src/util/expandFatArrows.ts +118 -118
  300. package/src/util/findScrollableParent.ts +15 -15
  301. package/src/util/getParentFrameBoundingClientRect.ts +13 -13
  302. package/src/util/getScrollerBoundingClientRect.ts +12 -12
  303. package/src/util/getSearchQueryPredicate.spec.ts +40 -40
  304. package/src/util/getSearchQueryPredicate.ts +58 -58
  305. package/src/util/getTopLevelBoundingClientRect.ts +7 -7
  306. package/src/util/getVendorPrefix.ts +33 -33
  307. package/src/util/hasKey.ts +18 -18
  308. package/src/util/index.scss +10 -10
  309. package/src/util/index.ts +55 -55
  310. package/src/util/isArray.ts +3 -3
  311. package/src/util/isDefined.ts +3 -3
  312. package/src/util/isDigit.ts +8 -8
  313. package/src/util/isFunction.ts +3 -3
  314. package/src/util/isNonEmptyArray.ts +3 -3
  315. package/src/util/isNumber.ts +3 -3
  316. package/src/util/isObject.ts +3 -3
  317. package/src/util/isPromise.ts +6 -6
  318. package/src/util/isString.ts +3 -3
  319. package/src/util/isTextInputElement.ts +2 -2
  320. package/src/util/isTouchDevice.ts +7 -7
  321. package/src/util/isTouchEvent.ts +64 -64
  322. package/src/util/isUndefined.ts +3 -3
  323. package/src/util/isValidIdentifierName.spec.ts +33 -33
  324. package/src/util/isValidIdentifierName.ts +5 -5
  325. package/src/util/onIdleCallback.ts +10 -10
  326. package/src/util/parseStyle.ts +29 -29
  327. package/src/util/quote.ts +6 -6
  328. package/src/util/reverseSlice.ts +9 -9
  329. package/src/util/routeAppend.spec.ts +19 -19
  330. package/src/util/routeAppend.ts +15 -15
  331. package/src/util/scrollElementIntoView.ts +40 -40
  332. package/src/util/scss/add-rules.scss +40 -40
  333. package/src/util/scss/calc.scss +44 -44
  334. package/src/util/scss/call-once.scss +12 -12
  335. package/src/util/scss/clockwise.scss +49 -49
  336. package/src/util/scss/colors.scss +9 -9
  337. package/src/util/scss/deep-get.scss +11 -11
  338. package/src/util/scss/deep-merge.scss +21 -21
  339. package/src/util/scss/divide.scss +3 -3
  340. package/src/util/scss/include.scss +48 -48
  341. package/src/util/scss/index.scss +9 -9
  342. package/src/util/shallowEquals.ts +43 -43
  343. package/src/util/test/createTestRenderer.tsx +19 -12
  344. package/src/util/throttle.ts +21 -21
  345. package/src/util/validatedDebounce.ts +23 -23
  346. package/src/variables.scss +217 -217
  347. package/src/widgets/AccessorBindings.spec.tsx +90 -90
  348. package/src/widgets/Button.scss +119 -119
  349. package/src/widgets/Button.tsx +189 -189
  350. package/src/widgets/Button.variables.scss +117 -117
  351. package/src/widgets/CxCredit.scss +39 -39
  352. package/src/widgets/CxCredit.tsx +46 -46
  353. package/src/widgets/DocumentTitle.ts +95 -95
  354. package/src/widgets/FlexBox.scss +148 -148
  355. package/src/widgets/FlexBox.tsx +168 -168
  356. package/src/widgets/Heading.scss +40 -40
  357. package/src/widgets/Heading.ts +42 -42
  358. package/src/widgets/HighlightedSearchText.scss +20 -20
  359. package/src/widgets/HighlightedSearchText.tsx +54 -54
  360. package/src/widgets/HtmlElement.spec.helpers.tsx +108 -108
  361. package/src/widgets/HtmlElement.spec.tsx +89 -89
  362. package/src/widgets/HtmlElement.tsx +407 -407
  363. package/src/widgets/Icon.scss +22 -22
  364. package/src/widgets/Icon.ts +64 -64
  365. package/src/widgets/List.scss +93 -93
  366. package/src/widgets/List.tsx +793 -793
  367. package/src/widgets/ProgressBar.scss +50 -50
  368. package/src/widgets/ProgressBar.tsx +66 -66
  369. package/src/widgets/ReactElementWrapper.spec.tsx +452 -452
  370. package/src/widgets/ReactElementWrapper.tsx +108 -108
  371. package/src/widgets/Resizer.scss +43 -43
  372. package/src/widgets/Resizer.tsx +200 -200
  373. package/src/widgets/Section.scss +55 -55
  374. package/src/widgets/Section.tsx +187 -187
  375. package/src/widgets/animations.scss +10 -10
  376. package/src/widgets/autoFocus.ts +9 -9
  377. package/src/widgets/cx.ts +63 -63
  378. package/src/widgets/drag-drop/DragClone.scss +35 -35
  379. package/src/widgets/drag-drop/DragHandle.scss +18 -18
  380. package/src/widgets/drag-drop/DragHandle.tsx +47 -47
  381. package/src/widgets/drag-drop/DragSource.scss +26 -26
  382. package/src/widgets/drag-drop/DragSource.tsx +237 -237
  383. package/src/widgets/drag-drop/DropZone.scss +76 -76
  384. package/src/widgets/drag-drop/DropZone.tsx +353 -353
  385. package/src/widgets/drag-drop/index.scss +3 -3
  386. package/src/widgets/drag-drop/index.ts +4 -4
  387. package/src/widgets/drag-drop/ops.tsx +422 -422
  388. package/src/widgets/drag-drop/variables.scss +14 -14
  389. package/src/widgets/enableAllInternalDependencies.ts +11 -11
  390. package/src/widgets/form/Calendar.scss +199 -199
  391. package/src/widgets/form/Calendar.tsx +760 -760
  392. package/src/widgets/form/Calendar.variables.scss +63 -63
  393. package/src/widgets/form/Checkbox.scss +129 -129
  394. package/src/widgets/form/Checkbox.tsx +287 -287
  395. package/src/widgets/form/Checkbox.variables.scss +39 -39
  396. package/src/widgets/form/ColorField.scss +98 -98
  397. package/src/widgets/form/ColorField.tsx +497 -497
  398. package/src/widgets/form/ColorPicker.scss +285 -285
  399. package/src/widgets/form/ColorPicker.tsx +544 -544
  400. package/src/widgets/form/ColorPicker.variables.scss +22 -22
  401. package/src/widgets/form/DateField.ts +21 -21
  402. package/src/widgets/form/DateTimeField.scss +92 -92
  403. package/src/widgets/form/DateTimeField.tsx +726 -726
  404. package/src/widgets/form/DateTimePicker.scss +46 -46
  405. package/src/widgets/form/DateTimePicker.tsx +429 -429
  406. package/src/widgets/form/Field.scss +164 -164
  407. package/src/widgets/form/Field.tsx +608 -608
  408. package/src/widgets/form/FieldGroup.ts +10 -10
  409. package/src/widgets/form/FieldIcon.ts +61 -61
  410. package/src/widgets/form/HelpText.scss +24 -24
  411. package/src/widgets/form/HelpText.ts +15 -15
  412. package/src/widgets/form/Label.scss +37 -37
  413. package/src/widgets/form/Label.tsx +117 -117
  414. package/src/widgets/form/LabeledContainer.ts +77 -77
  415. package/src/widgets/form/LookupField.scss +221 -221
  416. package/src/widgets/form/LookupField.spec.tsx +93 -93
  417. package/src/widgets/form/LookupField.tsx +1421 -1421
  418. package/src/widgets/form/MonthField.scss +100 -100
  419. package/src/widgets/form/MonthField.tsx +670 -670
  420. package/src/widgets/form/MonthPicker.scss +125 -125
  421. package/src/widgets/form/MonthPicker.tsx +822 -822
  422. package/src/widgets/form/NumberField.scss +63 -63
  423. package/src/widgets/form/NumberField.tsx +543 -543
  424. package/src/widgets/form/Radio.scss +123 -123
  425. package/src/widgets/form/Radio.tsx +249 -249
  426. package/src/widgets/form/Radio.variables.scss +45 -45
  427. package/src/widgets/form/Select.scss +101 -101
  428. package/src/widgets/form/Select.tsx +327 -327
  429. package/src/widgets/form/Slider.scss +121 -121
  430. package/src/widgets/form/Slider.tsx +473 -473
  431. package/src/widgets/form/Switch.scss +142 -142
  432. package/src/widgets/form/Switch.tsx +176 -176
  433. package/src/widgets/form/TextArea.scss +45 -45
  434. package/src/widgets/form/TextArea.tsx +229 -229
  435. package/src/widgets/form/TextField.scss +57 -57
  436. package/src/widgets/form/TextField.tsx +407 -407
  437. package/src/widgets/form/TimeField.ts +10 -10
  438. package/src/widgets/form/TimeList.tsx +105 -105
  439. package/src/widgets/form/UploadButton.scss +49 -49
  440. package/src/widgets/form/UploadButton.tsx +307 -307
  441. package/src/widgets/form/ValidationError.scss +22 -22
  442. package/src/widgets/form/ValidationError.tsx +72 -72
  443. package/src/widgets/form/ValidationGroup.spec.tsx +147 -147
  444. package/src/widgets/form/ValidationGroup.ts +141 -141
  445. package/src/widgets/form/Validator.ts +60 -60
  446. package/src/widgets/form/Wheel.scss +152 -152
  447. package/src/widgets/form/Wheel.tsx +314 -314
  448. package/src/widgets/form/index.scss +24 -24
  449. package/src/widgets/form/index.ts +28 -28
  450. package/src/widgets/form/variables.scss +355 -355
  451. package/src/widgets/grid/Grid.scss +640 -640
  452. package/src/widgets/grid/Grid.tsx +4243 -4243
  453. package/src/widgets/grid/GridCellEditor.tsx +58 -58
  454. package/src/widgets/grid/GridRow.ts +302 -302
  455. package/src/widgets/grid/GridRowLine.ts +49 -49
  456. package/src/widgets/grid/Pagination.scss +115 -115
  457. package/src/widgets/grid/Pagination.tsx +126 -126
  458. package/src/widgets/grid/TreeNode.scss +90 -90
  459. package/src/widgets/grid/TreeNode.tsx +154 -154
  460. package/src/widgets/grid/createGridCellEditor.tsx +18 -18
  461. package/src/widgets/grid/index.scss +3 -3
  462. package/src/widgets/grid/index.ts +16 -16
  463. package/src/widgets/grid/variables.scss +137 -137
  464. package/src/widgets/icons/arrow-down.svg +3 -3
  465. package/src/widgets/icons/arrow-right.svg +2 -2
  466. package/src/widgets/icons/base.svg +104 -104
  467. package/src/widgets/icons/calendar-old.svg +169 -169
  468. package/src/widgets/icons/calendar.svg +187 -187
  469. package/src/widgets/icons/calendar.tsx +20 -15
  470. package/src/widgets/icons/check.tsx +2 -1
  471. package/src/widgets/icons/clear.svg +74 -74
  472. package/src/widgets/icons/clear.tsx +2 -1
  473. package/src/widgets/icons/close.svg +74 -74
  474. package/src/widgets/icons/close.tsx +2 -2
  475. package/src/widgets/icons/cx.tsx +2 -1
  476. package/src/widgets/icons/drop-down.tsx +2 -1
  477. package/src/widgets/icons/dropdown-arrow.svg +61 -61
  478. package/src/widgets/icons/file.svg +4 -4
  479. package/src/widgets/icons/file.tsx +2 -1
  480. package/src/widgets/icons/folder-open.svg +5 -5
  481. package/src/widgets/icons/folder-open.tsx +2 -1
  482. package/src/widgets/icons/folder.svg +58 -58
  483. package/src/widgets/icons/folder.tsx +2 -1
  484. package/src/widgets/icons/forward.svg +67 -67
  485. package/src/widgets/icons/forward.tsx +2 -1
  486. package/src/widgets/icons/index.ts +14 -14
  487. package/src/widgets/icons/loading.svg +4 -4
  488. package/src/widgets/icons/loading.tsx +2 -1
  489. package/src/widgets/icons/menu.tsx +2 -1
  490. package/src/widgets/icons/pixel-picker.tsx +2 -2
  491. package/src/widgets/icons/registry.ts +56 -56
  492. package/src/widgets/icons/search.svg +107 -107
  493. package/src/widgets/icons/search.tsx +2 -1
  494. package/src/widgets/icons/sort-asc.svg +3 -3
  495. package/src/widgets/icons/sort-asc.tsx +2 -1
  496. package/src/widgets/icons/square.tsx +2 -1
  497. package/src/widgets/index.d.ts +55 -55
  498. package/src/widgets/index.scss +16 -16
  499. package/src/widgets/index.ts +58 -58
  500. package/src/widgets/nav/Link.scss +20 -20
  501. package/src/widgets/nav/Link.ts +11 -11
  502. package/src/widgets/nav/LinkButton.ts +176 -176
  503. package/src/widgets/nav/Menu.scss +76 -76
  504. package/src/widgets/nav/Menu.tsx +489 -489
  505. package/src/widgets/nav/Menu.variables.scss +25 -25
  506. package/src/widgets/nav/MenuItem.scss +130 -130
  507. package/src/widgets/nav/MenuItem.tsx +525 -525
  508. package/src/widgets/nav/MenuSpacer.ts +18 -18
  509. package/src/widgets/nav/RedirectRoute.ts +49 -49
  510. package/src/widgets/nav/Route.spec.tsx +24 -24
  511. package/src/widgets/nav/Scroller.scss +148 -148
  512. package/src/widgets/nav/Scroller.tsx +252 -252
  513. package/src/widgets/nav/Submenu.ts +6 -6
  514. package/src/widgets/nav/Tab.scss +82 -82
  515. package/src/widgets/nav/Tab.ts +120 -120
  516. package/src/widgets/nav/Tab.variables.scss +84 -84
  517. package/src/widgets/nav/cover.scss +22 -22
  518. package/src/widgets/nav/index.scss +5 -5
  519. package/src/widgets/nav/index.ts +10 -10
  520. package/src/widgets/nav/variables.scss +27 -27
  521. package/src/widgets/overlay/ContextMenu.ts +42 -42
  522. package/src/widgets/overlay/Dropdown.scss +186 -186
  523. package/src/widgets/overlay/FlyweightTooltipTracker.ts +57 -57
  524. package/src/widgets/overlay/Overlay.scss +68 -68
  525. package/src/widgets/overlay/Overlay.tsx +947 -947
  526. package/src/widgets/overlay/Toast.scss +163 -163
  527. package/src/widgets/overlay/Tooltip.scss +177 -177
  528. package/src/widgets/overlay/Tooltip.tsx +393 -393
  529. package/src/widgets/overlay/Window.scss +129 -129
  530. package/src/widgets/overlay/Window.variables.scss +62 -62
  531. package/src/widgets/overlay/captureMouse.scss +13 -13
  532. package/src/widgets/overlay/captureMouse.ts +195 -195
  533. package/src/widgets/overlay/createHotPromiseWindowFactory.ts +71 -71
  534. package/src/widgets/overlay/index.scss +15 -15
  535. package/src/widgets/overlay/tooltip-ops.ts +173 -173
  536. package/src/widgets/overlay/variables.scss +85 -85
  537. package/src/widgets/variables.scss +146 -146
  538. package/tsconfig.compile.json +4 -4
  539. package/tsconfig.json +34 -34
  540. package/tsconfig.mocha.json +14 -14
@@ -1,407 +1,407 @@
1
- /** @jsxImportSource react */
2
-
3
- import { Widget, getContent } from "../../ui/Widget";
4
- import { Field, FieldConfig, getFieldTooltip } from "./Field";
5
- import { BooleanProp, NumberProp, Prop, StringProp } from "../../ui/Prop";
6
- import { Instance } from "../../ui/Instance";
7
-
8
- export interface TextFieldConfig extends FieldConfig {
9
- /** Textual value of the input field. */
10
- value?: Prop<any>;
11
-
12
- /** Default text displayed when the field is empty. */
13
- placeholder?: StringProp;
14
-
15
- /** Defaults to `false`. Set to `true` to disable the field. */
16
- disabled?: BooleanProp;
17
-
18
- /** The opposite of `disabled`. */
19
- enabled?: BooleanProp;
20
-
21
- /** Defaults to `false`. Used to make the field read-only. */
22
- readOnly?: BooleanProp;
23
-
24
- /** Defaults to `false`. Used to make the field required. */
25
- required?: BooleanProp;
26
-
27
- /** Minimal length of the input text. */
28
- minLength?: NumberProp;
29
-
30
- /** Maximal length of the input text. */
31
- maxLength?: NumberProp;
32
-
33
- /** Regular expression used to validate the user's input. */
34
- validationRegExp?: Prop<RegExp>;
35
-
36
- /** Error message displayed upon validation failure. */
37
- validationErrorText?: StringProp;
38
-
39
- /** Error message displayed when input text is too short. */
40
- minLengthValidationErrorText?: StringProp;
41
-
42
- /** Error message displayed when input text is too long. */
43
- maxLengthValidationErrorText?: StringProp;
44
-
45
- /** Event triggering value updates. Possible values are `input` (default), `enter`, or `blur`. Multiple values can be separated by space. */
46
- reactOn?: StringProp;
47
-
48
- /** Input type. Defaults to `text`. Other common value is `password`. */
49
- inputType?: StringProp;
50
-
51
- /** Base CSS class to be applied to the field. Defaults to `textfield`. */
52
- baseClass?: string;
53
-
54
- /** Keyboard shortcut used to focus the field. */
55
- keyboardShortcut?: StringProp;
56
-
57
- /** Set to `true` to remove leading and trailing whitespace. Default is `false`. */
58
- trim?: BooleanProp;
59
-
60
- /** Set to `true` to hide the clear button. Default value is `false`. */
61
- hideClear?: BooleanProp;
62
-
63
- /** Set to `false` to hide the clear button. Default value is `true`. */
64
- showClear?: BooleanProp;
65
-
66
- /** Set to `true` to display the clear button even if `required` is set. Default is `false`. */
67
- alwaysShowClear?: BooleanProp;
68
-
69
- /** Name or configuration of the icon to be put on the left side of the input. */
70
- icon?: Prop<any>;
71
-
72
- /** Additional attributes to be passed to the input element. */
73
- inputAttrs?: Prop<any>;
74
-
75
- /** If `trackFocus` is set, this value will be set when the field receives or loses focus. */
76
- focused?: BooleanProp;
77
-
78
- /** Callback invoked when the value changes. */
79
- onChange?: string | ((value: any, instance: Instance) => void);
80
-
81
- /** Callback invoked on each input event. */
82
- onInput?: string | ((value: any, instance: Instance) => void);
83
-
84
- /** Callback invoked when the field receives focus. */
85
- onFocus?: string | ((e: FocusEvent, instance: Instance) => void);
86
-
87
- /** Callback invoked when the field loses focus. */
88
- onBlur?: string | ((e: FocusEvent, instance: Instance) => void);
89
-
90
- /** Handler triggered on key down events. Return `false` to prevent default behavior. */
91
- onKeyDown?: string | ((e: KeyboardEvent, instance: Instance) => boolean | void);
92
-
93
- /** Custom validation function. */
94
- onValidate?: string | ((value: string, instance: Instance, validationParams: any) => string | undefined | false);
95
- }
96
-
97
- // Legacy alias for backward compatibility
98
- export interface TextFieldProps extends TextFieldConfig {}
99
-
100
- import {
101
- tooltipParentWillReceiveProps,
102
- tooltipParentWillUnmount,
103
- tooltipMouseMove,
104
- tooltipMouseLeave,
105
- tooltipParentDidMount,
106
- } from "../overlay/tooltip-ops";
107
- import { stopPropagation, preventDefault } from "../../util/eventCallbacks";
108
- import { StringTemplate } from "../../data/StringTemplate";
109
- import { Icon } from "../Icon";
110
- import { KeyCode } from "../../util/KeyCode";
111
- import { Localization } from "../../ui/Localization";
112
- import ClearIcon from "../icons/clear";
113
- import { autoFocus } from "../autoFocus";
114
- import { isString } from "../../util/isString";
115
- import { getActiveElement } from "../../util/getActiveElement";
116
- import { VDOM } from "../../ui/VDOM";
117
-
118
- export class TextField<Config extends TextFieldConfig = TextFieldConfig> extends Field<Config> {
119
- declare public hideClear?: boolean;
120
- declare public showClear?: boolean;
121
- declare public alwaysShowClear?: boolean;
122
- declare public validationRegExp?: RegExp;
123
- declare public validationErrorText?: string;
124
- declare public minLengthValidationErrorText: string;
125
- declare public maxLengthValidationErrorText: string;
126
- declare public reactOn: string;
127
- declare public inputType?: string;
128
- declare public keyboardShortcut?: string;
129
- declare public trim?: boolean;
130
-
131
- public init(): void {
132
- if (typeof this.hideClear !== "undefined") this.showClear = !this.hideClear;
133
-
134
- if (this.alwaysShowClear) this.showClear = true;
135
-
136
- super.init();
137
- }
138
-
139
- public declareData(...args: any[]): void {
140
- super.declareData(
141
- {
142
- value: this.emptyValue,
143
- disabled: undefined,
144
- readOnly: undefined,
145
- enabled: undefined,
146
- placeholder: undefined,
147
- required: undefined,
148
- minLength: undefined,
149
- maxLength: undefined,
150
- icon: undefined,
151
- trim: undefined,
152
- },
153
- ...args,
154
- );
155
- }
156
-
157
- public renderInput(context: any, instance: any, key?: any): any {
158
- return (
159
- <Input
160
- key={key}
161
- instance={instance}
162
- data={instance.data}
163
- label={this.labelPlacement && getContent(this.renderLabel(context, instance, "label"))}
164
- help={this.helpPlacement && getContent(this.renderHelp(context, instance, "help"))}
165
- icon={this.renderIcon(context, instance, "icon")}
166
- />
167
- );
168
- }
169
-
170
- public validate(context: any, instance: any): void {
171
- super.validate(context, instance);
172
-
173
- let { data } = instance;
174
-
175
- if (!data.error && data.value) {
176
- if (this.validationRegExp) this.validationRegExp.lastIndex = 0;
177
- if (this.validationRegExp && !this.validationRegExp.test(data.value)) data.error = this.validationErrorText;
178
- else if (typeof data.value === "string" && data.minLength != null && data.value.length < data.minLength)
179
- data.error = StringTemplate.format(this.minLengthValidationErrorText, data.minLength, data.value.length);
180
- else if (typeof data.value === "string" && data.maxLength != null && data.value.length > data.maxLength)
181
- data.error = StringTemplate.format(this.maxLengthValidationErrorText, data.maxLength, data.value.length);
182
- }
183
- }
184
- }
185
-
186
- TextField.prototype.baseClass = "textfield";
187
- TextField.prototype.reactOn = "change input blur enter";
188
- TextField.prototype.inputType = "text";
189
- TextField.prototype.validationErrorText = "The entered value is not valid.";
190
- TextField.prototype.minLengthValidationErrorText = "Enter {[{0}-{1}]} more character(s).";
191
- TextField.prototype.maxLengthValidationErrorText = "Use {0} characters or fewer.";
192
- TextField.prototype.suppressErrorsUntilVisited = true;
193
- TextField.prototype.icon = null;
194
- TextField.prototype.showClear = false;
195
- TextField.prototype.alwaysShowClear = false;
196
- TextField.prototype.keyboardShortcut = "false";
197
- TextField.prototype.trim = false;
198
-
199
- Localization.registerPrototype("cx/widgets/TextField", TextField);
200
-
201
- class Input extends VDOM.Component<any, any> {
202
- public input?: HTMLInputElement;
203
-
204
- constructor(props: any) {
205
- super(props);
206
- this.state = {
207
- focus: false,
208
- };
209
- }
210
-
211
- render(): any {
212
- let { instance, data, label, help, icon: iconVDOM } = this.props;
213
- let { widget, state } = instance;
214
- let { CSS, baseClass, suppressErrorsUntilVisited } = widget;
215
-
216
- let icon = iconVDOM && (
217
- <div
218
- className={CSS.element(baseClass, "left-icon")}
219
- onMouseDown={preventDefault}
220
- onClick={(e: any) => this.onChange((e.target as any).value, "enter")}
221
- >
222
- {iconVDOM}
223
- </div>
224
- );
225
-
226
- let insideButton;
227
- if (
228
- widget.showClear &&
229
- !data.empty &&
230
- !data.readOnly &&
231
- !data.disabled &&
232
- (widget.alwaysShowClear || !data.required)
233
- ) {
234
- insideButton = (
235
- <div
236
- className={CSS.element(baseClass, "clear")}
237
- onMouseDown={(e: any) => e.preventDefault()}
238
- onClick={(e: any) => this.onClearClick(e)}
239
- >
240
- <ClearIcon className={CSS.element(baseClass, "icon")} />
241
- </div>
242
- );
243
- }
244
-
245
- let empty = this.input ? !this.trimmed(this.input.value) : data.empty;
246
-
247
- return (
248
- <div
249
- className={CSS.expand(
250
- data.classNames,
251
- CSS.state({
252
- visited: state.visited,
253
- focus: this.state.focus,
254
- icon: !!icon,
255
- clear: insideButton != null,
256
- empty: empty && !data.placeholder,
257
- error: data.error && (state.visited || !suppressErrorsUntilVisited || !empty),
258
- }),
259
- )}
260
- style={data.style}
261
- onMouseDown={stopPropagation}
262
- onTouchStart={stopPropagation}
263
- >
264
- <input
265
- ref={(el: HTMLInputElement | null) => {
266
- this.input = el || undefined;
267
- }}
268
- className={CSS.expand(CSS.element(baseClass, "input"), data.inputClass)}
269
- defaultValue={data.value}
270
- id={data.id}
271
- style={data.inputStyle}
272
- type={widget.inputType}
273
- disabled={data.disabled}
274
- readOnly={data.readOnly}
275
- tabIndex={data.tabIndex}
276
- placeholder={data.placeholder}
277
- {...data.inputAttrs}
278
- onMouseMove={this.onMouseMove.bind(this)}
279
- onMouseLeave={this.onMouseLeave.bind(this)}
280
- onInput={(e: any) => this.onChange(e.target.value, "input")}
281
- onChange={(e: any) => this.onChange((e.target as any).value, "change")}
282
- onKeyDown={this.onKeyDown.bind(this)}
283
- onFocus={this.onFocus.bind(this)}
284
- onBlur={this.onBlur.bind(this)}
285
- onClick={stopPropagation}
286
- />
287
- {insideButton}
288
- {icon}
289
- {label}
290
- {help}
291
- </div>
292
- );
293
- }
294
-
295
- onFocus(): void {
296
- let { instance, data } = this.props;
297
- let { widget } = instance;
298
- if (widget.trackFocus) {
299
- this.setState({
300
- focus: true,
301
- });
302
- instance.set("focused", true);
303
- }
304
- if (data.error && data.value) instance.setState({ visited: true });
305
- }
306
-
307
- onBlur(e: any): void {
308
- if (this.state.focus) {
309
- this.setState({
310
- focus: false,
311
- });
312
- this.props.instance.set("focused", false);
313
- }
314
- this.onChange((e.target as any).value, "blur");
315
- }
316
-
317
- onClearClick(_e: any): void {
318
- if (this.input) this.input.value = ""; // prevent onChange call with old text value on blur or component unmount
319
- this.props.instance.set("value", this.props.instance.widget.emptyValue, { immediate: true });
320
- }
321
-
322
- onMouseMove(e: any): void {
323
- const tooltip = getFieldTooltip(this.props.instance);
324
- tooltipMouseMove(e, tooltip[0], tooltip[1], tooltip[2]);
325
- }
326
-
327
- onMouseLeave(e: any): void {
328
- const tooltip = getFieldTooltip(this.props.instance);
329
- tooltipMouseLeave(e, tooltip[0], tooltip[1], tooltip[2]);
330
- }
331
-
332
- componentDidMount(): void {
333
- const tooltip = getFieldTooltip(this.props.instance);
334
- tooltipParentDidMount(this.input!, tooltip[0], tooltip[1], tooltip[2]);
335
- autoFocus(this.input, this);
336
- }
337
-
338
- componentDidUpdate(): void {
339
- autoFocus(this.input, this);
340
- }
341
-
342
- componentWillUnmount(): void {
343
- if (this.input == getActiveElement() && this.input && this.input.value != this.props.data.value)
344
- this.onChange(this.input.value, "blur");
345
- tooltipParentWillUnmount(this.props.instance);
346
- }
347
-
348
- onKeyDown(e: any): void {
349
- let { instance } = this.props;
350
- if (instance.widget.handleKeyDown(e, instance) === false) return;
351
-
352
- switch (e.keyCode) {
353
- case KeyCode.enter:
354
- this.onChange(e.target.value, "enter");
355
- break;
356
-
357
- case KeyCode.left:
358
- case KeyCode.right:
359
- e.stopPropagation();
360
- break;
361
- }
362
- }
363
-
364
- UNSAFE_componentWillReceiveProps(props: any): void {
365
- let { data } = props;
366
- // The second check is required for debouncing, sometimes the value in the store lags after the input
367
- // and update may be caused by some other property, i.e. visited
368
- if (this.input && data.value != this.input.value && data.value != this.props.data.value)
369
- this.input.value = data.value || "";
370
- const tooltip = getFieldTooltip(props.instance);
371
- tooltipParentWillReceiveProps(this.input!, tooltip[0], tooltip[1], tooltip[2]);
372
- }
373
-
374
- onChange(textValue: any, change: string): void {
375
- let { instance, data } = this.props;
376
-
377
- let immediate = change == "blur" || change == "enter";
378
-
379
- if (immediate) {
380
- instance.setState({ visited: true });
381
- }
382
-
383
- let { widget } = instance;
384
-
385
- if (widget.reactOn.indexOf(change) != -1) {
386
- let text = this.trimmed(textValue);
387
- if (data.maxLength != null && text.length > data.maxLength) {
388
- text = text.substring(0, data.maxLength);
389
- if (this.input) this.input.value = text;
390
- }
391
-
392
- let value = text || widget.emptyValue;
393
- if (!instance.set("value", value, { immediate })) {
394
- if (this.input && text != this.input.value && immediate) this.input.value = text;
395
- } else {
396
- if (value) instance.setState({ visited: true });
397
- }
398
- }
399
- }
400
-
401
- trimmed(value: any): any {
402
- if (this.props.data.trim && isString(value)) return value.trim();
403
- return value;
404
- }
405
- }
406
-
407
- Widget.alias("textfield", TextField);
1
+ /** @jsxImportSource react */
2
+
3
+ import { Widget, getContent } from "../../ui/Widget";
4
+ import { Field, FieldConfig, getFieldTooltip } from "./Field";
5
+ import { BooleanProp, NumberProp, Prop, StringProp } from "../../ui/Prop";
6
+ import { Instance } from "../../ui/Instance";
7
+
8
+ export interface TextFieldConfig extends FieldConfig {
9
+ /** Textual value of the input field. */
10
+ value?: Prop<any>;
11
+
12
+ /** Default text displayed when the field is empty. */
13
+ placeholder?: StringProp;
14
+
15
+ /** Defaults to `false`. Set to `true` to disable the field. */
16
+ disabled?: BooleanProp;
17
+
18
+ /** The opposite of `disabled`. */
19
+ enabled?: BooleanProp;
20
+
21
+ /** Defaults to `false`. Used to make the field read-only. */
22
+ readOnly?: BooleanProp;
23
+
24
+ /** Defaults to `false`. Used to make the field required. */
25
+ required?: BooleanProp;
26
+
27
+ /** Minimal length of the input text. */
28
+ minLength?: NumberProp;
29
+
30
+ /** Maximal length of the input text. */
31
+ maxLength?: NumberProp;
32
+
33
+ /** Regular expression used to validate the user's input. */
34
+ validationRegExp?: Prop<RegExp>;
35
+
36
+ /** Error message displayed upon validation failure. */
37
+ validationErrorText?: StringProp;
38
+
39
+ /** Error message displayed when input text is too short. */
40
+ minLengthValidationErrorText?: StringProp;
41
+
42
+ /** Error message displayed when input text is too long. */
43
+ maxLengthValidationErrorText?: StringProp;
44
+
45
+ /** Event triggering value updates. Possible values are `input` (default), `enter`, or `blur`. Multiple values can be separated by space. */
46
+ reactOn?: StringProp;
47
+
48
+ /** Input type. Defaults to `text`. Other common value is `password`. */
49
+ inputType?: StringProp;
50
+
51
+ /** Base CSS class to be applied to the field. Defaults to `textfield`. */
52
+ baseClass?: string;
53
+
54
+ /** Keyboard shortcut used to focus the field. */
55
+ keyboardShortcut?: StringProp;
56
+
57
+ /** Set to `true` to remove leading and trailing whitespace. Default is `false`. */
58
+ trim?: BooleanProp;
59
+
60
+ /** Set to `true` to hide the clear button. Default value is `false`. */
61
+ hideClear?: BooleanProp;
62
+
63
+ /** Set to `false` to hide the clear button. Default value is `true`. */
64
+ showClear?: BooleanProp;
65
+
66
+ /** Set to `true` to display the clear button even if `required` is set. Default is `false`. */
67
+ alwaysShowClear?: BooleanProp;
68
+
69
+ /** Name or configuration of the icon to be put on the left side of the input. */
70
+ icon?: Prop<any>;
71
+
72
+ /** Additional attributes to be passed to the input element. */
73
+ inputAttrs?: Prop<any>;
74
+
75
+ /** If `trackFocus` is set, this value will be set when the field receives or loses focus. */
76
+ focused?: BooleanProp;
77
+
78
+ /** Callback invoked when the value changes. */
79
+ onChange?: string | ((value: any, instance: Instance) => void);
80
+
81
+ /** Callback invoked on each input event. */
82
+ onInput?: string | ((value: any, instance: Instance) => void);
83
+
84
+ /** Callback invoked when the field receives focus. */
85
+ onFocus?: string | ((e: FocusEvent, instance: Instance) => void);
86
+
87
+ /** Callback invoked when the field loses focus. */
88
+ onBlur?: string | ((e: FocusEvent, instance: Instance) => void);
89
+
90
+ /** Handler triggered on key down events. Return `false` to prevent default behavior. */
91
+ onKeyDown?: string | ((e: KeyboardEvent, instance: Instance) => boolean | void);
92
+
93
+ /** Custom validation function. */
94
+ onValidate?: string | ((value: string, instance: Instance, validationParams: any) => string | undefined | false);
95
+ }
96
+
97
+ // Legacy alias for backward compatibility
98
+ export interface TextFieldProps extends TextFieldConfig {}
99
+
100
+ import {
101
+ tooltipParentWillReceiveProps,
102
+ tooltipParentWillUnmount,
103
+ tooltipMouseMove,
104
+ tooltipMouseLeave,
105
+ tooltipParentDidMount,
106
+ } from "../overlay/tooltip-ops";
107
+ import { stopPropagation, preventDefault } from "../../util/eventCallbacks";
108
+ import { StringTemplate } from "../../data/StringTemplate";
109
+ import { Icon } from "../Icon";
110
+ import { KeyCode } from "../../util/KeyCode";
111
+ import { Localization } from "../../ui/Localization";
112
+ import ClearIcon from "../icons/clear";
113
+ import { autoFocus } from "../autoFocus";
114
+ import { isString } from "../../util/isString";
115
+ import { getActiveElement } from "../../util/getActiveElement";
116
+ import { VDOM } from "../../ui/VDOM";
117
+
118
+ export class TextField<Config extends TextFieldConfig = TextFieldConfig> extends Field<Config> {
119
+ declare public hideClear?: boolean;
120
+ declare public showClear?: boolean;
121
+ declare public alwaysShowClear?: boolean;
122
+ declare public validationRegExp?: RegExp;
123
+ declare public validationErrorText?: string;
124
+ declare public minLengthValidationErrorText: string;
125
+ declare public maxLengthValidationErrorText: string;
126
+ declare public reactOn: string;
127
+ declare public inputType?: string;
128
+ declare public keyboardShortcut?: string;
129
+ declare public trim?: boolean;
130
+
131
+ public init(): void {
132
+ if (typeof this.hideClear !== "undefined") this.showClear = !this.hideClear;
133
+
134
+ if (this.alwaysShowClear) this.showClear = true;
135
+
136
+ super.init();
137
+ }
138
+
139
+ public declareData(...args: any[]): void {
140
+ super.declareData(
141
+ {
142
+ value: this.emptyValue,
143
+ disabled: undefined,
144
+ readOnly: undefined,
145
+ enabled: undefined,
146
+ placeholder: undefined,
147
+ required: undefined,
148
+ minLength: undefined,
149
+ maxLength: undefined,
150
+ icon: undefined,
151
+ trim: undefined,
152
+ },
153
+ ...args,
154
+ );
155
+ }
156
+
157
+ public renderInput(context: any, instance: any, key?: any): any {
158
+ return (
159
+ <Input
160
+ key={key}
161
+ instance={instance}
162
+ data={instance.data}
163
+ label={this.labelPlacement && getContent(this.renderLabel(context, instance, "label"))}
164
+ help={this.helpPlacement && getContent(this.renderHelp(context, instance, "help"))}
165
+ icon={this.renderIcon(context, instance, "icon")}
166
+ />
167
+ );
168
+ }
169
+
170
+ public validate(context: any, instance: any): void {
171
+ super.validate(context, instance);
172
+
173
+ let { data } = instance;
174
+
175
+ if (!data.error && data.value) {
176
+ if (this.validationRegExp) this.validationRegExp.lastIndex = 0;
177
+ if (this.validationRegExp && !this.validationRegExp.test(data.value)) data.error = this.validationErrorText;
178
+ else if (typeof data.value === "string" && data.minLength != null && data.value.length < data.minLength)
179
+ data.error = StringTemplate.format(this.minLengthValidationErrorText, data.minLength, data.value.length);
180
+ else if (typeof data.value === "string" && data.maxLength != null && data.value.length > data.maxLength)
181
+ data.error = StringTemplate.format(this.maxLengthValidationErrorText, data.maxLength, data.value.length);
182
+ }
183
+ }
184
+ }
185
+
186
+ TextField.prototype.baseClass = "textfield";
187
+ TextField.prototype.reactOn = "change input blur enter";
188
+ TextField.prototype.inputType = "text";
189
+ TextField.prototype.validationErrorText = "The entered value is not valid.";
190
+ TextField.prototype.minLengthValidationErrorText = "Enter {[{0}-{1}]} more character(s).";
191
+ TextField.prototype.maxLengthValidationErrorText = "Use {0} characters or fewer.";
192
+ TextField.prototype.suppressErrorsUntilVisited = true;
193
+ TextField.prototype.icon = null;
194
+ TextField.prototype.showClear = false;
195
+ TextField.prototype.alwaysShowClear = false;
196
+ TextField.prototype.keyboardShortcut = "false";
197
+ TextField.prototype.trim = false;
198
+
199
+ Localization.registerPrototype("cx/widgets/TextField", TextField);
200
+
201
+ class Input extends VDOM.Component<any, any> {
202
+ public input?: HTMLInputElement;
203
+
204
+ constructor(props: any) {
205
+ super(props);
206
+ this.state = {
207
+ focus: false,
208
+ };
209
+ }
210
+
211
+ render(): any {
212
+ let { instance, data, label, help, icon: iconVDOM } = this.props;
213
+ let { widget, state } = instance;
214
+ let { CSS, baseClass, suppressErrorsUntilVisited } = widget;
215
+
216
+ let icon = iconVDOM && (
217
+ <div
218
+ className={CSS.element(baseClass, "left-icon")}
219
+ onMouseDown={preventDefault}
220
+ onClick={(e: any) => this.onChange((e.target as any).value, "enter")}
221
+ >
222
+ {iconVDOM}
223
+ </div>
224
+ );
225
+
226
+ let insideButton;
227
+ if (
228
+ widget.showClear &&
229
+ !data.empty &&
230
+ !data.readOnly &&
231
+ !data.disabled &&
232
+ (widget.alwaysShowClear || !data.required)
233
+ ) {
234
+ insideButton = (
235
+ <div
236
+ className={CSS.element(baseClass, "clear")}
237
+ onMouseDown={(e: any) => e.preventDefault()}
238
+ onClick={(e: any) => this.onClearClick(e)}
239
+ >
240
+ <ClearIcon className={CSS.element(baseClass, "icon")} />
241
+ </div>
242
+ );
243
+ }
244
+
245
+ let empty = this.input ? !this.trimmed(this.input.value) : data.empty;
246
+
247
+ return (
248
+ <div
249
+ className={CSS.expand(
250
+ data.classNames,
251
+ CSS.state({
252
+ visited: state.visited,
253
+ focus: this.state.focus,
254
+ icon: !!icon,
255
+ clear: insideButton != null,
256
+ empty: empty && !data.placeholder,
257
+ error: data.error && (state.visited || !suppressErrorsUntilVisited || !empty),
258
+ }),
259
+ )}
260
+ style={data.style}
261
+ onMouseDown={stopPropagation}
262
+ onTouchStart={stopPropagation}
263
+ >
264
+ <input
265
+ ref={(el: HTMLInputElement | null) => {
266
+ this.input = el || undefined;
267
+ }}
268
+ className={CSS.expand(CSS.element(baseClass, "input"), data.inputClass)}
269
+ defaultValue={data.value}
270
+ id={data.id}
271
+ style={data.inputStyle}
272
+ type={widget.inputType}
273
+ disabled={data.disabled}
274
+ readOnly={data.readOnly}
275
+ tabIndex={data.tabIndex}
276
+ placeholder={data.placeholder}
277
+ {...data.inputAttrs}
278
+ onMouseMove={this.onMouseMove.bind(this)}
279
+ onMouseLeave={this.onMouseLeave.bind(this)}
280
+ onInput={(e: any) => this.onChange(e.target.value, "input")}
281
+ onChange={(e: any) => this.onChange((e.target as any).value, "change")}
282
+ onKeyDown={this.onKeyDown.bind(this)}
283
+ onFocus={this.onFocus.bind(this)}
284
+ onBlur={this.onBlur.bind(this)}
285
+ onClick={stopPropagation}
286
+ />
287
+ {insideButton}
288
+ {icon}
289
+ {label}
290
+ {help}
291
+ </div>
292
+ );
293
+ }
294
+
295
+ onFocus(): void {
296
+ let { instance, data } = this.props;
297
+ let { widget } = instance;
298
+ if (widget.trackFocus) {
299
+ this.setState({
300
+ focus: true,
301
+ });
302
+ instance.set("focused", true);
303
+ }
304
+ if (data.error && data.value) instance.setState({ visited: true });
305
+ }
306
+
307
+ onBlur(e: any): void {
308
+ if (this.state.focus) {
309
+ this.setState({
310
+ focus: false,
311
+ });
312
+ this.props.instance.set("focused", false);
313
+ }
314
+ this.onChange((e.target as any).value, "blur");
315
+ }
316
+
317
+ onClearClick(_e: any): void {
318
+ if (this.input) this.input.value = ""; // prevent onChange call with old text value on blur or component unmount
319
+ this.props.instance.set("value", this.props.instance.widget.emptyValue, { immediate: true });
320
+ }
321
+
322
+ onMouseMove(e: any): void {
323
+ const tooltip = getFieldTooltip(this.props.instance);
324
+ tooltipMouseMove(e, tooltip[0], tooltip[1], tooltip[2]);
325
+ }
326
+
327
+ onMouseLeave(e: any): void {
328
+ const tooltip = getFieldTooltip(this.props.instance);
329
+ tooltipMouseLeave(e, tooltip[0], tooltip[1], tooltip[2]);
330
+ }
331
+
332
+ componentDidMount(): void {
333
+ const tooltip = getFieldTooltip(this.props.instance);
334
+ tooltipParentDidMount(this.input!, tooltip[0], tooltip[1], tooltip[2]);
335
+ autoFocus(this.input, this);
336
+ }
337
+
338
+ componentDidUpdate(): void {
339
+ autoFocus(this.input, this);
340
+ }
341
+
342
+ componentWillUnmount(): void {
343
+ if (this.input == getActiveElement() && this.input && this.input.value != this.props.data.value)
344
+ this.onChange(this.input.value, "blur");
345
+ tooltipParentWillUnmount(this.props.instance);
346
+ }
347
+
348
+ onKeyDown(e: any): void {
349
+ let { instance } = this.props;
350
+ if (instance.widget.handleKeyDown(e, instance) === false) return;
351
+
352
+ switch (e.keyCode) {
353
+ case KeyCode.enter:
354
+ this.onChange(e.target.value, "enter");
355
+ break;
356
+
357
+ case KeyCode.left:
358
+ case KeyCode.right:
359
+ e.stopPropagation();
360
+ break;
361
+ }
362
+ }
363
+
364
+ UNSAFE_componentWillReceiveProps(props: any): void {
365
+ let { data } = props;
366
+ // The second check is required for debouncing, sometimes the value in the store lags after the input
367
+ // and update may be caused by some other property, i.e. visited
368
+ if (this.input && data.value != this.input.value && data.value != this.props.data.value)
369
+ this.input.value = data.value || "";
370
+ const tooltip = getFieldTooltip(props.instance);
371
+ tooltipParentWillReceiveProps(this.input!, tooltip[0], tooltip[1], tooltip[2]);
372
+ }
373
+
374
+ onChange(textValue: any, change: string): void {
375
+ let { instance, data } = this.props;
376
+
377
+ let immediate = change == "blur" || change == "enter";
378
+
379
+ if (immediate) {
380
+ instance.setState({ visited: true });
381
+ }
382
+
383
+ let { widget } = instance;
384
+
385
+ if (widget.reactOn.indexOf(change) != -1) {
386
+ let text = this.trimmed(textValue);
387
+ if (data.maxLength != null && text.length > data.maxLength) {
388
+ text = text.substring(0, data.maxLength);
389
+ if (this.input) this.input.value = text;
390
+ }
391
+
392
+ let value = text || widget.emptyValue;
393
+ if (!instance.set("value", value, { immediate })) {
394
+ if (this.input && text != this.input.value && immediate) this.input.value = text;
395
+ } else {
396
+ if (value) instance.setState({ visited: true });
397
+ }
398
+ }
399
+ }
400
+
401
+ trimmed(value: any): any {
402
+ if (this.props.data.trim && isString(value)) return value.trim();
403
+ return value;
404
+ }
405
+ }
406
+
407
+ Widget.alias("textfield", TextField);