@oracle/oraclejet-core-pack 14.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (517) hide show
  1. package/oj-c/Avatar.json +458 -0
  2. package/oj-c/Button.json +536 -0
  3. package/oj-c/Collapsible.json +396 -0
  4. package/oj-c/FilePicker.json +555 -0
  5. package/oj-c/InputNumber.json +1321 -0
  6. package/oj-c/InputPassword.json +1164 -0
  7. package/oj-c/InputText.json +1411 -0
  8. package/oj-c/ListItemLayout.json +313 -0
  9. package/oj-c/MessageToast.json +334 -0
  10. package/oj-c/MeterBar.json +735 -0
  11. package/oj-c/MeterCircle.json +797 -0
  12. package/oj-c/ProgressBar.json +212 -0
  13. package/oj-c/ProgressCircle.json +223 -0
  14. package/oj-c/RatingGauge.json +495 -0
  15. package/oj-c/SelectMultiple.json +1143 -0
  16. package/oj-c/SelectSingle.json +1450 -0
  17. package/oj-c/SplitMenuButton.json +495 -0
  18. package/oj-c/TextArea.json +1283 -0
  19. package/oj-c/avatar/__webdriver__/AvatarWebElement.js +32 -0
  20. package/oj-c/avatar/__webdriver__/AvatarWebElementBase.js +87 -0
  21. package/oj-c/avatar/__webdriver__/index.js +74 -0
  22. package/oj-c/avatar/avatar-styles.css +10 -0
  23. package/oj-c/avatar/avatar.js +27 -0
  24. package/oj-c/avatar/component.json +227 -0
  25. package/oj-c/avatar/index.js +6 -0
  26. package/oj-c/avatar.js +6 -0
  27. package/oj-c/button/__tests__/button.test.js +20 -0
  28. package/oj-c/button/__webdriver__/ButtonWebElement.js +96 -0
  29. package/oj-c/button/__webdriver__/ButtonWebElementBase.js +96 -0
  30. package/oj-c/button/__webdriver__/index.js +74 -0
  31. package/oj-c/button/button-styles.css +11 -0
  32. package/oj-c/button/button.js +71 -0
  33. package/oj-c/button/component.json +243 -0
  34. package/oj-c/button/index.js +6 -0
  35. package/oj-c/button.js +6 -0
  36. package/oj-c/collapsible/__webdriver__/CollapsibleWebElement.js +116 -0
  37. package/oj-c/collapsible/__webdriver__/CollapsibleWebElementBase.js +60 -0
  38. package/oj-c/collapsible/__webdriver__/index.js +74 -0
  39. package/oj-c/collapsible/collapsible-styles.css +11 -0
  40. package/oj-c/collapsible/collapsible.js +69 -0
  41. package/oj-c/collapsible/component.json +184 -0
  42. package/oj-c/collapsible/index.js +6 -0
  43. package/oj-c/collapsible.js +6 -0
  44. package/oj-c/component.json +104 -0
  45. package/oj-c/corepackbundle.js +4049 -0
  46. package/oj-c/docs/avatar.html +149 -0
  47. package/oj-c/docs/button.html +149 -0
  48. package/oj-c/docs/collapsible.html +149 -0
  49. package/oj-c/docs/file-picker.html +149 -0
  50. package/oj-c/docs/index.html +168 -0
  51. package/oj-c/docs/input-number.html +149 -0
  52. package/oj-c/docs/input-password.html +149 -0
  53. package/oj-c/docs/input-text.html +149 -0
  54. package/oj-c/docs/jsDocMd.json +1 -0
  55. package/oj-c/docs/list-item-layout.html +149 -0
  56. package/oj-c/docs/message-toast.html +149 -0
  57. package/oj-c/docs/meter-bar.html +149 -0
  58. package/oj-c/docs/meter-circle.html +149 -0
  59. package/oj-c/docs/oj-c.Avatar.html +1778 -0
  60. package/oj-c/docs/oj-c.Button.html +2065 -0
  61. package/oj-c/docs/oj-c.Collapsible.html +1990 -0
  62. package/oj-c/docs/oj-c.FilePicker.html +2380 -0
  63. package/oj-c/docs/oj-c.InputNumber.html +5850 -0
  64. package/oj-c/docs/oj-c.InputPassword.html +4891 -0
  65. package/oj-c/docs/oj-c.InputText.html +5772 -0
  66. package/oj-c/docs/oj-c.ListItemLayout.html +1549 -0
  67. package/oj-c/docs/oj-c.MessageToast.html +1574 -0
  68. package/oj-c/docs/oj-c.MeterBar.html +3193 -0
  69. package/oj-c/docs/oj-c.MeterCircle.html +3502 -0
  70. package/oj-c/docs/oj-c.ProgressBar.html +1122 -0
  71. package/oj-c/docs/oj-c.ProgressCircle.html +1138 -0
  72. package/oj-c/docs/oj-c.RatingGauge.html +2320 -0
  73. package/oj-c/docs/oj-c.SelectMultiple.html +4720 -0
  74. package/oj-c/docs/oj-c.SelectSingle.html +5920 -0
  75. package/oj-c/docs/oj-c.SplitMenuButton.html +1891 -0
  76. package/oj-c/docs/oj-c.TextArea.html +5447 -0
  77. package/oj-c/docs/progress-bar.html +149 -0
  78. package/oj-c/docs/progress-circle.html +149 -0
  79. package/oj-c/docs/rating-gauge.html +149 -0
  80. package/oj-c/docs/scripts/deprecated.js +268 -0
  81. package/oj-c/docs/scripts/prettify/Apache-License-2.0.txt +202 -0
  82. package/oj-c/docs/scripts/prettify/lang-css.js +9 -0
  83. package/oj-c/docs/scripts/prettify/prettify.js +35 -0
  84. package/oj-c/docs/select-multiple.html +149 -0
  85. package/oj-c/docs/select-single.html +149 -0
  86. package/oj-c/docs/split-menu-button.html +149 -0
  87. package/oj-c/docs/styles/images/bookmark.png +0 -0
  88. package/oj-c/docs/styles/images/linesarrowup.png +0 -0
  89. package/oj-c/docs/styles/images/linesarrowup_blue.png +0 -0
  90. package/oj-c/docs/styles/images/linesarrowup_hov.png +0 -0
  91. package/oj-c/docs/styles/images/linesarrowup_white.png +0 -0
  92. package/oj-c/docs/styles/images/oracle_logo_sm.png +0 -0
  93. package/oj-c/docs/styles/jsdoc-default.css +851 -0
  94. package/oj-c/docs/styles/prettify-jsdoc.css +111 -0
  95. package/oj-c/docs/styles/prettify-tomorrow.css +132 -0
  96. package/oj-c/docs/text-area.html +149 -0
  97. package/oj-c/editable-value/UNSAFE_useAssistiveText/useAssistiveText.js +57 -0
  98. package/oj-c/editable-value/UNSAFE_useComponentMessaging/useComponentMessaging.js +80 -0
  99. package/oj-c/editable-value/UNSAFE_useConverter/useConverter.js +56 -0
  100. package/oj-c/editable-value/UNSAFE_useConverterLifecycle/useConverterLifecycle.js +26 -0
  101. package/oj-c/editable-value/UNSAFE_useDeferredValidators/useDeferredValidators.js +22 -0
  102. package/oj-c/editable-value/UNSAFE_useEditableValue/useEditableValue.js +154 -0
  103. package/oj-c/editable-value/UNSAFE_useStaleIdentity/useStaleIdentity.js +17 -0
  104. package/oj-c/editable-value/UNSAFE_useValidationLifecycle/useValidationLifecycle.js +118 -0
  105. package/oj-c/editable-value/UNSAFE_useValidators/useValidators.js +153 -0
  106. package/oj-c/editable-value/UNSAFE_useValue/useValue.js +42 -0
  107. package/oj-c/editable-value/UNSAFE_useValueLifecycle/useValueLifecycle.js +27 -0
  108. package/oj-c/editable-value/component.json +9 -0
  109. package/oj-c/editable-value/utils/utils.js +31 -0
  110. package/oj-c/file-picker/__webdriver__/FilePickerWebElement.js +32 -0
  111. package/oj-c/file-picker/__webdriver__/FilePickerWebElementBase.js +87 -0
  112. package/oj-c/file-picker/__webdriver__/index.js +74 -0
  113. package/oj-c/file-picker/component.json +209 -0
  114. package/oj-c/file-picker/file-picker-styles.css +17 -0
  115. package/oj-c/file-picker/file-picker.js +59 -0
  116. package/oj-c/file-picker/index.js +6 -0
  117. package/oj-c/file-picker.js +6 -0
  118. package/oj-c/hooks/UNSAFE_useDataProvider/DataProviderHandler.js +89 -0
  119. package/oj-c/hooks/UNSAFE_useDataProvider/useDataProvider.js +25 -0
  120. package/oj-c/hooks/UNSAFE_useDataProvider/utils.js +202 -0
  121. package/oj-c/hooks/UNSAFE_useListData/__tests__/useListData.test.js +124 -0
  122. package/oj-c/hooks/UNSAFE_useListData/useListData.js +297 -0
  123. package/oj-c/hooks/UNSAFE_useTreeData/__tests__/useTreeData.test.js +62 -0
  124. package/oj-c/hooks/UNSAFE_useTreeData/useTreeData.js +130 -0
  125. package/oj-c/hooks/component.json +9 -0
  126. package/oj-c/input-number/__dev__/input-number.doc.mdx +31 -0
  127. package/oj-c/input-number/__webdriver__/InputNumberWebElement.js +32 -0
  128. package/oj-c/input-number/__webdriver__/InputNumberWebElementBase.js +339 -0
  129. package/oj-c/input-number/__webdriver__/index.js +74 -0
  130. package/oj-c/input-number/component.json +536 -0
  131. package/oj-c/input-number/index.js +6 -0
  132. package/oj-c/input-number/input-number-styles.css +13 -0
  133. package/oj-c/input-number/input-number.js +119 -0
  134. package/oj-c/input-number/stepBasisUtils.js +76 -0
  135. package/oj-c/input-number/useImplicitNumberConverter.js +12 -0
  136. package/oj-c/input-number/useImplicitNumberRangeValidator.js +28 -0
  137. package/oj-c/input-number/useNumberInputTextPreact.js +153 -0
  138. package/oj-c/input-number.js +6 -0
  139. package/oj-c/input-password/__webdriver__/InputPasswordWebElement.js +32 -0
  140. package/oj-c/input-password/__webdriver__/InputPasswordWebElementBase.js +258 -0
  141. package/oj-c/input-password/__webdriver__/index.js +74 -0
  142. package/oj-c/input-password/component.json +488 -0
  143. package/oj-c/input-password/index.js +6 -0
  144. package/oj-c/input-password/input-password-styles.css +13 -0
  145. package/oj-c/input-password/input-password.js +112 -0
  146. package/oj-c/input-password/useInputPasswordPreact.js +46 -0
  147. package/oj-c/input-password.js +6 -0
  148. package/oj-c/input-text/__dev__/input-text.doc.mdx +30 -0
  149. package/oj-c/input-text/__tests__/input-text.test.js +70 -0
  150. package/oj-c/input-text/__webdriver__/InputTextWebElement.js +32 -0
  151. package/oj-c/input-text/__webdriver__/InputTextWebElementBase.js +294 -0
  152. package/oj-c/input-text/__webdriver__/index.js +74 -0
  153. package/oj-c/input-text/component.json +580 -0
  154. package/oj-c/input-text/index.js +6 -0
  155. package/oj-c/input-text/input-text-styles.css +13 -0
  156. package/oj-c/input-text/input-text.js +118 -0
  157. package/oj-c/input-text/useInputTextPreact.js +46 -0
  158. package/oj-c/input-text.js +6 -0
  159. package/oj-c/list-item-layout/__webdriver__/ListItemLayoutWebElement.js +32 -0
  160. package/oj-c/list-item-layout/__webdriver__/ListItemLayoutWebElementBase.js +42 -0
  161. package/oj-c/list-item-layout/__webdriver__/index.js +74 -0
  162. package/oj-c/list-item-layout/component.json +139 -0
  163. package/oj-c/list-item-layout/index.js +6 -0
  164. package/oj-c/list-item-layout/list-item-layout-styles.css +12 -0
  165. package/oj-c/list-item-layout/list-item-layout.js +30 -0
  166. package/oj-c/list-item-layout.js +6 -0
  167. package/oj-c/message-toast/__webdriver__/MessageToastWebElement.js +32 -0
  168. package/oj-c/message-toast/__webdriver__/MessageToastWebElementBase.js +78 -0
  169. package/oj-c/message-toast/__webdriver__/index.js +74 -0
  170. package/oj-c/message-toast/component.json +244 -0
  171. package/oj-c/message-toast/index.js +6 -0
  172. package/oj-c/message-toast/message-toast-styles.css +8 -0
  173. package/oj-c/message-toast/message-toast.js +35 -0
  174. package/oj-c/message-toast.js +6 -0
  175. package/oj-c/metadata/allComponents.json +5552 -0
  176. package/oj-c/meter-bar/__webdriver__/MeterBarWebElement.js +32 -0
  177. package/oj-c/meter-bar/__webdriver__/MeterBarWebElementBase.js +195 -0
  178. package/oj-c/meter-bar/__webdriver__/index.js +74 -0
  179. package/oj-c/meter-bar/component.json +246 -0
  180. package/oj-c/meter-bar/index.js +6 -0
  181. package/oj-c/meter-bar/meter-bar-styles.css +21 -0
  182. package/oj-c/meter-bar/meter-bar.js +44 -0
  183. package/oj-c/meter-bar.js +6 -0
  184. package/oj-c/meter-circle/__webdriver__/MeterCircleWebElement.js +32 -0
  185. package/oj-c/meter-circle/__webdriver__/MeterCircleWebElementBase.js +213 -0
  186. package/oj-c/meter-circle/__webdriver__/index.js +74 -0
  187. package/oj-c/meter-circle/component.json +289 -0
  188. package/oj-c/meter-circle/index.js +6 -0
  189. package/oj-c/meter-circle/meter-circle-styles.css +14 -0
  190. package/oj-c/meter-circle/meter-circle.js +47 -0
  191. package/oj-c/meter-circle.js +6 -0
  192. package/oj-c/min/avatar/avatar-styles.css +10 -0
  193. package/oj-c/min/avatar.js +2 -0
  194. package/oj-c/min/avatar.js.map +1 -0
  195. package/oj-c/min/button/button-styles.css +11 -0
  196. package/oj-c/min/button.js +2 -0
  197. package/oj-c/min/button.js.map +1 -0
  198. package/oj-c/min/collapsible/collapsible-styles.css +11 -0
  199. package/oj-c/min/collapsible.js +2 -0
  200. package/oj-c/min/collapsible.js.map +1 -0
  201. package/oj-c/min/corepackbundle.css +226 -0
  202. package/oj-c/min/corepackbundle.js +6 -0
  203. package/oj-c/min/corepackbundle.js.map +1 -0
  204. package/oj-c/min/editable-value/UNSAFE_useAssistiveText/useAssistiveText.d.ts +32 -0
  205. package/oj-c/min/editable-value/UNSAFE_useAssistiveText/useAssistiveText.js +57 -0
  206. package/oj-c/min/editable-value/UNSAFE_useComponentMessaging/useComponentMessaging.d.ts +24 -0
  207. package/oj-c/min/editable-value/UNSAFE_useComponentMessaging/useComponentMessaging.js +80 -0
  208. package/oj-c/min/editable-value/UNSAFE_useConverter/useConverter.d.ts +14 -0
  209. package/oj-c/min/editable-value/UNSAFE_useConverter/useConverter.js +56 -0
  210. package/oj-c/min/editable-value/UNSAFE_useConverterLifecycle/useConverterLifecycle.d.ts +11 -0
  211. package/oj-c/min/editable-value/UNSAFE_useConverterLifecycle/useConverterLifecycle.js +26 -0
  212. package/oj-c/min/editable-value/UNSAFE_useDeferredValidators/useDeferredValidators.d.ts +8 -0
  213. package/oj-c/min/editable-value/UNSAFE_useDeferredValidators/useDeferredValidators.js +22 -0
  214. package/oj-c/min/editable-value/UNSAFE_useEditableValue/useEditableValue.d.ts +47 -0
  215. package/oj-c/min/editable-value/UNSAFE_useEditableValue/useEditableValue.js +154 -0
  216. package/oj-c/min/editable-value/UNSAFE_useStaleIdentity/useStaleIdentity.d.ts +5 -0
  217. package/oj-c/min/editable-value/UNSAFE_useStaleIdentity/useStaleIdentity.js +17 -0
  218. package/oj-c/min/editable-value/UNSAFE_useValidationLifecycle/useValidationLifecycle.d.ts +15 -0
  219. package/oj-c/min/editable-value/UNSAFE_useValidationLifecycle/useValidationLifecycle.js +118 -0
  220. package/oj-c/min/editable-value/UNSAFE_useValidators/useValidators.d.ts +35 -0
  221. package/oj-c/min/editable-value/UNSAFE_useValidators/useValidators.js +153 -0
  222. package/oj-c/min/editable-value/UNSAFE_useValue/useValue.d.ts +23 -0
  223. package/oj-c/min/editable-value/UNSAFE_useValue/useValue.js +42 -0
  224. package/oj-c/min/editable-value/UNSAFE_useValueLifecycle/useValueLifecycle.d.ts +9 -0
  225. package/oj-c/min/editable-value/UNSAFE_useValueLifecycle/useValueLifecycle.js +27 -0
  226. package/oj-c/min/editable-value/component.json +9 -0
  227. package/oj-c/min/editable-value/utils/utils.d.ts +6 -0
  228. package/oj-c/min/editable-value/utils/utils.js +31 -0
  229. package/oj-c/min/file-picker/file-picker-styles.css +17 -0
  230. package/oj-c/min/file-picker.js +2 -0
  231. package/oj-c/min/file-picker.js.map +1 -0
  232. package/oj-c/min/hooks/UNSAFE_useDataProvider/DataProviderHandler.d.ts +18 -0
  233. package/oj-c/min/hooks/UNSAFE_useDataProvider/DataProviderHandler.js +89 -0
  234. package/oj-c/min/hooks/UNSAFE_useDataProvider/useDataProvider.d.ts +10 -0
  235. package/oj-c/min/hooks/UNSAFE_useDataProvider/useDataProvider.js +25 -0
  236. package/oj-c/min/hooks/UNSAFE_useDataProvider/utils.d.ts +3 -0
  237. package/oj-c/min/hooks/UNSAFE_useDataProvider/utils.js +202 -0
  238. package/oj-c/min/hooks/UNSAFE_useListData/__tests__/useListData.test.d.ts +1 -0
  239. package/oj-c/min/hooks/UNSAFE_useListData/__tests__/useListData.test.js +124 -0
  240. package/oj-c/min/hooks/UNSAFE_useListData/useListData.d.ts +21 -0
  241. package/oj-c/min/hooks/UNSAFE_useListData/useListData.js +297 -0
  242. package/oj-c/min/hooks/UNSAFE_useTreeData/__tests__/useTreeData.test.d.ts +1 -0
  243. package/oj-c/min/hooks/UNSAFE_useTreeData/__tests__/useTreeData.test.js +62 -0
  244. package/oj-c/min/hooks/UNSAFE_useTreeData/useTreeData.d.ts +27 -0
  245. package/oj-c/min/hooks/UNSAFE_useTreeData/useTreeData.js +130 -0
  246. package/oj-c/min/hooks/component.json +9 -0
  247. package/oj-c/min/input-number/input-number-styles.css +13 -0
  248. package/oj-c/min/input-number.js +2 -0
  249. package/oj-c/min/input-number.js.map +1 -0
  250. package/oj-c/min/input-password/input-password-styles.css +13 -0
  251. package/oj-c/min/input-password.js +2 -0
  252. package/oj-c/min/input-password.js.map +1 -0
  253. package/oj-c/min/input-text/input-text-styles.css +13 -0
  254. package/oj-c/min/input-text.js +2 -0
  255. package/oj-c/min/input-text.js.map +1 -0
  256. package/oj-c/min/list-item-layout/list-item-layout-styles.css +12 -0
  257. package/oj-c/min/list-item-layout.js +2 -0
  258. package/oj-c/min/list-item-layout.js.map +1 -0
  259. package/oj-c/min/message-toast/message-toast-styles.css +8 -0
  260. package/oj-c/min/message-toast.js +2 -0
  261. package/oj-c/min/message-toast.js.map +1 -0
  262. package/oj-c/min/meter-bar/meter-bar-styles.css +21 -0
  263. package/oj-c/min/meter-bar.js +2 -0
  264. package/oj-c/min/meter-bar.js.map +1 -0
  265. package/oj-c/min/meter-circle/meter-circle-styles.css +14 -0
  266. package/oj-c/min/meter-circle.js +2 -0
  267. package/oj-c/min/meter-circle.js.map +1 -0
  268. package/oj-c/min/progress-bar/progress-bar-styles.css +11 -0
  269. package/oj-c/min/progress-bar.js +2 -0
  270. package/oj-c/min/progress-bar.js.map +1 -0
  271. package/oj-c/min/progress-circle/progress-circle-styles.css +14 -0
  272. package/oj-c/min/progress-circle.js +2 -0
  273. package/oj-c/min/progress-circle.js.map +1 -0
  274. package/oj-c/min/rating-gauge/rating-gauge-styles.css +12 -0
  275. package/oj-c/min/rating-gauge.js +2 -0
  276. package/oj-c/min/rating-gauge.js.map +1 -0
  277. package/oj-c/min/select-common/UNSAFE_useDataProviderListeners/index.d.ts +2 -0
  278. package/oj-c/min/select-common/UNSAFE_useDataProviderListeners/index.js +6 -0
  279. package/oj-c/min/select-common/UNSAFE_useDataProviderListeners/useDataProviderListeners.d.ts +13 -0
  280. package/oj-c/min/select-common/UNSAFE_useDataProviderListeners/useDataProviderListeners.js +96 -0
  281. package/oj-c/min/select-common/UNSAFE_useWrapDataProvider/index.d.ts +1 -0
  282. package/oj-c/min/select-common/UNSAFE_useWrapDataProvider/index.js +6 -0
  283. package/oj-c/min/select-common/UNSAFE_useWrapDataProvider/useWrapDataProvider.d.ts +3 -0
  284. package/oj-c/min/select-common/UNSAFE_useWrapDataProvider/useWrapDataProvider.js +16 -0
  285. package/oj-c/min/select-common/UNSAFE_useWrapValueState/index.d.ts +1 -0
  286. package/oj-c/min/select-common/UNSAFE_useWrapValueState/index.js +6 -0
  287. package/oj-c/min/select-common/UNSAFE_useWrapValueState/useWrapValueState.d.ts +23 -0
  288. package/oj-c/min/select-common/UNSAFE_useWrapValueState/useWrapValueState.js +23 -0
  289. package/oj-c/min/select-common/component.json +9 -0
  290. package/oj-c/min/select-common/utils/utils.d.ts +10 -0
  291. package/oj-c/min/select-common/utils/utils.js +19 -0
  292. package/oj-c/min/select-multiple/select-multiple-styles.css +13 -0
  293. package/oj-c/min/select-multiple.js +3 -0
  294. package/oj-c/min/select-multiple.js.map +1 -0
  295. package/oj-c/min/select-single/select-single-styles.css +22 -0
  296. package/oj-c/min/select-single.js +3 -0
  297. package/oj-c/min/select-single.js.map +1 -0
  298. package/oj-c/min/split-menu-button/split-menu-button-styles.css +11 -0
  299. package/oj-c/min/split-menu-button.js +2 -0
  300. package/oj-c/min/split-menu-button.js.map +1 -0
  301. package/oj-c/min/text-area/text-area-styles.css +13 -0
  302. package/oj-c/min/text-area.js +2 -0
  303. package/oj-c/min/text-area.js.map +1 -0
  304. package/oj-c/min/utils/UNSAFE_focusTabUtils/focusUtils.d.ts +2 -0
  305. package/oj-c/min/utils/UNSAFE_focusTabUtils/focusUtils.js +23 -0
  306. package/oj-c/min/utils/UNSAFE_focusTabUtils/index.d.ts +1 -0
  307. package/oj-c/min/utils/UNSAFE_focusTabUtils/index.js +6 -0
  308. package/oj-c/min/utils/UNSAFE_keyUtils/index.d.ts +1 -0
  309. package/oj-c/min/utils/UNSAFE_keyUtils/index.js +19 -0
  310. package/oj-c/min/utils/UNSAFE_keyUtils/keySetUtils.d.ts +4 -0
  311. package/oj-c/min/utils/UNSAFE_keyUtils/keySetUtils.js +33 -0
  312. package/oj-c/min/utils/UNSAFE_meterUtils/index.d.ts +1 -0
  313. package/oj-c/min/utils/UNSAFE_meterUtils/index.js +6 -0
  314. package/oj-c/min/utils/UNSAFE_meterUtils/meterUtils.d.ts +2 -0
  315. package/oj-c/min/utils/UNSAFE_meterUtils/meterUtils.js +12 -0
  316. package/oj-c/min/utils/component.json +9 -0
  317. package/oj-c/progress-bar/__webdriver__/ProgressBarWebElement.js +32 -0
  318. package/oj-c/progress-bar/__webdriver__/ProgressBarWebElementBase.js +60 -0
  319. package/oj-c/progress-bar/__webdriver__/index.js +74 -0
  320. package/oj-c/progress-bar/component.json +123 -0
  321. package/oj-c/progress-bar/index.js +6 -0
  322. package/oj-c/progress-bar/progress-bar-styles.css +11 -0
  323. package/oj-c/progress-bar/progress-bar.js +26 -0
  324. package/oj-c/progress-bar.js +6 -0
  325. package/oj-c/progress-circle/__webdriver__/ProgressCircleWebElement.js +32 -0
  326. package/oj-c/progress-circle/__webdriver__/ProgressCircleWebElementBase.js +60 -0
  327. package/oj-c/progress-circle/__webdriver__/index.js +74 -0
  328. package/oj-c/progress-circle/component.json +128 -0
  329. package/oj-c/progress-circle/index.js +6 -0
  330. package/oj-c/progress-circle/progress-circle-styles.css +14 -0
  331. package/oj-c/progress-circle/progress-circle.js +26 -0
  332. package/oj-c/progress-circle.js +6 -0
  333. package/oj-c/rating-gauge/__webdriver__/RatingGaugeWebElement.js +32 -0
  334. package/oj-c/rating-gauge/__webdriver__/RatingGaugeWebElementBase.js +168 -0
  335. package/oj-c/rating-gauge/__webdriver__/index.js +74 -0
  336. package/oj-c/rating-gauge/component.json +188 -0
  337. package/oj-c/rating-gauge/index.js +6 -0
  338. package/oj-c/rating-gauge/rating-gauge-styles.css +12 -0
  339. package/oj-c/rating-gauge/rating-gauge.js +44 -0
  340. package/oj-c/rating-gauge.js +6 -0
  341. package/oj-c/select-common/UNSAFE_useDataProviderListeners/index.js +6 -0
  342. package/oj-c/select-common/UNSAFE_useDataProviderListeners/useDataProviderListeners.js +96 -0
  343. package/oj-c/select-common/UNSAFE_useWrapDataProvider/index.js +6 -0
  344. package/oj-c/select-common/UNSAFE_useWrapDataProvider/useWrapDataProvider.js +16 -0
  345. package/oj-c/select-common/UNSAFE_useWrapValueState/index.js +6 -0
  346. package/oj-c/select-common/UNSAFE_useWrapValueState/useWrapValueState.js +23 -0
  347. package/oj-c/select-common/component.json +9 -0
  348. package/oj-c/select-common/utils/utils.js +19 -0
  349. package/oj-c/select-multiple/__dev__/select-multiple.doc.mdx +30 -0
  350. package/oj-c/select-multiple/__webdriver__/SelectMultipleWebElement.js +32 -0
  351. package/oj-c/select-multiple/__webdriver__/SelectMultipleWebElementBase.js +258 -0
  352. package/oj-c/select-multiple/__webdriver__/index.js +74 -0
  353. package/oj-c/select-multiple/component.json +475 -0
  354. package/oj-c/select-multiple/index.js +6 -0
  355. package/oj-c/select-multiple/select-multiple-styles.css +13 -0
  356. package/oj-c/select-multiple/select-multiple.js +108 -0
  357. package/oj-c/select-multiple/useSelectMultiplePreact.js +123 -0
  358. package/oj-c/select-multiple/useSyncValueAndValueItems.js +125 -0
  359. package/oj-c/select-multiple/useValueItems.js +22 -0
  360. package/oj-c/select-multiple.js +6 -0
  361. package/oj-c/select-single/__dev__/select-single.doc.mdx +30 -0
  362. package/oj-c/select-single/__webdriver__/SelectSingleWebElement.js +32 -0
  363. package/oj-c/select-single/__webdriver__/SelectSingleWebElementBase.js +258 -0
  364. package/oj-c/select-single/__webdriver__/index.js +74 -0
  365. package/oj-c/select-single/component.json +545 -0
  366. package/oj-c/select-single/index.js +6 -0
  367. package/oj-c/select-single/select-single-styles.css +22 -0
  368. package/oj-c/select-single/select-single.js +108 -0
  369. package/oj-c/select-single/useSelectSinglePreact.js +157 -0
  370. package/oj-c/select-single/useSyncValueAndValueItem.js +110 -0
  371. package/oj-c/select-single/useValueItem.js +18 -0
  372. package/oj-c/select-single.js +6 -0
  373. package/oj-c/split-menu-button/__dev__/split-menu-button.doc.mdx +32 -0
  374. package/oj-c/split-menu-button/__tests__/split-menu-button.test.js +17 -0
  375. package/oj-c/split-menu-button/__webdriver__/SplitMenuButtonWebElement.js +32 -0
  376. package/oj-c/split-menu-button/__webdriver__/SplitMenuButtonWebElementBase.js +87 -0
  377. package/oj-c/split-menu-button/__webdriver__/index.js +74 -0
  378. package/oj-c/split-menu-button/component.json +205 -0
  379. package/oj-c/split-menu-button/index.js +6 -0
  380. package/oj-c/split-menu-button/split-menu-button-styles.css +11 -0
  381. package/oj-c/split-menu-button/split-menu-button.js +76 -0
  382. package/oj-c/split-menu-button.js +6 -0
  383. package/oj-c/text-area/__webdriver__/TextAreaWebElement.js +32 -0
  384. package/oj-c/text-area/__webdriver__/TextAreaWebElementBase.js +285 -0
  385. package/oj-c/text-area/__webdriver__/index.js +74 -0
  386. package/oj-c/text-area/component.json +497 -0
  387. package/oj-c/text-area/index.js +6 -0
  388. package/oj-c/text-area/text-area-styles.css +13 -0
  389. package/oj-c/text-area/text-area.js +138 -0
  390. package/oj-c/text-area/useTextAreaAutosizePreact.js +44 -0
  391. package/oj-c/text-area/useTextAreaPreact.js +46 -0
  392. package/oj-c/text-area.js +6 -0
  393. package/oj-c/types/avatar/avatar.d.ts +68 -0
  394. package/oj-c/types/avatar/index.d.ts +2 -0
  395. package/oj-c/types/button/__tests__/button.test.d.ts +1 -0
  396. package/oj-c/types/button/button.d.ts +91 -0
  397. package/oj-c/types/button/index.d.ts +2 -0
  398. package/oj-c/types/collapsible/collapsible.d.ts +88 -0
  399. package/oj-c/types/collapsible/index.d.ts +2 -0
  400. package/oj-c/types/editable-value/UNSAFE_useAssistiveText/useAssistiveText.d.ts +32 -0
  401. package/oj-c/types/editable-value/UNSAFE_useComponentMessaging/useComponentMessaging.d.ts +24 -0
  402. package/oj-c/types/editable-value/UNSAFE_useConverter/useConverter.d.ts +14 -0
  403. package/oj-c/types/editable-value/UNSAFE_useConverterLifecycle/useConverterLifecycle.d.ts +11 -0
  404. package/oj-c/types/editable-value/UNSAFE_useDeferredValidators/useDeferredValidators.d.ts +8 -0
  405. package/oj-c/types/editable-value/UNSAFE_useEditableValue/useEditableValue.d.ts +47 -0
  406. package/oj-c/types/editable-value/UNSAFE_useStaleIdentity/useStaleIdentity.d.ts +5 -0
  407. package/oj-c/types/editable-value/UNSAFE_useValidationLifecycle/useValidationLifecycle.d.ts +15 -0
  408. package/oj-c/types/editable-value/UNSAFE_useValidators/useValidators.d.ts +35 -0
  409. package/oj-c/types/editable-value/UNSAFE_useValue/useValue.d.ts +23 -0
  410. package/oj-c/types/editable-value/UNSAFE_useValueLifecycle/useValueLifecycle.d.ts +9 -0
  411. package/oj-c/types/editable-value/utils/utils.d.ts +6 -0
  412. package/oj-c/types/file-picker/file-picker.d.ts +103 -0
  413. package/oj-c/types/file-picker/index.d.ts +2 -0
  414. package/oj-c/types/hooks/UNSAFE_useDataProvider/DataProviderHandler.d.ts +18 -0
  415. package/oj-c/types/hooks/UNSAFE_useDataProvider/useDataProvider.d.ts +10 -0
  416. package/oj-c/types/hooks/UNSAFE_useDataProvider/utils.d.ts +3 -0
  417. package/oj-c/types/hooks/UNSAFE_useListData/__tests__/useListData.test.d.ts +1 -0
  418. package/oj-c/types/hooks/UNSAFE_useListData/useListData.d.ts +21 -0
  419. package/oj-c/types/hooks/UNSAFE_useTreeData/__tests__/useTreeData.test.d.ts +1 -0
  420. package/oj-c/types/hooks/UNSAFE_useTreeData/useTreeData.d.ts +27 -0
  421. package/oj-c/types/input-number/index.d.ts +2 -0
  422. package/oj-c/types/input-number/input-number.d.ts +231 -0
  423. package/oj-c/types/input-number/stepBasisUtils.d.ts +1 -0
  424. package/oj-c/types/input-number/useImplicitNumberConverter.d.ts +10 -0
  425. package/oj-c/types/input-number/useImplicitNumberRangeValidator.d.ts +17 -0
  426. package/oj-c/types/input-number/useNumberInputTextPreact.d.ts +54 -0
  427. package/oj-c/types/input-password/index.d.ts +2 -0
  428. package/oj-c/types/input-password/input-password.d.ts +183 -0
  429. package/oj-c/types/input-password/useInputPasswordPreact.d.ts +40 -0
  430. package/oj-c/types/input-text/__tests__/input-text.test.d.ts +1 -0
  431. package/oj-c/types/input-text/index.d.ts +2 -0
  432. package/oj-c/types/input-text/input-text.d.ts +212 -0
  433. package/oj-c/types/input-text/useInputTextPreact.d.ts +47 -0
  434. package/oj-c/types/list-item-layout/index.d.ts +2 -0
  435. package/oj-c/types/list-item-layout/list-item-layout.d.ts +53 -0
  436. package/oj-c/types/message-toast/index.d.ts +2 -0
  437. package/oj-c/types/message-toast/message-toast.d.ts +83 -0
  438. package/oj-c/types/meter-bar/index.d.ts +2 -0
  439. package/oj-c/types/meter-bar/meter-bar.d.ts +133 -0
  440. package/oj-c/types/meter-circle/index.d.ts +2 -0
  441. package/oj-c/types/meter-circle/meter-circle.d.ts +148 -0
  442. package/oj-c/types/progress-bar/index.d.ts +2 -0
  443. package/oj-c/types/progress-bar/progress-bar.d.ts +53 -0
  444. package/oj-c/types/progress-circle/index.d.ts +2 -0
  445. package/oj-c/types/progress-circle/progress-circle.d.ts +53 -0
  446. package/oj-c/types/rating-gauge/index.d.ts +2 -0
  447. package/oj-c/types/rating-gauge/rating-gauge.d.ts +109 -0
  448. package/oj-c/types/select-common/UNSAFE_useDataProviderListeners/index.d.ts +2 -0
  449. package/oj-c/types/select-common/UNSAFE_useDataProviderListeners/useDataProviderListeners.d.ts +13 -0
  450. package/oj-c/types/select-common/UNSAFE_useWrapDataProvider/index.d.ts +1 -0
  451. package/oj-c/types/select-common/UNSAFE_useWrapDataProvider/useWrapDataProvider.d.ts +3 -0
  452. package/oj-c/types/select-common/UNSAFE_useWrapValueState/index.d.ts +1 -0
  453. package/oj-c/types/select-common/UNSAFE_useWrapValueState/useWrapValueState.d.ts +23 -0
  454. package/oj-c/types/select-common/utils/utils.d.ts +10 -0
  455. package/oj-c/types/select-multiple/index.d.ts +2 -0
  456. package/oj-c/types/select-multiple/select-multiple.d.ts +176 -0
  457. package/oj-c/types/select-multiple/useSelectMultiplePreact.d.ts +42 -0
  458. package/oj-c/types/select-multiple/useSyncValueAndValueItems.d.ts +17 -0
  459. package/oj-c/types/select-multiple/useValueItems.d.ts +6 -0
  460. package/oj-c/types/select-single/index.d.ts +2 -0
  461. package/oj-c/types/select-single/select-single.d.ts +186 -0
  462. package/oj-c/types/select-single/useSelectSinglePreact.d.ts +42 -0
  463. package/oj-c/types/select-single/useSyncValueAndValueItem.d.ts +17 -0
  464. package/oj-c/types/select-single/useValueItem.d.ts +5 -0
  465. package/oj-c/types/split-menu-button/__tests__/split-menu-button.test.d.ts +1 -0
  466. package/oj-c/types/split-menu-button/index.d.ts +2 -0
  467. package/oj-c/types/split-menu-button/split-menu-button.d.ts +93 -0
  468. package/oj-c/types/text-area/index.d.ts +2 -0
  469. package/oj-c/types/text-area/text-area.d.ts +209 -0
  470. package/oj-c/types/text-area/useTextAreaAutosizePreact.d.ts +44 -0
  471. package/oj-c/types/text-area/useTextAreaPreact.d.ts +44 -0
  472. package/oj-c/types/utils/UNSAFE_focusTabUtils/focusUtils.d.ts +2 -0
  473. package/oj-c/types/utils/UNSAFE_focusTabUtils/index.d.ts +1 -0
  474. package/oj-c/types/utils/UNSAFE_keyUtils/index.d.ts +1 -0
  475. package/oj-c/types/utils/UNSAFE_keyUtils/keySetUtils.d.ts +4 -0
  476. package/oj-c/types/utils/UNSAFE_meterUtils/index.d.ts +1 -0
  477. package/oj-c/types/utils/UNSAFE_meterUtils/meterUtils.d.ts +2 -0
  478. package/oj-c/utils/UNSAFE_focusTabUtils/focusUtils.js +23 -0
  479. package/oj-c/utils/UNSAFE_focusTabUtils/index.js +6 -0
  480. package/oj-c/utils/UNSAFE_keyUtils/index.js +19 -0
  481. package/oj-c/utils/UNSAFE_keyUtils/keySetUtils.js +33 -0
  482. package/oj-c/utils/UNSAFE_meterUtils/index.js +6 -0
  483. package/oj-c/utils/UNSAFE_meterUtils/meterUtils.js +12 -0
  484. package/oj-c/utils/component.json +9 -0
  485. package/package.json +22 -0
  486. package/webdriver/docs/.nojekyll +1 -0
  487. package/webdriver/docs/assets/highlight.css +78 -0
  488. package/webdriver/docs/assets/icons.css +1043 -0
  489. package/webdriver/docs/assets/icons.png +0 -0
  490. package/webdriver/docs/assets/icons@2x.png +0 -0
  491. package/webdriver/docs/assets/main.js +52 -0
  492. package/webdriver/docs/assets/search.js +1 -0
  493. package/webdriver/docs/assets/style.css +1414 -0
  494. package/webdriver/docs/assets/widgets.png +0 -0
  495. package/webdriver/docs/assets/widgets@2x.png +0 -0
  496. package/webdriver/docs/classes/AvatarWebElement.html +117 -0
  497. package/webdriver/docs/classes/ButtonWebElement.html +163 -0
  498. package/webdriver/docs/classes/CollapsibleWebElement.html +111 -0
  499. package/webdriver/docs/classes/FilePickerWebElement.html +117 -0
  500. package/webdriver/docs/classes/InputNumberWebElement.html +231 -0
  501. package/webdriver/docs/classes/InputPasswordWebElement.html +195 -0
  502. package/webdriver/docs/classes/InputTextWebElement.html +211 -0
  503. package/webdriver/docs/classes/ListItemLayoutWebElement.html +97 -0
  504. package/webdriver/docs/classes/MessageToastWebElement.html +113 -0
  505. package/webdriver/docs/classes/MeterBarWebElement.html +153 -0
  506. package/webdriver/docs/classes/MeterCircleWebElement.html +159 -0
  507. package/webdriver/docs/classes/ProgressBarWebElement.html +105 -0
  508. package/webdriver/docs/classes/ProgressCircleWebElement.html +105 -0
  509. package/webdriver/docs/classes/RatingGaugeWebElement.html +147 -0
  510. package/webdriver/docs/classes/SelectMultipleWebElement.html +196 -0
  511. package/webdriver/docs/classes/SelectSingleWebElement.html +196 -0
  512. package/webdriver/docs/classes/SplitMenuButtonWebElement.html +117 -0
  513. package/webdriver/docs/classes/TextAreaWebElement.html +207 -0
  514. package/webdriver/docs/index.html +16 -0
  515. package/webdriver/docs/modules.html +181 -0
  516. package/webdriver/index.js +34 -0
  517. package/webdriver/index.ts +18 -0
