cx 26.1.3 → 26.1.4

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 (569) 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/ui/Widget.d.ts +1 -1
  6. package/build/ui/exprHelpers.d.ts +8 -0
  7. package/build/ui/exprHelpers.js +11 -0
  8. package/build/widgets/overlay/Overlay.d.ts +3 -3
  9. package/build.js +133 -133
  10. package/dist/manifest.js +893 -893
  11. package/dist/ui.js +18 -4
  12. package/dist/util.js +0 -4
  13. package/dist/widgets.js +320 -395
  14. package/package.json +100 -100
  15. package/src/charts/Bar.scss +28 -28
  16. package/src/charts/Bar.ts +114 -114
  17. package/src/charts/BarGraph.scss +28 -28
  18. package/src/charts/BarGraph.tsx +145 -145
  19. package/src/charts/BubbleGraph.scss +31 -31
  20. package/src/charts/BubbleGraph.tsx +165 -165
  21. package/src/charts/Chart.ts +108 -108
  22. package/src/charts/ColorMap.ts +150 -150
  23. package/src/charts/Column.scss +28 -28
  24. package/src/charts/Column.ts +124 -124
  25. package/src/charts/ColumnBarBase.tsx +284 -284
  26. package/src/charts/ColumnBarGraphBase.tsx +229 -229
  27. package/src/charts/ColumnGraph.scss +29 -29
  28. package/src/charts/ColumnGraph.tsx +153 -153
  29. package/src/charts/Grid.ts +5 -5
  30. package/src/charts/Gridlines.scss +24 -24
  31. package/src/charts/Gridlines.tsx +88 -88
  32. package/src/charts/Legend.scss +50 -50
  33. package/src/charts/Legend.tsx +270 -270
  34. package/src/charts/LegendEntry.scss +29 -29
  35. package/src/charts/LegendEntry.tsx +197 -197
  36. package/src/charts/LineGraph.scss +24 -24
  37. package/src/charts/LineGraph.tsx +455 -455
  38. package/src/charts/Marker.scss +43 -43
  39. package/src/charts/Marker.tsx +483 -483
  40. package/src/charts/MarkerLine.scss +19 -19
  41. package/src/charts/MarkerLine.tsx +214 -214
  42. package/src/charts/MouseTracker.tsx +112 -112
  43. package/src/charts/Pie.ts +8 -8
  44. package/src/charts/PieChart.scss +28 -28
  45. package/src/charts/PieChart.tsx +717 -717
  46. package/src/charts/PieLabel.tsx +106 -106
  47. package/src/charts/PieLabelsContainer.ts +68 -68
  48. package/src/charts/Range.scss +19 -19
  49. package/src/charts/Range.tsx +318 -318
  50. package/src/charts/RangeMarker.scss +17 -17
  51. package/src/charts/RangeMarker.tsx +233 -233
  52. package/src/charts/ScatterGraph.scss +23 -23
  53. package/src/charts/ScatterGraph.tsx +245 -245
  54. package/src/charts/Swimlane.scss +16 -16
  55. package/src/charts/Swimlane.tsx +195 -195
  56. package/src/charts/Swimlanes.scss +16 -16
  57. package/src/charts/Swimlanes.tsx +179 -179
  58. package/src/charts/axis/Axis.scss +22 -22
  59. package/src/charts/axis/Axis.tsx +444 -444
  60. package/src/charts/axis/CategoryAxis.scss +34 -34
  61. package/src/charts/axis/CategoryAxis.tsx +313 -313
  62. package/src/charts/axis/NumericAxis.scss +34 -34
  63. package/src/charts/axis/NumericAxis.tsx +437 -437
  64. package/src/charts/axis/Stack.ts +61 -61
  65. package/src/charts/axis/TimeAxis.scss +33 -33
  66. package/src/charts/axis/TimeAxis.tsx +718 -718
  67. package/src/charts/axis/index.scss +5 -5
  68. package/src/charts/axis/index.ts +3 -3
  69. package/src/charts/axis/variables.scss +2 -2
  70. package/src/charts/helpers/MinMaxFinder.ts +66 -66
  71. package/src/charts/helpers/PointReducer.ts +135 -135
  72. package/src/charts/helpers/SnapPointFinder.ts +136 -136
  73. package/src/charts/helpers/ValueAtFinder.ts +72 -72
  74. package/src/charts/helpers/index.ts +4 -4
  75. package/src/charts/index.scss +22 -22
  76. package/src/charts/index.ts +34 -34
  77. package/src/charts/palette.scss +97 -97
  78. package/src/charts/shapes.tsx +86 -86
  79. package/src/charts/variables.scss +22 -22
  80. package/src/core.d.ts +182 -182
  81. package/src/data/AggregateFunction.ts +171 -171
  82. package/src/data/ArrayElementView.spec.ts +88 -88
  83. package/src/data/ArrayElementView.ts +91 -91
  84. package/src/data/ArrayRef.ts +34 -34
  85. package/src/data/AugmentedViewBase.ts +88 -88
  86. package/src/data/Binding.spec.ts +69 -69
  87. package/src/data/Binding.ts +104 -104
  88. package/src/data/ExposedRecordView.ts +95 -95
  89. package/src/data/ExposedValueView.ts +89 -89
  90. package/src/data/Expression.spec.ts +229 -229
  91. package/src/data/Expression.ts +233 -233
  92. package/src/data/Grouper.spec.ts +57 -57
  93. package/src/data/Grouper.ts +158 -158
  94. package/src/data/NestedDataView.ts +43 -43
  95. package/src/data/ReadOnlyDataView.ts +39 -39
  96. package/src/data/Ref.spec.ts +79 -79
  97. package/src/data/Ref.ts +104 -104
  98. package/src/data/Selector.ts +10 -10
  99. package/src/data/Store.spec.ts +22 -22
  100. package/src/data/Store.ts +52 -52
  101. package/src/data/StoreProxy.ts +19 -19
  102. package/src/data/StoreRef.spec.ts +24 -24
  103. package/src/data/StoreRef.ts +66 -66
  104. package/src/data/StringTemplate.spec.ts +132 -132
  105. package/src/data/StringTemplate.ts +93 -93
  106. package/src/data/StructuredSelector.spec.ts +113 -113
  107. package/src/data/StructuredSelector.ts +146 -146
  108. package/src/data/SubscribableView.ts +63 -63
  109. package/src/data/View.spec.ts +60 -60
  110. package/src/data/View.ts +289 -289
  111. package/src/data/ZoomIntoPropertyView.spec.ts +64 -64
  112. package/src/data/ZoomIntoPropertyView.ts +45 -45
  113. package/src/data/comparer.spec.ts +60 -60
  114. package/src/data/comparer.ts +78 -78
  115. package/src/data/computable.spec.ts +87 -87
  116. package/src/data/computable.ts +69 -69
  117. package/src/data/createAccessorModelProxy.spec.tsx +145 -145
  118. package/src/data/createAccessorModelProxy.ts +66 -66
  119. package/src/data/createStructuredSelector.spec.ts +45 -45
  120. package/src/data/createStructuredSelector.ts +62 -62
  121. package/src/data/defaultCompare.ts +14 -14
  122. package/src/data/diff/diffArrays.ts +49 -49
  123. package/src/data/diff/diffs.spec.ts +49 -49
  124. package/src/data/diff/index.ts +1 -1
  125. package/src/data/enableFatArrowExpansion.ts +6 -6
  126. package/src/data/getAccessor.spec.ts +11 -11
  127. package/src/data/getAccessor.ts +74 -74
  128. package/src/data/getSelector.spec.ts +43 -43
  129. package/src/data/getSelector.ts +66 -66
  130. package/src/data/index.ts +30 -30
  131. package/src/data/isSelector.ts +26 -26
  132. package/src/data/ops/append.spec.ts +28 -28
  133. package/src/data/ops/append.ts +5 -5
  134. package/src/data/ops/filter.spec.ts +35 -35
  135. package/src/data/ops/filter.ts +9 -9
  136. package/src/data/ops/findTreeNode.spec.ts +23 -23
  137. package/src/data/ops/findTreeNode.ts +14 -14
  138. package/src/data/ops/findTreePath.ts +23 -23
  139. package/src/data/ops/index.ts +11 -11
  140. package/src/data/ops/insertElement.ts +3 -3
  141. package/src/data/ops/merge.spec.ts +27 -27
  142. package/src/data/ops/merge.ts +13 -13
  143. package/src/data/ops/moveElement.ts +21 -21
  144. package/src/data/ops/removeTreeNodes.spec.ts +37 -37
  145. package/src/data/ops/removeTreeNodes.ts +15 -15
  146. package/src/data/ops/updateArray.spec.ts +69 -69
  147. package/src/data/ops/updateArray.ts +31 -31
  148. package/src/data/ops/updateTree.spec.ts +54 -54
  149. package/src/data/ops/updateTree.ts +23 -23
  150. package/src/data/test-types.ts +7 -7
  151. package/src/global.scss +13 -13
  152. package/src/hooks/createLocalStorageRef.ts +21 -21
  153. package/src/hooks/index.ts +8 -8
  154. package/src/hooks/invokeCallback.spec.tsx +59 -59
  155. package/src/hooks/invokeCallback.ts +8 -8
  156. package/src/hooks/resolveCallback.spec.tsx +71 -71
  157. package/src/hooks/resolveCallback.ts +16 -16
  158. package/src/hooks/store.spec.tsx +67 -67
  159. package/src/hooks/store.ts +46 -46
  160. package/src/hooks/useEffect.ts +14 -14
  161. package/src/hooks/useInterval.ts +8 -8
  162. package/src/hooks/useState.ts +20 -20
  163. package/src/hooks/useTrigger.spec.tsx +105 -105
  164. package/src/hooks/useTrigger.ts +26 -26
  165. package/src/index.scss +6 -6
  166. package/src/index.ts +7 -7
  167. package/src/jsx-dev-runtime.ts +4 -4
  168. package/src/jsx-runtime.spec.tsx +431 -431
  169. package/src/jsx-runtime.ts +79 -79
  170. package/src/locale/de-de.ts +76 -76
  171. package/src/locale/en-us.ts +75 -75
  172. package/src/locale/es-es.ts +76 -76
  173. package/src/locale/fr-fr.ts +76 -76
  174. package/src/locale/nl-nl.ts +76 -76
  175. package/src/locale/pt-pt.ts +76 -76
  176. package/src/locale/sr-latn-ba.ts +76 -76
  177. package/src/svg/BoundedObject.ts +101 -101
  178. package/src/svg/ClipRect.tsx +29 -29
  179. package/src/svg/Ellipse.tsx +68 -68
  180. package/src/svg/Line.tsx +58 -58
  181. package/src/svg/NonOverlappingRect.ts +26 -26
  182. package/src/svg/NonOverlappingRectGroup.ts +49 -49
  183. package/src/svg/Rectangle.tsx +90 -90
  184. package/src/svg/Svg.scss +27 -27
  185. package/src/svg/Svg.tsx +241 -241
  186. package/src/svg/Text.tsx +134 -134
  187. package/src/svg/TextualBoundedObject.ts +35 -35
  188. package/src/svg/index.scss +8 -8
  189. package/src/svg/index.ts +17 -17
  190. package/src/svg/util/Rect.ts +105 -105
  191. package/src/ui/CSS.ts +87 -87
  192. package/src/ui/CSSHelper.ts +17 -17
  193. package/src/ui/Container.tsx +216 -216
  194. package/src/ui/ContentResolver.spec.tsx +585 -585
  195. package/src/ui/ContentResolver.ts +132 -132
  196. package/src/ui/Controller.spec.tsx +574 -574
  197. package/src/ui/Controller.ts +202 -202
  198. package/src/ui/Culture.ts +159 -159
  199. package/src/ui/Cx.spec.tsx +210 -210
  200. package/src/ui/Cx.tsx +386 -386
  201. package/src/ui/DataProxy.spec.tsx +337 -337
  202. package/src/ui/DataProxy.ts +55 -55
  203. package/src/ui/DetachedScope.tsx +159 -159
  204. package/src/ui/FocusManager.ts +171 -171
  205. package/src/ui/Format.ts +108 -108
  206. package/src/ui/HoverSync.tsx +189 -189
  207. package/src/ui/Instance.ts +866 -866
  208. package/src/ui/IsolatedScope.spec.tsx +62 -62
  209. package/src/ui/IsolatedScope.ts +50 -50
  210. package/src/ui/Localization.ts +70 -70
  211. package/src/ui/Prop.ts +140 -140
  212. package/src/ui/PureContainer.spec.tsx +232 -232
  213. package/src/ui/PureContainer.tsx +19 -19
  214. package/src/ui/RenderingContext.ts +99 -99
  215. package/src/ui/Repeater.spec.tsx +143 -143
  216. package/src/ui/Repeater.ts +194 -194
  217. package/src/ui/Rescope.spec.tsx +199 -199
  218. package/src/ui/Rescope.ts +49 -49
  219. package/src/ui/ResizeManager.ts +30 -30
  220. package/src/ui/Restate.spec.tsx +422 -422
  221. package/src/ui/Restate.tsx +217 -217
  222. package/src/ui/StaticText.ts +11 -11
  223. package/src/ui/StructuredInstanceDataAccessor.ts +32 -32
  224. package/src/ui/Text.ts +49 -49
  225. package/src/ui/VDOM.ts +1 -1
  226. package/src/ui/Widget.spec.tsx +53 -53
  227. package/src/ui/Widget.tsx +301 -301
  228. package/src/ui/ZIndexManager.ts +11 -11
  229. package/src/ui/adapter/ArrayAdapter.spec.ts +55 -55
  230. package/src/ui/adapter/ArrayAdapter.ts +229 -229
  231. package/src/ui/adapter/DataAdapter.ts +52 -52
  232. package/src/ui/adapter/GroupAdapter.ts +235 -235
  233. package/src/ui/adapter/TreeAdapter.spec.ts +76 -76
  234. package/src/ui/adapter/TreeAdapter.ts +185 -185
  235. package/src/ui/adapter/index.ts +4 -4
  236. package/src/ui/app/History.ts +133 -133
  237. package/src/ui/app/Url.spec.ts +50 -50
  238. package/src/ui/app/Url.ts +102 -102
  239. package/src/ui/app/index.ts +5 -5
  240. package/src/ui/app/startAppLoop.tsx +71 -71
  241. package/src/ui/app/startHotAppLoop.ts +41 -41
  242. package/src/ui/batchUpdates.ts +77 -77
  243. package/src/ui/bind.ts +10 -10
  244. package/src/ui/createFunctionalComponent.spec.tsx +454 -454
  245. package/src/ui/createFunctionalComponent.ts +86 -86
  246. package/src/ui/expr.ts +47 -47
  247. package/src/ui/exprHelpers.spec.ts +412 -379
  248. package/src/ui/exprHelpers.ts +95 -78
  249. package/src/ui/flattenProps.ts +21 -21
  250. package/src/ui/index.scss +2 -2
  251. package/src/ui/index.ts +47 -47
  252. package/src/ui/keyboardShortcuts.ts +40 -40
  253. package/src/ui/layout/Content.ts +30 -30
  254. package/src/ui/layout/ContentPlaceholder.spec.tsx +599 -599
  255. package/src/ui/layout/ContentPlaceholder.ts +133 -133
  256. package/src/ui/layout/FirstVisibleChildLayout.spec.tsx +207 -207
  257. package/src/ui/layout/FirstVisibleChildLayout.ts +60 -60
  258. package/src/ui/layout/LabelsLeftLayout.scss +46 -46
  259. package/src/ui/layout/LabelsLeftLayout.tsx +76 -76
  260. package/src/ui/layout/LabelsTopLayout.scss +64 -64
  261. package/src/ui/layout/LabelsTopLayout.tsx +156 -156
  262. package/src/ui/layout/UseParentLayout.ts +8 -8
  263. package/src/ui/layout/exploreChildren.ts +38 -38
  264. package/src/ui/layout/index.scss +3 -3
  265. package/src/ui/layout/index.ts +10 -10
  266. package/src/ui/layout/variables.scss +2 -2
  267. package/src/ui/selection/KeySelection.ts +153 -153
  268. package/src/ui/selection/PropertySelection.ts +87 -87
  269. package/src/ui/selection/Selection.ts +128 -128
  270. package/src/ui/selection/index.ts +3 -3
  271. package/src/ui/tpl.ts +4 -4
  272. package/src/ui/variables.scss +1 -1
  273. package/src/util/Component.spec.ts +411 -411
  274. package/src/util/Component.ts +301 -301
  275. package/src/util/Console.ts +13 -13
  276. package/src/util/DOM.ts +88 -88
  277. package/src/util/Debug.ts +71 -71
  278. package/src/util/Format.spec.ts +69 -69
  279. package/src/util/Format.ts +267 -267
  280. package/src/util/GlobalCacheIdentifier.ts +11 -11
  281. package/src/util/KeyCode.ts +21 -21
  282. package/src/util/SubscriberList.ts +86 -86
  283. package/src/util/Timing.ts +58 -58
  284. package/src/util/TraversalStack.spec.ts +53 -53
  285. package/src/util/TraversalStack.ts +47 -47
  286. package/src/util/addEventListenerWithOptions.ts +41 -41
  287. package/src/util/browserSupportsPassiveEventHandlers.ts +20 -20
  288. package/src/util/calculateNaturalElementHeight.ts +22 -22
  289. package/src/util/call-once.scss +6 -6
  290. package/src/util/capitalize.ts +4 -4
  291. package/src/util/coalesce.ts +6 -6
  292. package/src/util/color/hslToRgb.ts +34 -34
  293. package/src/util/color/index.ts +4 -4
  294. package/src/util/color/parseColor.ts +173 -173
  295. package/src/util/color/rgbToHex.ts +14 -14
  296. package/src/util/color/rgbToHsl.ts +35 -35
  297. package/src/util/date/dateDiff.ts +9 -9
  298. package/src/util/date/diff.ts +13 -13
  299. package/src/util/date/encodeDate.ts +8 -8
  300. package/src/util/date/encodeDateWithTimezoneOffset.ts +18 -18
  301. package/src/util/date/index.ts +11 -11
  302. package/src/util/date/lowerBoundCheck.ts +13 -13
  303. package/src/util/date/maxDate.ts +14 -14
  304. package/src/util/date/minDate.ts +14 -14
  305. package/src/util/date/monthStart.ts +8 -8
  306. package/src/util/date/parseDateInvariant.ts +20 -20
  307. package/src/util/date/sameDate.ts +11 -11
  308. package/src/util/date/upperBoundCheck.spec.ts +30 -30
  309. package/src/util/date/upperBoundCheck.ts +13 -13
  310. package/src/util/date/zeroTime.ts +9 -9
  311. package/src/util/debounce.ts +26 -26
  312. package/src/util/dummyCallback.ts +1 -1
  313. package/src/util/escapeSpecialRegexCharacters.ts +8 -8
  314. package/src/util/eventCallbacks.ts +12 -12
  315. package/src/util/expandFatArrows.ts +118 -118
  316. package/src/util/findScrollableParent.ts +15 -15
  317. package/src/util/getActiveElement.ts +4 -4
  318. package/src/util/getParentFrameBoundingClientRect.ts +13 -13
  319. package/src/util/getScrollerBoundingClientRect.ts +12 -12
  320. package/src/util/getSearchQueryPredicate.spec.ts +40 -40
  321. package/src/util/getSearchQueryPredicate.ts +58 -58
  322. package/src/util/getTopLevelBoundingClientRect.ts +7 -7
  323. package/src/util/getVendorPrefix.ts +33 -33
  324. package/src/util/hasKey.ts +18 -18
  325. package/src/util/index.scss +10 -10
  326. package/src/util/index.ts +55 -55
  327. package/src/util/innerTextTrim.ts +10 -10
  328. package/src/util/isArray.ts +3 -3
  329. package/src/util/isDataRecord.ts +5 -5
  330. package/src/util/isDefined.ts +3 -3
  331. package/src/util/isDigit.ts +8 -8
  332. package/src/util/isFunction.ts +3 -3
  333. package/src/util/isNonEmptyArray.ts +3 -3
  334. package/src/util/isNumber.ts +3 -3
  335. package/src/util/isObject.ts +3 -3
  336. package/src/util/isPromise.ts +6 -6
  337. package/src/util/isString.ts +3 -3
  338. package/src/util/isTextInputElement.ts +2 -2
  339. package/src/util/isTouchDevice.ts +7 -7
  340. package/src/util/isTouchEvent.ts +64 -64
  341. package/src/util/isUndefined.ts +3 -3
  342. package/src/util/isValidIdentifierName.spec.ts +33 -33
  343. package/src/util/isValidIdentifierName.ts +5 -5
  344. package/src/util/onIdleCallback.ts +10 -10
  345. package/src/util/parseStyle.ts +29 -29
  346. package/src/util/quote.ts +6 -6
  347. package/src/util/reverseSlice.ts +9 -9
  348. package/src/util/routeAppend.spec.ts +19 -19
  349. package/src/util/routeAppend.ts +15 -15
  350. package/src/util/scrollElementIntoView.ts +40 -40
  351. package/src/util/scss/add-rules.scss +40 -40
  352. package/src/util/scss/calc.scss +44 -44
  353. package/src/util/scss/call-once.scss +12 -12
  354. package/src/util/scss/clockwise.scss +49 -49
  355. package/src/util/scss/colors.scss +9 -9
  356. package/src/util/scss/deep-get.scss +11 -11
  357. package/src/util/scss/deep-merge.scss +21 -21
  358. package/src/util/scss/divide.scss +3 -3
  359. package/src/util/scss/include.scss +48 -48
  360. package/src/util/scss/index.scss +9 -9
  361. package/src/util/shallowEquals.ts +43 -43
  362. package/src/util/test/createTestRenderer.tsx +19 -19
  363. package/src/util/throttle.ts +21 -21
  364. package/src/util/validatedDebounce.ts +23 -23
  365. package/src/variables.scss +217 -217
  366. package/src/widgets/AccessorBindings.spec.tsx +90 -90
  367. package/src/widgets/Button.scss +119 -119
  368. package/src/widgets/Button.tsx +189 -189
  369. package/src/widgets/Button.variables.scss +117 -117
  370. package/src/widgets/CxCredit.scss +39 -39
  371. package/src/widgets/CxCredit.tsx +46 -46
  372. package/src/widgets/DocumentTitle.ts +95 -95
  373. package/src/widgets/FlexBox.scss +148 -148
  374. package/src/widgets/FlexBox.tsx +168 -168
  375. package/src/widgets/Heading.scss +40 -40
  376. package/src/widgets/Heading.ts +42 -42
  377. package/src/widgets/HighlightedSearchText.scss +20 -20
  378. package/src/widgets/HighlightedSearchText.tsx +54 -54
  379. package/src/widgets/HtmlElement.spec.helpers.tsx +108 -108
  380. package/src/widgets/HtmlElement.spec.tsx +89 -89
  381. package/src/widgets/HtmlElement.tsx +407 -407
  382. package/src/widgets/Icon.scss +22 -22
  383. package/src/widgets/Icon.ts +64 -64
  384. package/src/widgets/List.scss +93 -93
  385. package/src/widgets/List.tsx +793 -793
  386. package/src/widgets/ProgressBar.scss +50 -50
  387. package/src/widgets/ProgressBar.tsx +66 -66
  388. package/src/widgets/ReactElementWrapper.spec.tsx +452 -452
  389. package/src/widgets/ReactElementWrapper.tsx +108 -108
  390. package/src/widgets/Resizer.scss +43 -43
  391. package/src/widgets/Resizer.tsx +200 -200
  392. package/src/widgets/Sandbox.ts +103 -103
  393. package/src/widgets/Section.scss +55 -55
  394. package/src/widgets/Section.tsx +187 -187
  395. package/src/widgets/animations.scss +10 -10
  396. package/src/widgets/autoFocus.ts +9 -9
  397. package/src/widgets/cx.ts +63 -63
  398. package/src/widgets/drag-drop/DragClone.scss +35 -35
  399. package/src/widgets/drag-drop/DragHandle.scss +18 -18
  400. package/src/widgets/drag-drop/DragHandle.tsx +47 -47
  401. package/src/widgets/drag-drop/DragSource.scss +26 -26
  402. package/src/widgets/drag-drop/DragSource.tsx +237 -237
  403. package/src/widgets/drag-drop/DropZone.scss +76 -76
  404. package/src/widgets/drag-drop/DropZone.tsx +353 -353
  405. package/src/widgets/drag-drop/index.scss +3 -3
  406. package/src/widgets/drag-drop/index.ts +4 -4
  407. package/src/widgets/drag-drop/ops.tsx +422 -422
  408. package/src/widgets/drag-drop/variables.scss +14 -14
  409. package/src/widgets/enableAllInternalDependencies.ts +11 -11
  410. package/src/widgets/form/Calendar.scss +199 -199
  411. package/src/widgets/form/Calendar.tsx +760 -760
  412. package/src/widgets/form/Calendar.variables.scss +63 -63
  413. package/src/widgets/form/Checkbox.scss +129 -129
  414. package/src/widgets/form/Checkbox.tsx +287 -287
  415. package/src/widgets/form/Checkbox.variables.scss +39 -39
  416. package/src/widgets/form/ColorField.scss +98 -98
  417. package/src/widgets/form/ColorField.tsx +497 -497
  418. package/src/widgets/form/ColorPicker.scss +285 -285
  419. package/src/widgets/form/ColorPicker.tsx +544 -544
  420. package/src/widgets/form/ColorPicker.variables.scss +22 -22
  421. package/src/widgets/form/DateField.ts +21 -21
  422. package/src/widgets/form/DateTimeField.scss +92 -92
  423. package/src/widgets/form/DateTimeField.tsx +726 -726
  424. package/src/widgets/form/DateTimePicker.scss +46 -46
  425. package/src/widgets/form/DateTimePicker.tsx +429 -429
  426. package/src/widgets/form/Field.scss +164 -164
  427. package/src/widgets/form/Field.tsx +608 -608
  428. package/src/widgets/form/FieldGroup.ts +10 -10
  429. package/src/widgets/form/FieldIcon.ts +61 -61
  430. package/src/widgets/form/HelpText.scss +24 -24
  431. package/src/widgets/form/HelpText.ts +15 -15
  432. package/src/widgets/form/Label.scss +37 -37
  433. package/src/widgets/form/Label.tsx +117 -117
  434. package/src/widgets/form/LabeledContainer.ts +77 -77
  435. package/src/widgets/form/LookupField.scss +221 -221
  436. package/src/widgets/form/LookupField.spec.tsx +93 -93
  437. package/src/widgets/form/LookupField.tsx +1421 -1421
  438. package/src/widgets/form/MonthField.scss +100 -100
  439. package/src/widgets/form/MonthField.tsx +670 -670
  440. package/src/widgets/form/MonthPicker.scss +125 -125
  441. package/src/widgets/form/MonthPicker.tsx +822 -822
  442. package/src/widgets/form/NumberField.scss +63 -63
  443. package/src/widgets/form/NumberField.tsx +543 -543
  444. package/src/widgets/form/Radio.scss +123 -123
  445. package/src/widgets/form/Radio.tsx +249 -249
  446. package/src/widgets/form/Radio.variables.scss +45 -45
  447. package/src/widgets/form/Select.scss +101 -101
  448. package/src/widgets/form/Select.tsx +327 -327
  449. package/src/widgets/form/Slider.scss +121 -121
  450. package/src/widgets/form/Slider.tsx +473 -473
  451. package/src/widgets/form/Switch.scss +142 -142
  452. package/src/widgets/form/Switch.tsx +176 -176
  453. package/src/widgets/form/TextArea.scss +45 -45
  454. package/src/widgets/form/TextArea.tsx +229 -229
  455. package/src/widgets/form/TextField.scss +57 -57
  456. package/src/widgets/form/TextField.tsx +407 -407
  457. package/src/widgets/form/TimeField.ts +10 -10
  458. package/src/widgets/form/TimeList.tsx +105 -105
  459. package/src/widgets/form/UploadButton.scss +49 -49
  460. package/src/widgets/form/UploadButton.tsx +307 -307
  461. package/src/widgets/form/ValidationError.scss +22 -22
  462. package/src/widgets/form/ValidationError.tsx +72 -72
  463. package/src/widgets/form/ValidationGroup.spec.tsx +147 -147
  464. package/src/widgets/form/ValidationGroup.ts +141 -141
  465. package/src/widgets/form/Validator.ts +60 -60
  466. package/src/widgets/form/Wheel.scss +152 -152
  467. package/src/widgets/form/Wheel.tsx +314 -314
  468. package/src/widgets/form/index.scss +24 -24
  469. package/src/widgets/form/index.ts +28 -28
  470. package/src/widgets/form/variables.scss +355 -355
  471. package/src/widgets/grid/Grid.scss +640 -640
  472. package/src/widgets/grid/Grid.tsx +4243 -4243
  473. package/src/widgets/grid/GridCell.ts +143 -143
  474. package/src/widgets/grid/GridCellEditor.tsx +58 -58
  475. package/src/widgets/grid/GridRow.ts +302 -302
  476. package/src/widgets/grid/GridRowLine.ts +49 -49
  477. package/src/widgets/grid/Pagination.scss +115 -115
  478. package/src/widgets/grid/Pagination.tsx +126 -126
  479. package/src/widgets/grid/TreeNode.scss +90 -90
  480. package/src/widgets/grid/TreeNode.tsx +154 -154
  481. package/src/widgets/grid/createGridCellEditor.tsx +18 -18
  482. package/src/widgets/grid/index.scss +3 -3
  483. package/src/widgets/grid/index.ts +16 -16
  484. package/src/widgets/grid/variables.scss +137 -137
  485. package/src/widgets/icons/arrow-down.svg +3 -3
  486. package/src/widgets/icons/arrow-right.svg +2 -2
  487. package/src/widgets/icons/base.svg +104 -104
  488. package/src/widgets/icons/calendar-old.svg +169 -169
  489. package/src/widgets/icons/calendar.svg +187 -187
  490. package/src/widgets/icons/calendar.tsx +22 -22
  491. package/src/widgets/icons/check.tsx +14 -14
  492. package/src/widgets/icons/clear.svg +74 -74
  493. package/src/widgets/icons/clear.tsx +16 -16
  494. package/src/widgets/icons/close.svg +74 -74
  495. package/src/widgets/icons/close.tsx +20 -20
  496. package/src/widgets/icons/cx.tsx +39 -39
  497. package/src/widgets/icons/drop-down.tsx +16 -16
  498. package/src/widgets/icons/dropdown-arrow.svg +61 -61
  499. package/src/widgets/icons/file.svg +4 -4
  500. package/src/widgets/icons/file.tsx +14 -14
  501. package/src/widgets/icons/folder-open.svg +5 -5
  502. package/src/widgets/icons/folder-open.tsx +16 -16
  503. package/src/widgets/icons/folder.svg +58 -58
  504. package/src/widgets/icons/folder.tsx +14 -14
  505. package/src/widgets/icons/forward.svg +67 -67
  506. package/src/widgets/icons/forward.tsx +23 -23
  507. package/src/widgets/icons/index.ts +14 -14
  508. package/src/widgets/icons/loading.svg +4 -4
  509. package/src/widgets/icons/loading.tsx +25 -25
  510. package/src/widgets/icons/menu.tsx +18 -18
  511. package/src/widgets/icons/pixel-picker.tsx +18 -18
  512. package/src/widgets/icons/registry.ts +56 -56
  513. package/src/widgets/icons/search.svg +107 -107
  514. package/src/widgets/icons/search.tsx +14 -14
  515. package/src/widgets/icons/sort-asc.svg +3 -3
  516. package/src/widgets/icons/sort-asc.tsx +15 -15
  517. package/src/widgets/icons/square.tsx +19 -19
  518. package/src/widgets/index.d.ts +55 -55
  519. package/src/widgets/index.scss +16 -16
  520. package/src/widgets/index.ts +58 -58
  521. package/src/widgets/nav/Link.scss +20 -20
  522. package/src/widgets/nav/Link.ts +11 -11
  523. package/src/widgets/nav/LinkButton.ts +176 -176
  524. package/src/widgets/nav/Menu.scss +76 -76
  525. package/src/widgets/nav/Menu.tsx +489 -489
  526. package/src/widgets/nav/Menu.variables.scss +25 -25
  527. package/src/widgets/nav/MenuItem.scss +130 -130
  528. package/src/widgets/nav/MenuItem.tsx +525 -525
  529. package/src/widgets/nav/MenuSpacer.ts +18 -18
  530. package/src/widgets/nav/RedirectRoute.ts +49 -49
  531. package/src/widgets/nav/Route.spec.tsx +24 -24
  532. package/src/widgets/nav/Route.ts +142 -142
  533. package/src/widgets/nav/Scroller.scss +148 -148
  534. package/src/widgets/nav/Scroller.tsx +252 -252
  535. package/src/widgets/nav/Submenu.ts +6 -6
  536. package/src/widgets/nav/Tab.scss +82 -82
  537. package/src/widgets/nav/Tab.ts +120 -120
  538. package/src/widgets/nav/Tab.variables.scss +84 -84
  539. package/src/widgets/nav/cover.scss +22 -22
  540. package/src/widgets/nav/index.scss +5 -5
  541. package/src/widgets/nav/index.ts +10 -10
  542. package/src/widgets/nav/variables.scss +27 -27
  543. package/src/widgets/overlay/ContextMenu.ts +42 -42
  544. package/src/widgets/overlay/Dropdown.scss +186 -186
  545. package/src/widgets/overlay/Dropdown.tsx +762 -762
  546. package/src/widgets/overlay/FlyweightTooltipTracker.ts +57 -57
  547. package/src/widgets/overlay/MsgBox.tsx +141 -141
  548. package/src/widgets/overlay/Overlay.scss +68 -68
  549. package/src/widgets/overlay/Overlay.tsx +947 -947
  550. package/src/widgets/overlay/Toast.scss +163 -163
  551. package/src/widgets/overlay/Toast.ts +111 -111
  552. package/src/widgets/overlay/Tooltip.scss +177 -177
  553. package/src/widgets/overlay/Tooltip.tsx +393 -393
  554. package/src/widgets/overlay/Window.scss +129 -129
  555. package/src/widgets/overlay/Window.tsx +299 -299
  556. package/src/widgets/overlay/Window.variables.scss +62 -62
  557. package/src/widgets/overlay/alerts.ts +46 -46
  558. package/src/widgets/overlay/captureMouse.scss +13 -13
  559. package/src/widgets/overlay/captureMouse.ts +195 -195
  560. package/src/widgets/overlay/createHotPromiseWindowFactory.ts +71 -71
  561. package/src/widgets/overlay/index.d.ts +11 -11
  562. package/src/widgets/overlay/index.scss +15 -15
  563. package/src/widgets/overlay/index.ts +11 -11
  564. package/src/widgets/overlay/tooltip-ops.ts +173 -173
  565. package/src/widgets/overlay/variables.scss +85 -85
  566. package/src/widgets/variables.scss +146 -146
  567. package/tsconfig.compile.json +4 -4
  568. package/tsconfig.json +34 -34
  569. package/tsconfig.mocha.json +14 -14
