cx 26.1.1 → 26.1.3

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 (561) hide show
  1. package/.mocharc.json +5 -5
  2. package/LICENSE-THIRD-PARTY.md +91 -91
  3. package/LICENSE.md +7 -7
  4. package/README.md +46 -46
  5. package/build/data/ArrayElementView.d.ts +4 -3
  6. package/build/ui/adapter/DataAdapter.d.ts +3 -3
  7. package/build.js +133 -133
  8. package/dist/manifest.js +899 -899
  9. package/package.json +100 -99
  10. package/src/charts/Bar.scss +28 -28
  11. package/src/charts/Bar.ts +114 -114
  12. package/src/charts/BarGraph.scss +28 -28
  13. package/src/charts/BarGraph.tsx +145 -145
  14. package/src/charts/BubbleGraph.scss +31 -31
  15. package/src/charts/BubbleGraph.tsx +165 -165
  16. package/src/charts/Chart.ts +108 -108
  17. package/src/charts/ColorMap.ts +150 -150
  18. package/src/charts/Column.scss +28 -28
  19. package/src/charts/Column.ts +124 -124
  20. package/src/charts/ColumnBarBase.tsx +284 -284
  21. package/src/charts/ColumnBarGraphBase.tsx +229 -229
  22. package/src/charts/ColumnGraph.scss +29 -29
  23. package/src/charts/ColumnGraph.tsx +153 -153
  24. package/src/charts/Grid.ts +5 -5
  25. package/src/charts/Gridlines.scss +24 -24
  26. package/src/charts/Gridlines.tsx +88 -88
  27. package/src/charts/Legend.scss +50 -50
  28. package/src/charts/Legend.tsx +270 -270
  29. package/src/charts/LegendEntry.scss +29 -29
  30. package/src/charts/LegendEntry.tsx +197 -197
  31. package/src/charts/LineGraph.scss +24 -24
  32. package/src/charts/LineGraph.tsx +455 -455
  33. package/src/charts/Marker.scss +43 -43
  34. package/src/charts/Marker.tsx +483 -483
  35. package/src/charts/MarkerLine.scss +19 -19
  36. package/src/charts/MarkerLine.tsx +214 -214
  37. package/src/charts/MouseTracker.tsx +112 -112
  38. package/src/charts/Pie.ts +8 -8
  39. package/src/charts/PieChart.scss +28 -28
  40. package/src/charts/PieChart.tsx +717 -717
  41. package/src/charts/PieLabel.tsx +106 -106
  42. package/src/charts/PieLabelsContainer.ts +68 -68
  43. package/src/charts/Range.scss +19 -19
  44. package/src/charts/Range.tsx +318 -318
  45. package/src/charts/RangeMarker.scss +17 -17
  46. package/src/charts/RangeMarker.tsx +233 -233
  47. package/src/charts/ScatterGraph.scss +23 -23
  48. package/src/charts/ScatterGraph.tsx +245 -245
  49. package/src/charts/Swimlane.scss +16 -16
  50. package/src/charts/Swimlane.tsx +195 -195
  51. package/src/charts/Swimlanes.scss +16 -16
  52. package/src/charts/Swimlanes.tsx +179 -179
  53. package/src/charts/axis/Axis.scss +22 -22
  54. package/src/charts/axis/Axis.tsx +444 -444
  55. package/src/charts/axis/CategoryAxis.scss +34 -34
  56. package/src/charts/axis/CategoryAxis.tsx +313 -313
  57. package/src/charts/axis/NumericAxis.scss +34 -34
  58. package/src/charts/axis/NumericAxis.tsx +437 -437
  59. package/src/charts/axis/Stack.ts +61 -61
  60. package/src/charts/axis/TimeAxis.scss +33 -33
  61. package/src/charts/axis/TimeAxis.tsx +718 -718
  62. package/src/charts/axis/index.scss +5 -5
  63. package/src/charts/axis/index.ts +3 -3
  64. package/src/charts/axis/variables.scss +2 -2
  65. package/src/charts/helpers/MinMaxFinder.ts +66 -66
  66. package/src/charts/helpers/PointReducer.ts +135 -135
  67. package/src/charts/helpers/SnapPointFinder.ts +136 -136
  68. package/src/charts/helpers/ValueAtFinder.ts +72 -72
  69. package/src/charts/helpers/index.ts +4 -4
  70. package/src/charts/index.scss +22 -22
  71. package/src/charts/index.ts +34 -34
  72. package/src/charts/palette.scss +97 -97
  73. package/src/charts/shapes.tsx +86 -86
  74. package/src/charts/variables.scss +22 -22
  75. package/src/core.d.ts +182 -182
  76. package/src/data/AggregateFunction.ts +171 -171
  77. package/src/data/ArrayElementView.spec.ts +88 -88
  78. package/src/data/ArrayElementView.ts +91 -90
  79. package/src/data/ArrayRef.ts +34 -34
  80. package/src/data/AugmentedViewBase.ts +88 -88
  81. package/src/data/Binding.spec.ts +69 -69
  82. package/src/data/Binding.ts +104 -104
  83. package/src/data/ExposedRecordView.ts +95 -95
  84. package/src/data/ExposedValueView.ts +89 -89
  85. package/src/data/Expression.spec.ts +229 -229
  86. package/src/data/Expression.ts +233 -233
  87. package/src/data/Grouper.spec.ts +57 -57
  88. package/src/data/Grouper.ts +158 -158
  89. package/src/data/NestedDataView.ts +43 -43
  90. package/src/data/ReadOnlyDataView.ts +39 -39
  91. package/src/data/Ref.spec.ts +79 -79
  92. package/src/data/Ref.ts +104 -104
  93. package/src/data/Selector.ts +10 -10
  94. package/src/data/Store.spec.ts +22 -22
  95. package/src/data/Store.ts +52 -52
  96. package/src/data/StoreProxy.ts +19 -19
  97. package/src/data/StoreRef.spec.ts +24 -24
  98. package/src/data/StoreRef.ts +66 -66
  99. package/src/data/StringTemplate.spec.ts +132 -132
  100. package/src/data/StringTemplate.ts +93 -93
  101. package/src/data/StructuredSelector.spec.ts +113 -113
  102. package/src/data/StructuredSelector.ts +146 -146
  103. package/src/data/SubscribableView.ts +63 -63
  104. package/src/data/View.spec.ts +60 -60
  105. package/src/data/View.ts +289 -289
  106. package/src/data/ZoomIntoPropertyView.spec.ts +64 -64
  107. package/src/data/ZoomIntoPropertyView.ts +45 -45
  108. package/src/data/comparer.spec.ts +60 -60
  109. package/src/data/comparer.ts +78 -78
  110. package/src/data/computable.spec.ts +87 -87
  111. package/src/data/computable.ts +69 -69
  112. package/src/data/createAccessorModelProxy.spec.tsx +145 -145
  113. package/src/data/createAccessorModelProxy.ts +66 -66
  114. package/src/data/createStructuredSelector.spec.ts +45 -45
  115. package/src/data/createStructuredSelector.ts +62 -62
  116. package/src/data/defaultCompare.ts +14 -14
  117. package/src/data/diff/diffArrays.ts +49 -49
  118. package/src/data/diff/diffs.spec.ts +49 -49
  119. package/src/data/diff/index.ts +1 -1
  120. package/src/data/enableFatArrowExpansion.ts +6 -6
  121. package/src/data/getAccessor.spec.ts +11 -11
  122. package/src/data/getAccessor.ts +74 -74
  123. package/src/data/getSelector.spec.ts +43 -43
  124. package/src/data/getSelector.ts +66 -66
  125. package/src/data/index.ts +30 -30
  126. package/src/data/isSelector.ts +26 -26
  127. package/src/data/ops/append.spec.ts +28 -28
  128. package/src/data/ops/append.ts +5 -5
  129. package/src/data/ops/filter.spec.ts +35 -35
  130. package/src/data/ops/filter.ts +9 -9
  131. package/src/data/ops/findTreeNode.spec.ts +23 -23
  132. package/src/data/ops/findTreeNode.ts +14 -14
  133. package/src/data/ops/findTreePath.ts +23 -23
  134. package/src/data/ops/index.ts +11 -11
  135. package/src/data/ops/insertElement.ts +3 -3
  136. package/src/data/ops/merge.spec.ts +27 -27
  137. package/src/data/ops/merge.ts +13 -13
  138. package/src/data/ops/moveElement.ts +21 -21
  139. package/src/data/ops/removeTreeNodes.spec.ts +37 -37
  140. package/src/data/ops/removeTreeNodes.ts +15 -15
  141. package/src/data/ops/updateArray.spec.ts +69 -69
  142. package/src/data/ops/updateArray.ts +31 -31
  143. package/src/data/ops/updateTree.spec.ts +54 -54
  144. package/src/data/ops/updateTree.ts +23 -23
  145. package/src/data/test-types.ts +7 -7
  146. package/src/global.scss +13 -13
  147. package/src/hooks/createLocalStorageRef.ts +21 -21
  148. package/src/hooks/index.ts +8 -8
  149. package/src/hooks/invokeCallback.spec.tsx +59 -59
  150. package/src/hooks/invokeCallback.ts +8 -8
  151. package/src/hooks/resolveCallback.spec.tsx +71 -71
  152. package/src/hooks/resolveCallback.ts +16 -16
  153. package/src/hooks/store.spec.tsx +67 -67
  154. package/src/hooks/store.ts +46 -46
  155. package/src/hooks/useEffect.ts +14 -14
  156. package/src/hooks/useInterval.ts +8 -8
  157. package/src/hooks/useState.ts +20 -20
  158. package/src/hooks/useTrigger.spec.tsx +105 -105
  159. package/src/hooks/useTrigger.ts +26 -26
  160. package/src/index.ts +7 -7
  161. package/src/jsx-dev-runtime.ts +4 -4
  162. package/src/jsx-runtime.spec.tsx +431 -431
  163. package/src/jsx-runtime.ts +79 -79
  164. package/src/locale/de-de.ts +76 -76
  165. package/src/locale/en-us.ts +75 -75
  166. package/src/locale/es-es.ts +76 -76
  167. package/src/locale/fr-fr.ts +76 -76
  168. package/src/locale/nl-nl.ts +76 -76
  169. package/src/locale/pt-pt.ts +76 -76
  170. package/src/locale/sr-latn-ba.ts +76 -76
  171. package/src/svg/BoundedObject.ts +101 -101
  172. package/src/svg/ClipRect.tsx +29 -29
  173. package/src/svg/Ellipse.tsx +68 -68
  174. package/src/svg/Line.tsx +58 -58
  175. package/src/svg/NonOverlappingRect.ts +26 -26
  176. package/src/svg/NonOverlappingRectGroup.ts +49 -49
  177. package/src/svg/Rectangle.tsx +90 -90
  178. package/src/svg/Svg.scss +27 -27
  179. package/src/svg/Svg.tsx +241 -241
  180. package/src/svg/Text.tsx +134 -134
  181. package/src/svg/TextualBoundedObject.ts +35 -35
  182. package/src/svg/index.scss +8 -8
  183. package/src/svg/index.ts +17 -17
  184. package/src/svg/util/Rect.ts +105 -105
  185. package/src/ui/CSS.ts +87 -87
  186. package/src/ui/CSSHelper.ts +17 -17
  187. package/src/ui/Container.tsx +216 -216
  188. package/src/ui/ContentResolver.spec.tsx +585 -585
  189. package/src/ui/ContentResolver.ts +132 -132
  190. package/src/ui/Controller.spec.tsx +574 -574
  191. package/src/ui/Controller.ts +202 -202
  192. package/src/ui/Culture.ts +159 -159
  193. package/src/ui/Cx.spec.tsx +210 -210
  194. package/src/ui/Cx.tsx +386 -386
  195. package/src/ui/DataProxy.spec.tsx +337 -337
  196. package/src/ui/DataProxy.ts +55 -55
  197. package/src/ui/DetachedScope.tsx +159 -159
  198. package/src/ui/FocusManager.ts +171 -171
  199. package/src/ui/Format.ts +108 -108
  200. package/src/ui/HoverSync.tsx +189 -189
  201. package/src/ui/Instance.ts +866 -866
  202. package/src/ui/IsolatedScope.spec.tsx +62 -62
  203. package/src/ui/IsolatedScope.ts +50 -50
  204. package/src/ui/Localization.ts +70 -70
  205. package/src/ui/Prop.ts +140 -140
  206. package/src/ui/PureContainer.spec.tsx +232 -232
  207. package/src/ui/PureContainer.tsx +19 -19
  208. package/src/ui/RenderingContext.ts +99 -99
  209. package/src/ui/Repeater.spec.tsx +143 -143
  210. package/src/ui/Repeater.ts +194 -194
  211. package/src/ui/Rescope.spec.tsx +199 -199
  212. package/src/ui/Rescope.ts +49 -49
  213. package/src/ui/ResizeManager.ts +30 -30
  214. package/src/ui/Restate.spec.tsx +422 -422
  215. package/src/ui/Restate.tsx +217 -217
  216. package/src/ui/StaticText.ts +11 -11
  217. package/src/ui/StructuredInstanceDataAccessor.ts +32 -32
  218. package/src/ui/Text.ts +49 -49
  219. package/src/ui/VDOM.ts +1 -1
  220. package/src/ui/Widget.spec.tsx +53 -53
  221. package/src/ui/Widget.tsx +301 -301
  222. package/src/ui/ZIndexManager.ts +11 -11
  223. package/src/ui/adapter/ArrayAdapter.spec.ts +55 -55
  224. package/src/ui/adapter/ArrayAdapter.ts +229 -229
  225. package/src/ui/adapter/DataAdapter.ts +52 -52
  226. package/src/ui/adapter/GroupAdapter.ts +235 -235
  227. package/src/ui/adapter/TreeAdapter.spec.ts +76 -76
  228. package/src/ui/adapter/TreeAdapter.ts +185 -185
  229. package/src/ui/adapter/index.ts +4 -4
  230. package/src/ui/app/History.ts +133 -133
  231. package/src/ui/app/Url.spec.ts +50 -50
  232. package/src/ui/app/Url.ts +102 -102
  233. package/src/ui/app/index.ts +5 -5
  234. package/src/ui/app/startAppLoop.tsx +71 -71
  235. package/src/ui/app/startHotAppLoop.ts +41 -41
  236. package/src/ui/batchUpdates.ts +77 -77
  237. package/src/ui/bind.ts +10 -10
  238. package/src/ui/createFunctionalComponent.spec.tsx +454 -454
  239. package/src/ui/createFunctionalComponent.ts +86 -86
  240. package/src/ui/expr.ts +47 -47
  241. package/src/ui/exprHelpers.spec.ts +379 -379
  242. package/src/ui/exprHelpers.ts +78 -78
  243. package/src/ui/flattenProps.ts +21 -21
  244. package/src/ui/index.scss +2 -2
  245. package/src/ui/index.ts +47 -47
  246. package/src/ui/keyboardShortcuts.ts +40 -40
  247. package/src/ui/layout/Content.ts +30 -30
  248. package/src/ui/layout/ContentPlaceholder.spec.tsx +599 -599
  249. package/src/ui/layout/ContentPlaceholder.ts +133 -133
  250. package/src/ui/layout/FirstVisibleChildLayout.spec.tsx +207 -207
  251. package/src/ui/layout/FirstVisibleChildLayout.ts +60 -60
  252. package/src/ui/layout/LabelsLeftLayout.scss +46 -46
  253. package/src/ui/layout/LabelsLeftLayout.tsx +76 -76
  254. package/src/ui/layout/LabelsTopLayout.scss +64 -64
  255. package/src/ui/layout/LabelsTopLayout.tsx +156 -156
  256. package/src/ui/layout/UseParentLayout.ts +8 -8
  257. package/src/ui/layout/exploreChildren.ts +38 -38
  258. package/src/ui/layout/index.scss +3 -3
  259. package/src/ui/layout/index.ts +10 -10
  260. package/src/ui/layout/variables.scss +2 -2
  261. package/src/ui/selection/KeySelection.ts +153 -153
  262. package/src/ui/selection/PropertySelection.ts +87 -87
  263. package/src/ui/selection/Selection.ts +128 -128
  264. package/src/ui/selection/index.ts +3 -3
  265. package/src/ui/tpl.ts +4 -4
  266. package/src/ui/variables.scss +1 -1
  267. package/src/util/Component.spec.ts +411 -411
  268. package/src/util/Console.ts +13 -13
  269. package/src/util/DOM.ts +88 -88
  270. package/src/util/Debug.ts +71 -71
  271. package/src/util/Format.spec.ts +69 -69
  272. package/src/util/Format.ts +267 -267
  273. package/src/util/GlobalCacheIdentifier.ts +11 -11
  274. package/src/util/KeyCode.ts +21 -21
  275. package/src/util/SubscriberList.ts +86 -86
  276. package/src/util/Timing.ts +58 -58
  277. package/src/util/TraversalStack.spec.ts +53 -53
  278. package/src/util/TraversalStack.ts +47 -47
  279. package/src/util/addEventListenerWithOptions.ts +41 -41
  280. package/src/util/browserSupportsPassiveEventHandlers.ts +20 -20
  281. package/src/util/calculateNaturalElementHeight.ts +22 -22
  282. package/src/util/call-once.scss +6 -6
  283. package/src/util/capitalize.ts +4 -4
  284. package/src/util/coalesce.ts +6 -6
  285. package/src/util/color/hslToRgb.ts +34 -34
  286. package/src/util/color/index.ts +4 -4
  287. package/src/util/color/parseColor.ts +173 -173
  288. package/src/util/color/rgbToHex.ts +14 -14
  289. package/src/util/color/rgbToHsl.ts +35 -35
  290. package/src/util/date/dateDiff.ts +9 -9
  291. package/src/util/date/diff.ts +13 -13
  292. package/src/util/date/encodeDate.ts +8 -8
  293. package/src/util/date/encodeDateWithTimezoneOffset.ts +18 -18
  294. package/src/util/date/index.ts +11 -11
  295. package/src/util/date/lowerBoundCheck.ts +13 -13
  296. package/src/util/date/maxDate.ts +14 -14
  297. package/src/util/date/minDate.ts +14 -14
  298. package/src/util/date/monthStart.ts +8 -8
  299. package/src/util/date/parseDateInvariant.ts +20 -20
  300. package/src/util/date/sameDate.ts +11 -11
  301. package/src/util/date/upperBoundCheck.spec.ts +30 -30
  302. package/src/util/date/upperBoundCheck.ts +13 -13
  303. package/src/util/date/zeroTime.ts +9 -9
  304. package/src/util/debounce.ts +26 -26
  305. package/src/util/dummyCallback.ts +1 -1
  306. package/src/util/escapeSpecialRegexCharacters.ts +8 -8
  307. package/src/util/eventCallbacks.ts +12 -12
  308. package/src/util/expandFatArrows.ts +118 -118
  309. package/src/util/findScrollableParent.ts +15 -15
  310. package/src/util/getActiveElement.ts +4 -4
  311. package/src/util/getParentFrameBoundingClientRect.ts +13 -13
  312. package/src/util/getScrollerBoundingClientRect.ts +12 -12
  313. package/src/util/getSearchQueryPredicate.spec.ts +40 -40
  314. package/src/util/getSearchQueryPredicate.ts +58 -58
  315. package/src/util/getTopLevelBoundingClientRect.ts +7 -7
  316. package/src/util/getVendorPrefix.ts +33 -33
  317. package/src/util/hasKey.ts +18 -18
  318. package/src/util/index.scss +10 -10
  319. package/src/util/index.ts +55 -55
  320. package/src/util/innerTextTrim.ts +10 -10
  321. package/src/util/isArray.ts +3 -3
  322. package/src/util/isDataRecord.ts +5 -5
  323. package/src/util/isDefined.ts +3 -3
  324. package/src/util/isDigit.ts +8 -8
  325. package/src/util/isFunction.ts +3 -3
  326. package/src/util/isNonEmptyArray.ts +3 -3
  327. package/src/util/isNumber.ts +3 -3
  328. package/src/util/isObject.ts +3 -3
  329. package/src/util/isPromise.ts +6 -6
  330. package/src/util/isString.ts +3 -3
  331. package/src/util/isTextInputElement.ts +2 -2
  332. package/src/util/isTouchDevice.ts +7 -7
  333. package/src/util/isTouchEvent.ts +64 -64
  334. package/src/util/isUndefined.ts +3 -3
  335. package/src/util/isValidIdentifierName.spec.ts +33 -33
  336. package/src/util/isValidIdentifierName.ts +5 -5
  337. package/src/util/onIdleCallback.ts +10 -10
  338. package/src/util/parseStyle.ts +29 -29
  339. package/src/util/quote.ts +6 -6
  340. package/src/util/reverseSlice.ts +9 -9
  341. package/src/util/routeAppend.spec.ts +19 -19
  342. package/src/util/routeAppend.ts +15 -15
  343. package/src/util/scrollElementIntoView.ts +40 -40
  344. package/src/util/scss/add-rules.scss +40 -40
  345. package/src/util/scss/calc.scss +44 -44
  346. package/src/util/scss/call-once.scss +12 -12
  347. package/src/util/scss/clockwise.scss +49 -49
  348. package/src/util/scss/colors.scss +9 -9
  349. package/src/util/scss/deep-get.scss +11 -11
  350. package/src/util/scss/deep-merge.scss +21 -21
  351. package/src/util/scss/divide.scss +3 -3
  352. package/src/util/scss/include.scss +48 -48
  353. package/src/util/scss/index.scss +9 -9
  354. package/src/util/shallowEquals.ts +43 -43
  355. package/src/util/test/createTestRenderer.tsx +19 -19
  356. package/src/util/throttle.ts +21 -21
  357. package/src/util/validatedDebounce.ts +23 -23
  358. package/src/variables.scss +217 -217
  359. package/src/widgets/AccessorBindings.spec.tsx +90 -90
  360. package/src/widgets/Button.scss +119 -119
  361. package/src/widgets/Button.tsx +189 -189
  362. package/src/widgets/Button.variables.scss +117 -117
  363. package/src/widgets/CxCredit.scss +39 -39
  364. package/src/widgets/CxCredit.tsx +46 -46
  365. package/src/widgets/DocumentTitle.ts +95 -95
  366. package/src/widgets/FlexBox.scss +148 -148
  367. package/src/widgets/FlexBox.tsx +168 -168
  368. package/src/widgets/Heading.scss +40 -40
  369. package/src/widgets/Heading.ts +42 -42
  370. package/src/widgets/HighlightedSearchText.scss +20 -20
  371. package/src/widgets/HighlightedSearchText.tsx +54 -54
  372. package/src/widgets/HtmlElement.spec.helpers.tsx +108 -108
  373. package/src/widgets/HtmlElement.spec.tsx +89 -89
  374. package/src/widgets/HtmlElement.tsx +407 -407
  375. package/src/widgets/Icon.scss +22 -22
  376. package/src/widgets/Icon.ts +64 -64
  377. package/src/widgets/List.scss +93 -93
  378. package/src/widgets/List.tsx +793 -793
  379. package/src/widgets/ProgressBar.scss +50 -50
  380. package/src/widgets/ProgressBar.tsx +66 -66
  381. package/src/widgets/ReactElementWrapper.spec.tsx +452 -452
  382. package/src/widgets/ReactElementWrapper.tsx +108 -108
  383. package/src/widgets/Resizer.scss +43 -43
  384. package/src/widgets/Resizer.tsx +200 -200
  385. package/src/widgets/Sandbox.ts +103 -103
  386. package/src/widgets/Section.scss +55 -55
  387. package/src/widgets/Section.tsx +187 -187
  388. package/src/widgets/animations.scss +10 -10
  389. package/src/widgets/autoFocus.ts +9 -9
  390. package/src/widgets/cx.ts +63 -63
  391. package/src/widgets/drag-drop/DragClone.scss +35 -35
  392. package/src/widgets/drag-drop/DragHandle.scss +18 -18
  393. package/src/widgets/drag-drop/DragHandle.tsx +47 -47
  394. package/src/widgets/drag-drop/DragSource.scss +26 -26
  395. package/src/widgets/drag-drop/DragSource.tsx +237 -237
  396. package/src/widgets/drag-drop/DropZone.scss +76 -76
  397. package/src/widgets/drag-drop/DropZone.tsx +353 -353
  398. package/src/widgets/drag-drop/index.scss +3 -3
  399. package/src/widgets/drag-drop/index.ts +4 -4
  400. package/src/widgets/drag-drop/ops.tsx +422 -422
  401. package/src/widgets/drag-drop/variables.scss +14 -14
  402. package/src/widgets/enableAllInternalDependencies.ts +11 -11
  403. package/src/widgets/form/Calendar.scss +199 -199
  404. package/src/widgets/form/Calendar.tsx +760 -760
  405. package/src/widgets/form/Calendar.variables.scss +63 -63
  406. package/src/widgets/form/Checkbox.scss +129 -129
  407. package/src/widgets/form/Checkbox.tsx +287 -287
  408. package/src/widgets/form/Checkbox.variables.scss +39 -39
  409. package/src/widgets/form/ColorField.scss +98 -98
  410. package/src/widgets/form/ColorField.tsx +497 -497
  411. package/src/widgets/form/ColorPicker.scss +285 -285
  412. package/src/widgets/form/ColorPicker.tsx +544 -544
  413. package/src/widgets/form/ColorPicker.variables.scss +22 -22
  414. package/src/widgets/form/DateField.ts +21 -21
  415. package/src/widgets/form/DateTimeField.scss +92 -92
  416. package/src/widgets/form/DateTimeField.tsx +726 -726
  417. package/src/widgets/form/DateTimePicker.scss +46 -46
  418. package/src/widgets/form/DateTimePicker.tsx +429 -429
  419. package/src/widgets/form/Field.scss +164 -164
  420. package/src/widgets/form/Field.tsx +608 -608
  421. package/src/widgets/form/FieldGroup.ts +10 -10
  422. package/src/widgets/form/FieldIcon.ts +61 -61
  423. package/src/widgets/form/HelpText.scss +24 -24
  424. package/src/widgets/form/HelpText.ts +15 -15
  425. package/src/widgets/form/Label.scss +37 -37
  426. package/src/widgets/form/Label.tsx +117 -117
  427. package/src/widgets/form/LabeledContainer.ts +77 -77
  428. package/src/widgets/form/LookupField.scss +221 -221
  429. package/src/widgets/form/LookupField.spec.tsx +93 -93
  430. package/src/widgets/form/LookupField.tsx +1421 -1421
  431. package/src/widgets/form/MonthField.scss +100 -100
  432. package/src/widgets/form/MonthField.tsx +670 -670
  433. package/src/widgets/form/MonthPicker.scss +125 -125
  434. package/src/widgets/form/MonthPicker.tsx +822 -822
  435. package/src/widgets/form/NumberField.scss +63 -63
  436. package/src/widgets/form/NumberField.tsx +543 -543
  437. package/src/widgets/form/Radio.scss +123 -123
  438. package/src/widgets/form/Radio.tsx +249 -249
  439. package/src/widgets/form/Radio.variables.scss +45 -45
  440. package/src/widgets/form/Select.scss +101 -101
  441. package/src/widgets/form/Select.tsx +327 -327
  442. package/src/widgets/form/Slider.scss +121 -121
  443. package/src/widgets/form/Slider.tsx +473 -473
  444. package/src/widgets/form/Switch.scss +142 -142
  445. package/src/widgets/form/Switch.tsx +176 -176
  446. package/src/widgets/form/TextArea.scss +45 -45
  447. package/src/widgets/form/TextArea.tsx +229 -229
  448. package/src/widgets/form/TextField.scss +57 -57
  449. package/src/widgets/form/TextField.tsx +407 -407
  450. package/src/widgets/form/TimeField.ts +10 -10
  451. package/src/widgets/form/TimeList.tsx +105 -105
  452. package/src/widgets/form/UploadButton.scss +49 -49
  453. package/src/widgets/form/UploadButton.tsx +307 -307
  454. package/src/widgets/form/ValidationError.scss +22 -22
  455. package/src/widgets/form/ValidationError.tsx +72 -72
  456. package/src/widgets/form/ValidationGroup.spec.tsx +147 -147
  457. package/src/widgets/form/ValidationGroup.ts +141 -141
  458. package/src/widgets/form/Validator.ts +60 -60
  459. package/src/widgets/form/Wheel.scss +152 -152
  460. package/src/widgets/form/Wheel.tsx +314 -314
  461. package/src/widgets/form/index.scss +24 -24
  462. package/src/widgets/form/index.ts +28 -28
  463. package/src/widgets/form/variables.scss +355 -355
  464. package/src/widgets/grid/Grid.scss +640 -640
  465. package/src/widgets/grid/Grid.tsx +4243 -4243
  466. package/src/widgets/grid/GridCell.ts +143 -143
  467. package/src/widgets/grid/GridCellEditor.tsx +58 -58
  468. package/src/widgets/grid/GridRow.ts +302 -302
  469. package/src/widgets/grid/GridRowLine.ts +49 -49
  470. package/src/widgets/grid/Pagination.scss +115 -115
  471. package/src/widgets/grid/Pagination.tsx +126 -126
  472. package/src/widgets/grid/TreeNode.scss +90 -90
  473. package/src/widgets/grid/TreeNode.tsx +154 -154
  474. package/src/widgets/grid/createGridCellEditor.tsx +18 -18
  475. package/src/widgets/grid/index.scss +3 -3
  476. package/src/widgets/grid/index.ts +16 -16
  477. package/src/widgets/grid/variables.scss +137 -137
  478. package/src/widgets/icons/arrow-down.svg +3 -3
  479. package/src/widgets/icons/arrow-right.svg +2 -2
  480. package/src/widgets/icons/base.svg +104 -104
  481. package/src/widgets/icons/calendar-old.svg +169 -169
  482. package/src/widgets/icons/calendar.svg +187 -187
  483. package/src/widgets/icons/calendar.tsx +22 -22
  484. package/src/widgets/icons/check.tsx +14 -14
  485. package/src/widgets/icons/clear.svg +74 -74
  486. package/src/widgets/icons/clear.tsx +16 -16
  487. package/src/widgets/icons/close.svg +74 -74
  488. package/src/widgets/icons/close.tsx +20 -20
  489. package/src/widgets/icons/cx.tsx +39 -39
  490. package/src/widgets/icons/drop-down.tsx +16 -16
  491. package/src/widgets/icons/dropdown-arrow.svg +61 -61
  492. package/src/widgets/icons/file.svg +4 -4
  493. package/src/widgets/icons/file.tsx +14 -14
  494. package/src/widgets/icons/folder-open.svg +5 -5
  495. package/src/widgets/icons/folder-open.tsx +16 -16
  496. package/src/widgets/icons/folder.svg +58 -58
  497. package/src/widgets/icons/folder.tsx +14 -14
  498. package/src/widgets/icons/forward.svg +67 -67
  499. package/src/widgets/icons/forward.tsx +23 -23
  500. package/src/widgets/icons/index.ts +14 -14
  501. package/src/widgets/icons/loading.svg +4 -4
  502. package/src/widgets/icons/loading.tsx +25 -25
  503. package/src/widgets/icons/menu.tsx +18 -18
  504. package/src/widgets/icons/pixel-picker.tsx +18 -18
  505. package/src/widgets/icons/registry.ts +56 -56
  506. package/src/widgets/icons/search.svg +107 -107
  507. package/src/widgets/icons/search.tsx +14 -14
  508. package/src/widgets/icons/sort-asc.svg +3 -3
  509. package/src/widgets/icons/sort-asc.tsx +15 -15
  510. package/src/widgets/icons/square.tsx +19 -19
  511. package/src/widgets/index.d.ts +55 -55
  512. package/src/widgets/index.scss +16 -16
  513. package/src/widgets/index.ts +58 -58
  514. package/src/widgets/nav/Link.scss +20 -20
  515. package/src/widgets/nav/Link.ts +11 -11
  516. package/src/widgets/nav/LinkButton.ts +176 -176
  517. package/src/widgets/nav/Menu.scss +76 -76
  518. package/src/widgets/nav/Menu.tsx +489 -489
  519. package/src/widgets/nav/Menu.variables.scss +25 -25
  520. package/src/widgets/nav/MenuItem.scss +130 -130
  521. package/src/widgets/nav/MenuItem.tsx +525 -525
  522. package/src/widgets/nav/MenuSpacer.ts +18 -18
  523. package/src/widgets/nav/RedirectRoute.ts +49 -49
  524. package/src/widgets/nav/Route.spec.tsx +24 -24
  525. package/src/widgets/nav/Route.ts +142 -142
  526. package/src/widgets/nav/Scroller.scss +148 -148
  527. package/src/widgets/nav/Scroller.tsx +252 -252
  528. package/src/widgets/nav/Submenu.ts +6 -6
  529. package/src/widgets/nav/Tab.scss +82 -82
  530. package/src/widgets/nav/Tab.ts +120 -120
  531. package/src/widgets/nav/Tab.variables.scss +84 -84
  532. package/src/widgets/nav/cover.scss +22 -22
  533. package/src/widgets/nav/index.scss +5 -5
  534. package/src/widgets/nav/index.ts +10 -10
  535. package/src/widgets/nav/variables.scss +27 -27
  536. package/src/widgets/overlay/ContextMenu.ts +42 -42
  537. package/src/widgets/overlay/Dropdown.scss +186 -186
  538. package/src/widgets/overlay/Dropdown.tsx +762 -762
  539. package/src/widgets/overlay/FlyweightTooltipTracker.ts +57 -57
  540. package/src/widgets/overlay/MsgBox.tsx +141 -141
  541. package/src/widgets/overlay/Overlay.scss +68 -68
  542. package/src/widgets/overlay/Overlay.tsx +947 -947
  543. package/src/widgets/overlay/Toast.scss +163 -163
  544. package/src/widgets/overlay/Toast.ts +111 -111
  545. package/src/widgets/overlay/Tooltip.scss +177 -177
  546. package/src/widgets/overlay/Tooltip.tsx +393 -393
  547. package/src/widgets/overlay/Window.scss +129 -129
  548. package/src/widgets/overlay/Window.tsx +299 -299
  549. package/src/widgets/overlay/Window.variables.scss +62 -62
  550. package/src/widgets/overlay/alerts.ts +46 -46
  551. package/src/widgets/overlay/captureMouse.scss +13 -13
  552. package/src/widgets/overlay/captureMouse.ts +195 -195
  553. package/src/widgets/overlay/createHotPromiseWindowFactory.ts +71 -71
  554. package/src/widgets/overlay/index.scss +15 -15
  555. package/src/widgets/overlay/index.ts +11 -11
  556. package/src/widgets/overlay/tooltip-ops.ts +173 -173
  557. package/src/widgets/overlay/variables.scss +85 -85
  558. package/src/widgets/variables.scss +146 -146
  559. package/tsconfig.compile.json +4 -4
  560. package/tsconfig.json +34 -34
  561. 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
+ }