@@ -0,0 +1,4891 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <title>Element: &lt;oj-c-input-password></title>
6
+
7
+ <script src="scripts/prettify/prettify.js"> </script>
8
+ <script src="scripts/prettify/lang-css.js"> </script>
9
+ <!--[if lt IE 9]>
10
+ <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
11
+ <![endif]-->
12
+ <script src="scripts/deprecated.js"></script>
13
+
14
+ <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
15
+ <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
16
+ </head>
17
+
18
+ <body>
19
+
20
+
21
+ <nav id="nav" data-current-item="navItem23">
22
+ <h2>Oracle® JET</h2>
23
+ <h2>Core Pack Components</h2>
24
+ <h3>14.0.0</h3
25
+ <div class="deprecation-checkboxes" style="display: none">
26
+ <ul style="list-style: none; display: none;">
27
+ <li style="margin-top:0px">
28
+ <label for="deprecated">
29
+ <div class="deprecated-cb-common"><input type="checkbox" id="deprecated"><span style="padding:2px">Show Deprecated APIs</span></div>
30
+ </label>
31
+ </li>
32
+ <li style="margin-top:0px">
33
+ <label for="jsonly"></label>
34
+ <div class="deprecated-cb-common"><input type="checkbox" id="jsonly"><span style="padding:2px 12px 2px 2px">Javascript Only APIs</span></div>
35
+ </li>
36
+ </ul>
37
+ </div>
38
+ <ul><li id="idx"><h2 id="navIndex"><a href="index.html" id="navIndexFocusable">Index</a></h2></li><li><div id="nav_toggle">
39
+ <input type="radio" id="elements_rb" name="toggle" value="Elements">
40
+ <label for="elements">Elements</label>
41
+ <input type="radio" id="modules_rb" name="toggle" value="Modules">
42
+ <label for="modules">Modules</label><br>
43
+ </div></li><li id="nav_elements" style="display: none"><h3 id="navElements">Elements</h3><ul class="subList"><li id="navItem0"><a href="oj-c.Avatar.html">&lt;oj-c-avatar></a></li><li id="navItem1"><a href="oj-c.Button.html">&lt;oj-c-button></a></li><li id="navItem2"><a href="oj-c.Collapsible.html">&lt;oj-c-collapsible></a></li><li id="navItem3"><a href="oj-c.FilePicker.html">&lt;oj-c-file-picker></a></li><li id="navItem4"><a href="oj-c.InputNumber.html">&lt;oj-c-input-number></a></li><li id="navItem5"><a href="oj-c.InputPassword.html">&lt;oj-c-input-password></a></li><li id="navItem6"><a href="oj-c.InputText.html">&lt;oj-c-input-text></a></li><li id="navItem7"><a href="oj-c.ListItemLayout.html">&lt;oj-c-list-item-layout></a></li><li id="navItem8"><a href="oj-c.MessageToast.html">&lt;oj-c-message-toast></a></li><li id="navItem9"><a href="oj-c.MeterBar.html">&lt;oj-c-meter-bar></a></li><li id="navItem10"><a href="oj-c.MeterCircle.html">&lt;oj-c-meter-circle></a></li><li id="navItem11"><a href="oj-c.ProgressBar.html">&lt;oj-c-progress-bar></a></li><li id="navItem12"><a href="oj-c.ProgressCircle.html">&lt;oj-c-progress-circle></a></li><li id="navItem13"><a href="oj-c.RatingGauge.html">&lt;oj-c-rating-gauge></a></li><li id="navItem14"><a href="oj-c.SelectMultiple.html">&lt;oj-c-select-multiple></a></li><li id="navItem15"><a href="oj-c.SelectSingle.html">&lt;oj-c-select-single></a></li><li id="navItem16"><a href="oj-c.SplitMenuButton.html">&lt;oj-c-split-menu-button></a></li><li id="navItem17"><a href="oj-c.TextArea.html">&lt;oj-c-text-area></a></li></ul></li><li id="nav_modules" style="display: none"><h3 id="navElements">Modules</h3><ul class="subList_lev2"><li class="module">
44
+ <div id="avatar" class="module_element">
45
+ <a href="avatar.html">avatar</a>
46
+ </div><ul class="subList_lev3"><li id="navItem18"><a href="oj-c.Avatar.html">&lt;oj-c-avatar></a></li></ul></li><li class="module">
47
+ <div id="button" class="module_element">
48
+ <a href="button.html">button</a>
49
+ </div><ul class="subList_lev3"><li id="navItem19"><a href="oj-c.Button.html">&lt;oj-c-button></a></li></ul></li><li class="module">
50
+ <div id="collapsible" class="module_element">
51
+ <a href="collapsible.html">collapsible</a>
52
+ </div><ul class="subList_lev3"><li id="navItem20"><a href="oj-c.Collapsible.html">&lt;oj-c-collapsible></a></li></ul></li><li class="module">
53
+ <div id="file-picker" class="module_element">
54
+ <a href="file-picker.html">file-picker</a>
55
+ </div><ul class="subList_lev3"><li id="navItem21"><a href="oj-c.FilePicker.html">&lt;oj-c-file-picker></a></li></ul></li><li class="module">
56
+ <div id="input-number" class="module_element">
57
+ <a href="input-number.html">input-number</a>
58
+ </div><ul class="subList_lev3"><li id="navItem22"><a href="oj-c.InputNumber.html">&lt;oj-c-input-number></a></li></ul></li><li class="module">
59
+ <div id="input-password" class="module_element">
60
+ <a href="input-password.html">input-password</a>
61
+ </div><ul class="subList_lev3"><li id="navItem23"><a href="oj-c.InputPassword.html">&lt;oj-c-input-password></a></li></ul></li><li class="module">
62
+ <div id="input-text" class="module_element">
63
+ <a href="input-text.html">input-text</a>
64
+ </div><ul class="subList_lev3"><li id="navItem24"><a href="oj-c.InputText.html">&lt;oj-c-input-text></a></li></ul></li><li class="module">
65
+ <div id="list-item-layout" class="module_element">
66
+ <a href="list-item-layout.html">list-item-layout</a>
67
+ </div><ul class="subList_lev3"><li id="navItem25"><a href="oj-c.ListItemLayout.html">&lt;oj-c-list-item-layout></a></li></ul></li><li class="module">
68
+ <div id="message-toast" class="module_element">
69
+ <a href="message-toast.html">message-toast</a>
70
+ </div><ul class="subList_lev3"><li id="navItem26"><a href="oj-c.MessageToast.html">&lt;oj-c-message-toast></a></li></ul></li><li class="module">
71
+ <div id="meter-bar" class="module_element">
72
+ <a href="meter-bar.html">meter-bar</a>
73
+ </div><ul class="subList_lev3"><li id="navItem27"><a href="oj-c.MeterBar.html">&lt;oj-c-meter-bar></a></li></ul></li><li class="module">
74
+ <div id="meter-circle" class="module_element">
75
+ <a href="meter-circle.html">meter-circle</a>
76
+ </div><ul class="subList_lev3"><li id="navItem28"><a href="oj-c.MeterCircle.html">&lt;oj-c-meter-circle></a></li></ul></li><li class="module">
77
+ <div id="progress-bar" class="module_element">
78
+ <a href="progress-bar.html">progress-bar</a>
79
+ </div><ul class="subList_lev3"><li id="navItem29"><a href="oj-c.ProgressBar.html">&lt;oj-c-progress-bar></a></li></ul></li><li class="module">
80
+ <div id="progress-circle" class="module_element">
81
+ <a href="progress-circle.html">progress-circle</a>
82
+ </div><ul class="subList_lev3"><li id="navItem30"><a href="oj-c.ProgressCircle.html">&lt;oj-c-progress-circle></a></li></ul></li><li class="module">
83
+ <div id="rating-gauge" class="module_element">
84
+ <a href="rating-gauge.html">rating-gauge</a>
85
+ </div><ul class="subList_lev3"><li id="navItem31"><a href="oj-c.RatingGauge.html">&lt;oj-c-rating-gauge></a></li></ul></li><li class="module">
86
+ <div id="select-multiple" class="module_element">
87
+ <a href="select-multiple.html">select-multiple</a>
88
+ </div><ul class="subList_lev3"><li id="navItem32"><a href="oj-c.SelectMultiple.html">&lt;oj-c-select-multiple></a></li></ul></li><li class="module">
89
+ <div id="select-single" class="module_element">
90
+ <a href="select-single.html">select-single</a>
91
+ </div><ul class="subList_lev3"><li id="navItem33"><a href="oj-c.SelectSingle.html">&lt;oj-c-select-single></a></li></ul></li><li class="module">
92
+ <div id="split-menu-button" class="module_element">
93
+ <a href="split-menu-button.html">split-menu-button</a>
94
+ </div><ul class="subList_lev3"><li id="navItem34"><a href="oj-c.SplitMenuButton.html">&lt;oj-c-split-menu-button></a></li></ul></li><li class="module">
95
+ <div id="text-area" class="module_element">
96
+ <a href="text-area.html">text-area</a>
97
+ </div><ul class="subList_lev3"><li id="navItem35"><a href="oj-c.TextArea.html">&lt;oj-c-text-area></a></li></ul></li></ul></li></ul>
98
+ </nav>
99
+
100
+ <div id="main">
101
+
102
+ <button onclick="topFunction()" id="jump-to-top-btn" title="Go to top"></button>
103
+ <div class="page-title">
104
+ <h1>Element: &lt;oj-c-input-password></h1>
105
+ </div>
106
+
107
+ <p class="product-docs-header">
108
+ <span style="font-weight:bold">Oracle® JavaScript Extension Toolkit (JET)<br>
109
+ 14.0.0</span><br>
110
+ </p>
111
+
112
+
113
+
114
+
115
+
116
+
117
+
118
+
119
+
120
+
121
+
122
+
123
+ <dl class="details">
124
+
125
+ <dt class="tag-since">Since:</dt>
126
+ <dd class="tag-since"><ul class="dummy"><li>13.0.0</li></ul></dd>
127
+
128
+ <dt class="tag-module">Module:</dt>
129
+ <dd class="tag-module"><ul class="dummy"><li>input-password</li></ul></dd>
130
+
131
+ </dl>
132
+
133
+ <section id="quick-nav" class="">
134
+ <header><h2>QuickNav</h2></header>
135
+
136
+
137
+
138
+ <div class="quick-nav-section3">
139
+ <h3> <a href="#members-section">Attributes</a></h3>
140
+ <ul class="optionsSubList">
141
+
142
+ <li><div><a href="#autocomplete">autocomplete</a></div>
143
+
144
+ </li>
145
+
146
+ <li><div><a href="#clearIcon">clear-icon</a></div>
147
+
148
+ </li>
149
+
150
+ <li><div><a href="#containerReadonly">container-readonly</a></div>
151
+
152
+ </li>
153
+
154
+ <li><div><a href="#disabled">disabled</a></div>
155
+
156
+ </li>
157
+
158
+ <li><div><a href="javascript:void(0)" ><b>display-options</b></a></div>
159
+
160
+ <ul class='optionsInnerSubList'>
161
+
162
+ <li><div><a href="#displayOptions.converterHint">converter-hint</a></div>
163
+
164
+ </li>
165
+
166
+ <li><div><a href="#displayOptions.messages">messages</a></div>
167
+
168
+ </li>
169
+
170
+ <li><div><a href="#displayOptions.validatorHint">validator-hint</a></div>
171
+
172
+ </ul></li>
173
+
174
+ <li><div><a href="javascript:void(0)" ><b>help</b></a></div>
175
+
176
+ <ul class='optionsInnerSubList'>
177
+
178
+ <li><div><a href="#help.instruction">instruction</a></div>
179
+
180
+ </ul></li>
181
+
182
+ <li><div><a href="javascript:void(0)" ><b>help-hints</b></a></div>
183
+
184
+ <ul class='optionsInnerSubList'>
185
+
186
+ <li><div><a href="#helpHints.definition">definition</a></div>
187
+
188
+ </li>
189
+
190
+ <li><div><a href="#helpHints.source">source</a></div>
191
+
192
+ </li>
193
+
194
+ <li><div><a href="#helpHints.sourceText">source-text</a></div>
195
+
196
+ </ul></li>
197
+
198
+ <li><div><a href="#labelEdge">label-edge</a></div>
199
+
200
+ </li>
201
+
202
+ <li><div><a href="#labelHint">label-hint</a></div>
203
+
204
+ </li>
205
+
206
+ <li><div><a href="#labelStartWidth">label-start-width</a></div>
207
+
208
+ </li>
209
+
210
+ <li><div><a href="#labelWrapping">label-wrapping</a></div>
211
+
212
+ </li>
213
+
214
+ <li><div><a href="#maskIcon">mask-icon</a></div>
215
+
216
+ </li>
217
+
218
+ <li><div><a href="javascript:void(0)" ><b>messages-custom</b></a></div>
219
+
220
+ <ul class='optionsInnerSubList'>
221
+
222
+ <li><div><a href="#messagesCustom[].detail">detail</a></div>
223
+
224
+ </li>
225
+
226
+ <li><div><a href="#messagesCustom[].severity">severity</a></div>
227
+
228
+ </li>
229
+
230
+ <li><div><a href="#messagesCustom[].summary">summary</a></div>
231
+
232
+ </ul></li>
233
+
234
+ <li><div><a href="#placeholder">placeholder</a></div>
235
+
236
+ </li>
237
+
238
+ <li><div><a href="#rawValue">raw-value</a></div>
239
+
240
+ </li>
241
+
242
+ <li><div><a href="#readonly">readonly</a></div>
243
+
244
+ </li>
245
+
246
+ <li><div><a href="#required">required</a></div>
247
+
248
+ </li>
249
+
250
+ <li><div><a href="#requiredMessageDetail">required-message-detail</a></div>
251
+
252
+ </li>
253
+
254
+ <li><div><a href="#textAlign">text-align</a></div>
255
+
256
+ </li>
257
+
258
+ <li><div><a href="#userAssistanceDensity">user-assistance-density</a></div>
259
+
260
+ </li>
261
+
262
+ <li><div><a href="#valid">valid</a></div>
263
+
264
+ </li>
265
+
266
+ <li><div><a href="#validators">validators</a></div>
267
+
268
+ </li>
269
+
270
+ <li><div><a href="#value">value</a></div>
271
+
272
+ </ul>
273
+ <script type="text/javascript" >
274
+ var innerSubLists = document.getElementsByClassName('optionsInnerSubList');
275
+ for (var i=0; i<innerSubLists.length; i++) {
276
+ innerSubLists[i].parentNode.onclick=function(event) {
277
+ event.stopPropagation();
278
+ // Only interpret the click event if the <a> element is the target and do nothing if click occurred elsewhere on the div
279
+ if (event.target.parentNode == this.firstChild.firstChild) {
280
+ // toggle only the clicked sub properties list and not any nested ones
281
+ var subProperties = this.getElementsByClassName('optionsInnerSubList');
282
+ subProperties[0].style.display = (subProperties[0].style.display=='block' ? 'none' : 'block');
283
+ }
284
+ }
285
+ }
286
+ </script>
287
+
288
+
289
+
290
+
291
+
292
+ </div>
293
+
294
+
295
+
296
+
297
+
298
+ <div class="quick-nav-section3">
299
+ <h3><a href="#methods-section">Methods</a></h3>
300
+ <ul class="subList">
301
+
302
+ <li><a href="#getProperty">getProperty</a></li>
303
+
304
+ <li><a href="#reset">reset</a></li>
305
+
306
+ <li><a href="#setProperties">setProperties</a></li>
307
+
308
+ <li><a href="#setProperty">setProperty</a></li>
309
+
310
+ <li><a href="#showMessages">showMessages</a></li>
311
+
312
+ <li><a href="#validate">validate</a></li>
313
+
314
+ </ul>
315
+
316
+ </div>
317
+
318
+
319
+
320
+ <div class="quick-nav-section3">
321
+ <h3>Other Topics</h3>
322
+ <ul class="subList">
323
+
324
+ <li><a href="#touch-section">Touch Section</a></li>
325
+
326
+ <li><a href="#keyboard-section">Keyboard Section</a></li>
327
+
328
+ <li><a href="#a11y-section">Accessibility Section</a></li>
329
+
330
+ </ul>
331
+ </div>
332
+
333
+ </section>
334
+
335
+ <section class="">
336
+ <header>
337
+
338
+ </br>
339
+
340
+ <div class="class-description">
341
+ <p><h3 id="inputPasswordOverview-section">
342
+ JET InputPassword Component
343
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#inputPasswordOverview-section"></a>
344
+ </h3>
345
+
346
+ <p>Description: The oj-c-input-password component enhances a browser input type="password" element.</p>
347
+ <p>
348
+ An input password displays a field that allows a user to enter a password that will be masked.
349
+ The user can reveal the password by clicking on the reveal toggle button. When the user
350
+ leaves the field, the password is automatically masked.
351
+ </p>
352
+
353
+ <pre class="prettyprint"><code>&lt;oj-c-input-password label-hint="Input Password">&lt;/oj-c-input-password></code></pre>
354
+
355
+ <h3 id="validation-section">
356
+ Validation and Messaging
357
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#validation-section"></a>
358
+ </h3>
359
+
360
+ <p>
361
+ An editable component runs validation (normal or deferred) based on the action performed on it
362
+ (either by end-user or page author), and the state it was in when the action occurred. Examples
363
+ of actions are - creating a component, user changing the value of the component by interacting
364
+ with it, the app setting a value programmatically, the app calling the validate() method etc. At
365
+ the time the action occurs, the component could already be showing errors, or can have a deferred
366
+ error or have no errors.
367
+ </p>
368
+ <p>
369
+ These factors also determine whether validation errors/messages get shown to the user immediately
370
+ or get deferred. The following sections highlight the kinds of validation that are run and how
371
+ messages get handled.
372
+ </p>
373
+
374
+ <h4 id="normal-validation-section">
375
+ Normal Validation
376
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#normal-validation-section"></a>
377
+ </h4>
378
+ Normal validation is run in the following cases on the display value, using the converter and
379
+ validators (this includes async-validators) set on the component,
380
+ and validation errors are reported to user immediately.
381
+ <ul>
382
+ <li>When value changes as a result of user interaction all messages are cleared, including custom
383
+ messages added by the app, and full validation is run on the UI value. The steps performed are
384
+ outlined below.
385
+ <ol>
386
+ <li>All messages are cleared and <code class="prettyprint">messagesCustom</code> property is cleared</li>
387
+ <li>If no converter is present then processing continues to next step. If a converter is
388
+ present, the UI value is first converted (i.e., parsed). If there is a parse error then
389
+ the messages are shown and processing returns.</li>
390
+ <li>If there are no validators setup for the component then the value is set on the component.
391
+ Otherwise all validators are run in sequence using the parsed value from the previous step. The
392
+ implicit required is run first if the component is marked required. When a validation error is
393
+ encountered it is remembered and the next validator in the sequence is run.
394
+ <ul><li>NOTE: The value is trimmed before required validation is run</li></ul>
395
+ </li>
396
+ <li>At the end of the validation run if there are errors, the messages are shown
397
+ and processing returns. If there are async-validators, those errors are shown as soon as they
398
+ come in, and not until all validators, sync and async validators, are complete, does processing
399
+ return, that is, value and valid are updated. If there are no errors, then the
400
+ <code class="prettyprint">value</code> property is updated and the formatted value displayed on the
401
+ UI.</li>
402
+ </ol>
403
+ </li>
404
+ <li>When the <code class="prettyprint">validate</code> method is called by app, all messages are
405
+ cleared and full validation run using the display value. See <code class="prettyprint">validate</code>
406
+ method on the sub-classes for details. Note: JET validation is designed to catch user input errors, and not invalid
407
+ data passed from the server; this should be caught on the server.</li>
408
+ <li>When certain properties change through programmatic intervention by app, the component
409
+ determines whether it needs to run normal validation based on the state the component is in.
410
+ Refer to the <a href="#mixed-validation-section">Mixed Validation</a> section below for details. </li>
411
+ </ul>
412
+
413
+ <h4 id="deferred-validation-section">
414
+ Deferred Validation
415
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#deferred-validation-section"></a>
416
+ </h4>
417
+ Deferred validation is run in the following cases on the component value using the implicit
418
+ required validator if required is true, and validation errors are deferred, i.e., not shown to user immediately.
419
+ Refer to the <a href="#deferred-messages-section">Showing Deferred Messages</a> section to
420
+ understand how deferred messages can be shown.
421
+ <ul>
422
+ <li>When a component is created and it is required deferred validation is run and no messages are cleared
423
+ prior to running validation.
424
+ Refer to the <a href="#deferred-validators-section">Validators
425
+ Participating in Deferred Validation</a> section for details.</li>
426
+ <li>When the <code class="prettyprint">value</code> property changes due to programmatic
427
+ intervention deferred validation is run, after all messages and messagesCustom property are cleared.</li>
428
+ <li>When the <code class="prettyprint">reset</code> method is called, deferred validation is run
429
+ after all messages and messagesCustom property are cleared.</li>
430
+ <li>When certain properties change through programmatic intervention by app, the component
431
+ determines whether it needs to run deferred validation based on the state the component is in.
432
+ Refer to the <a href="#mixed-validation-section">Mixed Validation</a> section below for details.</li>
433
+ </ul>
434
+
435
+ <h4 id="mixed-validation-section">
436
+ Mixed Validation
437
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#mixed-validation-section"></a>
438
+ </h4>
439
+ Either deferred or normal validation is run in the following cases based on the state the
440
+ component is in and any validation errors encountered are either hidden or shown to user.
441
+ <ul>
442
+ <li>when disabled property changes. See <a href="#disabled">disabled</a> property for details.</li>
443
+ <li>when required property changes. See <a href="#required">required</a> property for details.</li>
444
+ <li>when validators property changes. See <a href="#validators">validators</a> property for details.</li>
445
+ </ul>
446
+
447
+ <h3 id="deferred-messages-section">
448
+ Showing Deferred Messages
449
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#deferred-messages-section"></a>
450
+ </h3>
451
+ Deferred validation messages are displayed only when page author requests for it explicitly in
452
+ one of the following ways:
453
+ <ul>
454
+ <li>calls the <a href="#showMessages"><code class="prettyprint">showMessages</code></a> method on the component</li>
455
+ </ul>
456
+
457
+ <h3 id="deferred-validators-section">
458
+ Validators Participating in Deferred Validation
459
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#deferred-validators-section"></a>
460
+ </h3>
461
+ The required validator is the only validator type that participates in deferred validation.
462
+ The required property needs to be set to true for the required validator to run.
463
+
464
+ <h3 id="user-assistance-text-section">
465
+ User Assistance Text
466
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#user-assistance-text-section"></a>
467
+ </h3>
468
+ <p>
469
+ User assistive text provides guidance to help the user understand what data to enter or select.
470
+ </p>
471
+ <p>
472
+ By default all user assistance text shows inline.
473
+ For input components, it shows when the field takes focus. In other components
474
+ it shows all the time. See the user-assistance-density property for other ways
475
+ the user assistance text can render, like in 'compact' mode, it will render as an icon on the label
476
+ which when clicked will show the user assistance text in a notewindow.
477
+ </p>
478
+ <p>
479
+ The JET form component properties that are used for user assistance text are help.instruction,
480
+ validator and converter hints, and help-hints.
481
+ In the Redwood theme for clarity only one user assistance text shows to the user.
482
+ The precedence rules are:
483
+ <ul>
484
+ <li>help.instruction shows;</li>
485
+ <li>if no help.instruction, then validator hint shows;</li>
486
+ <li>if no help.instruction or validator hint, then help-hints.definition shows;</li>
487
+ <li>if no help.instruction, validator hint, or help-hints.definition, then converter hint shows.</li>
488
+ <li>help-hints.source always shows along side the above.</li>
489
+ </ul>
490
+ </p>
491
+ <p>Sometimes a validator or converter hint shows that you do not want to show. To not show it,
492
+ set the display-options.validator-hint and/or display-options.converter-hint property to 'none'.
493
+ </p>
494
+ <p>required and placeholder properties also can be used to guide the user.
495
+ In Redwood, a required field shows the word Required under the field
496
+ when the field is empty and does not have focus.
497
+ Placeholder is shown when the field is empty and has focus.
498
+ </p>
499
+
500
+ <h3 id="touch-section">
501
+ Touch End User Information
502
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#touch-section"></a>
503
+ </h3>
504
+
505
+ <table class="keyboard-table">
506
+ <thead>
507
+ <tr>
508
+ <th>Target</th>
509
+ <th>Gesture</th>
510
+ <th>Action</th>
511
+ </tr>
512
+ </thead>
513
+ <tbody>
514
+ <tr>
515
+ <td>Input</td>
516
+ <td><kbd>Tap</kbd></td>
517
+ <td>Sets focus to input. Show user assistance text.</td>
518
+ </tr>
519
+ </tbody>
520
+ </table>
521
+
522
+ <h3 id="keyboard-section">
523
+ Keyboard End User Information
524
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#keyboard-section"></a>
525
+ </h3>
526
+
527
+ <table class="keyboard-table">
528
+ <thead>
529
+ <tr>
530
+ <th>Target</th>
531
+ <th>Key</th>
532
+ <th>Action</th>
533
+ </tr>
534
+ </thead>
535
+ <tbody>
536
+ <tr>
537
+ <td>Input</td>
538
+ <td><kbd>Tab In</kbd></td>
539
+ <td>Set focus to the input. Show user assistance text.</td>
540
+ </tr>
541
+ </tbody>
542
+ </table>
543
+
544
+ <h3 id="a11y-section">
545
+ Accessibility
546
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#a11y-section"></a>
547
+ </h3>
548
+
549
+ <p>
550
+ For accessibility, set the <a href="#labelHint">label-hint</a> property.
551
+ If there is no visible label, then to make this accessible to screen reader users,
552
+ set the <a href="#labelHint">label-hint</a> and <a href="#labelEdge">label-edge</a>='none'
553
+ which renders an aria-label with the label-hint text.
554
+ </p>
555
+
556
+ <p>
557
+ The placeholder text is not read reliably by the screen reader. For accessibility reasons,
558
+ you need to associate the text to its JET form component using aria-describedby.
559
+ </p>
560
+
561
+ <p>
562
+ Disabled content: JET supports an accessible luminosity contrast ratio,
563
+ as specified in <a href="http://www.w3.org/TR/WCAG20/#visual-audio-contrast-contrast">WCAG 2.0 - Section 1.4.3 "Contrast"</a>,
564
+ in the themes that are accessible. (See the "Theming" chapter of the JET Developer Guide for more information on which
565
+ themes are accessible.) Note that Section 1.4.3 says that text or images of text that are part of an inactive user
566
+ interface component have no contrast requirement. Because disabled content may not meet the minimum contrast ratio
567
+ required of enabled content, it cannot be used to convey meaningful information.
568
+ </p></p>
569
+ </div>
570
+ </br>
571
+
572
+ </header>
573
+
574
+
575
+ <article>
576
+ <div class="container-overview">
577
+
578
+
579
+ <div class="usage-section">
580
+ <h3 id="usage-section">Usage<a class="bookmarkable-link" title="Bookmarkable Link" href="#usage-section"></a></h3>
581
+
582
+ <dt class="null" style="margin-right: 100px;"><h5><span>Signature: </span><p> <span class="name type-signature">interface CInputPasswordElement</span></p></h5></dt>
583
+
584
+ <dl>
585
+ <dt><h5>Typescript Import Format</h5></dt>
586
+ <dd><pre class="prettyprint"><code>//To typecheck the element APIs, import as below.<br>import {CInputPasswordElement} from "oj-c/input-password";<br><br>//For the transpiled javascript to load the element's module, import as below<br>import "oj-c/input-password";</code></pre></dd>
587
+ </dl>
588
+
589
+ <p>For additional information visit:</p>
590
+ <ul>
591
+
592
+ <li><a href="../../../jsdocs/CustomElementOverview.html" target="_blank">Using JET Custom Elements</a></li>
593
+
594
+ <li><a href="../../../jsdocs/TypescriptOverview.html" target="_blank">Using JET with TypeScript</a></li>
595
+ <li><a href="../../../jsdocs/ModuleLoadingOverview.html" target="_blank">JET Module Loading</a></li>
596
+ </ul>
597
+
598
+ <p class="important">Note: Application logic should not interact with the component's properties or invoke its methods
599
+ until the <a href="../../../jsdocs/oj.BusyContext.html" target="_blank">BusyContext</a> indicates that the component is ready for interaction.</p>
600
+
601
+ </div>
602
+ <br>
603
+
604
+
605
+
606
+
607
+
608
+
609
+
610
+ <dl class="details">
611
+
612
+
613
+
614
+
615
+
616
+
617
+
618
+
619
+
620
+
621
+
622
+
623
+
624
+
625
+
626
+
627
+
628
+
629
+
630
+
631
+
632
+
633
+
634
+
635
+
636
+
637
+
638
+
639
+
640
+ </dl>
641
+
642
+
643
+
644
+ </div>
645
+
646
+
647
+
648
+
649
+
650
+
651
+
652
+
653
+
654
+
655
+
656
+
657
+
658
+ <h3 id="members-section" class="subsection-title">
659
+ Attributes
660
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#members-section"></a>
661
+ </h3>
662
+
663
+ <dl>
664
+
665
+
666
+ <dt class="">
667
+
668
+ <h4 id="autocomplete" class="name">
669
+
670
+ <span class="type-signature"></span>autocomplete<span class="type-signature"> :string</span>
671
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#autocomplete"></a>
672
+
673
+ </h4>
674
+
675
+
676
+ </dt>
677
+
678
+ <dd class="">
679
+
680
+ <div class="description">
681
+ Dictates component's autocomplete state. This attribute indicates whether the value of
682
+ the control can be automatically completed by the browser. The common values are 'on' and 'off'.
683
+
684
+ Since this attribute passes through to the input element unchanged, you can look at the html specs for
685
+ detailed information for how browsers behave and what values besides 'on' and 'off' you can set.
686
+ The html spec says the default is 'on', so when autocomplete is not explicitly set, the browsers treat it as 'on'.
687
+ </div>
688
+
689
+
690
+
691
+
692
+ <dl class="details">
693
+
694
+
695
+
696
+
697
+
698
+ <dt class="tag-default">Default Value:</dt>
699
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">"on"</code></li></ul></dd>
700
+
701
+
702
+
703
+
704
+
705
+
706
+
707
+
708
+
709
+
710
+
711
+
712
+
713
+
714
+
715
+
716
+
717
+
718
+
719
+
720
+
721
+
722
+
723
+
724
+
725
+ </dl>
726
+
727
+
728
+
729
+ <h5>Names</h5>
730
+ <table class="keyboard-table">
731
+ <thead>
732
+ <tr>
733
+ <th>Item</th>
734
+ <th>Name</th>
735
+ </tr>
736
+ </thead>
737
+ <tbody>
738
+ <tr>
739
+ <td>Property</td>
740
+ <td><code class="prettyprint">autocomplete</code></td>
741
+ </tr>
742
+
743
+ <tr>
744
+ <td>Property change event</td>
745
+ <td><code class="prettyprint">autocompleteChanged</code></td>
746
+ </tr>
747
+ <tr>
748
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
749
+ <td><code class="pretty-print-noprettify">on-autocomplete-changed</code></td>
750
+ </tr>
751
+
752
+ </tbody>
753
+ </table>
754
+
755
+ </dd>
756
+
757
+
758
+ <dt class="">
759
+
760
+ <h4 id="clearIcon" class="name">
761
+
762
+ <span class="type-signature"></span>clear-icon<span class="type-signature"> :"always"|"never"|"conditional"</span>
763
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#clearIcon"></a>
764
+
765
+ </h4>
766
+
767
+
768
+ </dt>
769
+
770
+ <dd class="">
771
+
772
+ <div class="description">
773
+ Specifies if an icon to clear the input field should be visible.
774
+ </div>
775
+
776
+
777
+
778
+
779
+ <dl class="details">
780
+
781
+
782
+
783
+
784
+ <h5 class="subsection-title">Supported Values:</h5>
785
+
786
+ <dl>
787
+
788
+ <table class="props">
789
+ <thead>
790
+ <tr>
791
+
792
+ <th>Value</th>
793
+
794
+
795
+
796
+
797
+
798
+
799
+
800
+ <th class="last">Description</th>
801
+
802
+ </tr>
803
+ </thead>
804
+
805
+ <tbody>
806
+
807
+
808
+ <tr>
809
+
810
+ <td class="name"><code>always</code></td>
811
+
812
+
813
+
814
+
815
+
816
+
817
+
818
+ <td class="description last">The clear icon will always be shown.
819
+ </td>
820
+
821
+ </tr>
822
+
823
+
824
+
825
+ <tr>
826
+
827
+ <td class="name"><code>conditional</code></td>
828
+
829
+
830
+
831
+
832
+
833
+
834
+
835
+ <td class="description last">The clear icon is visible under the following conditions: if the component has a non-empty value, and it either has focus or the mouse is over the field.
836
+ </td>
837
+
838
+ </tr>
839
+
840
+
841
+
842
+ <tr>
843
+
844
+ <td class="name"><code>never</code></td>
845
+
846
+
847
+
848
+
849
+
850
+
851
+
852
+ <td class="description last">The clear icon will never be shown (default, if unspecified).
853
+ </td>
854
+
855
+ </tr>
856
+
857
+
858
+ </tbody>
859
+ </table></dl>
860
+
861
+
862
+
863
+
864
+ <dt class="tag-default">Default Value:</dt>
865
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">"never"</code></li></ul></dd>
866
+
867
+
868
+
869
+
870
+
871
+
872
+
873
+
874
+
875
+
876
+
877
+
878
+
879
+
880
+
881
+
882
+
883
+
884
+
885
+
886
+
887
+
888
+
889
+
890
+
891
+ </dl>
892
+
893
+
894
+
895
+ <h5>Names</h5>
896
+ <table class="keyboard-table">
897
+ <thead>
898
+ <tr>
899
+ <th>Item</th>
900
+ <th>Name</th>
901
+ </tr>
902
+ </thead>
903
+ <tbody>
904
+ <tr>
905
+ <td>Property</td>
906
+ <td><code class="prettyprint">clearIcon</code></td>
907
+ </tr>
908
+
909
+ <tr>
910
+ <td>Property change event</td>
911
+ <td><code class="prettyprint">clearIconChanged</code></td>
912
+ </tr>
913
+ <tr>
914
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
915
+ <td><code class="pretty-print-noprettify">on-clear-icon-changed</code></td>
916
+ </tr>
917
+
918
+ </tbody>
919
+ </table>
920
+
921
+ </dd>
922
+
923
+
924
+ <dt class="">
925
+
926
+ <h4 id="containerReadonly" class="name">
927
+
928
+ <span class="type-signature"></span>container-readonly<span class="type-signature"> :boolean</span>
929
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#containerReadonly"></a>
930
+
931
+ </h4>
932
+
933
+
934
+ </dt>
935
+
936
+ <dd class="">
937
+
938
+ <div class="description">
939
+ Specifies whether an ancestor container, like oj-form-layout, is readonly.
940
+ This affects whether a readonly component renders in full or mixed readonly mode.
941
+ </div>
942
+
943
+
944
+
945
+
946
+ <dl class="details">
947
+
948
+
949
+
950
+
951
+
952
+
953
+
954
+
955
+
956
+
957
+
958
+
959
+
960
+
961
+
962
+
963
+
964
+
965
+
966
+
967
+
968
+
969
+
970
+
971
+
972
+
973
+
974
+
975
+
976
+ </dl>
977
+
978
+
979
+
980
+ <h5>Names</h5>
981
+ <table class="keyboard-table">
982
+ <thead>
983
+ <tr>
984
+ <th>Item</th>
985
+ <th>Name</th>
986
+ </tr>
987
+ </thead>
988
+ <tbody>
989
+ <tr>
990
+ <td>Property</td>
991
+ <td><code class="prettyprint">containerReadonly</code></td>
992
+ </tr>
993
+
994
+ <tr>
995
+ <td>Property change event</td>
996
+ <td><code class="prettyprint">containerReadonlyChanged</code></td>
997
+ </tr>
998
+ <tr>
999
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
1000
+ <td><code class="pretty-print-noprettify">on-container-readonly-changed</code></td>
1001
+ </tr>
1002
+
1003
+ </tbody>
1004
+ </table>
1005
+
1006
+ </dd>
1007
+
1008
+
1009
+ <dt class="">
1010
+
1011
+ <h4 id="disabled" class="name">
1012
+
1013
+ <span class="type-signature"></span>disabled<span class="type-signature"> :boolean</span>
1014
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#disabled"></a>
1015
+
1016
+ </h4>
1017
+
1018
+
1019
+ </dt>
1020
+
1021
+ <dd class="">
1022
+
1023
+ <div class="description">
1024
+ Whether the component is disabled. The default is false.
1025
+ </div>
1026
+
1027
+
1028
+
1029
+
1030
+ <dl class="details">
1031
+
1032
+
1033
+
1034
+
1035
+
1036
+ <dt class="tag-default">Default Value:</dt>
1037
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">false</code></li></ul></dd>
1038
+
1039
+
1040
+
1041
+
1042
+
1043
+
1044
+
1045
+
1046
+
1047
+
1048
+
1049
+
1050
+
1051
+
1052
+
1053
+
1054
+
1055
+
1056
+
1057
+
1058
+
1059
+
1060
+
1061
+
1062
+
1063
+ </dl>
1064
+
1065
+
1066
+
1067
+ <h5>Names</h5>
1068
+ <table class="keyboard-table">
1069
+ <thead>
1070
+ <tr>
1071
+ <th>Item</th>
1072
+ <th>Name</th>
1073
+ </tr>
1074
+ </thead>
1075
+ <tbody>
1076
+ <tr>
1077
+ <td>Property</td>
1078
+ <td><code class="prettyprint">disabled</code></td>
1079
+ </tr>
1080
+
1081
+ <tr>
1082
+ <td>Property change event</td>
1083
+ <td><code class="prettyprint">disabledChanged</code></td>
1084
+ </tr>
1085
+ <tr>
1086
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
1087
+ <td><code class="pretty-print-noprettify">on-disabled-changed</code></td>
1088
+ </tr>
1089
+
1090
+ </tbody>
1091
+ </table>
1092
+
1093
+ </dd>
1094
+
1095
+
1096
+ <dt class="">
1097
+
1098
+ <h4 id="displayOptions" class="name">
1099
+
1100
+ <span class="type-signature"></span>display-options<span class="type-signature"> :Object</span>
1101
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#displayOptions"></a>
1102
+
1103
+ </h4>
1104
+
1105
+
1106
+ </dt>
1107
+
1108
+ <dd class="">
1109
+
1110
+ <div class="description">
1111
+ Display options for auxiliary content that determines whether or not it should be displayed.
1112
+ </div>
1113
+
1114
+
1115
+
1116
+
1117
+ <dl class="details">
1118
+
1119
+
1120
+
1121
+
1122
+
1123
+
1124
+
1125
+
1126
+
1127
+
1128
+
1129
+
1130
+
1131
+
1132
+
1133
+
1134
+
1135
+
1136
+
1137
+
1138
+
1139
+
1140
+
1141
+
1142
+
1143
+
1144
+
1145
+
1146
+
1147
+ </dl>
1148
+
1149
+
1150
+
1151
+ <h5>Names</h5>
1152
+ <table class="keyboard-table">
1153
+ <thead>
1154
+ <tr>
1155
+ <th>Item</th>
1156
+ <th>Name</th>
1157
+ </tr>
1158
+ </thead>
1159
+ <tbody>
1160
+ <tr>
1161
+ <td>Property</td>
1162
+ <td><code class="prettyprint">displayOptions</code></td>
1163
+ </tr>
1164
+
1165
+ <tr>
1166
+ <td>Property change event</td>
1167
+ <td><code class="prettyprint">displayOptionsChanged</code></td>
1168
+ </tr>
1169
+ <tr>
1170
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
1171
+ <td><code class="pretty-print-noprettify">on-display-options-changed</code></td>
1172
+ </tr>
1173
+
1174
+ </tbody>
1175
+ </table>
1176
+
1177
+ </dd>
1178
+
1179
+
1180
+ <dt class="">
1181
+
1182
+ <h4 id="displayOptions.converterHint" class="name">
1183
+
1184
+ <span class="type-signature"></span>display-options.converter-hint<span class="type-signature"> :"display"|"none"</span>
1185
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#displayOptions.converterHint"></a>
1186
+
1187
+ </h4>
1188
+
1189
+
1190
+ </dt>
1191
+
1192
+ <dd class="">
1193
+
1194
+ <div class="description">
1195
+ Display options for auxiliary converter hint text.
1196
+ </div>
1197
+
1198
+
1199
+
1200
+
1201
+ <dl class="details">
1202
+
1203
+
1204
+
1205
+
1206
+
1207
+ <dt class="tag-default">Default Value:</dt>
1208
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">"display"</code></li></ul></dd>
1209
+
1210
+
1211
+
1212
+
1213
+
1214
+
1215
+
1216
+
1217
+
1218
+
1219
+
1220
+
1221
+
1222
+
1223
+
1224
+
1225
+
1226
+
1227
+
1228
+
1229
+
1230
+
1231
+
1232
+
1233
+
1234
+ </dl>
1235
+
1236
+
1237
+
1238
+ <h5>Names</h5>
1239
+ <table class="keyboard-table">
1240
+ <thead>
1241
+ <tr>
1242
+ <th>Item</th>
1243
+ <th>Name</th>
1244
+ </tr>
1245
+ </thead>
1246
+ <tbody>
1247
+ <tr>
1248
+ <td>Property</td>
1249
+ <td><code class="prettyprint">displayOptions.converterHint</code></td>
1250
+ </tr>
1251
+
1252
+ </tbody>
1253
+ </table>
1254
+
1255
+ </dd>
1256
+
1257
+
1258
+ <dt class="">
1259
+
1260
+ <h4 id="displayOptions.messages" class="name">
1261
+
1262
+ <span class="type-signature"></span>display-options.messages<span class="type-signature"> :"display"|"none"</span>
1263
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#displayOptions.messages"></a>
1264
+
1265
+ </h4>
1266
+
1267
+
1268
+ </dt>
1269
+
1270
+ <dd class="">
1271
+
1272
+ <div class="description">
1273
+ Display options for auxiliary message text.
1274
+ </div>
1275
+
1276
+
1277
+
1278
+
1279
+ <dl class="details">
1280
+
1281
+
1282
+
1283
+
1284
+
1285
+ <dt class="tag-default">Default Value:</dt>
1286
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">"display"</code></li></ul></dd>
1287
+
1288
+
1289
+
1290
+
1291
+
1292
+
1293
+
1294
+
1295
+
1296
+
1297
+
1298
+
1299
+
1300
+
1301
+
1302
+
1303
+
1304
+
1305
+
1306
+
1307
+
1308
+
1309
+
1310
+
1311
+
1312
+ </dl>
1313
+
1314
+
1315
+
1316
+ <h5>Names</h5>
1317
+ <table class="keyboard-table">
1318
+ <thead>
1319
+ <tr>
1320
+ <th>Item</th>
1321
+ <th>Name</th>
1322
+ </tr>
1323
+ </thead>
1324
+ <tbody>
1325
+ <tr>
1326
+ <td>Property</td>
1327
+ <td><code class="prettyprint">displayOptions.messages</code></td>
1328
+ </tr>
1329
+
1330
+ </tbody>
1331
+ </table>
1332
+
1333
+ </dd>
1334
+
1335
+
1336
+ <dt class="">
1337
+
1338
+ <h4 id="displayOptions.validatorHint" class="name">
1339
+
1340
+ <span class="type-signature"></span>display-options.validator-hint<span class="type-signature"> :"display"|"none"</span>
1341
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#displayOptions.validatorHint"></a>
1342
+
1343
+ </h4>
1344
+
1345
+
1346
+ </dt>
1347
+
1348
+ <dd class="">
1349
+
1350
+ <div class="description">
1351
+ Display options for auxiliary validator hint text.
1352
+ </div>
1353
+
1354
+
1355
+
1356
+
1357
+ <dl class="details">
1358
+
1359
+
1360
+
1361
+
1362
+
1363
+ <dt class="tag-default">Default Value:</dt>
1364
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">"display"</code></li></ul></dd>
1365
+
1366
+
1367
+
1368
+
1369
+
1370
+
1371
+
1372
+
1373
+
1374
+
1375
+
1376
+
1377
+
1378
+
1379
+
1380
+
1381
+
1382
+
1383
+
1384
+
1385
+
1386
+
1387
+
1388
+
1389
+
1390
+ </dl>
1391
+
1392
+
1393
+
1394
+ <h5>Names</h5>
1395
+ <table class="keyboard-table">
1396
+ <thead>
1397
+ <tr>
1398
+ <th>Item</th>
1399
+ <th>Name</th>
1400
+ </tr>
1401
+ </thead>
1402
+ <tbody>
1403
+ <tr>
1404
+ <td>Property</td>
1405
+ <td><code class="prettyprint">displayOptions.validatorHint</code></td>
1406
+ </tr>
1407
+
1408
+ </tbody>
1409
+ </table>
1410
+
1411
+ </dd>
1412
+
1413
+
1414
+ <dt class="">
1415
+
1416
+ <h4 id="help" class="name">
1417
+
1418
+ <span class="type-signature"></span>help<span class="type-signature"> :Object</span>
1419
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#help"></a>
1420
+
1421
+ </h4>
1422
+
1423
+
1424
+ </dt>
1425
+
1426
+ <dd class="">
1427
+
1428
+ <div class="description">
1429
+ Form component help information.
1430
+ </div>
1431
+
1432
+
1433
+
1434
+
1435
+ <dl class="details">
1436
+
1437
+
1438
+
1439
+
1440
+
1441
+
1442
+
1443
+
1444
+
1445
+
1446
+
1447
+
1448
+
1449
+
1450
+
1451
+
1452
+
1453
+
1454
+
1455
+
1456
+
1457
+
1458
+
1459
+
1460
+
1461
+
1462
+
1463
+
1464
+
1465
+ </dl>
1466
+
1467
+
1468
+
1469
+ <h5>Names</h5>
1470
+ <table class="keyboard-table">
1471
+ <thead>
1472
+ <tr>
1473
+ <th>Item</th>
1474
+ <th>Name</th>
1475
+ </tr>
1476
+ </thead>
1477
+ <tbody>
1478
+ <tr>
1479
+ <td>Property</td>
1480
+ <td><code class="prettyprint">help</code></td>
1481
+ </tr>
1482
+
1483
+ <tr>
1484
+ <td>Property change event</td>
1485
+ <td><code class="prettyprint">helpChanged</code></td>
1486
+ </tr>
1487
+ <tr>
1488
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
1489
+ <td><code class="pretty-print-noprettify">on-help-changed</code></td>
1490
+ </tr>
1491
+
1492
+ </tbody>
1493
+ </table>
1494
+
1495
+ </dd>
1496
+
1497
+
1498
+ <dt class="">
1499
+
1500
+ <h4 id="help.instruction" class="name">
1501
+
1502
+ <span class="type-signature"></span>help.instruction<span class="type-signature"> :string</span>
1503
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#help.instruction"></a>
1504
+
1505
+ </h4>
1506
+
1507
+
1508
+ </dt>
1509
+
1510
+ <dd class="">
1511
+
1512
+ <div class="description">
1513
+ A type of user assistance text. User assistance text is used to provide guidance to
1514
+ help the user understand what data to enter or select.
1515
+ </div>
1516
+
1517
+
1518
+
1519
+
1520
+ <dl class="details">
1521
+
1522
+
1523
+
1524
+
1525
+
1526
+ <dt class="tag-default">Default Value:</dt>
1527
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">""</code></li></ul></dd>
1528
+
1529
+
1530
+
1531
+
1532
+
1533
+
1534
+
1535
+
1536
+
1537
+
1538
+
1539
+
1540
+
1541
+
1542
+
1543
+
1544
+
1545
+
1546
+
1547
+
1548
+
1549
+
1550
+
1551
+
1552
+
1553
+ </dl>
1554
+
1555
+
1556
+
1557
+ <h5>Names</h5>
1558
+ <table class="keyboard-table">
1559
+ <thead>
1560
+ <tr>
1561
+ <th>Item</th>
1562
+ <th>Name</th>
1563
+ </tr>
1564
+ </thead>
1565
+ <tbody>
1566
+ <tr>
1567
+ <td>Property</td>
1568
+ <td><code class="prettyprint">help.instruction</code></td>
1569
+ </tr>
1570
+
1571
+ </tbody>
1572
+ </table>
1573
+
1574
+ </dd>
1575
+
1576
+
1577
+ <dt class="">
1578
+
1579
+ <h4 id="helpHints" class="name">
1580
+
1581
+ <span class="type-signature"></span>help-hints<span class="type-signature"> :Object</span>
1582
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#helpHints"></a>
1583
+
1584
+ </h4>
1585
+
1586
+
1587
+ </dt>
1588
+
1589
+ <dd class="">
1590
+
1591
+ <div class="description">
1592
+ The helpHints object contains a definition property and a source property.
1593
+ </div>
1594
+
1595
+
1596
+
1597
+
1598
+ <dl class="details">
1599
+
1600
+
1601
+
1602
+
1603
+
1604
+
1605
+
1606
+
1607
+
1608
+
1609
+
1610
+
1611
+
1612
+
1613
+
1614
+
1615
+
1616
+
1617
+
1618
+
1619
+
1620
+
1621
+
1622
+
1623
+
1624
+
1625
+
1626
+
1627
+
1628
+ </dl>
1629
+
1630
+
1631
+
1632
+ <h5>Names</h5>
1633
+ <table class="keyboard-table">
1634
+ <thead>
1635
+ <tr>
1636
+ <th>Item</th>
1637
+ <th>Name</th>
1638
+ </tr>
1639
+ </thead>
1640
+ <tbody>
1641
+ <tr>
1642
+ <td>Property</td>
1643
+ <td><code class="prettyprint">helpHints</code></td>
1644
+ </tr>
1645
+
1646
+ <tr>
1647
+ <td>Property change event</td>
1648
+ <td><code class="prettyprint">helpHintsChanged</code></td>
1649
+ </tr>
1650
+ <tr>
1651
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
1652
+ <td><code class="pretty-print-noprettify">on-help-hints-changed</code></td>
1653
+ </tr>
1654
+
1655
+ </tbody>
1656
+ </table>
1657
+
1658
+ </dd>
1659
+
1660
+
1661
+ <dt class="">
1662
+
1663
+ <h4 id="helpHints.definition" class="name">
1664
+
1665
+ <span class="type-signature"></span>help-hints.definition<span class="type-signature"> :string</span>
1666
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#helpHints.definition"></a>
1667
+
1668
+ </h4>
1669
+
1670
+
1671
+ </dt>
1672
+
1673
+ <dd class="">
1674
+
1675
+ <div class="description">
1676
+ A type of user assistance text. User assistance text is used to provide guidance to help
1677
+ the user understand what data to enter or select. help-hints could come from a help system.
1678
+ </div>
1679
+
1680
+
1681
+
1682
+
1683
+ <dl class="details">
1684
+
1685
+
1686
+
1687
+
1688
+
1689
+ <dt class="tag-default">Default Value:</dt>
1690
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">""</code></li></ul></dd>
1691
+
1692
+
1693
+
1694
+
1695
+
1696
+
1697
+
1698
+
1699
+
1700
+
1701
+
1702
+
1703
+
1704
+
1705
+
1706
+
1707
+
1708
+
1709
+
1710
+
1711
+
1712
+
1713
+
1714
+
1715
+
1716
+ </dl>
1717
+
1718
+
1719
+
1720
+ <h5>Names</h5>
1721
+ <table class="keyboard-table">
1722
+ <thead>
1723
+ <tr>
1724
+ <th>Item</th>
1725
+ <th>Name</th>
1726
+ </tr>
1727
+ </thead>
1728
+ <tbody>
1729
+ <tr>
1730
+ <td>Property</td>
1731
+ <td><code class="prettyprint">helpHints.definition</code></td>
1732
+ </tr>
1733
+
1734
+ </tbody>
1735
+ </table>
1736
+
1737
+ </dd>
1738
+
1739
+
1740
+ <dt class="">
1741
+
1742
+ <h4 id="helpHints.source" class="name">
1743
+
1744
+ <span class="type-signature"></span>help-hints.source<span class="type-signature"> :string</span>
1745
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#helpHints.source"></a>
1746
+
1747
+ </h4>
1748
+
1749
+
1750
+ </dt>
1751
+
1752
+ <dd class="">
1753
+
1754
+ <div class="description">
1755
+ Help source URL associated with the component.
1756
+ </div>
1757
+
1758
+
1759
+
1760
+
1761
+ <dl class="details">
1762
+
1763
+
1764
+
1765
+
1766
+
1767
+ <dt class="tag-default">Default Value:</dt>
1768
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">""</code></li></ul></dd>
1769
+
1770
+
1771
+
1772
+
1773
+
1774
+
1775
+
1776
+
1777
+
1778
+
1779
+
1780
+
1781
+
1782
+
1783
+
1784
+
1785
+
1786
+
1787
+
1788
+
1789
+
1790
+
1791
+
1792
+
1793
+
1794
+ </dl>
1795
+
1796
+
1797
+
1798
+ <h5>Names</h5>
1799
+ <table class="keyboard-table">
1800
+ <thead>
1801
+ <tr>
1802
+ <th>Item</th>
1803
+ <th>Name</th>
1804
+ </tr>
1805
+ </thead>
1806
+ <tbody>
1807
+ <tr>
1808
+ <td>Property</td>
1809
+ <td><code class="prettyprint">helpHints.source</code></td>
1810
+ </tr>
1811
+
1812
+ </tbody>
1813
+ </table>
1814
+
1815
+ </dd>
1816
+
1817
+
1818
+ <dt class="">
1819
+
1820
+ <h4 id="helpHints.sourceText" class="name">
1821
+
1822
+ <span class="type-signature"></span>help-hints.source-text<span class="type-signature"> :string</span>
1823
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#helpHints.sourceText"></a>
1824
+
1825
+ </h4>
1826
+
1827
+
1828
+ </dt>
1829
+
1830
+ <dd class="">
1831
+
1832
+ <div class="description">
1833
+ Custom text to be used for the source link.
1834
+ </div>
1835
+
1836
+
1837
+
1838
+
1839
+ <dl class="details">
1840
+
1841
+
1842
+
1843
+
1844
+
1845
+
1846
+
1847
+
1848
+
1849
+
1850
+
1851
+
1852
+
1853
+
1854
+
1855
+
1856
+
1857
+
1858
+
1859
+
1860
+
1861
+
1862
+
1863
+
1864
+
1865
+
1866
+
1867
+
1868
+
1869
+ </dl>
1870
+
1871
+
1872
+
1873
+ <h5>Names</h5>
1874
+ <table class="keyboard-table">
1875
+ <thead>
1876
+ <tr>
1877
+ <th>Item</th>
1878
+ <th>Name</th>
1879
+ </tr>
1880
+ </thead>
1881
+ <tbody>
1882
+ <tr>
1883
+ <td>Property</td>
1884
+ <td><code class="prettyprint">helpHints.sourceText</code></td>
1885
+ </tr>
1886
+
1887
+ </tbody>
1888
+ </table>
1889
+
1890
+ </dd>
1891
+
1892
+
1893
+ <dt class="">
1894
+
1895
+ <h4 id="labelEdge" class="name">
1896
+
1897
+ <span class="type-signature"></span>label-edge<span class="type-signature"> :"inside"|"none"|"start"|"top"</span>
1898
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#labelEdge"></a>
1899
+
1900
+ </h4>
1901
+
1902
+
1903
+ </dt>
1904
+
1905
+ <dd class="">
1906
+
1907
+ <div class="description">
1908
+ Specifies how the label of the component is positioned when the label-hint
1909
+ attribute is set on the component.
1910
+ </div>
1911
+
1912
+
1913
+
1914
+
1915
+ <dl class="details">
1916
+
1917
+
1918
+
1919
+
1920
+ <h5 class="subsection-title">Supported Values:</h5>
1921
+
1922
+ <dl>
1923
+
1924
+ <table class="props">
1925
+ <thead>
1926
+ <tr>
1927
+
1928
+ <th>Value</th>
1929
+
1930
+
1931
+
1932
+
1933
+
1934
+
1935
+
1936
+ <th class="last">Description</th>
1937
+
1938
+ </tr>
1939
+ </thead>
1940
+
1941
+ <tbody>
1942
+
1943
+
1944
+ <tr>
1945
+
1946
+ <td class="name"><code>inside</code></td>
1947
+
1948
+
1949
+
1950
+
1951
+
1952
+
1953
+
1954
+ <td class="description last">The label floats over the input element, but moves up on focus or when the component has a value (default, if unspecified).
1955
+ </td>
1956
+
1957
+ </tr>
1958
+
1959
+
1960
+
1961
+ <tr>
1962
+
1963
+ <td class="name"><code>none</code></td>
1964
+
1965
+
1966
+
1967
+
1968
+
1969
+
1970
+
1971
+ <td class="description last">The component will not create a label, but instead set the aria-label property on the input element.
1972
+ </td>
1973
+
1974
+ </tr>
1975
+
1976
+
1977
+
1978
+ <tr>
1979
+
1980
+ <td class="name"><code>start</code></td>
1981
+
1982
+
1983
+
1984
+
1985
+
1986
+
1987
+
1988
+ <td class="description last">The label will be placed before the start of the component.
1989
+ </td>
1990
+
1991
+ </tr>
1992
+
1993
+
1994
+
1995
+ <tr>
1996
+
1997
+ <td class="name"><code>top</code></td>
1998
+
1999
+
2000
+
2001
+
2002
+
2003
+
2004
+
2005
+ <td class="description last">The label will be placed on top of the component.
2006
+ </td>
2007
+
2008
+ </tr>
2009
+
2010
+
2011
+ </tbody>
2012
+ </table></dl>
2013
+
2014
+
2015
+
2016
+
2017
+
2018
+
2019
+
2020
+
2021
+
2022
+
2023
+
2024
+
2025
+
2026
+
2027
+
2028
+
2029
+
2030
+
2031
+
2032
+
2033
+
2034
+
2035
+
2036
+
2037
+
2038
+
2039
+
2040
+
2041
+ </dl>
2042
+
2043
+
2044
+
2045
+ <h5>Names</h5>
2046
+ <table class="keyboard-table">
2047
+ <thead>
2048
+ <tr>
2049
+ <th>Item</th>
2050
+ <th>Name</th>
2051
+ </tr>
2052
+ </thead>
2053
+ <tbody>
2054
+ <tr>
2055
+ <td>Property</td>
2056
+ <td><code class="prettyprint">labelEdge</code></td>
2057
+ </tr>
2058
+
2059
+ <tr>
2060
+ <td>Property change event</td>
2061
+ <td><code class="prettyprint">labelEdgeChanged</code></td>
2062
+ </tr>
2063
+ <tr>
2064
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
2065
+ <td><code class="pretty-print-noprettify">on-label-edge-changed</code></td>
2066
+ </tr>
2067
+
2068
+ </tbody>
2069
+ </table>
2070
+
2071
+ </dd>
2072
+
2073
+
2074
+ <dt class="">
2075
+
2076
+ <h4 id="labelHint" class="name">
2077
+
2078
+ <span class="type-signature"></span>label-hint<span class="type-signature"> :string</span>
2079
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#labelHint"></a>
2080
+
2081
+ </h4>
2082
+
2083
+
2084
+ </dt>
2085
+
2086
+ <dd class="">
2087
+
2088
+ <div class="description">
2089
+ Represents a hint for rendering a label on the component.
2090
+ This is used in combination with the label-edge attribute to control how the label should be rendered.
2091
+ </div>
2092
+
2093
+
2094
+
2095
+
2096
+ <dl class="details">
2097
+
2098
+
2099
+
2100
+
2101
+
2102
+
2103
+
2104
+
2105
+
2106
+
2107
+
2108
+
2109
+
2110
+
2111
+
2112
+
2113
+
2114
+
2115
+
2116
+
2117
+
2118
+
2119
+
2120
+
2121
+
2122
+
2123
+
2124
+
2125
+
2126
+ </dl>
2127
+
2128
+
2129
+
2130
+ <h5>Names</h5>
2131
+ <table class="keyboard-table">
2132
+ <thead>
2133
+ <tr>
2134
+ <th>Item</th>
2135
+ <th>Name</th>
2136
+ </tr>
2137
+ </thead>
2138
+ <tbody>
2139
+ <tr>
2140
+ <td>Property</td>
2141
+ <td><code class="prettyprint">labelHint</code></td>
2142
+ </tr>
2143
+
2144
+ <tr>
2145
+ <td>Property change event</td>
2146
+ <td><code class="prettyprint">labelHintChanged</code></td>
2147
+ </tr>
2148
+ <tr>
2149
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
2150
+ <td><code class="pretty-print-noprettify">on-label-hint-changed</code></td>
2151
+ </tr>
2152
+
2153
+ </tbody>
2154
+ </table>
2155
+
2156
+ </dd>
2157
+
2158
+
2159
+ <dt class="">
2160
+
2161
+ <h4 id="labelStartWidth" class="name">
2162
+
2163
+ <span class="type-signature"></span>label-start-width<span class="type-signature"> :string</span>
2164
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#labelStartWidth"></a>
2165
+
2166
+ </h4>
2167
+
2168
+
2169
+ </dt>
2170
+
2171
+ <dd class="">
2172
+
2173
+ <div class="description">
2174
+ The width of the label when labelEdge is 'start'.
2175
+ </div>
2176
+
2177
+
2178
+
2179
+
2180
+ <dl class="details">
2181
+
2182
+
2183
+
2184
+
2185
+
2186
+
2187
+
2188
+
2189
+
2190
+
2191
+
2192
+
2193
+
2194
+
2195
+
2196
+
2197
+
2198
+
2199
+
2200
+
2201
+
2202
+
2203
+
2204
+
2205
+
2206
+
2207
+
2208
+
2209
+
2210
+ </dl>
2211
+
2212
+
2213
+
2214
+ <h5>Names</h5>
2215
+ <table class="keyboard-table">
2216
+ <thead>
2217
+ <tr>
2218
+ <th>Item</th>
2219
+ <th>Name</th>
2220
+ </tr>
2221
+ </thead>
2222
+ <tbody>
2223
+ <tr>
2224
+ <td>Property</td>
2225
+ <td><code class="prettyprint">labelStartWidth</code></td>
2226
+ </tr>
2227
+
2228
+ <tr>
2229
+ <td>Property change event</td>
2230
+ <td><code class="prettyprint">labelStartWidthChanged</code></td>
2231
+ </tr>
2232
+ <tr>
2233
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
2234
+ <td><code class="pretty-print-noprettify">on-label-start-width-changed</code></td>
2235
+ </tr>
2236
+
2237
+ </tbody>
2238
+ </table>
2239
+
2240
+ </dd>
2241
+
2242
+
2243
+ <dt class="">
2244
+
2245
+ <h4 id="labelWrapping" class="name">
2246
+
2247
+ <span class="type-signature"></span>label-wrapping<span class="type-signature"> :"truncate"|"wrap"</span>
2248
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#labelWrapping"></a>
2249
+
2250
+ </h4>
2251
+
2252
+
2253
+ </dt>
2254
+
2255
+ <dd class="">
2256
+
2257
+ <div class="description">
2258
+ Should the labels wrap or truncate when there is not enough available space.
2259
+ </div>
2260
+
2261
+
2262
+
2263
+
2264
+ <dl class="details">
2265
+
2266
+
2267
+
2268
+
2269
+ <h5 class="subsection-title">Supported Values:</h5>
2270
+
2271
+ <dl>
2272
+
2273
+ <table class="props">
2274
+ <thead>
2275
+ <tr>
2276
+
2277
+ <th>Value</th>
2278
+
2279
+
2280
+
2281
+
2282
+
2283
+
2284
+
2285
+ <th class="last">Description</th>
2286
+
2287
+ </tr>
2288
+ </thead>
2289
+
2290
+ <tbody>
2291
+
2292
+
2293
+ <tr>
2294
+
2295
+ <td class="name"><code>truncate</code></td>
2296
+
2297
+
2298
+
2299
+
2300
+
2301
+
2302
+
2303
+ <td class="description last">Label will truncate if needed.
2304
+ </td>
2305
+
2306
+ </tr>
2307
+
2308
+
2309
+
2310
+ <tr>
2311
+
2312
+ <td class="name"><code>wrap</code></td>
2313
+
2314
+
2315
+
2316
+
2317
+
2318
+
2319
+
2320
+ <td class="description last">Label will wrap if needed.
2321
+ </td>
2322
+
2323
+ </tr>
2324
+
2325
+
2326
+ </tbody>
2327
+ </table></dl>
2328
+
2329
+
2330
+
2331
+
2332
+
2333
+
2334
+
2335
+
2336
+
2337
+
2338
+
2339
+
2340
+
2341
+
2342
+
2343
+
2344
+
2345
+
2346
+
2347
+
2348
+
2349
+
2350
+
2351
+
2352
+
2353
+
2354
+
2355
+
2356
+ </dl>
2357
+
2358
+
2359
+
2360
+ <h5>Names</h5>
2361
+ <table class="keyboard-table">
2362
+ <thead>
2363
+ <tr>
2364
+ <th>Item</th>
2365
+ <th>Name</th>
2366
+ </tr>
2367
+ </thead>
2368
+ <tbody>
2369
+ <tr>
2370
+ <td>Property</td>
2371
+ <td><code class="prettyprint">labelWrapping</code></td>
2372
+ </tr>
2373
+
2374
+ <tr>
2375
+ <td>Property change event</td>
2376
+ <td><code class="prettyprint">labelWrappingChanged</code></td>
2377
+ </tr>
2378
+ <tr>
2379
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
2380
+ <td><code class="pretty-print-noprettify">on-label-wrapping-changed</code></td>
2381
+ </tr>
2382
+
2383
+ </tbody>
2384
+ </table>
2385
+
2386
+ </dd>
2387
+
2388
+
2389
+ <dt class="">
2390
+
2391
+ <h4 id="maskIcon" class="name">
2392
+
2393
+ <span class="type-signature"></span>mask-icon<span class="type-signature"> :"hidden"|"visible"</span>
2394
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#maskIcon"></a>
2395
+
2396
+ </h4>
2397
+
2398
+
2399
+ </dt>
2400
+
2401
+ <dd class="">
2402
+
2403
+ <div class="description">
2404
+ The user can click on the mask icon to toggle the visibility of the password.
2405
+ When the user leaves the field, the password is automatically masked.
2406
+ If maskIcon is set to hidden, then the user has no way to toggle the visibility of the password.
2407
+ </div>
2408
+
2409
+
2410
+
2411
+
2412
+ <dl class="details">
2413
+
2414
+
2415
+
2416
+
2417
+ <h5 class="subsection-title">Supported Values:</h5>
2418
+
2419
+ <dl>
2420
+
2421
+ <table class="props">
2422
+ <thead>
2423
+ <tr>
2424
+
2425
+ <th>Value</th>
2426
+
2427
+
2428
+
2429
+
2430
+
2431
+
2432
+
2433
+ <th class="last">Description</th>
2434
+
2435
+ </tr>
2436
+ </thead>
2437
+
2438
+ <tbody>
2439
+
2440
+
2441
+ <tr>
2442
+
2443
+ <td class="name"><code>hidden</code></td>
2444
+
2445
+
2446
+
2447
+
2448
+
2449
+
2450
+
2451
+ <td class="description last">The mask visibility icon is never visible.
2452
+ </td>
2453
+
2454
+ </tr>
2455
+
2456
+
2457
+
2458
+ <tr>
2459
+
2460
+ <td class="name"><code>visible</code></td>
2461
+
2462
+
2463
+
2464
+
2465
+
2466
+
2467
+
2468
+ <td class="description last">The mask visibility icon is always visible.
2469
+ </td>
2470
+
2471
+ </tr>
2472
+
2473
+
2474
+ </tbody>
2475
+ </table></dl>
2476
+
2477
+
2478
+
2479
+
2480
+ <dt class="tag-default">Default Value:</dt>
2481
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">"visible"</code></li></ul></dd>
2482
+
2483
+
2484
+
2485
+
2486
+
2487
+
2488
+
2489
+
2490
+
2491
+
2492
+
2493
+
2494
+
2495
+
2496
+
2497
+
2498
+
2499
+
2500
+
2501
+
2502
+
2503
+
2504
+
2505
+
2506
+
2507
+ </dl>
2508
+
2509
+
2510
+
2511
+ <h5>Names</h5>
2512
+ <table class="keyboard-table">
2513
+ <thead>
2514
+ <tr>
2515
+ <th>Item</th>
2516
+ <th>Name</th>
2517
+ </tr>
2518
+ </thead>
2519
+ <tbody>
2520
+ <tr>
2521
+ <td>Property</td>
2522
+ <td><code class="prettyprint">maskIcon</code></td>
2523
+ </tr>
2524
+
2525
+ <tr>
2526
+ <td>Property change event</td>
2527
+ <td><code class="prettyprint">maskIconChanged</code></td>
2528
+ </tr>
2529
+ <tr>
2530
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
2531
+ <td><code class="pretty-print-noprettify">on-mask-icon-changed</code></td>
2532
+ </tr>
2533
+
2534
+ </tbody>
2535
+ </table>
2536
+
2537
+ </dd>
2538
+
2539
+
2540
+ <dt class="">
2541
+
2542
+ <h4 id="messagesCustom" class="name">
2543
+
2544
+ <span class="type-signature"></span>messages-custom<span class="type-signature"> :Array&lt;ComponentMessageItem></span>
2545
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#messagesCustom"></a>
2546
+
2547
+ </h4>
2548
+
2549
+
2550
+ </dt>
2551
+
2552
+ <dd class="">
2553
+
2554
+ <div class="description">
2555
+ List of messages an app would add to the component when it has business/custom validation
2556
+ errors that it wants the component to show. This allows the app to perform further validation
2557
+ before sending data to the server. When this option is set the message shows to the
2558
+ user right away. To clear the custom message, set <code class="prettyprint">messagesCustom</code>
2559
+ back to an empty array.<br/>
2560
+ <p>
2561
+ See the <a href="#validation-section">Validation and Messages</a> section
2562
+ for details on when the component clears <code class="prettyprint">messagesCustom</code>;
2563
+ for example, when full validation is run.
2564
+ </p>
2565
+ </div>
2566
+
2567
+
2568
+
2569
+
2570
+ <dl class="details">
2571
+
2572
+
2573
+
2574
+
2575
+
2576
+ <dt class="tag-default">Default Value:</dt>
2577
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">[]</code></li></ul></dd>
2578
+
2579
+
2580
+
2581
+ <dt class="tag-default">Supports writeback:</dt>
2582
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">true</code></li></ul></dd>
2583
+
2584
+
2585
+
2586
+
2587
+
2588
+
2589
+
2590
+
2591
+
2592
+
2593
+
2594
+
2595
+
2596
+
2597
+
2598
+
2599
+
2600
+
2601
+
2602
+
2603
+
2604
+
2605
+
2606
+ </dl>
2607
+
2608
+
2609
+
2610
+ <h5>Names</h5>
2611
+ <table class="keyboard-table">
2612
+ <thead>
2613
+ <tr>
2614
+ <th>Item</th>
2615
+ <th>Name</th>
2616
+ </tr>
2617
+ </thead>
2618
+ <tbody>
2619
+ <tr>
2620
+ <td>Property</td>
2621
+ <td><code class="prettyprint">messagesCustom</code></td>
2622
+ </tr>
2623
+
2624
+ <tr>
2625
+ <td>Property change event</td>
2626
+ <td><code class="prettyprint">messagesCustomChanged</code></td>
2627
+ </tr>
2628
+ <tr>
2629
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
2630
+ <td><code class="pretty-print-noprettify">on-messages-custom-changed</code></td>
2631
+ </tr>
2632
+
2633
+ </tbody>
2634
+ </table>
2635
+
2636
+ </dd>
2637
+
2638
+
2639
+ <dt class="">
2640
+
2641
+ <h4 id="messagesCustom[].detail" class="name">
2642
+
2643
+ <span class="type-signature"></span>messagesCustom[].detail<span class="type-signature"> :string</span>
2644
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#messagesCustom[].detail"></a>
2645
+
2646
+ </h4>
2647
+
2648
+
2649
+ </dt>
2650
+
2651
+ <dd class="">
2652
+
2653
+
2654
+
2655
+
2656
+ <dl class="details">
2657
+
2658
+
2659
+
2660
+
2661
+
2662
+
2663
+
2664
+
2665
+
2666
+
2667
+
2668
+
2669
+
2670
+
2671
+
2672
+
2673
+
2674
+
2675
+
2676
+
2677
+
2678
+
2679
+
2680
+
2681
+
2682
+
2683
+
2684
+
2685
+
2686
+ </dl>
2687
+
2688
+
2689
+
2690
+ <div class="description">
2691
+ <b>Note: </b> This property is a subproperty of an array-valued property. <i>Such properties cannot be set individually
2692
+ either at init time via HTML attribute syntax or at runtime via JavaScript.</i> Instead, the outermost array-valued attribute, and its ancestor attributes,
2693
+ can be set at init time or runtime.
2694
+ </div>
2695
+
2696
+ </dd>
2697
+
2698
+
2699
+ <dt class="">
2700
+
2701
+ <h4 id="messagesCustom[].severity" class="name">
2702
+
2703
+ <span class="type-signature"></span>messagesCustom[].severity<span class="type-signature"> :"error"|"confirmation"|"info"|"warning"</span>
2704
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#messagesCustom[].severity"></a>
2705
+
2706
+ </h4>
2707
+
2708
+
2709
+ </dt>
2710
+
2711
+ <dd class="">
2712
+
2713
+
2714
+
2715
+
2716
+ <dl class="details">
2717
+
2718
+
2719
+
2720
+
2721
+
2722
+
2723
+
2724
+
2725
+
2726
+
2727
+
2728
+
2729
+
2730
+
2731
+
2732
+
2733
+
2734
+
2735
+
2736
+
2737
+
2738
+
2739
+
2740
+
2741
+
2742
+
2743
+
2744
+
2745
+
2746
+ </dl>
2747
+
2748
+
2749
+
2750
+ <div class="description">
2751
+ <b>Note: </b> This property is a subproperty of an array-valued property. <i>Such properties cannot be set individually
2752
+ either at init time via HTML attribute syntax or at runtime via JavaScript.</i> Instead, the outermost array-valued attribute, and its ancestor attributes,
2753
+ can be set at init time or runtime.
2754
+ </div>
2755
+
2756
+ </dd>
2757
+
2758
+
2759
+ <dt class="">
2760
+
2761
+ <h4 id="messagesCustom[].summary" class="name">
2762
+
2763
+ <span class="type-signature"></span>messagesCustom[].summary<span class="type-signature"> :string</span>
2764
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#messagesCustom[].summary"></a>
2765
+
2766
+ </h4>
2767
+
2768
+
2769
+ </dt>
2770
+
2771
+ <dd class="">
2772
+
2773
+
2774
+
2775
+
2776
+ <dl class="details">
2777
+
2778
+
2779
+
2780
+
2781
+
2782
+
2783
+
2784
+
2785
+
2786
+
2787
+
2788
+
2789
+
2790
+
2791
+
2792
+
2793
+
2794
+
2795
+
2796
+
2797
+
2798
+
2799
+
2800
+
2801
+
2802
+
2803
+
2804
+
2805
+
2806
+ </dl>
2807
+
2808
+
2809
+
2810
+ <div class="description">
2811
+ <b>Note: </b> This property is a subproperty of an array-valued property. <i>Such properties cannot be set individually
2812
+ either at init time via HTML attribute syntax or at runtime via JavaScript.</i> Instead, the outermost array-valued attribute, and its ancestor attributes,
2813
+ can be set at init time or runtime.
2814
+ </div>
2815
+
2816
+ </dd>
2817
+
2818
+
2819
+ <dt class="">
2820
+
2821
+ <h4 id="placeholder" class="name">
2822
+
2823
+ <span class="type-signature"></span>placeholder<span class="type-signature"> :string</span>
2824
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#placeholder"></a>
2825
+
2826
+ </h4>
2827
+
2828
+
2829
+ </dt>
2830
+
2831
+ <dd class="">
2832
+
2833
+ <div class="description">
2834
+ The placeholder text to set on the element.
2835
+ </div>
2836
+
2837
+
2838
+
2839
+
2840
+ <dl class="details">
2841
+
2842
+
2843
+
2844
+
2845
+
2846
+
2847
+
2848
+
2849
+
2850
+
2851
+
2852
+
2853
+
2854
+
2855
+
2856
+
2857
+
2858
+
2859
+
2860
+
2861
+
2862
+
2863
+
2864
+
2865
+
2866
+
2867
+
2868
+
2869
+
2870
+ </dl>
2871
+
2872
+
2873
+
2874
+ <h5>Names</h5>
2875
+ <table class="keyboard-table">
2876
+ <thead>
2877
+ <tr>
2878
+ <th>Item</th>
2879
+ <th>Name</th>
2880
+ </tr>
2881
+ </thead>
2882
+ <tbody>
2883
+ <tr>
2884
+ <td>Property</td>
2885
+ <td><code class="prettyprint">placeholder</code></td>
2886
+ </tr>
2887
+
2888
+ <tr>
2889
+ <td>Property change event</td>
2890
+ <td><code class="prettyprint">placeholderChanged</code></td>
2891
+ </tr>
2892
+ <tr>
2893
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
2894
+ <td><code class="pretty-print-noprettify">on-placeholder-changed</code></td>
2895
+ </tr>
2896
+
2897
+ </tbody>
2898
+ </table>
2899
+
2900
+ </dd>
2901
+
2902
+
2903
+ <dt class="">
2904
+
2905
+ <h4 id="rawValue" class="name">
2906
+
2907
+ <span class="type-signature">(readonly) </span>raw-value<span class="type-signature"> :string</span>
2908
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#rawValue"></a>
2909
+
2910
+ </h4>
2911
+
2912
+
2913
+ </dt>
2914
+
2915
+ <dd class="">
2916
+
2917
+ <div class="description">
2918
+ <p>The <code class="prettyprint">rawValue</code> is the read-only property for retrieving
2919
+ the current value from the input field in string form. The main consumer of
2920
+ <code class="prettyprint">rawValue</code> is a converter.</p>
2921
+ <p>
2922
+ The <code class="prettyprint">rawValue</code> updates on the 'input' javascript event,
2923
+ so the <code class="prettyprint">rawValue</code> changes as the value of the input is changed.
2924
+ If the user types in '1,200' into the field, the rawValue will be '1', then '1,', then '1,2',
2925
+ ..., and finally '1,200'. Then when the user blurs or presses
2926
+ Enter the <code class="prettyprint">value</code> property gets converted and validated
2927
+ (if there is a converter or validators) and then gets updated if valid.
2928
+ </p>
2929
+ <p>This is a read-only attribute so page authors cannot set or change it directly.</p>
2930
+ </div>
2931
+
2932
+
2933
+
2934
+
2935
+ <dl class="details">
2936
+
2937
+
2938
+
2939
+
2940
+
2941
+
2942
+
2943
+ <dt class="tag-default">Supports writeback:</dt>
2944
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">true</code></li></ul></dd>
2945
+
2946
+
2947
+
2948
+
2949
+
2950
+
2951
+
2952
+
2953
+
2954
+
2955
+
2956
+
2957
+
2958
+
2959
+
2960
+
2961
+
2962
+
2963
+
2964
+
2965
+
2966
+
2967
+
2968
+ </dl>
2969
+
2970
+
2971
+
2972
+ <h5>Names</h5>
2973
+ <table class="keyboard-table">
2974
+ <thead>
2975
+ <tr>
2976
+ <th>Item</th>
2977
+ <th>Name</th>
2978
+ </tr>
2979
+ </thead>
2980
+ <tbody>
2981
+ <tr>
2982
+ <td>Property</td>
2983
+ <td><code class="prettyprint">rawValue</code></td>
2984
+ </tr>
2985
+
2986
+ <tr>
2987
+ <td>Property change event</td>
2988
+ <td><code class="prettyprint">rawValueChanged</code></td>
2989
+ </tr>
2990
+ <tr>
2991
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
2992
+ <td><code class="pretty-print-noprettify">on-raw-value-changed</code></td>
2993
+ </tr>
2994
+
2995
+ </tbody>
2996
+ </table>
2997
+
2998
+ </dd>
2999
+
3000
+
3001
+ <dt class="">
3002
+
3003
+ <h4 id="readonly" class="name">
3004
+
3005
+ <span class="type-signature"></span>readonly<span class="type-signature"> :boolean</span>
3006
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#readonly"></a>
3007
+
3008
+ </h4>
3009
+
3010
+
3011
+ </dt>
3012
+
3013
+ <dd class="">
3014
+
3015
+ <div class="description">
3016
+ Whether the component is readonly. The readonly property sets or returns whether an element
3017
+ is readonly, or not. A readonly element cannot be modified. However, a user can tab to it,
3018
+ highlight it, focus on it, and copy the text from it. If you want to prevent the user from
3019
+ interacting with the element, use the disabled property instead.
3020
+ </div>
3021
+
3022
+
3023
+
3024
+
3025
+ <dl class="details">
3026
+
3027
+
3028
+
3029
+
3030
+
3031
+ <dt class="tag-default">Default Value:</dt>
3032
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">false</code></li></ul></dd>
3033
+
3034
+
3035
+
3036
+
3037
+
3038
+
3039
+
3040
+
3041
+
3042
+
3043
+
3044
+
3045
+
3046
+
3047
+
3048
+
3049
+
3050
+
3051
+
3052
+
3053
+
3054
+
3055
+
3056
+
3057
+
3058
+ </dl>
3059
+
3060
+
3061
+
3062
+ <h5>Names</h5>
3063
+ <table class="keyboard-table">
3064
+ <thead>
3065
+ <tr>
3066
+ <th>Item</th>
3067
+ <th>Name</th>
3068
+ </tr>
3069
+ </thead>
3070
+ <tbody>
3071
+ <tr>
3072
+ <td>Property</td>
3073
+ <td><code class="prettyprint">readonly</code></td>
3074
+ </tr>
3075
+
3076
+ <tr>
3077
+ <td>Property change event</td>
3078
+ <td><code class="prettyprint">readonlyChanged</code></td>
3079
+ </tr>
3080
+ <tr>
3081
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
3082
+ <td><code class="pretty-print-noprettify">on-readonly-changed</code></td>
3083
+ </tr>
3084
+
3085
+ </tbody>
3086
+ </table>
3087
+
3088
+ </dd>
3089
+
3090
+
3091
+ <dt class="">
3092
+
3093
+ <h4 id="required" class="name">
3094
+
3095
+ <span class="type-signature"></span>required<span class="type-signature"> :boolean</span>
3096
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#required"></a>
3097
+
3098
+ </h4>
3099
+
3100
+
3101
+ </dt>
3102
+
3103
+ <dd class="">
3104
+
3105
+ <div class="description">
3106
+ <p>
3107
+ This property set to <code class="prettyprint">false</code> implies that a value is not required to be provided by the user.
3108
+ This is the default.
3109
+ This property set to <code class="prettyprint">true</code> implies that a value is required to be provided by the user.
3110
+ </p>
3111
+ <p>
3112
+ In the Redwood theme, by default, a Required text is rendered inline when the field is empty.
3113
+ If user-assistance-density is 'compact', it will show on the label as an icon.
3114
+ </p>
3115
+ <p>The Required error text is based on Redwood UX designs, and it is not recommended that
3116
+ it be changed.
3117
+ To override the required error message,
3118
+ use the <code class="prettyprint">required-message-detail</code> attribute.
3119
+ The component's label text is passed in as a token {label} and can be used in the message detail.
3120
+ </p>
3121
+ <p>When required is set to true, an implicit
3122
+ required validator is created, i.e.,
3123
+ <code class="prettyprint">new RequiredValidator()</code>. The required validator is the only
3124
+ validator to run during initial render, and its error is not shown to the user at this time;
3125
+ this is called deferred validation. The required validator also runs during normal validation;
3126
+ this is when the errors are shown to the user.
3127
+ See the <a href="#validation-section">Validation and Messaging</a> section for details.
3128
+ </p>
3129
+ <p>
3130
+ When the <code class="prettyprint">required</code> property changes due to programmatic intervention,
3131
+ the component may clear component messages and run validation, based on the current state it's in. </br>
3132
+
3133
+ <h4>Running Validation when required property changes</h4>
3134
+ <ul>
3135
+ <li>if component is valid when required is set to true, then it runs deferred validation on
3136
+ the value property. If the field is empty, the valid state is invalidHidden. No errors are
3137
+ shown to the user.
3138
+ </li>
3139
+ <li>if component is invalid and has deferred messages when required is set to false, then
3140
+ component messages are cleared (messages-custom messages are not cleared)
3141
+ but no deferred validation is run because required is false.
3142
+ </li>
3143
+ <li>if component is invalid and currently showing invalid messages when required is set, then
3144
+ component messages are cleared and normal validation is run using the current display value.
3145
+ <ul>
3146
+ <li>if there are validation errors, then <code class="prettyprint">value</code>
3147
+ property is not updated and the error is shown.
3148
+ </li>
3149
+ <li>if no errors result from the validation, the <code class="prettyprint">value</code>
3150
+ property is updated; page author can listen to the <code class="prettyprint">valueChanged</code>
3151
+ event on the component to clear custom errors.</li>
3152
+ </ul>
3153
+ </li>
3154
+ </ul>
3155
+
3156
+ <h4>Clearing Messages when required property changes</h4>
3157
+ <ul>
3158
+ <li>Only messages created by the component, like validation messages, are cleared when the required property changes.</li>
3159
+ <li><code class="prettyprint">messagesCustom</code> property is not cleared.</li>
3160
+ </ul>
3161
+
3162
+ </p>
3163
+ </div>
3164
+
3165
+
3166
+
3167
+
3168
+ <dl class="details">
3169
+
3170
+
3171
+
3172
+
3173
+
3174
+ <dt class="tag-default">Default Value:</dt>
3175
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">false</code></li></ul></dd>
3176
+
3177
+
3178
+
3179
+
3180
+
3181
+
3182
+
3183
+
3184
+
3185
+
3186
+
3187
+
3188
+
3189
+
3190
+
3191
+
3192
+
3193
+
3194
+
3195
+
3196
+
3197
+
3198
+
3199
+
3200
+
3201
+ </dl>
3202
+
3203
+
3204
+
3205
+ <h5>Names</h5>
3206
+ <table class="keyboard-table">
3207
+ <thead>
3208
+ <tr>
3209
+ <th>Item</th>
3210
+ <th>Name</th>
3211
+ </tr>
3212
+ </thead>
3213
+ <tbody>
3214
+ <tr>
3215
+ <td>Property</td>
3216
+ <td><code class="prettyprint">required</code></td>
3217
+ </tr>
3218
+
3219
+ <tr>
3220
+ <td>Property change event</td>
3221
+ <td><code class="prettyprint">requiredChanged</code></td>
3222
+ </tr>
3223
+ <tr>
3224
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
3225
+ <td><code class="pretty-print-noprettify">on-required-changed</code></td>
3226
+ </tr>
3227
+
3228
+ </tbody>
3229
+ </table>
3230
+
3231
+ </dd>
3232
+
3233
+
3234
+ <dt class="">
3235
+
3236
+ <h4 id="requiredMessageDetail" class="name">
3237
+
3238
+ <span class="type-signature"></span>required-message-detail<span class="type-signature"> :string</span>
3239
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#requiredMessageDetail"></a>
3240
+
3241
+ </h4>
3242
+
3243
+
3244
+ </dt>
3245
+
3246
+ <dd class="">
3247
+
3248
+ <div class="description">
3249
+ <p>
3250
+ The component-specific message detail when the required validation fails.
3251
+ If the component needs a required validation error message that is different from the default,
3252
+ set this property. It should be a translated string.
3253
+ </p>
3254
+ </div>
3255
+
3256
+
3257
+
3258
+
3259
+ <dl class="details">
3260
+
3261
+
3262
+
3263
+
3264
+
3265
+
3266
+
3267
+
3268
+
3269
+
3270
+
3271
+
3272
+
3273
+
3274
+
3275
+
3276
+
3277
+
3278
+
3279
+
3280
+
3281
+
3282
+
3283
+
3284
+
3285
+
3286
+
3287
+
3288
+
3289
+ </dl>
3290
+
3291
+
3292
+
3293
+ <h5>Names</h5>
3294
+ <table class="keyboard-table">
3295
+ <thead>
3296
+ <tr>
3297
+ <th>Item</th>
3298
+ <th>Name</th>
3299
+ </tr>
3300
+ </thead>
3301
+ <tbody>
3302
+ <tr>
3303
+ <td>Property</td>
3304
+ <td><code class="prettyprint">requiredMessageDetail</code></td>
3305
+ </tr>
3306
+
3307
+ <tr>
3308
+ <td>Property change event</td>
3309
+ <td><code class="prettyprint">requiredMessageDetailChanged</code></td>
3310
+ </tr>
3311
+ <tr>
3312
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
3313
+ <td><code class="pretty-print-noprettify">on-required-message-detail-changed</code></td>
3314
+ </tr>
3315
+
3316
+ </tbody>
3317
+ </table>
3318
+
3319
+ </dd>
3320
+
3321
+
3322
+ <dt class="">
3323
+
3324
+ <h4 id="textAlign" class="name">
3325
+
3326
+ <span class="type-signature"></span>text-align<span class="type-signature"> :"start"|"end"|"right"</span>
3327
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#textAlign"></a>
3328
+
3329
+ </h4>
3330
+
3331
+
3332
+ </dt>
3333
+
3334
+ <dd class="">
3335
+
3336
+ <div class="description">
3337
+ Specifies how the text is aligned within the text field
3338
+ </div>
3339
+
3340
+
3341
+
3342
+
3343
+ <dl class="details">
3344
+
3345
+
3346
+
3347
+
3348
+ <h5 class="subsection-title">Supported Values:</h5>
3349
+
3350
+ <dl>
3351
+
3352
+ <table class="props">
3353
+ <thead>
3354
+ <tr>
3355
+
3356
+ <th>Value</th>
3357
+
3358
+
3359
+
3360
+
3361
+
3362
+
3363
+
3364
+ <th class="last">Description</th>
3365
+
3366
+ </tr>
3367
+ </thead>
3368
+
3369
+ <tbody>
3370
+
3371
+
3372
+ <tr>
3373
+
3374
+ <td class="name"><code>end</code></td>
3375
+
3376
+
3377
+
3378
+
3379
+
3380
+
3381
+
3382
+ <td class="description last">Aligns text right when reading direction is ltr and left when reading direction is rtl.
3383
+ </td>
3384
+
3385
+ </tr>
3386
+
3387
+
3388
+
3389
+ <tr>
3390
+
3391
+ <td class="name"><code>right</code></td>
3392
+
3393
+
3394
+
3395
+
3396
+
3397
+
3398
+
3399
+ <td class="description last">Aligns text right regardless of reading direction, often used for numbers.
3400
+ </td>
3401
+
3402
+ </tr>
3403
+
3404
+
3405
+
3406
+ <tr>
3407
+
3408
+ <td class="name"><code>start</code></td>
3409
+
3410
+
3411
+
3412
+
3413
+
3414
+
3415
+
3416
+ <td class="description last">Aligns text left when reading direction is ltr and right when reading direction is rtl (default, if unspecified).
3417
+ </td>
3418
+
3419
+ </tr>
3420
+
3421
+
3422
+ </tbody>
3423
+ </table></dl>
3424
+
3425
+
3426
+
3427
+
3428
+
3429
+
3430
+
3431
+
3432
+
3433
+
3434
+
3435
+
3436
+
3437
+
3438
+
3439
+
3440
+
3441
+
3442
+
3443
+
3444
+
3445
+
3446
+
3447
+
3448
+
3449
+
3450
+
3451
+
3452
+ </dl>
3453
+
3454
+
3455
+
3456
+ <h5>Names</h5>
3457
+ <table class="keyboard-table">
3458
+ <thead>
3459
+ <tr>
3460
+ <th>Item</th>
3461
+ <th>Name</th>
3462
+ </tr>
3463
+ </thead>
3464
+ <tbody>
3465
+ <tr>
3466
+ <td>Property</td>
3467
+ <td><code class="prettyprint">textAlign</code></td>
3468
+ </tr>
3469
+
3470
+ <tr>
3471
+ <td>Property change event</td>
3472
+ <td><code class="prettyprint">textAlignChanged</code></td>
3473
+ </tr>
3474
+ <tr>
3475
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
3476
+ <td><code class="pretty-print-noprettify">on-text-align-changed</code></td>
3477
+ </tr>
3478
+
3479
+ </tbody>
3480
+ </table>
3481
+
3482
+ </dd>
3483
+
3484
+
3485
+ <dt class="">
3486
+
3487
+ <h4 id="userAssistanceDensity" class="name">
3488
+
3489
+ <span class="type-signature"></span>user-assistance-density<span class="type-signature"> :"reflow"|"efficient"</span>
3490
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#userAssistanceDensity"></a>
3491
+
3492
+ </h4>
3493
+
3494
+
3495
+ </dt>
3496
+
3497
+ <dd class="">
3498
+
3499
+ <div class="description">
3500
+ Specifies the density of the form component's user assistance presentation. It can be shown inline with
3501
+ reserved rows to prevent reflow if a user assistance text shows up, inline without reserved rows that would
3502
+ reflow if a user assistance text shows up, or it can be shown compactly in a popup instead.
3503
+ </div>
3504
+
3505
+
3506
+
3507
+
3508
+ <dl class="details">
3509
+
3510
+
3511
+
3512
+
3513
+ <h5 class="subsection-title">Supported Values:</h5>
3514
+
3515
+ <dl>
3516
+
3517
+ <table class="props">
3518
+ <thead>
3519
+ <tr>
3520
+
3521
+ <th>Value</th>
3522
+
3523
+
3524
+
3525
+
3526
+
3527
+
3528
+
3529
+ <th class="last">Description</th>
3530
+
3531
+ </tr>
3532
+ </thead>
3533
+
3534
+ <tbody>
3535
+
3536
+
3537
+ <tr>
3538
+
3539
+ <td class="name"><code>efficient</code></td>
3540
+
3541
+
3542
+
3543
+
3544
+
3545
+
3546
+
3547
+ <td class="description last">Messages, help, hints, and required are all shown inline under the field with reserved space.
3548
+ </td>
3549
+
3550
+ </tr>
3551
+
3552
+
3553
+
3554
+ <tr>
3555
+
3556
+ <td class="name"><code>reflow</code></td>
3557
+
3558
+
3559
+
3560
+
3561
+
3562
+
3563
+
3564
+ <td class="description last">Messages, help, hints, and required are all shown inline under the field with no reserved space.
3565
+ </td>
3566
+
3567
+ </tr>
3568
+
3569
+
3570
+ </tbody>
3571
+ </table></dl>
3572
+
3573
+
3574
+
3575
+
3576
+ <dt class="tag-default">Default Value:</dt>
3577
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">"reflow"</code></li></ul></dd>
3578
+
3579
+
3580
+
3581
+
3582
+
3583
+
3584
+
3585
+
3586
+
3587
+
3588
+
3589
+
3590
+
3591
+
3592
+
3593
+
3594
+
3595
+
3596
+
3597
+
3598
+
3599
+
3600
+
3601
+
3602
+
3603
+ </dl>
3604
+
3605
+
3606
+
3607
+ <h5>Names</h5>
3608
+ <table class="keyboard-table">
3609
+ <thead>
3610
+ <tr>
3611
+ <th>Item</th>
3612
+ <th>Name</th>
3613
+ </tr>
3614
+ </thead>
3615
+ <tbody>
3616
+ <tr>
3617
+ <td>Property</td>
3618
+ <td><code class="prettyprint">userAssistanceDensity</code></td>
3619
+ </tr>
3620
+
3621
+ <tr>
3622
+ <td>Property change event</td>
3623
+ <td><code class="prettyprint">userAssistanceDensityChanged</code></td>
3624
+ </tr>
3625
+ <tr>
3626
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
3627
+ <td><code class="pretty-print-noprettify">on-user-assistance-density-changed</code></td>
3628
+ </tr>
3629
+
3630
+ </tbody>
3631
+ </table>
3632
+
3633
+ </dd>
3634
+
3635
+
3636
+ <dt class="">
3637
+
3638
+ <h4 id="valid" class="name">
3639
+
3640
+ <span class="type-signature">(readonly) </span>valid<span class="type-signature"> :"valid"|"pending"|"invalidHidden"|"invalidShown"</span>
3641
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#valid"></a>
3642
+
3643
+ </h4>
3644
+
3645
+
3646
+ </dt>
3647
+
3648
+ <dd class="">
3649
+
3650
+ <div class="description">
3651
+ <p>The <code class="prettyprint">rawValue</code> is the read-only property for retrieving
3652
+ the current value from the input field in string form. The main consumer of
3653
+ <code class="prettyprint">rawValue</code> is a converter.</p>
3654
+ <p>
3655
+ The <code class="prettyprint">rawValue</code> updates on the 'input' javascript event,
3656
+ so the <code class="prettyprint">rawValue</code> changes as the value of the input is changed.
3657
+ If the user types in '1,200' into the field, the rawValue will be '1', then '1,', then '1,2',
3658
+ ..., and finally '1,200'. Then when the user blurs or presses
3659
+ Enter the <code class="prettyprint">value</code> property gets converted and validated
3660
+ (if there is a converter or validators) and then gets updated if valid.
3661
+ </p>
3662
+ <p>This is a read-only attribute so page authors cannot set or change it directly.</p>
3663
+ </div>
3664
+
3665
+
3666
+
3667
+
3668
+ <dl class="details">
3669
+
3670
+
3671
+
3672
+
3673
+ <h5 class="subsection-title">Supported Values:</h5>
3674
+
3675
+ <dl>
3676
+
3677
+ <table class="props">
3678
+ <thead>
3679
+ <tr>
3680
+
3681
+ <th>Value</th>
3682
+
3683
+
3684
+
3685
+
3686
+
3687
+
3688
+
3689
+ <th class="last">Description</th>
3690
+
3691
+ </tr>
3692
+ </thead>
3693
+
3694
+ <tbody>
3695
+
3696
+
3697
+ <tr>
3698
+
3699
+ <td class="name"><code>invalidHidden</code></td>
3700
+
3701
+
3702
+
3703
+
3704
+
3705
+
3706
+
3707
+ <td class="description last">The component has invalid messages hidden and no invalid messages showing. An invalid message is one with severity 'error'.
3708
+ </td>
3709
+
3710
+ </tr>
3711
+
3712
+
3713
+
3714
+ <tr>
3715
+
3716
+ <td class="name"><code>invalidShown</code></td>
3717
+
3718
+
3719
+
3720
+
3721
+
3722
+
3723
+
3724
+ <td class="description last">The component has invalid messages showing. An invalid message is one with severity 'error'.
3725
+ </td>
3726
+
3727
+ </tr>
3728
+
3729
+
3730
+
3731
+ <tr>
3732
+
3733
+ <td class="name"><code>pending</code></td>
3734
+
3735
+
3736
+
3737
+
3738
+
3739
+
3740
+
3741
+ <td class="description last">The component is waiting for the validation state to be determined. The 'pending' state is set at the start of the convert/validate process.
3742
+ </td>
3743
+
3744
+ </tr>
3745
+
3746
+
3747
+
3748
+ <tr>
3749
+
3750
+ <td class="name"><code>valid</code></td>
3751
+
3752
+
3753
+
3754
+
3755
+
3756
+
3757
+
3758
+ <td class="description last">The component is valid
3759
+ </td>
3760
+
3761
+ </tr>
3762
+
3763
+
3764
+ </tbody>
3765
+ </table></dl>
3766
+
3767
+
3768
+
3769
+
3770
+
3771
+
3772
+ <dt class="tag-default">Supports writeback:</dt>
3773
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">true</code></li></ul></dd>
3774
+
3775
+
3776
+
3777
+
3778
+
3779
+
3780
+
3781
+
3782
+
3783
+
3784
+
3785
+
3786
+
3787
+
3788
+
3789
+
3790
+
3791
+
3792
+
3793
+
3794
+
3795
+
3796
+
3797
+ </dl>
3798
+
3799
+
3800
+
3801
+ <h5>Names</h5>
3802
+ <table class="keyboard-table">
3803
+ <thead>
3804
+ <tr>
3805
+ <th>Item</th>
3806
+ <th>Name</th>
3807
+ </tr>
3808
+ </thead>
3809
+ <tbody>
3810
+ <tr>
3811
+ <td>Property</td>
3812
+ <td><code class="prettyprint">valid</code></td>
3813
+ </tr>
3814
+
3815
+ <tr>
3816
+ <td>Property change event</td>
3817
+ <td><code class="prettyprint">validChanged</code></td>
3818
+ </tr>
3819
+ <tr>
3820
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
3821
+ <td><code class="pretty-print-noprettify">on-valid-changed</code></td>
3822
+ </tr>
3823
+
3824
+ </tbody>
3825
+ </table>
3826
+
3827
+ </dd>
3828
+
3829
+
3830
+ <dt class="">
3831
+
3832
+ <h4 id="validators" class="name">
3833
+
3834
+ <span class="type-signature"></span>validators<span class="type-signature"> :Array&lt;AsyncValidator&lt;string>|Validator&lt;string>>|null</span>
3835
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#validators"></a>
3836
+
3837
+ </h4>
3838
+
3839
+
3840
+ </dt>
3841
+
3842
+ <dd class="">
3843
+
3844
+ <div class="description">
3845
+ List of validators, synchronous or asynchronous,
3846
+ used by the component
3847
+ and the implicit component validators when performing validation. Each item is either an
3848
+ instance that duck types oj.Validator or oj.AsyncValidator.
3849
+ <p>
3850
+ Implicit validators are created by the element when certain attributes are present.
3851
+ For example, if the <code class="prettyprint">required</code> attribute
3852
+ is set, an implicit oj.RequiredValidator is created.
3853
+ At runtime when the component runs validation, it
3854
+ combines all the implicit validators with all the validators
3855
+ specified through this <code class="prettyprint">validators</code> attribute
3856
+ and the <code class="prettyprint">async-validators</code> attribute, and
3857
+ runs all of them.
3858
+ </p>
3859
+ <p>
3860
+ Hints exposed by validators are shown inline by default in the Redwood theme when the
3861
+ field has focus.
3862
+ You can turn off showing validator hints by using the
3863
+ 'validatorHint' property set to 'none' on the <code class="prettyprint">display-options</code>
3864
+ attribute.
3865
+ </p>
3866
+ <p>
3867
+ In the Redwood theme, only one hint shows at a time, so the precedence rules are:
3868
+ help.instruction shows; if no help.instruction then validator hints show;
3869
+ if none, then help-hints.definition shows; if none, then converter hint shows.
3870
+ help-hints.source always shows along with the other help or hint.
3871
+ </p>
3872
+
3873
+ <p>
3874
+ When <code class="prettyprint">validators</code> property changes due to programmatic
3875
+ intervention, the component may decide to clear messages and run validation, based on the
3876
+ current state it is in. </br>
3877
+
3878
+ <h4>Steps Performed Always</h4>
3879
+ <ul>
3880
+ <li>The cached list of validator instances are cleared and new validator hints is pushed to
3881
+ messaging.
3882
+ </li>
3883
+ </ul>
3884
+
3885
+ <h4>Running Validation</h4>
3886
+ <ul>
3887
+ <li>if component is valid when validators changes, component does nothing other than the
3888
+ steps it always performs.</li>
3889
+ <li>if component is invalid and is showing messages when
3890
+ <code class="prettyprint">validators</code> or
3891
+ <code class="prettyprint">async-validators</code> changes then all component messages
3892
+ are cleared and full validation run using the display value on the component.
3893
+ <ul>
3894
+ <li>if there are validation errors, then <code class="prettyprint">value</code>
3895
+ property is not updated and the error is shown.
3896
+ </li>
3897
+ <li>if no errors result from the validation, the <code class="prettyprint">value</code>
3898
+ property is updated; page author can listen to the <code class="prettyprint">valueChanged</code>
3899
+ event to clear custom errors.</li>
3900
+ </ul>
3901
+ </li>
3902
+ <li>if component is invalid and has deferred messages when validators changes, it does
3903
+ nothing other than the steps it performs always.</li>
3904
+ </ul>
3905
+ </p>
3906
+
3907
+ <h4>Clearing Messages</h4>
3908
+ <ul>
3909
+ <li>Only messages created by the component are cleared.</li>
3910
+ <li><code class="prettyprint">messagesCustom</code> property is not cleared.</li>
3911
+ </ul>
3912
+ </p>
3913
+ </div>
3914
+
3915
+
3916
+
3917
+
3918
+ <dl class="details">
3919
+
3920
+
3921
+
3922
+
3923
+
3924
+ <dt class="tag-default">Default Value:</dt>
3925
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">[]</code></li></ul></dd>
3926
+
3927
+
3928
+
3929
+
3930
+
3931
+
3932
+
3933
+
3934
+
3935
+
3936
+
3937
+
3938
+
3939
+
3940
+
3941
+
3942
+
3943
+
3944
+
3945
+
3946
+
3947
+
3948
+
3949
+
3950
+
3951
+ </dl>
3952
+
3953
+
3954
+
3955
+ <h5>Names</h5>
3956
+ <table class="keyboard-table">
3957
+ <thead>
3958
+ <tr>
3959
+ <th>Item</th>
3960
+ <th>Name</th>
3961
+ </tr>
3962
+ </thead>
3963
+ <tbody>
3964
+ <tr>
3965
+ <td>Property</td>
3966
+ <td><code class="prettyprint">validators</code></td>
3967
+ </tr>
3968
+
3969
+ <tr>
3970
+ <td>Property change event</td>
3971
+ <td><code class="prettyprint">validatorsChanged</code></td>
3972
+ </tr>
3973
+ <tr>
3974
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
3975
+ <td><code class="pretty-print-noprettify">on-validators-changed</code></td>
3976
+ </tr>
3977
+
3978
+ </tbody>
3979
+ </table>
3980
+
3981
+ </dd>
3982
+
3983
+
3984
+ <dt class="">
3985
+
3986
+ <h4 id="value" class="name">
3987
+
3988
+ <span class="type-signature"></span>value<span class="type-signature"> :(string|null)</span>
3989
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#value"></a>
3990
+
3991
+ </h4>
3992
+
3993
+
3994
+ </dt>
3995
+
3996
+ <dd class="">
3997
+
3998
+ <div class="description">
3999
+ The value of the component.
4000
+
4001
+ <p>
4002
+ When <code class="prettyprint">value</code> property changes due to programmatic
4003
+ intervention, the component always clears all messages
4004
+ including <code class="prettyprint">messagesCustom</code>, runs deferred validation, and
4005
+ always refreshes UI display value.
4006
+ </p>
4007
+
4008
+ <p>
4009
+ When the input field is cleared and the value is committed, the <code class="prettyprint">value</code>
4010
+ property is set to <code>null</code>.
4011
+ </p>
4012
+
4013
+ <h4>Running Validation</h4>
4014
+ <ul>
4015
+ <li>component always runs deferred validation; the
4016
+ <code class="prettyprint">valid</code> property is updated with the result.</li>
4017
+ </ul>
4018
+ </div>
4019
+
4020
+
4021
+
4022
+
4023
+ <dl class="details">
4024
+
4025
+
4026
+
4027
+
4028
+
4029
+ <dt class="tag-default">Default Value:</dt>
4030
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">null</code></li></ul></dd>
4031
+
4032
+
4033
+
4034
+ <dt class="tag-default">Supports writeback:</dt>
4035
+ <dd class="tag-default"><ul class="dummy"><li><code class="prettyprint">true</code></li></ul></dd>
4036
+
4037
+
4038
+
4039
+
4040
+
4041
+
4042
+
4043
+
4044
+
4045
+
4046
+
4047
+
4048
+
4049
+
4050
+
4051
+
4052
+
4053
+
4054
+
4055
+
4056
+
4057
+
4058
+
4059
+ </dl>
4060
+
4061
+
4062
+
4063
+ <h5>Names</h5>
4064
+ <table class="keyboard-table">
4065
+ <thead>
4066
+ <tr>
4067
+ <th>Item</th>
4068
+ <th>Name</th>
4069
+ </tr>
4070
+ </thead>
4071
+ <tbody>
4072
+ <tr>
4073
+ <td>Property</td>
4074
+ <td><code class="prettyprint">value</code></td>
4075
+ </tr>
4076
+
4077
+ <tr>
4078
+ <td>Property change event</td>
4079
+ <td><code class="prettyprint">valueChanged</code></td>
4080
+ </tr>
4081
+ <tr>
4082
+ <td>Property change listener attribute (<span class="important">must be of type function, see <a href="../../../jsdocs/CustomElementOverview.html#ce-events-section" target="_blank">Events and Listeners</a> for additional information.</span>)</td>
4083
+ <td><code class="pretty-print-noprettify">on-value-changed</code></td>
4084
+ </tr>
4085
+
4086
+ </tbody>
4087
+ </table>
4088
+
4089
+ </dd>
4090
+
4091
+ </dl>
4092
+
4093
+
4094
+ <h3 id="methods-section" class="subsection-title">
4095
+ Methods
4096
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#methods-section"></a>
4097
+ </h3>
4098
+
4099
+ <dl>
4100
+
4101
+
4102
+ <dt class="">
4103
+
4104
+
4105
+
4106
+ <h4 id="getProperty" class="name">
4107
+
4108
+ <span class="type-signature"></span>getProperty<span class="signature">(property)</span><span class="type-signature"> : {<a href="CustomElementOverview.html#ce-attrs-any-section">any</a>}</span>
4109
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#getProperty"></a>
4110
+
4111
+ </h4>
4112
+
4113
+
4114
+
4115
+
4116
+
4117
+ </dt>
4118
+ <dd class="">
4119
+
4120
+
4121
+ <div class="description">
4122
+ Retrieves the value of a property or a subproperty.
4123
+
4124
+ </div>
4125
+
4126
+
4127
+
4128
+
4129
+
4130
+
4131
+
4132
+
4133
+
4134
+
4135
+
4136
+ <h5>Parameters:</h5>
4137
+
4138
+
4139
+ <table class="params">
4140
+ <thead>
4141
+ <tr>
4142
+
4143
+ <th>Name</th>
4144
+
4145
+
4146
+ <th>Type</th>
4147
+
4148
+
4149
+
4150
+
4151
+
4152
+ <th class="last">Description</th>
4153
+ </tr>
4154
+ </thead>
4155
+
4156
+ <tbody>
4157
+
4158
+
4159
+ <tr>
4160
+
4161
+ <td class="name"><code>property</code></td>
4162
+
4163
+
4164
+ <td class="type">
4165
+
4166
+ </td>
4167
+
4168
+
4169
+
4170
+
4171
+ <td class="description last">The property name to get. Supports dot notation for subproperty access.
4172
+ </td>
4173
+ </tr>
4174
+
4175
+
4176
+ </tbody>
4177
+ </table>
4178
+
4179
+
4180
+
4181
+ <dl class="details">
4182
+
4183
+
4184
+
4185
+
4186
+
4187
+
4188
+
4189
+
4190
+
4191
+
4192
+
4193
+
4194
+
4195
+
4196
+
4197
+
4198
+
4199
+
4200
+
4201
+
4202
+
4203
+
4204
+
4205
+
4206
+
4207
+
4208
+
4209
+
4210
+
4211
+ </dl>
4212
+
4213
+
4214
+
4215
+
4216
+
4217
+
4218
+
4219
+ <h5>Returns:</h5>
4220
+
4221
+
4222
+
4223
+
4224
+ <dl>
4225
+ <dt>
4226
+ Type
4227
+ </dt>
4228
+ <dd>
4229
+
4230
+ <span class="param-type"><a href="CustomElementOverview.html#ce-attrs-any-section">any</a></span>
4231
+
4232
+
4233
+ </dd>
4234
+ </dl>
4235
+
4236
+
4237
+
4238
+
4239
+
4240
+ </dd>
4241
+
4242
+
4243
+
4244
+ <dt class="">
4245
+
4246
+
4247
+
4248
+ <h4 id="reset" class="name">
4249
+
4250
+ <span class="type-signature"></span>reset<span class="signature"></span><span class="type-signature"> : {<a href="CustomElementOverview.html#ce-attrs-any-section">any</a>}</span>
4251
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#reset"></a>
4252
+
4253
+ </h4>
4254
+
4255
+
4256
+
4257
+
4258
+
4259
+ </dt>
4260
+ <dd class="">
4261
+
4262
+
4263
+ <div class="description">
4264
+ Resets the component by clearing all messages and messagesCustom attribute
4265
+ and updates the component's display value using the attribute value.
4266
+ User entered values will be erased when this method is called.
4267
+
4268
+ </div>
4269
+
4270
+
4271
+
4272
+
4273
+
4274
+
4275
+
4276
+
4277
+
4278
+
4279
+
4280
+
4281
+
4282
+ <dl class="details">
4283
+
4284
+
4285
+
4286
+
4287
+
4288
+
4289
+
4290
+
4291
+
4292
+
4293
+
4294
+
4295
+
4296
+
4297
+
4298
+
4299
+
4300
+
4301
+
4302
+
4303
+
4304
+
4305
+
4306
+
4307
+
4308
+
4309
+
4310
+
4311
+
4312
+ </dl>
4313
+
4314
+
4315
+
4316
+
4317
+
4318
+
4319
+
4320
+ <h5>Returns:</h5>
4321
+
4322
+
4323
+
4324
+
4325
+ <dl>
4326
+ <dt>
4327
+ Type
4328
+ </dt>
4329
+ <dd>
4330
+
4331
+ <span class="param-type"><a href="CustomElementOverview.html#ce-attrs-any-section">any</a></span>
4332
+
4333
+
4334
+ </dd>
4335
+ </dl>
4336
+
4337
+
4338
+
4339
+
4340
+
4341
+ </dd>
4342
+
4343
+
4344
+
4345
+ <dt class="">
4346
+
4347
+
4348
+
4349
+ <h4 id="setProperties" class="name">
4350
+
4351
+ <span class="type-signature"></span>setProperties<span class="signature">(properties)</span><span class="type-signature"> : {void}</span>
4352
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#setProperties"></a>
4353
+
4354
+ </h4>
4355
+
4356
+
4357
+
4358
+
4359
+
4360
+ </dt>
4361
+ <dd class="">
4362
+
4363
+
4364
+ <div class="description">
4365
+ Performs a batch set of properties.
4366
+
4367
+ </div>
4368
+
4369
+
4370
+
4371
+
4372
+
4373
+
4374
+
4375
+
4376
+
4377
+
4378
+
4379
+ <h5>Parameters:</h5>
4380
+
4381
+
4382
+ <table class="params">
4383
+ <thead>
4384
+ <tr>
4385
+
4386
+ <th>Name</th>
4387
+
4388
+
4389
+ <th>Type</th>
4390
+
4391
+
4392
+
4393
+
4394
+
4395
+ <th class="last">Description</th>
4396
+ </tr>
4397
+ </thead>
4398
+
4399
+ <tbody>
4400
+
4401
+
4402
+ <tr>
4403
+
4404
+ <td class="name"><code>properties</code></td>
4405
+
4406
+
4407
+ <td class="type">
4408
+
4409
+ </td>
4410
+
4411
+
4412
+
4413
+
4414
+ <td class="description last">An object containing the property and value pairs to set.
4415
+ </td>
4416
+ </tr>
4417
+
4418
+
4419
+ </tbody>
4420
+ </table>
4421
+
4422
+
4423
+
4424
+ <dl class="details">
4425
+
4426
+
4427
+
4428
+
4429
+
4430
+
4431
+
4432
+
4433
+
4434
+
4435
+
4436
+
4437
+
4438
+
4439
+
4440
+
4441
+
4442
+
4443
+
4444
+
4445
+
4446
+
4447
+
4448
+
4449
+
4450
+
4451
+
4452
+
4453
+
4454
+ </dl>
4455
+
4456
+
4457
+
4458
+
4459
+
4460
+
4461
+
4462
+ <h5>Returns:</h5>
4463
+
4464
+
4465
+
4466
+
4467
+ <dl>
4468
+ <dt>
4469
+ Type
4470
+ </dt>
4471
+ <dd>
4472
+
4473
+ <span class="param-type">void</span>
4474
+
4475
+
4476
+ </dd>
4477
+ </dl>
4478
+
4479
+
4480
+
4481
+
4482
+
4483
+ </dd>
4484
+
4485
+
4486
+
4487
+ <dt class="">
4488
+
4489
+
4490
+
4491
+ <h4 id="setProperty" class="name">
4492
+
4493
+ <span class="type-signature"></span>setProperty<span class="signature">(property, value)</span><span class="type-signature"> : {void}</span>
4494
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#setProperty"></a>
4495
+
4496
+ </h4>
4497
+
4498
+
4499
+
4500
+
4501
+
4502
+ </dt>
4503
+ <dd class="">
4504
+
4505
+
4506
+ <div class="description">
4507
+ Sets a property or a single subproperty for complex properties and notifies the component of the change, triggering a corresponding event.
4508
+
4509
+ </div>
4510
+
4511
+
4512
+
4513
+
4514
+
4515
+
4516
+
4517
+
4518
+
4519
+
4520
+
4521
+ <h5>Parameters:</h5>
4522
+
4523
+
4524
+ <table class="params">
4525
+ <thead>
4526
+ <tr>
4527
+
4528
+ <th>Name</th>
4529
+
4530
+
4531
+ <th>Type</th>
4532
+
4533
+
4534
+
4535
+
4536
+
4537
+ <th class="last">Description</th>
4538
+ </tr>
4539
+ </thead>
4540
+
4541
+ <tbody>
4542
+
4543
+
4544
+ <tr>
4545
+
4546
+ <td class="name"><code>property</code></td>
4547
+
4548
+
4549
+ <td class="type">
4550
+
4551
+ </td>
4552
+
4553
+
4554
+
4555
+
4556
+ <td class="description last">The property name to set. Supports dot notation for subproperty access.
4557
+ </td>
4558
+ </tr>
4559
+
4560
+
4561
+
4562
+ <tr>
4563
+
4564
+ <td class="name"><code>value</code></td>
4565
+
4566
+
4567
+ <td class="type">
4568
+
4569
+ </td>
4570
+
4571
+
4572
+
4573
+
4574
+ <td class="description last">The new value to set the property to.
4575
+ </td>
4576
+ </tr>
4577
+
4578
+
4579
+ </tbody>
4580
+ </table>
4581
+
4582
+
4583
+
4584
+ <dl class="details">
4585
+
4586
+
4587
+
4588
+
4589
+
4590
+
4591
+
4592
+
4593
+
4594
+
4595
+
4596
+
4597
+
4598
+
4599
+
4600
+
4601
+
4602
+
4603
+
4604
+
4605
+
4606
+
4607
+
4608
+
4609
+
4610
+
4611
+
4612
+
4613
+
4614
+ </dl>
4615
+
4616
+
4617
+
4618
+
4619
+
4620
+
4621
+
4622
+ <h5>Returns:</h5>
4623
+
4624
+
4625
+
4626
+
4627
+ <dl>
4628
+ <dt>
4629
+ Type
4630
+ </dt>
4631
+ <dd>
4632
+
4633
+ <span class="param-type">void</span>
4634
+
4635
+
4636
+ </dd>
4637
+ </dl>
4638
+
4639
+
4640
+
4641
+
4642
+
4643
+ </dd>
4644
+
4645
+
4646
+
4647
+ <dt class="">
4648
+
4649
+
4650
+
4651
+ <h4 id="showMessages" class="name">
4652
+
4653
+ <span class="type-signature"></span>showMessages<span class="signature"></span><span class="type-signature"> : {<a href="CustomElementOverview.html#ce-attrs-any-section">any</a>}</span>
4654
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#showMessages"></a>
4655
+
4656
+ </h4>
4657
+
4658
+
4659
+
4660
+
4661
+
4662
+ </dt>
4663
+ <dd class="">
4664
+
4665
+
4666
+ <div class="description">
4667
+ Takes all deferred messages and shows them.
4668
+ It then updates the valid property;
4669
+ e.g., if the valid state was "invalidHidden" before showMessages(),
4670
+ the valid state will become "invalidShown" after showMessages().
4671
+ If there were no deferred messages this method simply returns.
4672
+
4673
+ </div>
4674
+
4675
+
4676
+
4677
+
4678
+
4679
+
4680
+
4681
+
4682
+
4683
+
4684
+
4685
+
4686
+
4687
+ <dl class="details">
4688
+
4689
+
4690
+
4691
+
4692
+
4693
+
4694
+
4695
+
4696
+
4697
+
4698
+
4699
+
4700
+
4701
+
4702
+
4703
+
4704
+
4705
+
4706
+
4707
+
4708
+
4709
+
4710
+
4711
+
4712
+
4713
+
4714
+
4715
+
4716
+
4717
+ </dl>
4718
+
4719
+
4720
+
4721
+
4722
+
4723
+
4724
+
4725
+ <h5>Returns:</h5>
4726
+
4727
+
4728
+
4729
+
4730
+ <dl>
4731
+ <dt>
4732
+ Type
4733
+ </dt>
4734
+ <dd>
4735
+
4736
+ <span class="param-type"><a href="CustomElementOverview.html#ce-attrs-any-section">any</a></span>
4737
+
4738
+
4739
+ </dd>
4740
+ </dl>
4741
+
4742
+
4743
+
4744
+
4745
+
4746
+ </dd>
4747
+
4748
+
4749
+
4750
+ <dt class="">
4751
+
4752
+
4753
+
4754
+ <h4 id="validate" class="name">
4755
+
4756
+ <span class="type-signature"></span>validate<span class="signature"></span><span class="type-signature"> : {Promise}</span>
4757
+ <a class="bookmarkable-link" title="Bookmarkable Link" href="#validate"></a>
4758
+
4759
+ </h4>
4760
+
4761
+
4762
+
4763
+
4764
+
4765
+ </dt>
4766
+ <dd class="">
4767
+
4768
+
4769
+ <div class="description">
4770
+ Validates the component's display value using the converter and
4771
+ all validators registered on the component and updates the value
4772
+ option by performing the following steps.
4773
+ <ol>
4774
+ <li>All messages are cleared, including custom messages added by the app.<li>
4775
+ <li>
4776
+ If no converter is present then processing continues to next step. If a converter is present,
4777
+ the UI value is first converted (i.e., parsed). If there is a parse error then the messages are shown.
4778
+ </li>
4779
+ <li>
4780
+ If there are no validators setup for the component the value option is updated using the display value.
4781
+ Otherwise all validators are run in sequence using the parsed value from the previous step.
4782
+ The implicit required validator is run first if the component is marked required.
4783
+ When a validation error is encountered it is remembered and the next validator in the sequence is run.
4784
+ </li>
4785
+ <li>
4786
+ At the end of validation if there are errors, the messages are shown.
4787
+ If there were no errors, then the value option is updated.
4788
+ </li>
4789
+ </ol>
4790
+
4791
+ </div>
4792
+
4793
+
4794
+
4795
+
4796
+
4797
+
4798
+
4799
+
4800
+
4801
+
4802
+
4803
+
4804
+
4805
+ <dl class="details">
4806
+
4807
+
4808
+
4809
+
4810
+
4811
+
4812
+
4813
+
4814
+
4815
+
4816
+
4817
+
4818
+
4819
+
4820
+
4821
+
4822
+
4823
+
4824
+
4825
+
4826
+
4827
+
4828
+
4829
+
4830
+
4831
+
4832
+
4833
+
4834
+
4835
+ </dl>
4836
+
4837
+
4838
+
4839
+
4840
+
4841
+
4842
+
4843
+ <h5>Returns:</h5>
4844
+
4845
+
4846
+ <div class="param-desc">
4847
+ <p>Promise resolves to "valid" if there were no converter parse errors and the component
4848
+ passed all validations. The Promise resolves to "invalid" if there were converter
4849
+ parse errors or if there were validation errors.</p>
4850
+ </div>
4851
+
4852
+
4853
+
4854
+ <dl>
4855
+ <dt>
4856
+ Type
4857
+ </dt>
4858
+ <dd>
4859
+
4860
+ <span class="param-type">Promise</span>
4861
+
4862
+
4863
+ </dd>
4864
+ </dl>
4865
+
4866
+
4867
+
4868
+
4869
+
4870
+ </dd>
4871
+
4872
+
4873
+ </dl>
4874
+
4875
+ </article>
4876
+
4877
+
4878
+ </section>
4879
+
4880
+
4881
+
4882
+
4883
+ <footer>
4884
+ Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.11</a> on Fri Jan 06 2023 02:37:41 GMT+0000 (Coordinated Universal Time)<br>
4885
+ <span class="product-docs-footer">Copyright © 2014, 2023 Oracle. All rights reserved.<span>
4886
+ </footer>
4887
+ </div>
4888
+
4889
+ <script> prettyPrint(); </script>
4890
+ </body>
4891
+ </html>