@@ -1,1421 +1,1421 @@
1
- /**@jsxImportSource react */
2
- import { Widget, VDOM, getContent } from "../../ui/Widget";
3
- import { Cx } from "../../ui/Cx";
4
- import { Field, getFieldTooltip, FieldInstance } from "./Field";
5
- import { ReadOnlyDataView } from "../../data/ReadOnlyDataView";
6
- import { HtmlElement, HtmlElementInstance } from "../HtmlElement";
7
- import { Binding, BindingInput } from "../../data/Binding";
8
- import { debug } from "../../util/Debug";
9
- import { Dropdown, DropdownConfig } from "../overlay/Dropdown";
10
- import { FocusManager } from "../../ui/FocusManager";
11
- import { isFocused } from "../../util/DOM";
12
- import { isTouchDevice } from "../../util/isTouchDevice";
13
- import { isTouchEvent } from "../../util/isTouchEvent";
14
- import {
15
- tooltipParentWillReceiveProps,
16
- tooltipParentWillUnmount,
17
- tooltipMouseMove,
18
- tooltipMouseLeave,
19
- tooltipParentDidMount,
20
- } from "../overlay/tooltip-ops";
21
- import { stopPropagation, preventDefault } from "../../util/eventCallbacks";
22
- import ClearIcon from "../icons/clear";
23
- import DropdownIcon from "../icons/drop-down";
24
- import { getSearchQueryPredicate } from "../../util/getSearchQueryPredicate";
25
- import { KeyCode } from "../../util/KeyCode";
26
- import { Localization } from "../../ui/Localization";
27
- import { StringTemplate } from "../../data/StringTemplate";
28
- import { Icon } from "../Icon";
29
- import { isString } from "../../util/isString";
30
- import { isDefined } from "../../util/isDefined";
31
- import { isArray } from "../../util/isArray";
32
- import { isNonEmptyArray } from "../../util/isNonEmptyArray";
33
- import { addEventListenerWithOptions } from "../../util/addEventListenerWithOptions";
34
- import { List } from "../List";
35
- import { Selection } from "../../ui/selection/Selection";
36
- import { HighlightedSearchText } from "../HighlightedSearchText";
37
- import { autoFocus } from "../autoFocus";
38
- import { bind } from "../../ui";
39
- import { AccessorChain, isAccessorChain } from "../../data/createAccessorModelProxy";
40
- import type { CxChild, RenderingContext } from "../../ui/RenderingContext";
41
- import type { DropdownInstance, Instance } from "../../ui/Instance";
42
- import { FieldConfig } from "./Field";
43
- import { Prop, BooleanProp, StringProp, StructuredProp, DataRecord } from "../../ui/Prop";
44
-
45
- export interface LookupBinding {
46
- local: string;
47
- remote: string;
48
- key?: boolean;
49
- }
50
-
51
- export interface LookupFieldConfig<TOption = unknown, TRecord = unknown> extends FieldConfig {
52
- /** Defaults to `false`. Set to `true` to enable multiple selection. */
53
- multiple?: BooleanProp;
54
-
55
- /** Selected value. Used only if `multiple` is set to `false`. */
56
- value?: Prop<number | string>;
57
-
58
- /** A list of selected ids. Used only if `multiple` is set to `true`. */
59
- values?: Prop<(number | string)[]>;
60
-
61
- /** A list of selected records. Used only if `multiple` is set to `true`. */
62
- records?: Prop<TRecord[]>;
63
-
64
- /** Text associated with the selection. Used only if `multiple` is set to `false`. */
65
- text?: StringProp;
66
-
67
- /** The opposite of `disabled`. */
68
- enabled?: BooleanProp;
69
-
70
- /** Defaults to `false`. Used to make the field read-only. */
71
- readOnly?: BooleanProp;
72
-
73
- /** Default text displayed when the field is empty. */
74
- placeholder?: StringProp;
75
-
76
- /** A list of available options. */
77
- options?: Prop<TOption[]>;
78
-
79
- /** Set to `true` to hide the clear button. Default value is `false`. */
80
- hideClear?: boolean;
81
-
82
- /** Set to `false` to hide the clear button. Default value is `true`. */
83
- showClear?: boolean;
84
-
85
- /** Set to `true` to display the clear button even if `required` is set. Default is `false`. */
86
- alwaysShowClear?: boolean;
87
-
88
- /** Base CSS class to be applied to the field. Defaults to `lookupfield`. */
89
- baseClass?: string;
90
-
91
- /** Name or configuration of the icon to be put on the left side of the input. */
92
- icon?: StringProp | Record<string, any>;
93
-
94
- /** Additional config to be applied to all items. */
95
- itemConfig?: any;
96
-
97
- /** An array of objects describing the mapping of option data to store data. */
98
- bindings?: LookupBinding[];
99
-
100
- /** A delay in milliseconds between typing stop and query. Default is `150`. */
101
- queryDelay?: number;
102
-
103
- /** Minimal number of characters required before query is made. */
104
- minQueryLength?: number;
105
-
106
- /** Set to `true` to hide the search field. */
107
- hideSearchField?: boolean;
108
-
109
- /** Number of options required to show search field. Defaults to `7`. */
110
- minOptionsForSearchField?: number;
111
-
112
- /** Text to display while data is being loaded. */
113
- loadingText?: string;
114
-
115
- /** Error message displayed if server query throws an exception. */
116
- queryErrorText?: string;
117
-
118
- /** Message to be displayed if no entries match the user query. */
119
- noResultsText?: string;
120
-
121
- /** Name of the field which holds the id of the option. Default is `id`. */
122
- optionIdField?: string;
123
-
124
- /** Name of the field which holds the display text of the option. Default is `text`. */
125
- optionTextField?: string;
126
-
127
- /** Name of the field to store id of selected value in multiple mode. Default is `id`. */
128
- valueIdField?: string;
129
-
130
- /** Name of the field to store display text of selected value. Default is `text`. */
131
- valueTextField?: string;
132
-
133
- /** `onQuery` will be called once to fetch all options; filtering occurs client-side. */
134
- fetchAll?: boolean;
135
-
136
- /** When set with `fetchAll`, fetched options are cached for widget lifetime. */
137
- cacheAll?: boolean;
138
-
139
- /** Close the dropdown after selection. Default is `true`. */
140
- closeOnSelect?: boolean;
141
-
142
- /** Message displayed if the entered search query is too short. */
143
- minQueryLengthMessageText?: string;
144
-
145
- /** Query function called to fetch options. */
146
- onQuery?:
147
- | string
148
- | ((
149
- query: string | { query: string; page: number; pageSize: number },
150
- instance: Instance,
151
- ) => TOption[] | Promise<TOption[]>);
152
-
153
- /** Set to `true` to sort dropdown options. */
154
- sort?: boolean;
155
-
156
- /** Additional list options, such as grouping configuration, custom sorting, etc. */
157
- listOptions?: Record<string, any>;
158
-
159
- /** Show dropdown immediately after component mount; useful for cell editing. */
160
- autoOpen?: BooleanProp;
161
-
162
- /** Allow enter key events to propagate; useful for forms or grid cell editors. */
163
- submitOnEnterKey?: BooleanProp;
164
-
165
- /** Allow dropdown enter key events to propagate for form submission. */
166
- submitOnDropdownEnterKey?: BooleanProp;
167
-
168
- /** Number of additional items loaded in `infinite` mode. Default is `100`. */
169
- pageSize?: number;
170
-
171
- /** Set to `true` to enable loading additional options when scroll reaches end. */
172
- infinite?: boolean;
173
-
174
- /** Allow quick selection of all displayed items on `Ctrl + A` key combination. */
175
- quickSelectAll?: boolean;
176
-
177
- /** Parameters that affect filtering. */
178
- filterParams?: StructuredProp;
179
-
180
- /** Used in multiple selection lookups to construct display text from multiple fields. */
181
- onGetRecordDisplayText?: ((record: TRecord, instance: Instance) => string) | null;
182
-
183
- /** Callback to create a filter function for given filter params. */
184
- onCreateVisibleOptionsFilter?:
185
- | string
186
- | ((filterParams: unknown, instance: Instance) => (option: TOption) => boolean);
187
-
188
- /** Additional configuration to be passed to the dropdown, such as `style`, `positioning`, etc. */
189
- dropdownOptions?: Partial<DropdownConfig>;
190
-
191
- /** Custom validation function. */
192
- onValidate?:
193
- | string
194
- | ((value: number | string, instance: Instance, validationParams: Record<string, unknown>) => unknown);
195
- }
196
-
197
- export class LookupField<TOption = unknown, TRecord = unknown> extends Field<
198
- LookupFieldConfig<TOption, TRecord>
199
- > {
200
- declare public baseClass: string;
201
- declare public multiple: boolean;
202
- declare public hideClear?: boolean;
203
- declare public showClear: boolean;
204
- declare public alwaysShowClear: boolean;
205
- declare public hideSearchField: boolean;
206
- declare public minOptionsForSearchField: number;
207
- declare public loadingText: string;
208
- declare public queryErrorText: string;
209
- declare public noResultsText: string;
210
- declare public optionIdField: string;
211
- declare public optionTextField: string;
212
- declare public valueIdField: string;
213
- declare public valueTextField: string;
214
- declare public fetchAll: boolean;
215
- declare public cacheAll: boolean;
216
- declare public closeOnSelect: boolean;
217
- declare public minQueryLengthMessageText: string;
218
- declare public sort?: boolean;
219
- declare public listOptions?: Record<string, any> | null;
220
- declare public autoOpen?: boolean;
221
- declare public submitOnEnterKey?: boolean;
222
- declare public submitOnDropdownEnterKey?: boolean;
223
- declare public pageSize: number;
224
- declare public infinite?: boolean;
225
- declare public quickSelectAll?: boolean;
226
- declare public queryDelay: number;
227
- declare public minQueryLength: number;
228
- declare public onGetRecordDisplayText?: ((record: Record<string, any>, instance: Instance) => string) | null;
229
- declare public onQuery?:
230
- | string
231
- | ((
232
- params: string | { query: string; page: number; pageSize: number },
233
- instance: Instance,
234
- ) => Promise<Record<string, any>[]> | Record<string, any>[]);
235
- declare public onCreateVisibleOptionsFilter?:
236
- | string
237
- | ((filterParams: unknown, instance: Instance) => (option: Record<string, any>) => boolean);
238
- declare public value?: BindingInput;
239
- declare public text?: BindingInput<string>;
240
- declare public records?: Record<string, any>[];
241
- declare public values?: unknown[];
242
- declare public options?: Record<string, any>[];
243
-
244
- declare public enabled?: boolean;
245
- declare public placeholder?: string;
246
- declare public readOnly?: boolean;
247
- declare public dropdownOptions?: Partial<DropdownConfig>;
248
- declare public bindings?: BindingConfig[];
249
- declare public keyBindings?: BindingConfig[];
250
- declare public itemConfig?: CxChild;
251
-
252
- declareData(...args: Record<string, any>[]): void {
253
- let additionalAttributes = this.multiple
254
- ? { values: undefined, records: undefined }
255
- : { value: undefined, text: undefined };
256
-
257
- super.declareData(
258
- {
259
- disabled: undefined,
260
- enabled: undefined,
261
- placeholder: undefined,
262
- required: undefined,
263
- options: undefined,
264
- icon: undefined,
265
- autoOpen: undefined,
266
- readOnly: undefined,
267
- filterParams: { structured: true },
268
- },
269
- additionalAttributes,
270
- ...args,
271
- );
272
- }
273
-
274
- init(): void {
275
- if (isDefined(this.hideClear)) this.showClear = !this.hideClear;
276
-
277
- if (this.alwaysShowClear) this.showClear = true;
278
-
279
- if (!this.bindings) {
280
- let b: BindingConfig[] = [];
281
- if (this.value) {
282
- if (isAccessorChain(this.value)) this.value = bind(this.value);
283
- if ((this.value as any).bind)
284
- b.push({
285
- key: true,
286
- local: (this.value as any).bind,
287
- remote: `$option.${this.optionIdField}`,
288
- set: (this.value as any).set,
289
- });
290
- }
291
-
292
- if (this.text as string | AccessorChain<unknown>) {
293
- if (isAccessorChain(this.text)) this.text = bind(this.text);
294
- if ((this.text as any).bind)
295
- b.push({
296
- local: (this.text as any).bind,
297
- remote: `$option.${this.optionTextField}`,
298
- set: (this.text as any).set,
299
- });
300
- }
301
-
302
- this.bindings = b;
303
- }
304
-
305
- if (this.bindings.length == 0 && this.multiple)
306
- this.bindings = [
307
- {
308
- key: true,
309
- local: `$value.${this.valueIdField}`,
310
- remote: `$option.${this.optionIdField}`,
311
- },
312
- {
313
- local: `$value.${this.valueTextField}`,
314
- remote: `$option.${this.optionTextField}`,
315
- },
316
- ];
317
-
318
- this.keyBindings = this.bindings.filter((b) => b.key);
319
-
320
- if (!this.items && !this.children)
321
- this.items = {
322
- type: HighlightedSearchText,
323
- text: { bind: `$option.${this.optionTextField}` },
324
- query: { bind: "$query" },
325
- } as any;
326
-
327
- this.itemConfig = this.children || this.items;
328
-
329
- this.items = [];
330
- delete this.children;
331
-
332
- super.init();
333
- }
334
-
335
- prepareData(context: RenderingContext, instance: FieldInstance<LookupField>): void {
336
- let { data, store } = instance;
337
-
338
- data.stateMods = {
339
- multiple: this.multiple,
340
- single: !this.multiple,
341
- disabled: data.disabled,
342
- readonly: data.readOnly,
343
- };
344
-
345
- data.visibleOptions = data.options;
346
- if (this.onCreateVisibleOptionsFilter && isArray(data.options)) {
347
- let filterPredicate = instance.invoke("onCreateVisibleOptionsFilter", data.filterParams, instance);
348
- data.visibleOptions = data.options.filter(filterPredicate);
349
- }
350
-
351
- data.selectedKeys = [];
352
-
353
- if (this.multiple) {
354
- if (isArray(data.values) && isArray(data.options)) {
355
- data.selectedKeys = data.values.map((v) => (this.keyBindings!.length == 1 ? [v] : v));
356
- let map: Record<number, Record<string, any>> = {};
357
- data.options.filter(($option) => {
358
- let optionKey = getOptionKey(this.keyBindings!, { $option });
359
- for (let i = 0; i < data.selectedKeys.length; i++)
360
- if (areKeysEqual(optionKey, data.selectedKeys[i])) {
361
- map[i] = convertOption(this.bindings!, { $option });
362
- break;
363
- }
364
- });
365
- data.records = [];
366
- for (let i = 0; i < data.selectedKeys.length; i++) if (map[i]) data.records.push(map[i]);
367
- } else if (isArray(data.records))
368
- data.selectedKeys.push(
369
- ...data.records.map(($value) => this.keyBindings!.map((b) => Binding.get(b.local).value({ $value }))),
370
- );
371
- } else {
372
- let dataViewData = store.getData();
373
- data.selectedKeys.push(this.keyBindings!.map((b) => Binding.get(b.local).value(dataViewData)));
374
- if (!this.text && isArray(data.options)) {
375
- let option = data.options.find(($option) =>
376
- areKeysEqual(getOptionKey(this.keyBindings!, { $option }), data.selectedKeys[0]),
377
- );
378
- data.text = (option && (option as any)[this.optionTextField!]) || "";
379
- }
380
- }
381
-
382
- (instance as DropdownInstance).lastDropdown = context.lastDropdown;
383
-
384
- super.prepareData(context, instance);
385
- }
386
-
387
- renderInput(context: RenderingContext, instance: FieldInstance<LookupField>, key: string): React.ReactNode {
388
- return (
389
- <LookupComponent
390
- key={key}
391
- multiple={this.multiple!}
392
- instance={instance}
393
- itemConfig={this.itemConfig}
394
- bindings={this.bindings!}
395
- baseClass={this.baseClass!}
396
- label={this.labelPlacement && getContent(this.renderLabel(context, instance, "label"))}
397
- help={this.helpPlacement && getContent(this.renderHelp(context, instance, "help"))}
398
- forceUpdate={context.forceUpdate}
399
- icon={this.renderIcon(context, instance, "icon")}
400
- />
401
- );
402
- }
403
-
404
- filterOptions(instance: Instance, options: DataRecord[], query?: string): DataRecord[] {
405
- if (!query) return options;
406
- let textPredicate = getSearchQueryPredicate(query);
407
- return options.filter(
408
- (o) => isString(o[this.optionTextField!]) && textPredicate((o as any)[this.optionTextField!] as string),
409
- );
410
- }
411
-
412
- isEmpty(data: Record<string, any>): boolean {
413
- if (this.multiple) return !isNonEmptyArray(data.values) && !isNonEmptyArray(data.records);
414
- return super.isEmpty(data);
415
- }
416
-
417
- getValidationValue(data: Record<string, any>): unknown {
418
- if (this.multiple) return data.records ?? data.values;
419
- return super.getValidationValue(data);
420
- }
421
-
422
- formatValue(context: RenderingContext, instance: Instance): string | React.ReactNode {
423
- if (!this.multiple) return super.formatValue(context, instance);
424
-
425
- let { records, values, options } = instance.data;
426
- if (isArray(records)) {
427
- let valueTextFormatter =
428
- typeof this.onGetRecordDisplayText === "function"
429
- ? this.onGetRecordDisplayText
430
- : (record: Record<string, any>) =>
431
- (record as any)[this.valueTextField!] || (record as any)[this.valueIdField!];
432
- return records.map((record) => valueTextFormatter(record as any, instance));
433
- }
434
-
435
- if (isArray(values)) {
436
- if (isArray(options))
437
- return values
438
- .map((id) => {
439
- let option = options.find((o) => (o as any)[this.optionIdField!] == id);
440
- return option ? (option as any)[this.valueTextField!] : id;
441
- })
442
- .filter(Boolean)
443
- .join(", ");
444
-
445
- return values.join(", ");
446
- }
447
-
448
- return null;
449
- }
450
- }
451
-
452
- LookupField.prototype.baseClass = "lookupfield";
453
- //LookupField.prototype.memoize = false;
454
- LookupField.prototype.multiple = false;
455
- LookupField.prototype.queryDelay = 150;
456
- LookupField.prototype.minQueryLength = 0;
457
- LookupField.prototype.hideSearchField = false;
458
- LookupField.prototype.minOptionsForSearchField = 7;
459
- LookupField.prototype.loadingText = "Loading...";
460
- LookupField.prototype.queryErrorText = "Error occurred while querying for lookup data.";
461
- LookupField.prototype.noResultsText = "No results found.";
462
- LookupField.prototype.optionIdField = "id";
463
- LookupField.prototype.optionTextField = "text";
464
- LookupField.prototype.valueIdField = "id";
465
- LookupField.prototype.valueTextField = "text";
466
- LookupField.prototype.suppressErrorsUntilVisited = true;
467
- LookupField.prototype.fetchAll = false;
468
- LookupField.prototype.cacheAll = false;
469
- LookupField.prototype.showClear = true;
470
- LookupField.prototype.alwaysShowClear = false;
471
- LookupField.prototype.closeOnSelect = true;
472
- LookupField.prototype.minQueryLengthMessageText = "Type in at least {0} character(s).";
473
- LookupField.prototype.icon = null;
474
- LookupField.prototype.sort = false;
475
- LookupField.prototype.listOptions = null;
476
- LookupField.prototype.autoOpen = false;
477
- LookupField.prototype.submitOnEnterKey = false;
478
- LookupField.prototype.submitOnDropdownEnterKey = false;
479
- LookupField.prototype.pageSize = 100;
480
- LookupField.prototype.infinite = false;
481
- LookupField.prototype.quickSelectAll = false;
482
- LookupField.prototype.onGetRecordDisplayText = null;
483
-
484
- Localization.registerPrototype("cx/widgets/LookupField", LookupField);
485
-
486
- Widget.alias("lookupfield", LookupField);
487
-
488
- interface BindingConfig {
489
- local: string;
490
- remote: string;
491
- key?: boolean;
492
- set?: (value: unknown, instance: Instance) => void;
493
- }
494
-
495
- function getOptionKey(bindings: BindingConfig[], data: Record<string, any>): unknown[] {
496
- return bindings.filter((a) => a.key).map((b) => Binding.get(b.remote).value(data));
497
- }
498
-
499
- function areKeysEqual(key1: unknown[], key2: unknown[]): boolean {
500
- if (!key1 || !key2 || key1.length != key2.length) return false;
501
-
502
- for (let i = 0; i < key1.length; i++) if (key1[i] !== key2[i]) return false;
503
-
504
- return true;
505
- }
506
-
507
- function convertOption(bindings: BindingConfig[], data: Record<string, any>): Record<string, any> {
508
- let result: Record<string, any> = { $value: {} };
509
- bindings.forEach((b) => {
510
- let value = Binding.get(b.remote).value(data);
511
- result = Binding.get(b.local).set(result, value);
512
- });
513
- return result.$value as Record<string, any>;
514
- }
515
-
516
- class SelectionDelegate extends Selection {
517
- delegate: (record: Record<string, any>, index: number) => boolean;
518
-
519
- constructor({ delegate }: { delegate: (record: Record<string, any>, index: number) => boolean }) {
520
- super();
521
- this.delegate = delegate;
522
- }
523
-
524
- getIsSelectedDelegate(store: unknown): (record: Record<string, any>, index: number) => boolean {
525
- return (record: Record<string, any>, index: number) => this.delegate(record, index);
526
- }
527
-
528
- select(): boolean {
529
- return false;
530
- }
531
- }
532
-
533
- interface LookupComponentProps {
534
- instance: FieldInstance<LookupField>;
535
- multiple: boolean;
536
- itemConfig: unknown;
537
- bindings: BindingConfig[];
538
- baseClass: string;
539
- label?: React.ReactNode;
540
- help?: React.ReactNode;
541
- forceUpdate: () => void;
542
- icon?: React.ReactNode;
543
- }
544
-
545
- interface LookupComponentState {
546
- options: unknown[];
547
- formatted?: string;
548
- value?: string;
549
- dropdownOpen: boolean;
550
- focus: boolean;
551
- status?: string;
552
- message?: string;
553
- query?: string;
554
- page?: number;
555
- hover?: boolean;
556
- }
557
-
558
- class LookupComponent extends VDOM.Component<LookupComponentProps, LookupComponentState> {
559
- dom: {
560
- input?: HTMLDivElement | null;
561
- dropdown?: HTMLDivElement | null;
562
- list?: HTMLDivElement | null;
563
- query?: HTMLInputElement | null;
564
- } = {};
565
- itemStore: ReadOnlyDataView;
566
- dropdown?: Widget;
567
- list?: Widget;
568
- listKeyDown?: (e: React.KeyboardEvent) => void;
569
- queryTimeoutId?: ReturnType<typeof setTimeout>;
570
- cachedResult?: Record<string, any>[];
571
- tmpCachedResult?: Record<string, any>[];
572
- lastQueryId?: number;
573
- lastQuery?: string;
574
- extraPageLoadingBlocker?: string | false;
575
- unsubscribeListOnWheel?: (() => void) | null;
576
- unsubscribeListOnScroll?: (() => void) | null;
577
-
578
- constructor(props: LookupComponentProps) {
579
- super(props);
580
- let { data, store } = this.props.instance;
581
- this.dom = {};
582
- this.state = {
583
- options: [],
584
- formatted: data.formatted,
585
- value: data.formatted,
586
- dropdownOpen: false,
587
- focus: false,
588
- };
589
-
590
- this.itemStore = new ReadOnlyDataView({
591
- store: store,
592
- });
593
- }
594
-
595
- getOptionKey(data: Record<string, any>): unknown[] {
596
- return this.props.bindings.filter((a) => a.key).map((b) => Binding.get(b.remote).value(data));
597
- }
598
-
599
- getLocalKey(data: Record<string, any>): unknown[] {
600
- return this.props.bindings.filter((a) => a.key).map((b) => Binding.get(b.local).value(data));
601
- }
602
-
603
- findOption(options: Record<string, any>[], key: unknown[]): number {
604
- if (!key) return -1;
605
- for (let i = 0; i < options.length; i++) {
606
- let optionKey = this.getOptionKey({ $option: options[i] });
607
- if (areKeysEqual(key, optionKey)) return i;
608
- }
609
- return -1;
610
- }
611
-
612
- getDropdown(): Widget {
613
- if (this.dropdown) return this.dropdown;
614
-
615
- let { widget }: { widget: LookupField } = this.props.instance as unknown as { widget: LookupField };
616
- let { lastDropdown } = this.props.instance as DropdownInstance;
617
-
618
- this.list = Widget.create({
619
- type: List,
620
- sortField: widget.sort && widget.optionTextField,
621
- sortDirection: "ASC",
622
- mod: "dropdown",
623
- scrollSelectionIntoView: true,
624
- cached: widget.infinite,
625
- ...widget.listOptions,
626
- records: bind("$options"),
627
- recordName: "$option",
628
- onItemClick: (e: React.MouseEvent, inst: Instance) => this.onItemClick(e, inst),
629
- pipeKeyDown: (kd: (e: React.KeyboardEvent) => void) => {
630
- this.listKeyDown = kd;
631
- },
632
- selectOnTab: true,
633
- focusable: false,
634
- selection: {
635
- type: SelectionDelegate,
636
- delegate: (data: any) =>
637
- this.props.instance.data.selectedKeys.find((x: any) =>
638
- areKeysEqual(x, this.getOptionKey({ $option: data })),
639
- ) != null,
640
- },
641
- children: this.props.itemConfig,
642
- });
643
-
644
- let dropdown = {
645
- constrain: true,
646
- scrollTracking: true,
647
- inline: !isTouchDevice() || !!lastDropdown,
648
- placementOrder: "down-right down-left up-right up-left",
649
- ...widget.dropdownOptions,
650
- type: Dropdown,
651
- relatedElement: this.dom.input,
652
- renderChildren: () => this.renderDropdownContents(),
653
- onFocusOut: (e: React.MouseEvent) => this.closeDropdown(e),
654
- memoize: false,
655
- touchFriendly: isTouchDevice(),
656
- onMeasureNaturalContentSize: () => {
657
- if (this.dom.dropdown && this.dom.list) {
658
- return {
659
- height:
660
- this.dom.dropdown.offsetHeight -
661
- this.dom.list.offsetHeight +
662
- ((this.dom.list.firstElementChild as HTMLElement)?.offsetHeight || 0),
663
- };
664
- }
665
- },
666
- onDismissAfterScroll: () => {
667
- this.closeDropdown(null, true);
668
- return false;
669
- },
670
- };
671
-
672
- return (this.dropdown = Widget.create(dropdown));
673
- }
674
-
675
- renderDropdownContents(): React.ReactNode {
676
- let content;
677
- let { instance } = this.props;
678
- let { data, widget }: { data: Record<string, any>; widget: LookupField } = instance as unknown as {
679
- data: Record<string, any>;
680
- widget: LookupField;
681
- };
682
- let { CSS, baseClass } = widget;
683
-
684
- let searchVisible =
685
- !widget.hideSearchField &&
686
- (!isArray(data.visibleOptions) ||
687
- (widget.minOptionsForSearchField && data.visibleOptions.length >= widget.minOptionsForSearchField));
688
-
689
- if (this.state.status == "loading") {
690
- content = (
691
- <div key="msg" className={CSS.element(baseClass, "message", "loading")}>
692
- {widget.loadingText}
693
- </div>
694
- );
695
- } else if (this.state.status == "error") {
696
- content = (
697
- <div key="msg" className={CSS.element(baseClass, "message", "error")}>
698
- {widget.queryErrorText}
699
- </div>
700
- );
701
- } else if (this.state.status == "info") {
702
- content = (
703
- <div key="msg" className={CSS.element(baseClass, "message", "info")}>
704
- {this.state.message}
705
- </div>
706
- );
707
- } else if (this.state.options.length == 0) {
708
- content = (
709
- <div key="msg" className={CSS.element(baseClass, "message", "no-results")}>
710
- {widget.noResultsText}
711
- </div>
712
- );
713
- } else {
714
- content = (
715
- <div
716
- key="msg"
717
- ref={(el) => {
718
- this.dom.list = el;
719
- this.subscribeListOnWheel(el);
720
- this.subscribeListOnScroll(el);
721
- }}
722
- className={CSS.element(baseClass, "scroll-container")}
723
- >
724
- <Cx widget={this.list} store={this.itemStore} options={{ name: "lookupfield-list" }} />
725
- </div>
726
- );
727
- }
728
-
729
- return (
730
- <div
731
- key="dropdown"
732
- ref={(el) => {
733
- this.dom.dropdown = el as HTMLDivElement;
734
- }}
735
- className={CSS.element(baseClass, "dropdown")}
736
- tabIndex={0}
737
- onFocus={(e) => this.onDropdownFocus(e)}
738
- onKeyDown={(e) => this.onDropdownKeyPress(e)}
739
- >
740
- {searchVisible && (
741
- <input
742
- key="query"
743
- ref={(el) => {
744
- this.dom.query = el as HTMLInputElement;
745
- }}
746
- type="text"
747
- className={CSS.element(baseClass, "query")}
748
- onClick={(e) => {
749
- e.preventDefault();
750
- e.stopPropagation();
751
- }}
752
- onChange={(e) => this.query(e.target.value)}
753
- onBlur={(e) => this.onQueryBlur(e)}
754
- />
755
- )}
756
- {content}
757
- </div>
758
- );
759
- }
760
-
761
- onListWheel(e: WheelEvent): void {
762
- let { list } = this.dom;
763
- if (
764
- list &&
765
- ((list.scrollTop + list.offsetHeight == list.scrollHeight && e.deltaY > 0) ||
766
- (list.scrollTop == 0 && e.deltaY < 0))
767
- ) {
768
- e.preventDefault();
769
- e.stopPropagation();
770
- }
771
- }
772
-
773
- onListScroll(): void {
774
- if (!this.dom.list) return;
775
- var el = this.dom.list;
776
- if (el.scrollTop > el.scrollHeight - 2 * el.offsetHeight) {
777
- this.loadAdditionalOptionPages();
778
- }
779
- }
780
-
781
- onDropdownFocus(e: React.FocusEvent): void {
782
- if (this.dom.query && !isFocused(this.dom.query) && !isTouchDevice()) FocusManager.focus(this.dom.query);
783
- }
784
-
785
- getPlaceholder(text?: string): React.ReactNode {
786
- let { CSS, baseClass } = this.props.instance.widget;
787
-
788
- if (text) return <span className={CSS.element(baseClass, "placeholder")}>{text}</span>;
789
-
790
- return <span className={CSS.element(baseClass, "placeholder")}>&nbsp;</span>;
791
- }
792
-
793
- render(): React.ReactNode {
794
- let { instance, label, help, icon: iconVDOM } = this.props;
795
- let { data, widget, state } = instance;
796
- let { CSS, baseClass, suppressErrorsUntilVisited } = widget as LookupField;
797
-
798
- let icon = iconVDOM && (
799
- <div
800
- key="icon"
801
- className={CSS.element(baseClass, "left-icon")}
802
- onMouseDown={preventDefault}
803
- onClick={(e) => {
804
- this.openDropdown(e);
805
- e.stopPropagation();
806
- e.preventDefault();
807
- }}
808
- >
809
- {iconVDOM}
810
- </div>
811
- );
812
-
813
- let dropdown;
814
- if (this.state.dropdownOpen) {
815
- this.itemStore.setData({
816
- $options: this.state.options,
817
- $query: this.lastQuery,
818
- });
819
- dropdown = (
820
- <Cx widget={this.getDropdown()} store={this.itemStore} options={{ name: "lookupfield-dropdown" }} />
821
- );
822
- }
823
-
824
- let insideButton = null;
825
- let multipleEntries = this.props.multiple && isArray(data.records) && data.records.length > 1;
826
-
827
- if (!data.readOnly) {
828
- if (
829
- widget.showClear &&
830
- !data.disabled &&
831
- !data.empty &&
832
- (widget.alwaysShowClear || (!data.required && !this.props.multiple) || multipleEntries)
833
- ) {
834
- insideButton = (
835
- <div
836
- key="ib"
837
- onMouseDown={preventDefault}
838
- onClick={(e) => (!this.props.multiple ? this.onClearClick(e) : this.onClearMultipleClick(e))}
839
- className={CSS.element(baseClass, "clear")}
840
- >
841
- <ClearIcon className={CSS.element(baseClass, "icon")} />
842
- </div>
843
- );
844
- } else {
845
- insideButton = (
846
- <div
847
- key="ib"
848
- className={CSS.element(baseClass, "tool")}
849
- onMouseDown={preventDefault}
850
- onClick={(e) => {
851
- this.toggleDropdown(e, true);
852
- e.stopPropagation();
853
- e.preventDefault();
854
- }}
855
- >
856
- <DropdownIcon className={CSS.element(baseClass, "icon")} />
857
- </div>
858
- );
859
- }
860
- }
861
-
862
- let text;
863
-
864
- if (this.props.multiple) {
865
- let readOnly = data.disabled || data.readOnly;
866
- if (isNonEmptyArray(data.records)) {
867
- let valueTextFormatter =
868
- widget.onGetRecordDisplayText ??
869
- ((record: Record<string, any>) => record[widget.valueTextField] as string);
870
- text = data.records.map((v, i) => (
871
- <div
872
- key={i}
873
- className={CSS.element(baseClass, "tag", {
874
- readonly: readOnly,
875
- })}
876
- >
877
- <span className={CSS.element(baseClass, "tag-value")}>{valueTextFormatter(v, instance)}</span>
878
- {!readOnly && (
879
- <div
880
- className={CSS.element(baseClass, "tag-clear")}
881
- onMouseDown={(e) => {
882
- e.preventDefault();
883
- e.stopPropagation();
884
- }}
885
- onClick={(e) => this.onClearClick(e, v)}
886
- >
887
- <ClearIcon className={CSS.element(baseClass, "icon")} />
888
- </div>
889
- )}
890
- </div>
891
- ));
892
- } else {
893
- text = this.getPlaceholder(data.placeholder);
894
- }
895
- } else {
896
- text = !data.empty ? data.text || this.getPlaceholder() : this.getPlaceholder(data.placeholder);
897
- }
898
-
899
- let states = {
900
- visited: state.visited,
901
- focus: this.state.focus || this.state.dropdownOpen,
902
- icon: !!iconVDOM,
903
- empty: !data.placeholder && data.empty,
904
- error: data.error && (state.visited || !suppressErrorsUntilVisited || !data.empty),
905
- };
906
-
907
- return (
908
- <div
909
- className={CSS.expand(data.classNames, CSS.state(states))}
910
- style={data.style}
911
- onMouseDown={stopPropagation}
912
- onTouchStart={stopPropagation}
913
- onKeyDown={(e) => this.onKeyDown(e)}
914
- >
915
- <div
916
- id={data.id}
917
- className={CSS.expand(CSS.element(widget.baseClass, "input"), data.inputClass)}
918
- style={data.inputStyle}
919
- tabIndex={data.disabled ? null : data.tabIndex || 0}
920
- ref={(el) => {
921
- this.dom.input = el;
922
- }}
923
- aria-labelledby={data.id + "-label"}
924
- onMouseMove={(e) => tooltipMouseMove(e, ...getFieldTooltip(this.props.instance))}
925
- onMouseLeave={(e) => tooltipMouseLeave(e, ...getFieldTooltip(this.props.instance))}
926
- onClick={(e) => this.onClick(e)}
927
- onKeyDown={(e) => this.onInputKeyDown(e)}
928
- onMouseDown={(e) => this.onMouseDown(e)}
929
- onBlur={(e) => this.onBlur(e)}
930
- onFocus={(e) => this.onFocus(e)}
931
- >
932
- {text}
933
- </div>
934
- {insideButton}
935
- {icon}
936
- {dropdown}
937
- {label}
938
- {help}
939
- </div>
940
- );
941
- }
942
-
943
- onMouseDown(e: React.MouseEvent): void {
944
- //skip touch start to allow touch scrolling
945
- if (isTouchEvent()) return;
946
- e.preventDefault();
947
- e.stopPropagation();
948
- this.toggleDropdown(e, true);
949
- }
950
-
951
- onClick(e: React.MouseEvent): void {
952
- //mouse down will handle it for non-touch events
953
- if (!isTouchEvent()) return;
954
- e.preventDefault();
955
- e.stopPropagation();
956
- this.toggleDropdown(e, true);
957
- }
958
-
959
- onItemClick(
960
- e: React.KeyboardEvent | React.MouseEvent,
961
- { store }: { store: { getData: () => Record<string, any> } },
962
- ): void {
963
- this.select(e, [store.getData()]);
964
- if (!this.props.instance.widget.submitOnEnterKey || e.type != "keydown") e.stopPropagation();
965
- if ((e as React.KeyboardEvent).keyCode != KeyCode.tab) e.preventDefault();
966
- }
967
-
968
- onClearClick(e: React.MouseEvent | React.KeyboardEvent, value?: Record<string, any>): void {
969
- let { instance } = this.props;
970
- let { data, store, widget } = instance;
971
- let { keyBindings } = widget;
972
- e.stopPropagation();
973
- e.preventDefault();
974
- if (widget.multiple) {
975
- if (isArray(data.records)) {
976
- let itemKey = this.getLocalKey({ $value: value });
977
- let newRecords = data.records.filter((v) => !areKeysEqual(this.getLocalKey({ $value: v }), itemKey));
978
-
979
- instance.set("records", newRecords);
980
-
981
- let newValues = newRecords
982
- .map((rec) => this.getLocalKey({ $value: rec }))
983
- .map((k) => (keyBindings!.length == 1 ? k[0] : k));
984
-
985
- instance.set("values", newValues);
986
- }
987
- } else {
988
- this.props.bindings.forEach((b) => {
989
- store.set(b.local, widget.emptyValue);
990
- });
991
- }
992
-
993
- if (!isTouchEvent()) this.dom.input!.focus();
994
- }
995
-
996
- onClearMultipleClick(e: React.MouseEvent): void {
997
- let { instance } = this.props;
998
- instance.set("records", []);
999
- instance.set("values", []);
1000
- }
1001
-
1002
- select(e: React.KeyboardEvent | React.MouseEvent, itemsData: Record<string, any>[], reset?: boolean): void {
1003
- let { instance } = this.props;
1004
- let { store, data, widget } = instance;
1005
- let { bindings, keyBindings } = widget;
1006
-
1007
- if (widget.multiple) {
1008
- let { selectedKeys, records } = data;
1009
-
1010
- let newRecords = reset ? [] : [...(records || [])];
1011
- let singleSelect = itemsData.length == 1;
1012
- let optionKey: unknown[] | null = null;
1013
- if (singleSelect) optionKey = this.getOptionKey(itemsData[0]);
1014
-
1015
- // deselect
1016
- if (singleSelect && selectedKeys.find((k: any) => areKeysEqual(optionKey!, k))) {
1017
- newRecords = records.filter((v: any) => !areKeysEqual(optionKey!, this.getLocalKey({ $value: v })));
1018
- } else {
1019
- itemsData.forEach((itemData) => {
1020
- let valueData: Record<string, any> = {
1021
- $value: {},
1022
- };
1023
- bindings!.forEach((b) => {
1024
- valueData = Binding.get(b.local).set(valueData, Binding.get(b.remote).value(itemData));
1025
- });
1026
- newRecords.push(valueData.$value as Record<string, any>);
1027
- });
1028
- }
1029
-
1030
- instance.set("records", newRecords);
1031
-
1032
- let newValues = newRecords
1033
- .map((rec) => this.getLocalKey({ $value: rec }))
1034
- .map((k) => (keyBindings!.length == 1 ? k[0] : k));
1035
-
1036
- instance.set("values", newValues);
1037
- } else {
1038
- bindings!.forEach((b) => {
1039
- let v = Binding.get(b.remote).value(itemsData[0]);
1040
- if (b.set) b.set(v, instance);
1041
- else store.set(b.local, v);
1042
- });
1043
- }
1044
-
1045
- if (widget.closeOnSelect) {
1046
- //Pressing Tab should work it's own thing. Focus will move elsewhere and the dropdown will close.
1047
- if ((e as React.KeyboardEvent).keyCode != KeyCode.tab) {
1048
- if (!isTouchEvent()) this.dom.input!.focus();
1049
- this.closeDropdown(e);
1050
- }
1051
- }
1052
-
1053
- if ((e as React.KeyboardEvent).keyCode == KeyCode.enter && widget.submitOnDropdownEnterKey) {
1054
- this.submitOnEnter(e as React.KeyboardEvent);
1055
- }
1056
- }
1057
-
1058
- onDropdownKeyPress(e: React.KeyboardEvent): void {
1059
- switch (e.keyCode) {
1060
- case KeyCode.esc:
1061
- this.closeDropdown(e);
1062
- this.dom.input!.focus();
1063
- break;
1064
-
1065
- case KeyCode.tab:
1066
- // if tab needs to do a list selection, we have to first call List's handleKeyDown
1067
- if (this.listKeyDown) this.listKeyDown(e);
1068
- // if next focusable element is disabled, recalculate and update the dom before switching focus
1069
- this.props.forceUpdate();
1070
- break;
1071
-
1072
- case KeyCode.a:
1073
- if (!e.ctrlKey) return;
1074
-
1075
- let { quickSelectAll, multiple } = this.props.instance.widget;
1076
- if (!quickSelectAll || !multiple) return;
1077
-
1078
- let optionsToSelect = this.state.options.map((o) => ({
1079
- $option: o,
1080
- }));
1081
- this.select(e, optionsToSelect, true);
1082
- e.stopPropagation();
1083
- e.preventDefault();
1084
- break;
1085
-
1086
- default:
1087
- if (this.listKeyDown) this.listKeyDown(e);
1088
- break;
1089
- }
1090
- }
1091
-
1092
- onKeyDown(e: React.KeyboardEvent): void {
1093
- switch (e.keyCode) {
1094
- case KeyCode.pageDown:
1095
- case KeyCode.pageUp:
1096
- if (this.state.dropdownOpen) e.preventDefault();
1097
- break;
1098
- }
1099
- }
1100
-
1101
- onInputKeyDown(e: React.KeyboardEvent): void {
1102
- let { instance } = this.props;
1103
- if (instance.widget.handleKeyDown(e, instance) === false) return;
1104
-
1105
- switch (e.keyCode) {
1106
- case KeyCode.delete:
1107
- this.onClearClick(e);
1108
- return;
1109
-
1110
- case KeyCode.shift:
1111
- case KeyCode.ctrl:
1112
- case KeyCode.tab:
1113
- case KeyCode.left:
1114
- case KeyCode.right:
1115
- case KeyCode.pageUp:
1116
- case KeyCode.pageDown:
1117
- case KeyCode.insert:
1118
- case KeyCode.esc:
1119
- break;
1120
-
1121
- case KeyCode.down:
1122
- this.openDropdown(e);
1123
- e.stopPropagation();
1124
- break;
1125
-
1126
- case KeyCode.enter:
1127
- if (this.props.instance.widget.submitOnEnterKey) {
1128
- this.submitOnEnter(e);
1129
- } else {
1130
- this.openDropdown(e);
1131
- }
1132
- break;
1133
-
1134
- default:
1135
- this.openDropdown(e);
1136
- break;
1137
- }
1138
- }
1139
-
1140
- onQueryBlur(e: React.FocusEvent): void {
1141
- FocusManager.nudge();
1142
- }
1143
-
1144
- onFocus(e: React.FocusEvent): void {
1145
- let { instance } = this.props;
1146
- let { widget } = instance;
1147
- if (widget.trackFocus) {
1148
- this.setState({
1149
- focus: true,
1150
- });
1151
- }
1152
-
1153
- if (this.props.instance.data.autoOpen) this.openDropdown(null);
1154
- }
1155
-
1156
- onBlur(e: React.FocusEvent): void {
1157
- if (!this.state.dropdownOpen) this.props.instance.setState({ visited: true });
1158
-
1159
- if (this.state.focus)
1160
- this.setState({
1161
- focus: false,
1162
- });
1163
- }
1164
-
1165
- toggleDropdown(e: React.KeyboardEvent | React.MouseEvent, keepFocus?: boolean): void {
1166
- if (this.state.dropdownOpen) this.closeDropdown(e, keepFocus);
1167
- else this.openDropdown(e);
1168
- }
1169
-
1170
- closeDropdown(e?: React.KeyboardEvent | React.MouseEvent | null, keepFocus?: boolean): void {
1171
- if (this.state.dropdownOpen) {
1172
- this.setState(
1173
- {
1174
- dropdownOpen: false,
1175
- },
1176
- () => keepFocus && this.dom.input?.focus(),
1177
- );
1178
-
1179
- this.props.instance.setState({
1180
- visited: true,
1181
- });
1182
- }
1183
-
1184
- //delete results valid only while the dropdown is open
1185
- delete this.tmpCachedResult;
1186
- }
1187
-
1188
- openDropdown(e: React.KeyboardEvent | React.MouseEvent | null): void {
1189
- let { instance } = this.props;
1190
- let { data } = instance;
1191
- if (!this.state.dropdownOpen && !data.disabled && !data.readOnly) {
1192
- this.query("");
1193
- this.setState(
1194
- {
1195
- dropdownOpen: true,
1196
- },
1197
- () => {
1198
- if (this.dom.dropdown) this.dom.dropdown.focus();
1199
- },
1200
- );
1201
- }
1202
- }
1203
-
1204
- query(q: string): void {
1205
- /*
1206
- In fetchAll mode onQuery should fetch all data and after
1207
- that everything is done filtering is done client-side.
1208
- If cacheAll is set results are cached for the lifetime of the
1209
- widget, otherwise cache is invalidated when dropdown closes.
1210
- */
1211
-
1212
- let { instance } = this.props;
1213
- let { widget, data } = instance;
1214
-
1215
- this.lastQuery = q;
1216
-
1217
- //do not make duplicate queries if fetchAll is enabled
1218
- if (widget.fetchAll && this.state.status == "loading") return;
1219
-
1220
- if (this.queryTimeoutId) clearTimeout(this.queryTimeoutId);
1221
-
1222
- if (q.length < widget.minQueryLength) {
1223
- this.setState({
1224
- status: "info",
1225
- message: StringTemplate.format(widget.minQueryLengthMessageText, widget.minQueryLength),
1226
- });
1227
- return;
1228
- }
1229
-
1230
- if (isArray(data.visibleOptions)) {
1231
- let results = widget.filterOptions(this.props.instance, data.visibleOptions as DataRecord[], q);
1232
- this.setState({
1233
- options: results,
1234
- status: "loaded",
1235
- });
1236
- }
1237
-
1238
- if (widget.onQuery) {
1239
- let { queryDelay, fetchAll, cacheAll, pageSize } = widget;
1240
-
1241
- if (fetchAll) queryDelay = 0;
1242
-
1243
- if (!this.cachedResult) {
1244
- this.setState({
1245
- status: "loading",
1246
- });
1247
- }
1248
-
1249
- this.queryTimeoutId = setTimeout(() => {
1250
- delete this.queryTimeoutId;
1251
-
1252
- let result = this.tmpCachedResult || this.cachedResult;
1253
- let query = fetchAll ? "" : q;
1254
- let params = !widget.infinite
1255
- ? query
1256
- : {
1257
- query,
1258
- page: 1,
1259
- pageSize,
1260
- };
1261
-
1262
- if (!result) result = instance.invoke("onQuery", params, instance);
1263
-
1264
- let queryId = (this.lastQueryId = Date.now());
1265
-
1266
- Promise.resolve(result)
1267
- .then((results) => {
1268
- //discard results which do not belong to the last query
1269
- if (queryId !== this.lastQueryId) return;
1270
-
1271
- if (!isArray(results)) results = [];
1272
-
1273
- if (fetchAll) {
1274
- if (cacheAll) this.cachedResult = results;
1275
- else this.tmpCachedResult = results;
1276
-
1277
- results = widget.filterOptions(this.props.instance, results, this.lastQuery);
1278
- }
1279
-
1280
- this.setState(
1281
- {
1282
- page: 1,
1283
- query,
1284
- options: results,
1285
- status: "loaded",
1286
- },
1287
- () => {
1288
- if (widget.infinite) this.onListScroll();
1289
- },
1290
- );
1291
- })
1292
- .catch((err) => {
1293
- this.setState({ status: "error" });
1294
- debug("Lookup query error:", err);
1295
- });
1296
- }, queryDelay);
1297
- }
1298
- }
1299
-
1300
- loadAdditionalOptionPages(): void {
1301
- let { instance } = this.props;
1302
- let { widget } = instance;
1303
- if (!widget.infinite) return;
1304
-
1305
- let { query, page, status, options } = this.state;
1306
- if (!page) page = 1;
1307
-
1308
- let blockerKey = query;
1309
-
1310
- if (status != "loaded") return;
1311
-
1312
- if (options.length < page * widget.pageSize) return; //some pages were not full which means we reached the end
1313
-
1314
- if (this.extraPageLoadingBlocker === blockerKey) return;
1315
-
1316
- this.extraPageLoadingBlocker = blockerKey;
1317
-
1318
- let params = {
1319
- page: page + 1,
1320
- query,
1321
- pageSize: widget.pageSize,
1322
- };
1323
-
1324
- var result = instance.invoke("onQuery", params, instance);
1325
-
1326
- Promise.resolve(result)
1327
- .then((results) => {
1328
- //discard results which do not belong to the last query
1329
- if (this.extraPageLoadingBlocker !== blockerKey) return;
1330
-
1331
- this.extraPageLoadingBlocker = false;
1332
-
1333
- if (!isArray(results)) return;
1334
-
1335
- this.setState(
1336
- {
1337
- page: params.page,
1338
- query,
1339
- options: [...options, ...results],
1340
- },
1341
- () => {
1342
- this.onListScroll();
1343
- },
1344
- );
1345
- })
1346
- .catch((err) => {
1347
- if (this.extraPageLoadingBlocker !== blockerKey) return;
1348
- this.extraPageLoadingBlocker = false;
1349
- this.setState({ status: "error" });
1350
- debug("Lookup query error:", err);
1351
- console.error(err);
1352
- });
1353
- }
1354
-
1355
- UNSAFE_componentWillReceiveProps(props: LookupComponentProps): void {
1356
- if (this.dom.input) {
1357
- tooltipParentWillReceiveProps(this.dom.input, ...getFieldTooltip(props.instance));
1358
- }
1359
- }
1360
-
1361
- componentDidMount(): void {
1362
- if (this.dom.input) {
1363
- tooltipParentDidMount(this.dom.input, ...getFieldTooltip(this.props.instance));
1364
- autoFocus(this.dom.input, this);
1365
- }
1366
- }
1367
-
1368
- componentDidUpdate(): void {
1369
- if (this.dom.input) {
1370
- autoFocus(this.dom.input, this);
1371
- }
1372
- }
1373
-
1374
- componentWillUnmount(): void {
1375
- if (this.queryTimeoutId) clearTimeout(this.queryTimeoutId);
1376
- tooltipParentWillUnmount(this.props.instance);
1377
- this.subscribeListOnWheel(null);
1378
- }
1379
-
1380
- subscribeListOnWheel(list: HTMLDivElement | null): void {
1381
- if (this.unsubscribeListOnWheel) {
1382
- this.unsubscribeListOnWheel();
1383
- this.unsubscribeListOnWheel = null;
1384
- }
1385
- if (list) {
1386
- this.unsubscribeListOnWheel = addEventListenerWithOptions(
1387
- list,
1388
- "wheel",
1389
- (e) => this.onListWheel(e as WheelEvent),
1390
- {
1391
- passive: false,
1392
- },
1393
- );
1394
- }
1395
- }
1396
-
1397
- subscribeListOnScroll(list: HTMLDivElement | null): void {
1398
- if (this.unsubscribeListOnScroll) {
1399
- this.unsubscribeListOnScroll();
1400
- this.unsubscribeListOnScroll = null;
1401
- }
1402
- if (list) {
1403
- this.unsubscribeListOnScroll = addEventListenerWithOptions(list, "scroll", () => this.onListScroll(), {
1404
- passive: false,
1405
- });
1406
- }
1407
- }
1408
-
1409
- submitOnEnter(e: React.KeyboardEvent): void {
1410
- let instance = this.props.instance.parent;
1411
- while (instance) {
1412
- let htmlInstance = instance as HtmlElementInstance;
1413
- if (htmlInstance.events && htmlInstance.events.onSubmit) {
1414
- htmlInstance.events.onSubmit(e, instance);
1415
- break;
1416
- } else {
1417
- instance = instance.parent;
1418
- }
1419
- }
1420
- }
1421
- }
1
+ /**@jsxImportSource react */
2
+ import { Widget, VDOM, getContent } from "../../ui/Widget";
3
+ import { Cx } from "../../ui/Cx";
4
+ import { Field, getFieldTooltip, FieldInstance } from "./Field";
5
+ import { ReadOnlyDataView } from "../../data/ReadOnlyDataView";
6
+ import { HtmlElement, HtmlElementInstance } from "../HtmlElement";
7
+ import { Binding, BindingInput } from "../../data/Binding";
8
+ import { debug } from "../../util/Debug";
9
+ import { Dropdown, DropdownConfig } from "../overlay/Dropdown";
10
+ import { FocusManager } from "../../ui/FocusManager";
11
+ import { isFocused } from "../../util/DOM";
12
+ import { isTouchDevice } from "../../util/isTouchDevice";
13
+ import { isTouchEvent } from "../../util/isTouchEvent";
14
+ import {
15
+ tooltipParentWillReceiveProps,
16
+ tooltipParentWillUnmount,
17
+ tooltipMouseMove,
18
+ tooltipMouseLeave,
19
+ tooltipParentDidMount,
20
+ } from "../overlay/tooltip-ops";
21
+ import { stopPropagation, preventDefault } from "../../util/eventCallbacks";
22
+ import ClearIcon from "../icons/clear";
23
+ import DropdownIcon from "../icons/drop-down";
24
+ import { getSearchQueryPredicate } from "../../util/getSearchQueryPredicate";
25
+ import { KeyCode } from "../../util/KeyCode";
26
+ import { Localization } from "../../ui/Localization";
27
+ import { StringTemplate } from "../../data/StringTemplate";
28
+ import { Icon } from "../Icon";
29
+ import { isString } from "../../util/isString";
30
+ import { isDefined } from "../../util/isDefined";
31
+ import { isArray } from "../../util/isArray";
32
+ import { isNonEmptyArray } from "../../util/isNonEmptyArray";
33
+ import { addEventListenerWithOptions } from "../../util/addEventListenerWithOptions";
34
+ import { List } from "../List";
35
+ import { Selection } from "../../ui/selection/Selection";
36
+ import { HighlightedSearchText } from "../HighlightedSearchText";
37
+ import { autoFocus } from "../autoFocus";
38
+ import { bind } from "../../ui";
39
+ import { AccessorChain, isAccessorChain } from "../../data/createAccessorModelProxy";
40
+ import type { CxChild, RenderingContext } from "../../ui/RenderingContext";
41
+ import type { DropdownInstance, Instance } from "../../ui/Instance";
42
+ import { FieldConfig } from "./Field";
43
+ import { Prop, BooleanProp, StringProp, StructuredProp, DataRecord } from "../../ui/Prop";
44
+
45
+ export interface LookupBinding {
46
+ local: string;
47
+ remote: string;
48
+ key?: boolean;
49
+ }
50
+
51
+ export interface LookupFieldConfig<TOption = unknown, TRecord = unknown> extends FieldConfig {
52
+ /** Defaults to `false`. Set to `true` to enable multiple selection. */
53
+ multiple?: BooleanProp;
54
+
55
+ /** Selected value. Used only if `multiple` is set to `false`. */
56
+ value?: Prop<number | string>;
57
+
58
+ /** A list of selected ids. Used only if `multiple` is set to `true`. */
59
+ values?: Prop<(number | string)[]>;
60
+
61
+ /** A list of selected records. Used only if `multiple` is set to `true`. */
62
+ records?: Prop<TRecord[]>;
63
+
64
+ /** Text associated with the selection. Used only if `multiple` is set to `false`. */
65
+ text?: StringProp;
66
+
67
+ /** The opposite of `disabled`. */
68
+ enabled?: BooleanProp;
69
+
70
+ /** Defaults to `false`. Used to make the field read-only. */
71
+ readOnly?: BooleanProp;
72
+
73
+ /** Default text displayed when the field is empty. */
74
+ placeholder?: StringProp;
75
+
76
+ /** A list of available options. */
77
+ options?: Prop<TOption[]>;
78
+
79
+ /** Set to `true` to hide the clear button. Default value is `false`. */
80
+ hideClear?: boolean;
81
+
82
+ /** Set to `false` to hide the clear button. Default value is `true`. */
83
+ showClear?: boolean;
84
+
85
+ /** Set to `true` to display the clear button even if `required` is set. Default is `false`. */
86
+ alwaysShowClear?: boolean;
87
+
88
+ /** Base CSS class to be applied to the field. Defaults to `lookupfield`. */
89
+ baseClass?: string;
90
+
91
+ /** Name or configuration of the icon to be put on the left side of the input. */
92
+ icon?: StringProp | Record<string, any>;
93
+
94
+ /** Additional config to be applied to all items. */
95
+ itemConfig?: any;
96
+
97
+ /** An array of objects describing the mapping of option data to store data. */
98
+ bindings?: LookupBinding[];
99
+
100
+ /** A delay in milliseconds between typing stop and query. Default is `150`. */
101
+ queryDelay?: number;
102
+
103
+ /** Minimal number of characters required before query is made. */
104
+ minQueryLength?: number;
105
+
106
+ /** Set to `true` to hide the search field. */
107
+ hideSearchField?: boolean;
108
+
109
+ /** Number of options required to show search field. Defaults to `7`. */
110
+ minOptionsForSearchField?: number;
111
+
112
+ /** Text to display while data is being loaded. */
113
+ loadingText?: string;
114
+
115
+ /** Error message displayed if server query throws an exception. */
116
+ queryErrorText?: string;
117
+
118
+ /** Message to be displayed if no entries match the user query. */
119
+ noResultsText?: string;
120
+
121
+ /** Name of the field which holds the id of the option. Default is `id`. */
122
+ optionIdField?: string;
123
+
124
+ /** Name of the field which holds the display text of the option. Default is `text`. */
125
+ optionTextField?: string;
126
+
127
+ /** Name of the field to store id of selected value in multiple mode. Default is `id`. */
128
+ valueIdField?: string;
129
+
130
+ /** Name of the field to store display text of selected value. Default is `text`. */
131
+ valueTextField?: string;
132
+
133
+ /** `onQuery` will be called once to fetch all options; filtering occurs client-side. */
134
+ fetchAll?: boolean;
135
+
136
+ /** When set with `fetchAll`, fetched options are cached for widget lifetime. */
137
+ cacheAll?: boolean;
138
+
139
+ /** Close the dropdown after selection. Default is `true`. */
140
+ closeOnSelect?: boolean;
141
+
142
+ /** Message displayed if the entered search query is too short. */
143
+ minQueryLengthMessageText?: string;
144
+
145
+ /** Query function called to fetch options. */
146
+ onQuery?:
147
+ | string
148
+ | ((
149
+ query: string | { query: string; page: number; pageSize: number },
150
+ instance: Instance,
151
+ ) => TOption[] | Promise<TOption[]>);
152
+
153
+ /** Set to `true` to sort dropdown options. */
154
+ sort?: boolean;
155
+
156
+ /** Additional list options, such as grouping configuration, custom sorting, etc. */
157
+ listOptions?: Record<string, any>;
158
+
159
+ /** Show dropdown immediately after component mount; useful for cell editing. */
160
+ autoOpen?: BooleanProp;
161
+
162
+ /** Allow enter key events to propagate; useful for forms or grid cell editors. */
163
+ submitOnEnterKey?: BooleanProp;
164
+
165
+ /** Allow dropdown enter key events to propagate for form submission. */
166
+ submitOnDropdownEnterKey?: BooleanProp;
167
+
168
+ /** Number of additional items loaded in `infinite` mode. Default is `100`. */
169
+ pageSize?: number;
170
+
171
+ /** Set to `true` to enable loading additional options when scroll reaches end. */
172
+ infinite?: boolean;
173
+
174
+ /** Allow quick selection of all displayed items on `Ctrl + A` key combination. */
175
+ quickSelectAll?: boolean;
176
+
177
+ /** Parameters that affect filtering. */
178
+ filterParams?: StructuredProp;
179
+
180
+ /** Used in multiple selection lookups to construct display text from multiple fields. */
181
+ onGetRecordDisplayText?: ((record: TRecord, instance: Instance) => string) | null;
182
+
183
+ /** Callback to create a filter function for given filter params. */
184
+ onCreateVisibleOptionsFilter?:
185
+ | string
186
+ | ((filterParams: unknown, instance: Instance) => (option: TOption) => boolean);
187
+
188
+ /** Additional configuration to be passed to the dropdown, such as `style`, `positioning`, etc. */
189
+ dropdownOptions?: Partial<DropdownConfig>;
190
+
191
+ /** Custom validation function. */
192
+ onValidate?:
193
+ | string
194
+ | ((value: number | string, instance: Instance, validationParams: Record<string, unknown>) => unknown);
195
+ }
196
+
197
+ export class LookupField<TOption = unknown, TRecord = unknown> extends Field<
198
+ LookupFieldConfig<TOption, TRecord>
199
+ > {
200
+ declare public baseClass: string;
201
+ declare public multiple: boolean;
202
+ declare public hideClear?: boolean;
203
+ declare public showClear: boolean;
204
+ declare public alwaysShowClear: boolean;
205
+ declare public hideSearchField: boolean;
206
+ declare public minOptionsForSearchField: number;
207
+ declare public loadingText: string;
208
+ declare public queryErrorText: string;
209
+ declare public noResultsText: string;
210
+ declare public optionIdField: string;
211
+ declare public optionTextField: string;
212
+ declare public valueIdField: string;
213
+ declare public valueTextField: string;
214
+ declare public fetchAll: boolean;
215
+ declare public cacheAll: boolean;
216
+ declare public closeOnSelect: boolean;
217
+ declare public minQueryLengthMessageText: string;
218
+ declare public sort?: boolean;
219
+ declare public listOptions?: Record<string, any> | null;
220
+ declare public autoOpen?: boolean;
221
+ declare public submitOnEnterKey?: boolean;
222
+ declare public submitOnDropdownEnterKey?: boolean;
223
+ declare public pageSize: number;
224
+ declare public infinite?: boolean;
225
+ declare public quickSelectAll?: boolean;
226
+ declare public queryDelay: number;
227
+ declare public minQueryLength: number;
228
+ declare public onGetRecordDisplayText?: ((record: Record<string, any>, instance: Instance) => string) | null;
229
+ declare public onQuery?:
230
+ | string
231
+ | ((
232
+ params: string | { query: string; page: number; pageSize: number },
233
+ instance: Instance,
234
+ ) => Promise<Record<string, any>[]> | Record<string, any>[]);
235
+ declare public onCreateVisibleOptionsFilter?:
236
+ | string
237
+ | ((filterParams: unknown, instance: Instance) => (option: Record<string, any>) => boolean);
238
+ declare public value?: BindingInput;
239
+ declare public text?: BindingInput<string>;
240
+ declare public records?: Record<string, any>[];
241
+ declare public values?: unknown[];
242
+ declare public options?: Record<string, any>[];
243
+
244
+ declare public enabled?: boolean;
245
+ declare public placeholder?: string;
246
+ declare public readOnly?: boolean;
247
+ declare public dropdownOptions?: Partial<DropdownConfig>;
248
+ declare public bindings?: BindingConfig[];
249
+ declare public keyBindings?: BindingConfig[];
250
+ declare public itemConfig?: CxChild;
251
+
252
+ declareData(...args: Record<string, any>[]): void {
253
+ let additionalAttributes = this.multiple
254
+ ? { values: undefined, records: undefined }
255
+ : { value: undefined, text: undefined };
256
+
257
+ super.declareData(
258
+ {
259
+ disabled: undefined,
260
+ enabled: undefined,
261
+ placeholder: undefined,
262
+ required: undefined,
263
+ options: undefined,
264
+ icon: undefined,
265
+ autoOpen: undefined,
266
+ readOnly: undefined,
267
+ filterParams: { structured: true },
268
+ },
269
+ additionalAttributes,
270
+ ...args,
271
+ );
272
+ }
273
+
274
+ init(): void {
275
+ if (isDefined(this.hideClear)) this.showClear = !this.hideClear;
276
+
277
+ if (this.alwaysShowClear) this.showClear = true;
278
+
279
+ if (!this.bindings) {
280
+ let b: BindingConfig[] = [];
281
+ if (this.value) {
282
+ if (isAccessorChain(this.value)) this.value = bind(this.value);
283
+ if ((this.value as any).bind)
284
+ b.push({
285
+ key: true,
286
+ local: (this.value as any).bind,
287
+ remote: `$option.${this.optionIdField}`,
288
+ set: (this.value as any).set,
289
+ });
290
+ }
291
+
292
+ if (this.text as string | AccessorChain<unknown>) {
293
+ if (isAccessorChain(this.text)) this.text = bind(this.text);
294
+ if ((this.text as any).bind)
295
+ b.push({
296
+ local: (this.text as any).bind,
297
+ remote: `$option.${this.optionTextField}`,
298
+ set: (this.text as any).set,
299
+ });
300
+ }
301
+
302
+ this.bindings = b;
303
+ }
304
+
305
+ if (this.bindings.length == 0 && this.multiple)
306
+ this.bindings = [
307
+ {
308
+ key: true,
309
+ local: `$value.${this.valueIdField}`,
310
+ remote: `$option.${this.optionIdField}`,
311
+ },
312
+ {
313
+ local: `$value.${this.valueTextField}`,
314
+ remote: `$option.${this.optionTextField}`,
315
+ },
316
+ ];
317
+
318
+ this.keyBindings = this.bindings.filter((b) => b.key);
319
+
320
+ if (!this.items && !this.children)
321
+ this.items = {
322
+ type: HighlightedSearchText,
323
+ text: { bind: `$option.${this.optionTextField}` },
324
+ query: { bind: "$query" },
325
+ } as any;
326
+
327
+ this.itemConfig = this.children || this.items;
328
+
329
+ this.items = [];
330
+ delete this.children;
331
+
332
+ super.init();
333
+ }
334
+
335
+ prepareData(context: RenderingContext, instance: FieldInstance<LookupField>): void {
336
+ let { data, store } = instance;
337
+
338
+ data.stateMods = {
339
+ multiple: this.multiple,
340
+ single: !this.multiple,
341
+ disabled: data.disabled,
342
+ readonly: data.readOnly,
343
+ };
344
+
345
+ data.visibleOptions = data.options;
346
+ if (this.onCreateVisibleOptionsFilter && isArray(data.options)) {
347
+ let filterPredicate = instance.invoke("onCreateVisibleOptionsFilter", data.filterParams, instance);
348
+ data.visibleOptions = data.options.filter(filterPredicate);
349
+ }
350
+
351
+ data.selectedKeys = [];
352
+
353
+ if (this.multiple) {
354
+ if (isArray(data.values) && isArray(data.options)) {
355
+ data.selectedKeys = data.values.map((v) => (this.keyBindings!.length == 1 ? [v] : v));
356
+ let map: Record<number, Record<string, any>> = {};
357
+ data.options.filter(($option) => {
358
+ let optionKey = getOptionKey(this.keyBindings!, { $option });
359
+ for (let i = 0; i < data.selectedKeys.length; i++)
360
+ if (areKeysEqual(optionKey, data.selectedKeys[i])) {
361
+ map[i] = convertOption(this.bindings!, { $option });
362
+ break;
363
+ }
364
+ });
365
+ data.records = [];
366
+ for (let i = 0; i < data.selectedKeys.length; i++) if (map[i]) data.records.push(map[i]);
367
+ } else if (isArray(data.records))
368
+ data.selectedKeys.push(
369
+ ...data.records.map(($value) => this.keyBindings!.map((b) => Binding.get(b.local).value({ $value }))),
370
+ );
371
+ } else {
372
+ let dataViewData = store.getData();
373
+ data.selectedKeys.push(this.keyBindings!.map((b) => Binding.get(b.local).value(dataViewData)));
374
+ if (!this.text && isArray(data.options)) {
375
+ let option = data.options.find(($option) =>
376
+ areKeysEqual(getOptionKey(this.keyBindings!, { $option }), data.selectedKeys[0]),
377
+ );
378
+ data.text = (option && (option as any)[this.optionTextField!]) || "";
379
+ }
380
+ }
381
+
382
+ (instance as DropdownInstance).lastDropdown = context.lastDropdown;
383
+
384
+ super.prepareData(context, instance);
385
+ }
386
+
387
+ renderInput(context: RenderingContext, instance: FieldInstance<LookupField>, key: string): React.ReactNode {
388
+ return (
389
+ <LookupComponent
390
+ key={key}
391
+ multiple={this.multiple!}
392
+ instance={instance}
393
+ itemConfig={this.itemConfig}
394
+ bindings={this.bindings!}
395
+ baseClass={this.baseClass!}
396
+ label={this.labelPlacement && getContent(this.renderLabel(context, instance, "label"))}
397
+ help={this.helpPlacement && getContent(this.renderHelp(context, instance, "help"))}
398
+ forceUpdate={context.forceUpdate}
399
+ icon={this.renderIcon(context, instance, "icon")}
400
+ />
401
+ );
402
+ }
403
+
404
+ filterOptions(instance: Instance, options: DataRecord[], query?: string): DataRecord[] {
405
+ if (!query) return options;
406
+ let textPredicate = getSearchQueryPredicate(query);
407
+ return options.filter(
408
+ (o) => isString(o[this.optionTextField!]) && textPredicate((o as any)[this.optionTextField!] as string),
409
+ );
410
+ }
411
+
412
+ isEmpty(data: Record<string, any>): boolean {
413
+ if (this.multiple) return !isNonEmptyArray(data.values) && !isNonEmptyArray(data.records);
414
+ return super.isEmpty(data);
415
+ }
416
+
417
+ getValidationValue(data: Record<string, any>): unknown {
418
+ if (this.multiple) return data.records ?? data.values;
419
+ return super.getValidationValue(data);
420
+ }
421
+
422
+ formatValue(context: RenderingContext, instance: Instance): string | React.ReactNode {
423
+ if (!this.multiple) return super.formatValue(context, instance);
424
+
425
+ let { records, values, options } = instance.data;
426
+ if (isArray(records)) {
427
+ let valueTextFormatter =
428
+ typeof this.onGetRecordDisplayText === "function"
429
+ ? this.onGetRecordDisplayText
430
+ : (record: Record<string, any>) =>
431
+ (record as any)[this.valueTextField!] || (record as any)[this.valueIdField!];
432
+ return records.map((record) => valueTextFormatter(record as any, instance));
433
+ }
434
+
435
+ if (isArray(values)) {
436
+ if (isArray(options))
437
+ return values
438
+ .map((id) => {
439
+ let option = options.find((o) => (o as any)[this.optionIdField!] == id);
440
+ return option ? (option as any)[this.valueTextField!] : id;
441
+ })
442
+ .filter(Boolean)
443
+ .join(", ");
444
+
445
+ return values.join(", ");
446
+ }
447
+
448
+ return null;
449
+ }
450
+ }
451
+
452
+ LookupField.prototype.baseClass = "lookupfield";
453
+ //LookupField.prototype.memoize = false;
454
+ LookupField.prototype.multiple = false;
455
+ LookupField.prototype.queryDelay = 150;
456
+ LookupField.prototype.minQueryLength = 0;
457
+ LookupField.prototype.hideSearchField = false;
458
+ LookupField.prototype.minOptionsForSearchField = 7;
459
+ LookupField.prototype.loadingText = "Loading...";
460
+ LookupField.prototype.queryErrorText = "Error occurred while querying for lookup data.";
461
+ LookupField.prototype.noResultsText = "No results found.";
462
+ LookupField.prototype.optionIdField = "id";
463
+ LookupField.prototype.optionTextField = "text";
464
+ LookupField.prototype.valueIdField = "id";
465
+ LookupField.prototype.valueTextField = "text";
466
+ LookupField.prototype.suppressErrorsUntilVisited = true;
467
+ LookupField.prototype.fetchAll = false;
468
+ LookupField.prototype.cacheAll = false;
469
+ LookupField.prototype.showClear = true;
470
+ LookupField.prototype.alwaysShowClear = false;
471
+ LookupField.prototype.closeOnSelect = true;
472
+ LookupField.prototype.minQueryLengthMessageText = "Type in at least {0} character(s).";
473
+ LookupField.prototype.icon = null;
474
+ LookupField.prototype.sort = false;
475
+ LookupField.prototype.listOptions = null;
476
+ LookupField.prototype.autoOpen = false;
477
+ LookupField.prototype.submitOnEnterKey = false;
478
+ LookupField.prototype.submitOnDropdownEnterKey = false;
479
+ LookupField.prototype.pageSize = 100;
480
+ LookupField.prototype.infinite = false;
481
+ LookupField.prototype.quickSelectAll = false;
482
+ LookupField.prototype.onGetRecordDisplayText = null;
483
+
484
+ Localization.registerPrototype("cx/widgets/LookupField", LookupField);
485
+
486
+ Widget.alias("lookupfield", LookupField);
487
+
488
+ interface BindingConfig {
489
+ local: string;
490
+ remote: string;
491
+ key?: boolean;
492
+ set?: (value: unknown, instance: Instance) => void;
493
+ }
494
+
495
+ function getOptionKey(bindings: BindingConfig[], data: Record<string, any>): unknown[] {
496
+ return bindings.filter((a) => a.key).map((b) => Binding.get(b.remote).value(data));
497
+ }
498
+
499
+ function areKeysEqual(key1: unknown[], key2: unknown[]): boolean {
500
+ if (!key1 || !key2 || key1.length != key2.length) return false;
501
+
502
+ for (let i = 0; i < key1.length; i++) if (key1[i] !== key2[i]) return false;
503
+
504
+ return true;
505
+ }
506
+
507
+ function convertOption(bindings: BindingConfig[], data: Record<string, any>): Record<string, any> {
508
+ let result: Record<string, any> = { $value: {} };
509
+ bindings.forEach((b) => {
510
+ let value = Binding.get(b.remote).value(data);
511
+ result = Binding.get(b.local).set(result, value);
512
+ });
513
+ return result.$value as Record<string, any>;
514
+ }
515
+
516
+ class SelectionDelegate extends Selection {
517
+ delegate: (record: Record<string, any>, index: number) => boolean;
518
+
519
+ constructor({ delegate }: { delegate: (record: Record<string, any>, index: number) => boolean }) {
520
+ super();
521
+ this.delegate = delegate;
522
+ }
523
+
524
+ getIsSelectedDelegate(store: unknown): (record: Record<string, any>, index: number) => boolean {
525
+ return (record: Record<string, any>, index: number) => this.delegate(record, index);
526
+ }
527
+
528
+ select(): boolean {
529
+ return false;
530
+ }
531
+ }
532
+
533
+ interface LookupComponentProps {
534
+ instance: FieldInstance<LookupField>;
535
+ multiple: boolean;
536
+ itemConfig: unknown;
537
+ bindings: BindingConfig[];
538
+ baseClass: string;
539
+ label?: React.ReactNode;
540
+ help?: React.ReactNode;
541
+ forceUpdate: () => void;
542
+ icon?: React.ReactNode;
543
+ }
544
+
545
+ interface LookupComponentState {
546
+ options: unknown[];
547
+ formatted?: string;
548
+ value?: string;
549
+ dropdownOpen: boolean;
550
+ focus: boolean;
551
+ status?: string;
552
+ message?: string;
553
+ query?: string;
554
+ page?: number;
555
+ hover?: boolean;
556
+ }
557
+
558
+ class LookupComponent extends VDOM.Component<LookupComponentProps, LookupComponentState> {
559
+ dom: {
560
+ input?: HTMLDivElement | null;
561
+ dropdown?: HTMLDivElement | null;
562
+ list?: HTMLDivElement | null;
563
+ query?: HTMLInputElement | null;
564
+ } = {};
565
+ itemStore: ReadOnlyDataView;
566
+ dropdown?: Widget;
567
+ list?: Widget;
568
+ listKeyDown?: (e: React.KeyboardEvent) => void;
569
+ queryTimeoutId?: ReturnType<typeof setTimeout>;
570
+ cachedResult?: Record<string, any>[];
571
+ tmpCachedResult?: Record<string, any>[];
572
+ lastQueryId?: number;
573
+ lastQuery?: string;
574
+ extraPageLoadingBlocker?: string | false;
575
+ unsubscribeListOnWheel?: (() => void) | null;
576
+ unsubscribeListOnScroll?: (() => void) | null;
577
+
578
+ constructor(props: LookupComponentProps) {
579
+ super(props);
580
+ let { data, store } = this.props.instance;
581
+ this.dom = {};
582
+ this.state = {
583
+ options: [],
584
+ formatted: data.formatted,
585
+ value: data.formatted,
586
+ dropdownOpen: false,
587
+ focus: false,
588
+ };
589
+
590
+ this.itemStore = new ReadOnlyDataView({
591
+ store: store,
592
+ });
593
+ }
594
+
595
+ getOptionKey(data: Record<string, any>): unknown[] {
596
+ return this.props.bindings.filter((a) => a.key).map((b) => Binding.get(b.remote).value(data));
597
+ }
598
+
599
+ getLocalKey(data: Record<string, any>): unknown[] {
600
+ return this.props.bindings.filter((a) => a.key).map((b) => Binding.get(b.local).value(data));
601
+ }
602
+
603
+ findOption(options: Record<string, any>[], key: unknown[]): number {
604
+ if (!key) return -1;
605
+ for (let i = 0; i < options.length; i++) {
606
+ let optionKey = this.getOptionKey({ $option: options[i] });
607
+ if (areKeysEqual(key, optionKey)) return i;
608
+ }
609
+ return -1;
610
+ }
611
+
612
+ getDropdown(): Widget {
613
+ if (this.dropdown) return this.dropdown;
614
+
615
+ let { widget }: { widget: LookupField } = this.props.instance as unknown as { widget: LookupField };
616
+ let { lastDropdown } = this.props.instance as DropdownInstance;
617
+
618
+ this.list = Widget.create({
619
+ type: List,
620
+ sortField: widget.sort && widget.optionTextField,
621
+ sortDirection: "ASC",
622
+ mod: "dropdown",
623
+ scrollSelectionIntoView: true,
624
+ cached: widget.infinite,
625
+ ...widget.listOptions,
626
+ records: bind("$options"),
627
+ recordName: "$option",
628
+ onItemClick: (e: React.MouseEvent, inst: Instance) => this.onItemClick(e, inst),
629
+ pipeKeyDown: (kd: (e: React.KeyboardEvent) => void) => {
630
+ this.listKeyDown = kd;
631
+ },
632
+ selectOnTab: true,
633
+ focusable: false,
634
+ selection: {
635
+ type: SelectionDelegate,
636
+ delegate: (data: any) =>
637
+ this.props.instance.data.selectedKeys.find((x: any) =>
638
+ areKeysEqual(x, this.getOptionKey({ $option: data })),
639
+ ) != null,
640
+ },
641
+ children: this.props.itemConfig,
642
+ });
643
+
644
+ let dropdown = {
645
+ constrain: true,
646
+ scrollTracking: true,
647
+ inline: !isTouchDevice() || !!lastDropdown,
648
+ placementOrder: "down-right down-left up-right up-left",
649
+ ...widget.dropdownOptions,
650
+ type: Dropdown,
651
+ relatedElement: this.dom.input,
652
+ renderChildren: () => this.renderDropdownContents(),
653
+ onFocusOut: (e: React.MouseEvent) => this.closeDropdown(e),
654
+ memoize: false,
655
+ touchFriendly: isTouchDevice(),
656
+ onMeasureNaturalContentSize: () => {
657
+ if (this.dom.dropdown && this.dom.list) {
658
+ return {
659
+ height:
660
+ this.dom.dropdown.offsetHeight -
661
+ this.dom.list.offsetHeight +
662
+ ((this.dom.list.firstElementChild as HTMLElement)?.offsetHeight || 0),
663
+ };
664
+ }
665
+ },
666
+ onDismissAfterScroll: () => {
667
+ this.closeDropdown(null, true);
668
+ return false;
669
+ },
670
+ };
671
+
672
+ return (this.dropdown = Widget.create(dropdown));
673
+ }
674
+
675
+ renderDropdownContents(): React.ReactNode {
676
+ let content;
677
+ let { instance } = this.props;
678
+ let { data, widget }: { data: Record<string, any>; widget: LookupField } = instance as unknown as {
679
+ data: Record<string, any>;
680
+ widget: LookupField;
681
+ };
682
+ let { CSS, baseClass } = widget;
683
+
684
+ let searchVisible =
685
+ !widget.hideSearchField &&
686
+ (!isArray(data.visibleOptions) ||
687
+ (widget.minOptionsForSearchField && data.visibleOptions.length >= widget.minOptionsForSearchField));
688
+
689
+ if (this.state.status == "loading") {
690
+ content = (
691
+ <div key="msg" className={CSS.element(baseClass, "message", "loading")}>
692
+ {widget.loadingText}
693
+ </div>
694
+ );
695
+ } else if (this.state.status == "error") {
696
+ content = (
697
+ <div key="msg" className={CSS.element(baseClass, "message", "error")}>
698
+ {widget.queryErrorText}
699
+ </div>
700
+ );
701
+ } else if (this.state.status == "info") {
702
+ content = (
703
+ <div key="msg" className={CSS.element(baseClass, "message", "info")}>
704
+ {this.state.message}
705
+ </div>
706
+ );
707
+ } else if (this.state.options.length == 0) {
708
+ content = (
709
+ <div key="msg" className={CSS.element(baseClass, "message", "no-results")}>
710
+ {widget.noResultsText}
711
+ </div>
712
+ );
713
+ } else {
714
+ content = (
715
+ <div
716
+ key="msg"
717
+ ref={(el) => {
718
+ this.dom.list = el;
719
+ this.subscribeListOnWheel(el);
720
+ this.subscribeListOnScroll(el);
721
+ }}
722
+ className={CSS.element(baseClass, "scroll-container")}
723
+ >
724
+ <Cx widget={this.list} store={this.itemStore} options={{ name: "lookupfield-list" }} />
725
+ </div>
726
+ );
727
+ }
728
+
729
+ return (
730
+ <div
731
+ key="dropdown"
732
+ ref={(el) => {
733
+ this.dom.dropdown = el as HTMLDivElement;
734
+ }}
735
+ className={CSS.element(baseClass, "dropdown")}
736
+ tabIndex={0}
737
+ onFocus={(e) => this.onDropdownFocus(e)}
738
+ onKeyDown={(e) => this.onDropdownKeyPress(e)}
739
+ >
740
+ {searchVisible && (
741
+ <input
742
+ key="query"
743
+ ref={(el) => {
744
+ this.dom.query = el as HTMLInputElement;
745
+ }}
746
+ type="text"
747
+ className={CSS.element(baseClass, "query")}
748
+ onClick={(e) => {
749
+ e.preventDefault();
750
+ e.stopPropagation();
751
+ }}
752
+ onChange={(e) => this.query(e.target.value)}
753
+ onBlur={(e) => this.onQueryBlur(e)}
754
+ />
755
+ )}
756
+ {content}
757
+ </div>
758
+ );
759
+ }
760
+
761
+ onListWheel(e: WheelEvent): void {
762
+ let { list } = this.dom;
763
+ if (
764
+ list &&
765
+ ((list.scrollTop + list.offsetHeight == list.scrollHeight && e.deltaY > 0) ||
766
+ (list.scrollTop == 0 && e.deltaY < 0))
767
+ ) {
768
+ e.preventDefault();
769
+ e.stopPropagation();
770
+ }
771
+ }
772
+
773
+ onListScroll(): void {
774
+ if (!this.dom.list) return;
775
+ var el = this.dom.list;
776
+ if (el.scrollTop > el.scrollHeight - 2 * el.offsetHeight) {
777
+ this.loadAdditionalOptionPages();
778
+ }
779
+ }
780
+
781
+ onDropdownFocus(e: React.FocusEvent): void {
782
+ if (this.dom.query && !isFocused(this.dom.query) && !isTouchDevice()) FocusManager.focus(this.dom.query);
783
+ }
784
+
785
+ getPlaceholder(text?: string): React.ReactNode {
786
+ let { CSS, baseClass } = this.props.instance.widget;
787
+
788
+ if (text) return <span className={CSS.element(baseClass, "placeholder")}>{text}</span>;
789
+
790
+ return <span className={CSS.element(baseClass, "placeholder")}>&nbsp;</span>;
791
+ }
792
+
793
+ render(): React.ReactNode {
794
+ let { instance, label, help, icon: iconVDOM } = this.props;
795
+ let { data, widget, state } = instance;
796
+ let { CSS, baseClass, suppressErrorsUntilVisited } = widget as LookupField;
797
+
798
+ let icon = iconVDOM && (
799
+ <div
800
+ key="icon"
801
+ className={CSS.element(baseClass, "left-icon")}
802
+ onMouseDown={preventDefault}
803
+ onClick={(e) => {
804
+ this.openDropdown(e);
805
+ e.stopPropagation();
806
+ e.preventDefault();
807
+ }}
808
+ >
809
+ {iconVDOM}
810
+ </div>
811
+ );
812
+
813
+ let dropdown;
814
+ if (this.state.dropdownOpen) {
815
+ this.itemStore.setData({
816
+ $options: this.state.options,
817
+ $query: this.lastQuery,
818
+ });
819
+ dropdown = (
820
+ <Cx widget={this.getDropdown()} store={this.itemStore} options={{ name: "lookupfield-dropdown" }} />
821
+ );
822
+ }
823
+
824
+ let insideButton = null;
825
+ let multipleEntries = this.props.multiple && isArray(data.records) && data.records.length > 1;
826
+
827
+ if (!data.readOnly) {
828
+ if (
829
+ widget.showClear &&
830
+ !data.disabled &&
831
+ !data.empty &&
832
+ (widget.alwaysShowClear || (!data.required && !this.props.multiple) || multipleEntries)
833
+ ) {
834
+ insideButton = (
835
+ <div
836
+ key="ib"
837
+ onMouseDown={preventDefault}
838
+ onClick={(e) => (!this.props.multiple ? this.onClearClick(e) : this.onClearMultipleClick(e))}
839
+ className={CSS.element(baseClass, "clear")}
840
+ >
841
+ <ClearIcon className={CSS.element(baseClass, "icon")} />
842
+ </div>
843
+ );
844
+ } else {
845
+ insideButton = (
846
+ <div
847
+ key="ib"
848
+ className={CSS.element(baseClass, "tool")}
849
+ onMouseDown={preventDefault}
850
+ onClick={(e) => {
851
+ this.toggleDropdown(e, true);
852
+ e.stopPropagation();
853
+ e.preventDefault();
854
+ }}
855
+ >
856
+ <DropdownIcon className={CSS.element(baseClass, "icon")} />
857
+ </div>
858
+ );
859
+ }
860
+ }
861
+
862
+ let text;
863
+
864
+ if (this.props.multiple) {
865
+ let readOnly = data.disabled || data.readOnly;
866
+ if (isNonEmptyArray(data.records)) {
867
+ let valueTextFormatter =
868
+ widget.onGetRecordDisplayText ??
869
+ ((record: Record<string, any>) => record[widget.valueTextField] as string);
870
+ text = data.records.map((v, i) => (
871
+ <div
872
+ key={i}
873
+ className={CSS.element(baseClass, "tag", {
874
+ readonly: readOnly,
875
+ })}
876
+ >
877
+ <span className={CSS.element(baseClass, "tag-value")}>{valueTextFormatter(v, instance)}</span>
878
+ {!readOnly && (
879
+ <div
880
+ className={CSS.element(baseClass, "tag-clear")}
881
+ onMouseDown={(e) => {
882
+ e.preventDefault();
883
+ e.stopPropagation();
884
+ }}
885
+ onClick={(e) => this.onClearClick(e, v)}
886
+ >
887
+ <ClearIcon className={CSS.element(baseClass, "icon")} />
888
+ </div>
889
+ )}
890
+ </div>
891
+ ));
892
+ } else {
893
+ text = this.getPlaceholder(data.placeholder);
894
+ }
895
+ } else {
896
+ text = !data.empty ? data.text || this.getPlaceholder() : this.getPlaceholder(data.placeholder);
897
+ }
898
+
899
+ let states = {
900
+ visited: state.visited,
901
+ focus: this.state.focus || this.state.dropdownOpen,
902
+ icon: !!iconVDOM,
903
+ empty: !data.placeholder && data.empty,
904
+ error: data.error && (state.visited || !suppressErrorsUntilVisited || !data.empty),
905
+ };
906
+
907
+ return (
908
+ <div
909
+ className={CSS.expand(data.classNames, CSS.state(states))}
910
+ style={data.style}
911
+ onMouseDown={stopPropagation}
912
+ onTouchStart={stopPropagation}
913
+ onKeyDown={(e) => this.onKeyDown(e)}
914
+ >
915
+ <div
916
+ id={data.id}
917
+ className={CSS.expand(CSS.element(widget.baseClass, "input"), data.inputClass)}
918
+ style={data.inputStyle}
919
+ tabIndex={data.disabled ? null : data.tabIndex || 0}
920
+ ref={(el) => {
921
+ this.dom.input = el;
922
+ }}
923
+ aria-labelledby={data.id + "-label"}
924
+ onMouseMove={(e) => tooltipMouseMove(e, ...getFieldTooltip(this.props.instance))}
925
+ onMouseLeave={(e) => tooltipMouseLeave(e, ...getFieldTooltip(this.props.instance))}
926
+ onClick={(e) => this.onClick(e)}
927
+ onKeyDown={(e) => this.onInputKeyDown(e)}
928
+ onMouseDown={(e) => this.onMouseDown(e)}
929
+ onBlur={(e) => this.onBlur(e)}
930
+ onFocus={(e) => this.onFocus(e)}
931
+ >
932
+ {text}
933
+ </div>
934
+ {insideButton}
935
+ {icon}
936
+ {dropdown}
937
+ {label}
938
+ {help}
939
+ </div>
940
+ );
941
+ }
942
+
943
+ onMouseDown(e: React.MouseEvent): void {
944
+ //skip touch start to allow touch scrolling
945
+ if (isTouchEvent()) return;
946
+ e.preventDefault();
947
+ e.stopPropagation();
948
+ this.toggleDropdown(e, true);
949
+ }
950
+
951
+ onClick(e: React.MouseEvent): void {
952
+ //mouse down will handle it for non-touch events
953
+ if (!isTouchEvent()) return;
954
+ e.preventDefault();
955
+ e.stopPropagation();
956
+ this.toggleDropdown(e, true);
957
+ }
958
+
959
+ onItemClick(
960
+ e: React.KeyboardEvent | React.MouseEvent,
961
+ { store }: { store: { getData: () => Record<string, any> } },
962
+ ): void {
963
+ this.select(e, [store.getData()]);
964
+ if (!this.props.instance.widget.submitOnEnterKey || e.type != "keydown") e.stopPropagation();
965
+ if ((e as React.KeyboardEvent).keyCode != KeyCode.tab) e.preventDefault();
966
+ }
967
+
968
+ onClearClick(e: React.MouseEvent | React.KeyboardEvent, value?: Record<string, any>): void {
969
+ let { instance } = this.props;
970
+ let { data, store, widget } = instance;
971
+ let { keyBindings } = widget;
972
+ e.stopPropagation();
973
+ e.preventDefault();
974
+ if (widget.multiple) {
975
+ if (isArray(data.records)) {
976
+ let itemKey = this.getLocalKey({ $value: value });
977
+ let newRecords = data.records.filter((v) => !areKeysEqual(this.getLocalKey({ $value: v }), itemKey));
978
+
979
+ instance.set("records", newRecords);
980
+
981
+ let newValues = newRecords
982
+ .map((rec) => this.getLocalKey({ $value: rec }))
983
+ .map((k) => (keyBindings!.length == 1 ? k[0] : k));
984
+
985
+ instance.set("values", newValues);
986
+ }
987
+ } else {
988
+ this.props.bindings.forEach((b) => {
989
+ store.set(b.local, widget.emptyValue);
990
+ });
991
+ }
992
+
993
+ if (!isTouchEvent()) this.dom.input!.focus();
994
+ }
995
+
996
+ onClearMultipleClick(e: React.MouseEvent): void {
997
+ let { instance } = this.props;
998
+ instance.set("records", []);
999
+ instance.set("values", []);
1000
+ }
1001
+
1002
+ select(e: React.KeyboardEvent | React.MouseEvent, itemsData: Record<string, any>[], reset?: boolean): void {
1003
+ let { instance } = this.props;
1004
+ let { store, data, widget } = instance;
1005
+ let { bindings, keyBindings } = widget;
1006
+
1007
+ if (widget.multiple) {
1008
+ let { selectedKeys, records } = data;
1009
+
1010
+ let newRecords = reset ? [] : [...(records || [])];
1011
+ let singleSelect = itemsData.length == 1;
1012
+ let optionKey: unknown[] | null = null;
1013
+ if (singleSelect) optionKey = this.getOptionKey(itemsData[0]);
1014
+
1015
+ // deselect
1016
+ if (singleSelect && selectedKeys.find((k: any) => areKeysEqual(optionKey!, k))) {
1017
+ newRecords = records.filter((v: any) => !areKeysEqual(optionKey!, this.getLocalKey({ $value: v })));
1018
+ } else {
1019
+ itemsData.forEach((itemData) => {
1020
+ let valueData: Record<string, any> = {
1021
+ $value: {},
1022
+ };
1023
+ bindings!.forEach((b) => {
1024
+ valueData = Binding.get(b.local).set(valueData, Binding.get(b.remote).value(itemData));
1025
+ });
1026
+ newRecords.push(valueData.$value as Record<string, any>);
1027
+ });
1028
+ }
1029
+
1030
+ instance.set("records", newRecords);
1031
+
1032
+ let newValues = newRecords
1033
+ .map((rec) => this.getLocalKey({ $value: rec }))
1034
+ .map((k) => (keyBindings!.length == 1 ? k[0] : k));
1035
+
1036
+ instance.set("values", newValues);
1037
+ } else {
1038
+ bindings!.forEach((b) => {
1039
+ let v = Binding.get(b.remote).value(itemsData[0]);
1040
+ if (b.set) b.set(v, instance);
1041
+ else store.set(b.local, v);
1042
+ });
1043
+ }
1044
+
1045
+ if (widget.closeOnSelect) {
1046
+ //Pressing Tab should work it's own thing. Focus will move elsewhere and the dropdown will close.
1047
+ if ((e as React.KeyboardEvent).keyCode != KeyCode.tab) {
1048
+ if (!isTouchEvent()) this.dom.input!.focus();
1049
+ this.closeDropdown(e);
1050
+ }
1051
+ }
1052
+
1053
+ if ((e as React.KeyboardEvent).keyCode == KeyCode.enter && widget.submitOnDropdownEnterKey) {
1054
+ this.submitOnEnter(e as React.KeyboardEvent);
1055
+ }
1056
+ }
1057
+
1058
+ onDropdownKeyPress(e: React.KeyboardEvent): void {
1059
+ switch (e.keyCode) {
1060
+ case KeyCode.esc:
1061
+ this.closeDropdown(e);
1062
+ this.dom.input!.focus();
1063
+ break;
1064
+
1065
+ case KeyCode.tab:
1066
+ // if tab needs to do a list selection, we have to first call List's handleKeyDown
1067
+ if (this.listKeyDown) this.listKeyDown(e);
1068
+ // if next focusable element is disabled, recalculate and update the dom before switching focus
1069
+ this.props.forceUpdate();
1070
+ break;
1071
+
1072
+ case KeyCode.a:
1073
+ if (!e.ctrlKey) return;
1074
+
1075
+ let { quickSelectAll, multiple } = this.props.instance.widget;
1076
+ if (!quickSelectAll || !multiple) return;
1077
+
1078
+ let optionsToSelect = this.state.options.map((o) => ({
1079
+ $option: o,
1080
+ }));
1081
+ this.select(e, optionsToSelect, true);
1082
+ e.stopPropagation();
1083
+ e.preventDefault();
1084
+ break;
1085
+
1086
+ default:
1087
+ if (this.listKeyDown) this.listKeyDown(e);
1088
+ break;
1089
+ }
1090
+ }
1091
+
1092
+ onKeyDown(e: React.KeyboardEvent): void {
1093
+ switch (e.keyCode) {
1094
+ case KeyCode.pageDown:
1095
+ case KeyCode.pageUp:
1096
+ if (this.state.dropdownOpen) e.preventDefault();
1097
+ break;
1098
+ }
1099
+ }
1100
+
1101
+ onInputKeyDown(e: React.KeyboardEvent): void {
1102
+ let { instance } = this.props;
1103
+ if (instance.widget.handleKeyDown(e, instance) === false) return;
1104
+
1105
+ switch (e.keyCode) {
1106
+ case KeyCode.delete:
1107
+ this.onClearClick(e);
1108
+ return;
1109
+
1110
+ case KeyCode.shift:
1111
+ case KeyCode.ctrl:
1112
+ case KeyCode.tab:
1113
+ case KeyCode.left:
1114
+ case KeyCode.right:
1115
+ case KeyCode.pageUp:
1116
+ case KeyCode.pageDown:
1117
+ case KeyCode.insert:
1118
+ case KeyCode.esc:
1119
+ break;
1120
+
1121
+ case KeyCode.down:
1122
+ this.openDropdown(e);
1123
+ e.stopPropagation();
1124
+ break;
1125
+
1126
+ case KeyCode.enter:
1127
+ if (this.props.instance.widget.submitOnEnterKey) {
1128
+ this.submitOnEnter(e);
1129
+ } else {
1130
+ this.openDropdown(e);
1131
+ }
1132
+ break;
1133
+
1134
+ default:
1135
+ this.openDropdown(e);
1136
+ break;
1137
+ }
1138
+ }
1139
+
1140
+ onQueryBlur(e: React.FocusEvent): void {
1141
+ FocusManager.nudge();
1142
+ }
1143
+
1144
+ onFocus(e: React.FocusEvent): void {
1145
+ let { instance } = this.props;
1146
+ let { widget } = instance;
1147
+ if (widget.trackFocus) {
1148
+ this.setState({
1149
+ focus: true,
1150
+ });
1151
+ }
1152
+
1153
+ if (this.props.instance.data.autoOpen) this.openDropdown(null);
1154
+ }
1155
+
1156
+ onBlur(e: React.FocusEvent): void {
1157
+ if (!this.state.dropdownOpen) this.props.instance.setState({ visited: true });
1158
+
1159
+ if (this.state.focus)
1160
+ this.setState({
1161
+ focus: false,
1162
+ });
1163
+ }
1164
+
1165
+ toggleDropdown(e: React.KeyboardEvent | React.MouseEvent, keepFocus?: boolean): void {
1166
+ if (this.state.dropdownOpen) this.closeDropdown(e, keepFocus);
1167
+ else this.openDropdown(e);
1168
+ }
1169
+
1170
+ closeDropdown(e?: React.KeyboardEvent | React.MouseEvent | null, keepFocus?: boolean): void {
1171
+ if (this.state.dropdownOpen) {
1172
+ this.setState(
1173
+ {
1174
+ dropdownOpen: false,
1175
+ },
1176
+ () => keepFocus && this.dom.input?.focus(),
1177
+ );
1178
+
1179
+ this.props.instance.setState({
1180
+ visited: true,
1181
+ });
1182
+ }
1183
+
1184
+ //delete results valid only while the dropdown is open
1185
+ delete this.tmpCachedResult;
1186
+ }
1187
+
1188
+ openDropdown(e: React.KeyboardEvent | React.MouseEvent | null): void {
1189
+ let { instance } = this.props;
1190
+ let { data } = instance;
1191
+ if (!this.state.dropdownOpen && !data.disabled && !data.readOnly) {
1192
+ this.query("");
1193
+ this.setState(
1194
+ {
1195
+ dropdownOpen: true,
1196
+ },
1197
+ () => {
1198
+ if (this.dom.dropdown) this.dom.dropdown.focus();
1199
+ },
1200
+ );
1201
+ }
1202
+ }
1203
+
1204
+ query(q: string): void {
1205
+ /*
1206
+ In fetchAll mode onQuery should fetch all data and after
1207
+ that everything is done filtering is done client-side.
1208
+ If cacheAll is set results are cached for the lifetime of the
1209
+ widget, otherwise cache is invalidated when dropdown closes.
1210
+ */
1211
+
1212
+ let { instance } = this.props;
1213
+ let { widget, data } = instance;
1214
+
1215
+ this.lastQuery = q;
1216
+
1217
+ //do not make duplicate queries if fetchAll is enabled
1218
+ if (widget.fetchAll && this.state.status == "loading") return;
1219
+
1220
+ if (this.queryTimeoutId) clearTimeout(this.queryTimeoutId);
1221
+
1222
+ if (q.length < widget.minQueryLength) {
1223
+ this.setState({
1224
+ status: "info",
1225
+ message: StringTemplate.format(widget.minQueryLengthMessageText, widget.minQueryLength),
1226
+ });
1227
+ return;
1228
+ }
1229
+
1230
+ if (isArray(data.visibleOptions)) {
1231
+ let results = widget.filterOptions(this.props.instance, data.visibleOptions as DataRecord[], q);
1232
+ this.setState({
1233
+ options: results,
1234
+ status: "loaded",
1235
+ });
1236
+ }
1237
+
1238
+ if (widget.onQuery) {
1239
+ let { queryDelay, fetchAll, cacheAll, pageSize } = widget;
1240
+
1241
+ if (fetchAll) queryDelay = 0;
1242
+
1243
+ if (!this.cachedResult) {
1244
+ this.setState({
1245
+ status: "loading",
1246
+ });
1247
+ }
1248
+
1249
+ this.queryTimeoutId = setTimeout(() => {
1250
+ delete this.queryTimeoutId;
1251
+
1252
+ let result = this.tmpCachedResult || this.cachedResult;
1253
+ let query = fetchAll ? "" : q;
1254
+ let params = !widget.infinite
1255
+ ? query
1256
+ : {
1257
+ query,
1258
+ page: 1,
1259
+ pageSize,
1260
+ };
1261
+
1262
+ if (!result) result = instance.invoke("onQuery", params, instance);
1263
+
1264
+ let queryId = (this.lastQueryId = Date.now());
1265
+
1266
+ Promise.resolve(result)
1267
+ .then((results) => {
1268
+ //discard results which do not belong to the last query
1269
+ if (queryId !== this.lastQueryId) return;
1270
+
1271
+ if (!isArray(results)) results = [];
1272
+
1273
+ if (fetchAll) {
1274
+ if (cacheAll) this.cachedResult = results;
1275
+ else this.tmpCachedResult = results;
1276
+
1277
+ results = widget.filterOptions(this.props.instance, results, this.lastQuery);
1278
+ }
1279
+
1280
+ this.setState(
1281
+ {
1282
+ page: 1,
1283
+ query,
1284
+ options: results,
1285
+ status: "loaded",
1286
+ },
1287
+ () => {
1288
+ if (widget.infinite) this.onListScroll();
1289
+ },
1290
+ );
1291
+ })
1292
+ .catch((err) => {
1293
+ this.setState({ status: "error" });
1294
+ debug("Lookup query error:", err);
1295
+ });
1296
+ }, queryDelay);
1297
+ }
1298
+ }
1299
+
1300
+ loadAdditionalOptionPages(): void {
1301
+ let { instance } = this.props;
1302
+ let { widget } = instance;
1303
+ if (!widget.infinite) return;
1304
+
1305
+ let { query, page, status, options } = this.state;
1306
+ if (!page) page = 1;
1307
+
1308
+ let blockerKey = query;
1309
+
1310
+ if (status != "loaded") return;
1311
+
1312
+ if (options.length < page * widget.pageSize) return; //some pages were not full which means we reached the end
1313
+
1314
+ if (this.extraPageLoadingBlocker === blockerKey) return;
1315
+
1316
+ this.extraPageLoadingBlocker = blockerKey;
1317
+
1318
+ let params = {
1319
+ page: page + 1,
1320
+ query,
1321
+ pageSize: widget.pageSize,
1322
+ };
1323
+
1324
+ var result = instance.invoke("onQuery", params, instance);
1325
+
1326
+ Promise.resolve(result)
1327
+ .then((results) => {
1328
+ //discard results which do not belong to the last query
1329
+ if (this.extraPageLoadingBlocker !== blockerKey) return;
1330
+
1331
+ this.extraPageLoadingBlocker = false;
1332
+
1333
+ if (!isArray(results)) return;
1334
+
1335
+ this.setState(
1336
+ {
1337
+ page: params.page,
1338
+ query,
1339
+ options: [...options, ...results],
1340
+ },
1341
+ () => {
1342
+ this.onListScroll();
1343
+ },
1344
+ );
1345
+ })
1346
+ .catch((err) => {
1347
+ if (this.extraPageLoadingBlocker !== blockerKey) return;
1348
+ this.extraPageLoadingBlocker = false;
1349
+ this.setState({ status: "error" });
1350
+ debug("Lookup query error:", err);
1351
+ console.error(err);
1352
+ });
1353
+ }
1354
+
1355
+ UNSAFE_componentWillReceiveProps(props: LookupComponentProps): void {
1356
+ if (this.dom.input) {
1357
+ tooltipParentWillReceiveProps(this.dom.input, ...getFieldTooltip(props.instance));
1358
+ }
1359
+ }
1360
+
1361
+ componentDidMount(): void {
1362
+ if (this.dom.input) {
1363
+ tooltipParentDidMount(this.dom.input, ...getFieldTooltip(this.props.instance));
1364
+ autoFocus(this.dom.input, this);
1365
+ }
1366
+ }
1367
+
1368
+ componentDidUpdate(): void {
1369
+ if (this.dom.input) {
1370
+ autoFocus(this.dom.input, this);
1371
+ }
1372
+ }
1373
+
1374
+ componentWillUnmount(): void {
1375
+ if (this.queryTimeoutId) clearTimeout(this.queryTimeoutId);
1376
+ tooltipParentWillUnmount(this.props.instance);
1377
+ this.subscribeListOnWheel(null);
1378
+ }
1379
+
1380
+ subscribeListOnWheel(list: HTMLDivElement | null): void {
1381
+ if (this.unsubscribeListOnWheel) {
1382
+ this.unsubscribeListOnWheel();
1383
+ this.unsubscribeListOnWheel = null;
1384
+ }
1385
+ if (list) {
1386
+ this.unsubscribeListOnWheel = addEventListenerWithOptions(
1387
+ list,
1388
+ "wheel",
1389
+ (e) => this.onListWheel(e as WheelEvent),
1390
+ {
1391
+ passive: false,
1392
+ },
1393
+ );
1394
+ }
1395
+ }
1396
+
1397
+ subscribeListOnScroll(list: HTMLDivElement | null): void {
1398
+ if (this.unsubscribeListOnScroll) {
1399
+ this.unsubscribeListOnScroll();
1400
+ this.unsubscribeListOnScroll = null;
1401
+ }
1402
+ if (list) {
1403
+ this.unsubscribeListOnScroll = addEventListenerWithOptions(list, "scroll", () => this.onListScroll(), {
1404
+ passive: false,
1405
+ });
1406
+ }
1407
+ }
1408
+
1409
+ submitOnEnter(e: React.KeyboardEvent): void {
1410
+ let instance = this.props.instance.parent;
1411
+ while (instance) {
1412
+ let htmlInstance = instance as HtmlElementInstance;
1413
+ if (htmlInstance.events && htmlInstance.events.onSubmit) {
1414
+ htmlInstance.events.onSubmit(e, instance);
1415
+ break;
1416
+ } else {
1417
+ instance = instance.parent;
1418
+ }
1419
+ }
1420
+ }
1421
+ }