@ui5/webcomponents-base 0.0.0-35e2c9666 → 0.0.0-3790e6927

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 (615) hide show
  1. package/.eslintignore +6 -4
  2. package/.npsrc.json +3 -0
  3. package/CHANGELOG.md +488 -0
  4. package/README.md +32 -6
  5. package/bundle.esm.js +20 -11
  6. package/config/wdio.conf.cjs +400 -0
  7. package/{src/AssetRegistry.js → dist/AssetRegistry.d.ts} +1 -7
  8. package/dist/AssetRegistry.js +2 -7
  9. package/dist/AssetRegistry.js.map +1 -0
  10. package/dist/Boot.d.ts +9 -0
  11. package/dist/Boot.js +56 -44
  12. package/dist/Boot.js.map +1 -0
  13. package/{src/CSP.js → dist/CSP.d.ts} +8 -37
  14. package/dist/CSP.js +16 -24
  15. package/dist/CSP.js.map +1 -0
  16. package/dist/CustomElementsRegistry.d.ts +5 -0
  17. package/dist/CustomElementsRegistry.js +66 -83
  18. package/dist/CustomElementsRegistry.js.map +1 -0
  19. package/dist/CustomElementsScope.d.ts +7 -0
  20. package/dist/CustomElementsScope.js +11 -108
  21. package/dist/CustomElementsScope.js.map +1 -0
  22. package/dist/CustomElementsScopeUtils.d.ts +55 -0
  23. package/{src/CustomElementsScope.js → dist/CustomElementsScopeUtils.js} +34 -52
  24. package/dist/CustomElementsScopeUtils.js.map +1 -0
  25. package/dist/DOMObserver.d.ts +11 -0
  26. package/dist/DOMObserver.js +12 -54
  27. package/dist/DOMObserver.js.map +1 -0
  28. package/dist/Device.d.ts +12 -0
  29. package/dist/Device.js +146 -96
  30. package/dist/Device.js.map +1 -0
  31. package/dist/EventProvider.d.ts +25 -0
  32. package/dist/EventProvider.js +67 -82
  33. package/dist/EventProvider.js.map +1 -0
  34. package/dist/FeaturesRegistry.d.ts +3 -0
  35. package/dist/FeaturesRegistry.js +5 -10
  36. package/dist/FeaturesRegistry.js.map +1 -0
  37. package/dist/FontFace.d.ts +2 -0
  38. package/dist/FontFace.js +14 -19
  39. package/dist/FontFace.js.map +1 -0
  40. package/dist/IgnoreCustomElements.d.ts +27 -0
  41. package/dist/IgnoreCustomElements.js +39 -0
  42. package/dist/IgnoreCustomElements.js.map +1 -0
  43. package/dist/InitialConfiguration.d.ts +27 -0
  44. package/dist/InitialConfiguration.js +121 -131
  45. package/dist/InitialConfiguration.js.map +1 -0
  46. package/dist/Keys.d.ts +57 -0
  47. package/dist/Keys.js +174 -291
  48. package/dist/Keys.js.map +1 -0
  49. package/dist/ManagedStyles.d.ts +8 -0
  50. package/dist/ManagedStyles.js +69 -68
  51. package/dist/ManagedStyles.js.map +1 -0
  52. package/dist/MarkedEvents.d.ts +9 -0
  53. package/dist/MarkedEvents.js +15 -0
  54. package/dist/MarkedEvents.js.map +1 -0
  55. package/dist/MediaRange.d.ts +37 -0
  56. package/dist/MediaRange.js +54 -65
  57. package/dist/MediaRange.js.map +1 -0
  58. package/dist/PropertiesFileFormat.d.ts +8 -0
  59. package/dist/PropertiesFileFormat.js +72 -82
  60. package/dist/PropertiesFileFormat.js.map +1 -0
  61. package/dist/Render.d.ts +47 -0
  62. package/dist/Render.js +81 -113
  63. package/dist/Render.js.map +1 -0
  64. package/dist/RenderQueue.d.ts +19 -0
  65. package/dist/RenderQueue.js +52 -62
  66. package/dist/RenderQueue.js.map +1 -0
  67. package/dist/Runtimes.d.ts +27 -0
  68. package/dist/Runtimes.js +49 -70
  69. package/dist/Runtimes.js.map +1 -0
  70. package/dist/StaticArea.d.ts +3 -0
  71. package/dist/StaticArea.js +5 -1
  72. package/dist/StaticArea.js.map +1 -0
  73. package/dist/StaticAreaItem.d.ts +36 -0
  74. package/dist/StaticAreaItem.js +88 -87
  75. package/dist/StaticAreaItem.js.map +1 -0
  76. package/dist/SystemCSSVars.d.ts +2 -0
  77. package/dist/SystemCSSVars.js +4 -5
  78. package/dist/SystemCSSVars.js.map +1 -0
  79. package/{src/Theming.js → dist/Theming.d.ts} +0 -1
  80. package/dist/Theming.js +1 -1
  81. package/dist/Theming.js.map +1 -0
  82. package/dist/UI5Element.d.ts +380 -0
  83. package/dist/UI5Element.js +930 -985
  84. package/dist/UI5Element.js.map +1 -0
  85. package/dist/UI5ElementMetadata.d.ts +150 -0
  86. package/dist/UI5ElementMetadata.js +278 -314
  87. package/dist/UI5ElementMetadata.js.map +1 -0
  88. package/dist/animations/AnimationQueue.d.ts +8 -0
  89. package/dist/animations/AnimationQueue.js +31 -38
  90. package/dist/animations/AnimationQueue.js.map +1 -0
  91. package/dist/animations/animate.d.ts +14 -0
  92. package/dist/animations/animate.js +46 -51
  93. package/dist/animations/animate.js.map +1 -0
  94. package/dist/animations/scroll.d.ts +5 -0
  95. package/dist/animations/scroll.js +18 -27
  96. package/dist/animations/scroll.js.map +1 -0
  97. package/dist/animations/slideDown.d.ts +5 -0
  98. package/dist/animations/slideDown.js +53 -78
  99. package/dist/animations/slideDown.js.map +1 -0
  100. package/dist/animations/slideUp.d.ts +5 -0
  101. package/dist/animations/slideUp.js +49 -70
  102. package/dist/animations/slideUp.js.map +1 -0
  103. package/dist/api.json +1 -0
  104. package/dist/asset-registries/Icons.d.ts +38 -0
  105. package/dist/asset-registries/Icons.js +109 -123
  106. package/dist/asset-registries/Icons.js.map +1 -0
  107. package/dist/asset-registries/Illustrations.d.ts +17 -0
  108. package/dist/asset-registries/Illustrations.js +41 -25
  109. package/dist/asset-registries/Illustrations.js.map +1 -0
  110. package/dist/asset-registries/LocaleData.d.ts +7 -0
  111. package/dist/asset-registries/LocaleData.js +104 -132
  112. package/dist/asset-registries/LocaleData.js.map +1 -0
  113. package/dist/asset-registries/Themes.d.ts +11 -0
  114. package/dist/asset-registries/Themes.js +40 -66
  115. package/dist/asset-registries/Themes.js.map +1 -0
  116. package/dist/asset-registries/i18n.d.ts +23 -0
  117. package/dist/asset-registries/i18n.js +61 -81
  118. package/dist/asset-registries/i18n.js.map +1 -0
  119. package/dist/assets/Boot.34b7cea0.css +1 -0
  120. package/dist/assets/Boot.c42af4c1.js +9 -0
  121. package/dist/assets/bundle.esm.5317b298.js +50 -0
  122. package/dist/assets-meta/IconCollectionsAlias.d.ts +31 -0
  123. package/dist/assets-meta/IconCollectionsAlias.js +30 -10
  124. package/dist/assets-meta/IconCollectionsAlias.js.map +1 -0
  125. package/dist/config/AnimationMode.d.ts +14 -0
  126. package/dist/config/AnimationMode.js +21 -18
  127. package/dist/config/AnimationMode.js.map +1 -0
  128. package/dist/config/CalendarType.d.ts +8 -0
  129. package/dist/config/CalendarType.js +13 -12
  130. package/dist/config/CalendarType.js.map +1 -0
  131. package/dist/config/FormatSettings.d.ts +15 -0
  132. package/dist/config/FormatSettings.js +15 -9
  133. package/dist/config/FormatSettings.js.map +1 -0
  134. package/dist/config/Icons.d.ts +55 -0
  135. package/dist/config/Icons.js +103 -0
  136. package/dist/config/Icons.js.map +1 -0
  137. package/dist/config/Language.d.ts +40 -0
  138. package/dist/config/Language.js +43 -43
  139. package/dist/config/Language.js.map +1 -0
  140. package/dist/config/NoConflict.d.ts +20 -0
  141. package/dist/config/NoConflict.js +41 -41
  142. package/dist/config/NoConflict.js.map +1 -0
  143. package/dist/config/RTL.d.ts +7 -0
  144. package/dist/config/RTL.js +26 -20
  145. package/dist/config/RTL.js.map +1 -0
  146. package/dist/config/Theme.d.ts +38 -0
  147. package/dist/config/Theme.js +54 -37
  148. package/dist/config/Theme.js.map +1 -0
  149. package/dist/config/ThemeRoot.d.ts +29 -0
  150. package/dist/config/ThemeRoot.js +59 -0
  151. package/dist/config/ThemeRoot.js.map +1 -0
  152. package/dist/config/Timezone.d.ts +17 -0
  153. package/dist/config/Timezone.js +30 -0
  154. package/dist/config/Timezone.js.map +1 -0
  155. package/dist/css/BusyIndicator.css +80 -0
  156. package/dist/css/FontFace.css +31 -10
  157. package/dist/decorators/customElement.d.ts +23 -0
  158. package/dist/decorators/customElement.js +37 -0
  159. package/dist/decorators/customElement.js.map +1 -0
  160. package/dist/decorators/event.d.ts +10 -0
  161. package/dist/decorators/event.js +24 -0
  162. package/dist/decorators/event.js.map +1 -0
  163. package/dist/decorators/property.d.ts +9 -0
  164. package/dist/decorators/property.js +24 -0
  165. package/dist/decorators/property.js.map +1 -0
  166. package/dist/decorators/slot.d.ts +9 -0
  167. package/dist/decorators/slot.js +37 -0
  168. package/dist/decorators/slot.js.map +1 -0
  169. package/dist/delegate/ItemNavigation.d.ts +113 -0
  170. package/dist/delegate/ItemNavigation.js +277 -312
  171. package/dist/delegate/ItemNavigation.js.map +1 -0
  172. package/dist/delegate/ResizeHandler.d.ts +25 -0
  173. package/dist/delegate/ResizeHandler.js +72 -91
  174. package/dist/delegate/ResizeHandler.js.map +1 -0
  175. package/dist/delegate/ScrollEnablement.d.ts +49 -0
  176. package/dist/delegate/ScrollEnablement.js +157 -180
  177. package/dist/delegate/ScrollEnablement.js.map +1 -0
  178. package/dist/features/F6Navigation.d.ts +19 -0
  179. package/dist/features/F6Navigation.js +145 -102
  180. package/dist/features/F6Navigation.js.map +1 -0
  181. package/dist/features/LegacyDateFormats.d.ts +18 -0
  182. package/dist/features/LegacyDateFormats.js +20 -0
  183. package/dist/features/LegacyDateFormats.js.map +1 -0
  184. package/dist/features/OpenUI5Element.d.ts +9 -0
  185. package/dist/features/OpenUI5Element.js +5 -0
  186. package/dist/features/OpenUI5Element.js.map +1 -0
  187. package/dist/features/OpenUI5Enablement.d.ts +11 -0
  188. package/dist/features/OpenUI5Enablement.js +96 -0
  189. package/dist/features/OpenUI5Enablement.js.map +1 -0
  190. package/dist/features/OpenUI5Support.d.ts +26 -0
  191. package/dist/features/OpenUI5Support.js +93 -119
  192. package/dist/features/OpenUI5Support.js.map +1 -0
  193. package/dist/generated/AssetParameters.js +2 -0
  194. package/dist/generated/VersionInfo.js +3 -3
  195. package/dist/generated/css/BusyIndicator.css.d.ts +3 -0
  196. package/dist/generated/css/BusyIndicator.css.js +7 -0
  197. package/dist/generated/css/BusyIndicator.css.js.map +1 -0
  198. package/dist/generated/css/FontFace.css.d.ts +3 -0
  199. package/dist/generated/css/FontFace.css.js +7 -5
  200. package/dist/generated/css/FontFace.css.js.map +1 -0
  201. package/dist/generated/css/OverrideFontFace.css.d.ts +3 -0
  202. package/dist/generated/css/OverrideFontFace.css.js +7 -5
  203. package/dist/generated/css/OverrideFontFace.css.js.map +1 -0
  204. package/dist/generated/css/SystemCSSVars.css.d.ts +3 -0
  205. package/dist/generated/css/SystemCSSVars.css.js +7 -5
  206. package/dist/generated/css/SystemCSSVars.css.js.map +1 -0
  207. package/dist/generated/templates/elements/WithComplexTemplateTemplate.lit.d.ts +4 -0
  208. package/dist/generated/templates/elements/WithComplexTemplateTemplate.lit.js +9 -0
  209. package/dist/generated/templates/elements/WithComplexTemplateTemplate.lit.js.map +1 -0
  210. package/dist/getSharedResource.d.ts +11 -0
  211. package/dist/getSharedResource.js +28 -18
  212. package/dist/getSharedResource.js.map +1 -0
  213. package/dist/global.d.ts +40 -0
  214. package/dist/i18nBundle.d.ts +43 -0
  215. package/dist/i18nBundle.js +57 -64
  216. package/dist/i18nBundle.js.map +1 -0
  217. package/dist/locale/Locale.d.ts +22 -0
  218. package/dist/locale/Locale.js +75 -87
  219. package/dist/locale/Locale.js.map +1 -0
  220. package/dist/locale/RTLAwareRegistry.d.ts +4 -0
  221. package/dist/locale/RTLAwareRegistry.js +6 -11
  222. package/dist/locale/RTLAwareRegistry.js.map +1 -0
  223. package/dist/locale/applyDirection.d.ts +10 -0
  224. package/dist/locale/applyDirection.js +7 -7
  225. package/dist/locale/applyDirection.js.map +1 -0
  226. package/dist/locale/directionChange.d.ts +15 -0
  227. package/dist/locale/directionChange.js +7 -15
  228. package/dist/locale/directionChange.js.map +1 -0
  229. package/dist/locale/getEffectiveDir.d.ts +2 -0
  230. package/dist/locale/getEffectiveDir.js +20 -24
  231. package/dist/locale/getEffectiveDir.js.map +1 -0
  232. package/dist/locale/getLocale.d.ts +7 -0
  233. package/dist/locale/getLocale.js +26 -29
  234. package/dist/locale/getLocale.js.map +1 -0
  235. package/dist/locale/languageChange.d.ts +5 -0
  236. package/dist/locale/languageChange.js +8 -16
  237. package/dist/locale/languageChange.js.map +1 -0
  238. package/dist/locale/nextFallbackLocale.d.ts +8 -0
  239. package/dist/locale/nextFallbackLocale.js +15 -19
  240. package/dist/locale/nextFallbackLocale.js.map +1 -0
  241. package/dist/locale/normalizeLocale.d.ts +7 -0
  242. package/dist/locale/normalizeLocale.js +34 -41
  243. package/dist/locale/normalizeLocale.js.map +1 -0
  244. package/dist/renderer/LitRenderer.d.ts +14 -0
  245. package/dist/renderer/LitRenderer.js +31 -24
  246. package/dist/renderer/LitRenderer.js.map +1 -0
  247. package/dist/renderer/executeTemplate.d.ts +13 -0
  248. package/dist/renderer/executeTemplate.js +20 -7
  249. package/dist/renderer/executeTemplate.js.map +1 -0
  250. package/dist/sap/base/Log.js +28 -29
  251. package/dist/sap/base/assert.js +5 -6
  252. package/dist/sap/base/security/URLListValidator.js +13 -2
  253. package/dist/sap/ui/thirdparty/caja-html-sanitizer.js +1 -1
  254. package/dist/theming/CustomStyle.d.ts +6 -0
  255. package/dist/theming/CustomStyle.js +33 -45
  256. package/dist/theming/CustomStyle.js.map +1 -0
  257. package/dist/theming/ThemeLoaded.d.ts +5 -0
  258. package/dist/theming/ThemeLoaded.js +8 -16
  259. package/dist/theming/ThemeLoaded.js.map +1 -0
  260. package/dist/theming/ThemeRegistered.d.ts +4 -0
  261. package/dist/theming/ThemeRegistered.js +11 -0
  262. package/dist/theming/ThemeRegistered.js.map +1 -0
  263. package/dist/theming/applyTheme.d.ts +2 -0
  264. package/dist/theming/applyTheme.js +61 -64
  265. package/dist/theming/applyTheme.js.map +1 -0
  266. package/dist/theming/getConstructableStyle.d.ts +9 -0
  267. package/dist/theming/getConstructableStyle.js +12 -17
  268. package/dist/theming/getConstructableStyle.js.map +1 -0
  269. package/dist/theming/getEffectiveLinksHrefs.d.ts +3 -0
  270. package/dist/theming/getEffectiveLinksHrefs.js +13 -16
  271. package/dist/theming/getEffectiveLinksHrefs.js.map +1 -0
  272. package/dist/theming/getEffectiveStyle.d.ts +3 -0
  273. package/dist/theming/getEffectiveStyle.js +25 -23
  274. package/dist/theming/getEffectiveStyle.js.map +1 -0
  275. package/dist/theming/getStylesString.d.ts +3 -0
  276. package/dist/theming/getStylesString.js +9 -13
  277. package/dist/theming/getStylesString.js.map +1 -0
  278. package/dist/theming/getThemeDesignerTheme.d.ts +7 -0
  279. package/dist/theming/getThemeDesignerTheme.js +72 -79
  280. package/dist/theming/getThemeDesignerTheme.js.map +1 -0
  281. package/dist/theming/preloadLinks.d.ts +3 -0
  282. package/dist/theming/preloadLinks.js +13 -17
  283. package/dist/theming/preloadLinks.js.map +1 -0
  284. package/dist/thirdparty/_merge.d.ts +2 -0
  285. package/dist/thirdparty/_merge.js +7 -4
  286. package/dist/thirdparty/_merge.js.map +1 -0
  287. package/dist/thirdparty/isPlainObject.d.ts +2 -0
  288. package/dist/thirdparty/isPlainObject.js +11 -10
  289. package/dist/thirdparty/isPlainObject.js.map +1 -0
  290. package/dist/thirdparty/merge.d.ts +2 -0
  291. package/dist/thirdparty/merge.js +4 -8
  292. package/dist/thirdparty/merge.js.map +1 -0
  293. package/dist/types/AnimationMode.d.ts +32 -0
  294. package/dist/types/AnimationMode.js +33 -6
  295. package/dist/types/AnimationMode.js.map +1 -0
  296. package/dist/types/CSSColor.d.ts +15 -0
  297. package/dist/types/CSSColor.js +14 -5
  298. package/dist/types/CSSColor.js.map +1 -0
  299. package/dist/types/CalendarType.d.ts +37 -0
  300. package/dist/types/CalendarType.js +35 -18
  301. package/dist/types/CalendarType.js.map +1 -0
  302. package/dist/types/DOMReference.d.ts +17 -0
  303. package/dist/types/DOMReference.js +25 -0
  304. package/dist/types/DOMReference.js.map +1 -0
  305. package/dist/types/DataType.d.ts +25 -0
  306. package/dist/types/DataType.js +33 -26
  307. package/dist/types/DataType.js.map +1 -0
  308. package/dist/types/Float.d.ts +17 -0
  309. package/dist/types/Float.js +17 -10
  310. package/dist/types/Float.js.map +1 -0
  311. package/dist/types/Integer.d.ts +17 -0
  312. package/dist/types/Integer.js +17 -9
  313. package/dist/types/Integer.js.map +1 -0
  314. package/dist/types/InvisibleMessageMode.d.ts +25 -0
  315. package/dist/types/InvisibleMessageMode.js +20 -23
  316. package/dist/types/InvisibleMessageMode.js.map +1 -0
  317. package/dist/types/ItemNavigationBehavior.d.ts +24 -0
  318. package/dist/types/ItemNavigationBehavior.js +22 -12
  319. package/dist/types/ItemNavigationBehavior.js.map +1 -0
  320. package/dist/types/NavigationMode.d.ts +32 -0
  321. package/dist/types/NavigationMode.js +33 -6
  322. package/dist/types/NavigationMode.js.map +1 -0
  323. package/dist/types/ValueState.d.ts +42 -0
  324. package/dist/types/ValueState.js +41 -19
  325. package/dist/types/ValueState.js.map +1 -0
  326. package/dist/types.d.ts +18 -0
  327. package/dist/types.js +2 -0
  328. package/dist/types.js.map +1 -0
  329. package/dist/updateShadowRoot.d.ts +8 -0
  330. package/dist/updateShadowRoot.js +29 -18
  331. package/dist/updateShadowRoot.js.map +1 -0
  332. package/dist/util/AriaLabelHelper.d.ts +15 -0
  333. package/dist/util/AriaLabelHelper.js +166 -36
  334. package/dist/util/AriaLabelHelper.js.map +1 -0
  335. package/dist/util/Caret.d.ts +7 -0
  336. package/dist/util/Caret.js +16 -38
  337. package/dist/util/Caret.js.map +1 -0
  338. package/dist/util/ColorConversion.d.ts +30 -0
  339. package/dist/util/ColorConversion.js +315 -348
  340. package/dist/util/ColorConversion.js.map +1 -0
  341. package/dist/util/FetchHelper.d.ts +3 -0
  342. package/dist/util/FetchHelper.js +19 -25
  343. package/dist/util/FetchHelper.js.map +1 -0
  344. package/dist/util/FocusableElements.d.ts +4 -0
  345. package/dist/util/FocusableElements.js +64 -71
  346. package/dist/util/FocusableElements.js.map +1 -0
  347. package/{src/util/HTMLSanitizer.js → dist/util/HTMLSanitizer.d.ts} +1 -5
  348. package/dist/util/HTMLSanitizer.js +4 -5
  349. package/dist/util/HTMLSanitizer.js.map +1 -0
  350. package/dist/util/InvisibleMessage.d.ts +10 -0
  351. package/dist/util/InvisibleMessage.js +41 -45
  352. package/dist/util/InvisibleMessage.js.map +1 -0
  353. package/dist/util/PopupUtils.d.ts +7 -0
  354. package/dist/util/PopupUtils.js +58 -77
  355. package/dist/util/PopupUtils.js.map +1 -0
  356. package/dist/util/SlotsHelper.d.ts +9 -0
  357. package/dist/util/SlotsHelper.js +22 -35
  358. package/dist/util/SlotsHelper.js.map +1 -0
  359. package/dist/util/StringHelper.d.ts +3 -0
  360. package/dist/util/StringHelper.js +17 -20
  361. package/dist/util/StringHelper.js.map +1 -0
  362. package/dist/util/TabbableElements.d.ts +17 -0
  363. package/dist/util/TabbableElements.js +53 -47
  364. package/dist/util/TabbableElements.js.map +1 -0
  365. package/dist/util/arraysAreEqual.d.ts +2 -0
  366. package/dist/util/arraysAreEqual.js +10 -12
  367. package/dist/util/arraysAreEqual.js.map +1 -0
  368. package/{src/util/clamp.js → dist/util/clamp.d.ts} +1 -4
  369. package/dist/util/clamp.js +2 -2
  370. package/dist/util/clamp.js.map +1 -0
  371. package/dist/util/createLinkInHead.d.ts +7 -0
  372. package/dist/util/createLinkInHead.js +14 -12
  373. package/dist/util/createLinkInHead.js.map +1 -0
  374. package/dist/util/createStyleInHead.d.ts +8 -0
  375. package/dist/util/createStyleInHead.js +10 -10
  376. package/dist/util/createStyleInHead.js.map +1 -0
  377. package/dist/util/debounce.d.ts +2 -0
  378. package/dist/util/debounce.js +6 -8
  379. package/dist/util/debounce.js.map +1 -0
  380. package/dist/util/detectNavigatorLanguage.d.ts +2 -0
  381. package/dist/util/detectNavigatorLanguage.js +7 -10
  382. package/dist/util/detectNavigatorLanguage.js.map +1 -0
  383. package/dist/util/escapeRegex.d.ts +8 -0
  384. package/dist/util/escapeRegex.js +8 -7
  385. package/dist/util/escapeRegex.js.map +1 -0
  386. package/dist/util/formatMessage.d.ts +2 -0
  387. package/dist/util/formatMessage.js +15 -19
  388. package/dist/util/formatMessage.js.map +1 -0
  389. package/dist/util/generateHighlightedMarkup.d.ts +9 -0
  390. package/dist/util/generateHighlightedMarkup.js +26 -27
  391. package/dist/util/generateHighlightedMarkup.js.map +1 -0
  392. package/dist/util/getActiveElement.d.ts +2 -0
  393. package/dist/util/getActiveElement.js +6 -8
  394. package/dist/util/getActiveElement.js.map +1 -0
  395. package/dist/util/getClassCopy.d.ts +400 -0
  396. package/dist/util/getClassCopy.js +7 -7
  397. package/dist/util/getClassCopy.js.map +1 -0
  398. package/dist/util/getDesigntimePropertyAsArray.d.ts +2 -0
  399. package/dist/util/getDesigntimePropertyAsArray.js +4 -3
  400. package/dist/util/getDesigntimePropertyAsArray.js.map +1 -0
  401. package/dist/util/getEffectiveContentDensity.d.ts +2 -0
  402. package/dist/util/getEffectiveContentDensity.js +2 -3
  403. package/dist/util/getEffectiveContentDensity.js.map +1 -0
  404. package/dist/util/getEffectiveScrollbarStyle.d.ts +2 -0
  405. package/dist/util/getEffectiveScrollbarStyle.js +4 -0
  406. package/dist/util/getEffectiveScrollbarStyle.js.map +1 -0
  407. package/dist/util/getFastNavigationGroups.d.ts +2 -0
  408. package/dist/util/getFastNavigationGroups.js +51 -0
  409. package/dist/util/getFastNavigationGroups.js.map +1 -0
  410. package/{src/util/getFileExtension.js → dist/util/getFileExtension.d.ts} +3 -12
  411. package/dist/util/getFileExtension.js +9 -11
  412. package/dist/util/getFileExtension.js.map +1 -0
  413. package/dist/util/getNormalizedTarget.d.ts +7 -0
  414. package/dist/util/getNormalizedTarget.js +14 -0
  415. package/dist/util/getNormalizedTarget.js.map +1 -0
  416. package/dist/util/getSingletonElementInstance.d.ts +11 -0
  417. package/dist/util/getSingletonElementInstance.js +17 -11
  418. package/dist/util/getSingletonElementInstance.js.map +1 -0
  419. package/dist/util/isElementClickable.d.ts +2 -0
  420. package/dist/util/isElementClickable.js +16 -0
  421. package/dist/util/isElementClickable.js.map +1 -0
  422. package/dist/util/isElementHidden.d.ts +2 -0
  423. package/dist/util/isElementHidden.js +8 -0
  424. package/dist/util/isElementHidden.js.map +1 -0
  425. package/dist/util/isElementInView.d.ts +6 -0
  426. package/dist/util/isElementInView.js +6 -9
  427. package/dist/util/isElementInView.js.map +1 -0
  428. package/dist/util/isElementTabbable.d.ts +9 -0
  429. package/dist/util/isElementTabbable.js +30 -0
  430. package/dist/util/isElementTabbable.js.map +1 -0
  431. package/dist/util/isValidPropertyName.d.ts +8 -0
  432. package/dist/util/isValidPropertyName.js +16 -17
  433. package/dist/util/isValidPropertyName.js.map +1 -0
  434. package/dist/util/whenDOMReady.d.ts +2 -0
  435. package/dist/util/whenDOMReady.js +11 -10
  436. package/dist/util/whenDOMReady.js.map +1 -0
  437. package/dist/util/willShowContent.d.ts +2 -0
  438. package/dist/util/willShowContent.js +7 -0
  439. package/dist/util/willShowContent.js.map +1 -0
  440. package/dist/validateThemeRoot.d.ts +2 -0
  441. package/dist/validateThemeRoot.js +48 -0
  442. package/dist/validateThemeRoot.js.map +1 -0
  443. package/index.js +227 -1
  444. package/lib/generate-asset-parameters/index.js +11 -5
  445. package/lib/generate-styles/index.js +26 -13
  446. package/lib/generate-version-info/index.js +18 -13
  447. package/package-scripts.cjs +71 -0
  448. package/package.json +8 -6
  449. package/src/css/BusyIndicator.css +80 -0
  450. package/src/css/FontFace.css +31 -10
  451. package/tsconfig.json +14 -0
  452. package/config/rollup.config.js +0 -1
  453. package/config/wdio.conf.js +0 -1
  454. package/dist/RenderScheduler.js +0 -44
  455. package/dist/animations/config.js +0 -5
  456. package/dist/isLegacyBrowser.js +0 -3
  457. package/dist/resources/bundle.esm.js +0 -37
  458. package/dist/resources/bundle.esm.js.map +0 -1
  459. package/dist/test-resources/assets/Themes.js +0 -17
  460. package/dist/test-resources/elements/Child.js +0 -35
  461. package/dist/test-resources/elements/Generic.js +0 -84
  462. package/dist/test-resources/elements/GenericExt.js +0 -26
  463. package/dist/test-resources/elements/NoShadowDOM.js +0 -13
  464. package/dist/test-resources/elements/Parent.js +0 -41
  465. package/dist/test-resources/elements/WithStaticArea.js +0 -77
  466. package/dist/test-resources/pages/AllTestElements.html +0 -42
  467. package/dist/test-resources/pages/Configuration.html +0 -18
  468. package/dist/test-resources/pages/ConfigurationScript.html +0 -34
  469. package/dist/test-resources/pages/assets/messagebundle_de.properties +0 -1
  470. package/dist/test-resources/pages/assets/messagebundle_en.properties +0 -1
  471. package/dist/test-resources/pages/assets/messagebundle_es.properties +0 -1
  472. package/dist/test-resources/pages/assets/messagebundle_fr.properties +0 -1
  473. package/dist/test-resources/pages/i18n.html +0 -33
  474. package/dist/test-resources/specs/ConfigurationChange.spec.js +0 -27
  475. package/dist/test-resources/specs/ConfigurationScript.spec.js +0 -63
  476. package/dist/test-resources/specs/ConfigurationURL.spec.js +0 -93
  477. package/dist/test-resources/specs/CustomTheme.spec.js +0 -27
  478. package/dist/test-resources/specs/EventProvider.spec.js +0 -63
  479. package/dist/test-resources/specs/StaticArea.spec.js +0 -78
  480. package/dist/test-resources/specs/Theming.spec.js +0 -33
  481. package/dist/test-resources/specs/UI5ElementInvalidation.js +0 -242
  482. package/dist/test-resources/specs/UI5ElementLifecycle.js +0 -98
  483. package/dist/test-resources/specs/UI5ElementListenForChildPropChanges.spec.js +0 -75
  484. package/dist/test-resources/specs/UI5ElementMetadataExt.js +0 -42
  485. package/dist/test-resources/specs/UI5ElementPropertyValidation.js +0 -14
  486. package/dist/test-resources/specs/UI5ElementPropsAndAttrs.spec.js +0 -67
  487. package/dist/test-resources/specs/UI5ElementShadowDOM.js +0 -24
  488. package/dist/test-resources/specs/UI5ElementSlots.js +0 -36
  489. package/dist/types/CSSSize.js +0 -9
  490. package/dist/types/PopupState.js +0 -37
  491. package/dist/util/findNodeOwner.js +0 -35
  492. package/dist/util/isDescendantOf.js +0 -15
  493. package/dist/util/isNodeClickable.js +0 -19
  494. package/dist/util/isNodeHidden.js +0 -9
  495. package/dist/util/isNodeTabbable.js +0 -28
  496. package/dist/util/setToArray.js +0 -10
  497. package/hash.txt +0 -1
  498. package/package-scripts.js +0 -62
  499. package/src/Boot.js +0 -59
  500. package/src/CustomElementsRegistry.js +0 -95
  501. package/src/DOMObserver.js +0 -65
  502. package/src/Device.js +0 -116
  503. package/src/EventProvider.js +0 -85
  504. package/src/FeaturesRegistry.js +0 -14
  505. package/src/FontFace.js +0 -30
  506. package/src/InitialConfiguration.js +0 -166
  507. package/src/Keys.js +0 -295
  508. package/src/ManagedStyles.js +0 -83
  509. package/src/MediaRange.js +0 -109
  510. package/src/PropertiesFileFormat.js +0 -95
  511. package/src/Render.js +0 -175
  512. package/src/RenderQueue.js +0 -66
  513. package/src/RenderScheduler.js +0 -44
  514. package/src/Runtimes.js +0 -107
  515. package/src/StaticArea.js +0 -3
  516. package/src/StaticAreaItem.js +0 -101
  517. package/src/SystemCSSVars.js +0 -10
  518. package/src/UI5Element.js +0 -1023
  519. package/src/UI5ElementMetadata.js +0 -327
  520. package/src/animations/AnimationQueue.js +0 -42
  521. package/src/animations/animate.js +0 -53
  522. package/src/animations/config.js +0 -5
  523. package/src/animations/scroll.js +0 -28
  524. package/src/animations/slideDown.js +0 -79
  525. package/src/animations/slideUp.js +0 -71
  526. package/src/asset-registries/Icons.js +0 -139
  527. package/src/asset-registries/Illustrations.js +0 -30
  528. package/src/asset-registries/LocaleData.js +0 -164
  529. package/src/asset-registries/Themes.js +0 -78
  530. package/src/asset-registries/i18n.js +0 -121
  531. package/src/assets-meta/IconCollectionsAlias.js +0 -18
  532. package/src/config/AnimationMode.js +0 -23
  533. package/src/config/CalendarType.js +0 -18
  534. package/src/config/FormatSettings.js +0 -13
  535. package/src/config/Language.js +0 -68
  536. package/src/config/NoConflict.js +0 -51
  537. package/src/config/RTL.js +0 -31
  538. package/src/config/Theme.js +0 -53
  539. package/src/delegate/ItemNavigation.js +0 -351
  540. package/src/delegate/ResizeHandler.js +0 -106
  541. package/src/delegate/ScrollEnablement.js +0 -188
  542. package/src/features/F6Navigation.js +0 -108
  543. package/src/features/OpenUI5Support.js +0 -125
  544. package/src/getSharedResource.js +0 -30
  545. package/src/i18nBundle.js +0 -86
  546. package/src/isLegacyBrowser.js +0 -3
  547. package/src/locale/Locale.js +0 -91
  548. package/src/locale/RTLAwareRegistry.js +0 -14
  549. package/src/locale/applyDirection.js +0 -17
  550. package/src/locale/directionChange.js +0 -32
  551. package/src/locale/getEffectiveDir.js +0 -28
  552. package/src/locale/getLocale.js +0 -41
  553. package/src/locale/languageChange.js +0 -22
  554. package/src/locale/nextFallbackLocale.js +0 -28
  555. package/src/locale/normalizeLocale.js +0 -54
  556. package/src/renderer/LitRenderer.js +0 -34
  557. package/src/renderer/executeTemplate.js +0 -17
  558. package/src/theming/CustomStyle.js +0 -60
  559. package/src/theming/ThemeLoaded.js +0 -22
  560. package/src/theming/applyTheme.js +0 -79
  561. package/src/theming/getConstructableStyle.js +0 -30
  562. package/src/theming/getEffectiveLinksHrefs.js +0 -20
  563. package/src/theming/getEffectiveStyle.js +0 -30
  564. package/src/theming/getStylesString.js +0 -15
  565. package/src/theming/getThemeDesignerTheme.js +0 -87
  566. package/src/theming/preloadLinks.js +0 -23
  567. package/src/thirdparty/_merge.js +0 -32
  568. package/src/thirdparty/isPlainObject.js +0 -18
  569. package/src/thirdparty/merge.js +0 -10
  570. package/src/types/AnimationMode.js +0 -7
  571. package/src/types/CSSColor.js +0 -9
  572. package/src/types/CSSSize.js +0 -9
  573. package/src/types/CalendarType.js +0 -22
  574. package/src/types/DataType.js +0 -37
  575. package/src/types/Float.js +0 -14
  576. package/src/types/Integer.js +0 -13
  577. package/src/types/InvisibleMessageMode.js +0 -30
  578. package/src/types/ItemNavigationBehavior.js +0 -16
  579. package/src/types/NavigationMode.js +0 -7
  580. package/src/types/PopupState.js +0 -37
  581. package/src/types/ValueState.js +0 -22
  582. package/src/updateShadowRoot.js +0 -30
  583. package/src/util/AriaLabelHelper.js +0 -41
  584. package/src/util/Caret.js +0 -45
  585. package/src/util/ColorConversion.js +0 -370
  586. package/src/util/FetchHelper.js +0 -31
  587. package/src/util/FocusableElements.js +0 -79
  588. package/src/util/InvisibleMessage.js +0 -60
  589. package/src/util/PopupUtils.js +0 -93
  590. package/src/util/SlotsHelper.js +0 -43
  591. package/src/util/StringHelper.js +0 -26
  592. package/src/util/TabbableElements.js +0 -51
  593. package/src/util/arraysAreEqual.js +0 -15
  594. package/src/util/createLinkInHead.js +0 -19
  595. package/src/util/createStyleInHead.js +0 -18
  596. package/src/util/debounce.js +0 -17
  597. package/src/util/detectNavigatorLanguage.js +0 -13
  598. package/src/util/escapeRegex.js +0 -10
  599. package/src/util/findNodeOwner.js +0 -35
  600. package/src/util/formatMessage.js +0 -23
  601. package/src/util/generateHighlightedMarkup.js +0 -42
  602. package/src/util/getActiveElement.js +0 -11
  603. package/src/util/getClassCopy.js +0 -10
  604. package/src/util/getDesigntimePropertyAsArray.js +0 -4
  605. package/src/util/getEffectiveContentDensity.js +0 -5
  606. package/src/util/getSingletonElementInstance.js +0 -13
  607. package/src/util/isDescendantOf.js +0 -15
  608. package/src/util/isElementInView.js +0 -15
  609. package/src/util/isNodeClickable.js +0 -19
  610. package/src/util/isNodeHidden.js +0 -9
  611. package/src/util/isNodeTabbable.js +0 -28
  612. package/src/util/isValidPropertyName.js +0 -29
  613. package/src/util/setToArray.js +0 -10
  614. package/src/util/whenDOMReady.js +0 -13
  615. /package/{config/.eslintrc.js → .eslintrc.cjs} +0 -0
@@ -5,1019 +5,964 @@ import EventProvider from "./EventProvider.js";
5
5
  import getSingletonElementInstance from "./util/getSingletonElementInstance.js";
6
6
  import StaticAreaItem from "./StaticAreaItem.js";
7
7
  import updateShadowRoot from "./updateShadowRoot.js";
8
+ import { shouldIgnoreCustomElement } from "./IgnoreCustomElements.js";
8
9
  import { renderDeferred, renderImmediately, cancelRender } from "./Render.js";
9
10
  import { registerTag, isTagRegistered, recordTagRegistrationFailure } from "./CustomElementsRegistry.js";
10
11
  import { observeDOMNode, unobserveDOMNode } from "./DOMObserver.js";
11
12
  import { skipOriginalEvent } from "./config/NoConflict.js";
12
13
  import getEffectiveDir from "./locale/getEffectiveDir.js";
13
- import DataType from "./types/DataType.js";
14
14
  import { kebabToCamelCase, camelToKebabCase } from "./util/StringHelper.js";
15
15
  import isValidPropertyName from "./util/isValidPropertyName.js";
16
- import isDescendantOf from "./util/isDescendantOf.js";
17
- import { isSlot, getSlotName, getSlottedElementsList } from "./util/SlotsHelper.js";
16
+ import { getSlotName, getSlottedNodesList } from "./util/SlotsHelper.js";
18
17
  import arraysAreEqual from "./util/arraysAreEqual.js";
19
- import getClassCopy from "./util/getClassCopy.js";
20
18
  import { markAsRtlAware } from "./locale/RTLAwareRegistry.js";
21
19
  import preloadLinks from "./theming/preloadLinks.js";
22
-
20
+ import executeTemplate from "./renderer/executeTemplate.js";
21
+ import { getCurrentRuntimeIndex } from "./Runtimes.js";
23
22
  let autoId = 0;
24
-
25
23
  const elementTimeouts = new Map();
26
24
  const uniqueDependenciesCache = new Map();
27
-
28
25
  /**
29
26
  * Triggers re-rendering of a UI5Element instance due to state change.
30
- *
31
- * @param changeInfo An object with information about the change that caused invalidation.
27
+ * @param {ChangeInfo} changeInfo An object with information about the change that caused invalidation.
32
28
  * @private
33
29
  */
34
30
  function _invalidate(changeInfo) {
35
- // Invalidation should be suppressed: 1) before the component is rendered for the first time 2) and during the execution of onBeforeRendering
36
- // This is necessary not only as an optimization, but also to avoid infinite loops on invalidation between children and parents (when invalidateOnChildChange is used)
37
- if (this._suppressInvalidation) {
38
- return;
39
- }
40
-
41
- // Call the onInvalidation hook
42
- this.onInvalidation(changeInfo);
43
-
44
- this._changedState.push(changeInfo);
45
- renderDeferred(this);
46
- this._eventProvider.fireEvent("invalidate", { ...changeInfo, target: this });
31
+ // Invalidation should be suppressed: 1) before the component is rendered for the first time 2) and during the execution of onBeforeRendering
32
+ // This is necessary not only as an optimization, but also to avoid infinite loops on invalidation between children and parents (when invalidateOnChildChange is used)
33
+ if (this._suppressInvalidation) {
34
+ return;
35
+ }
36
+ // Call the onInvalidation hook
37
+ this.onInvalidation(changeInfo);
38
+ this._changedState.push(changeInfo);
39
+ renderDeferred(this);
40
+ this._eventProvider.fireEvent("invalidate", { ...changeInfo, target: this });
47
41
  }
48
-
49
42
  /**
50
43
  * Base class for all UI5 Web Components
51
44
  *
52
45
  * @class
53
46
  * @constructor
54
47
  * @author SAP SE
55
- * @alias sap.ui.webcomponents.base.UI5Element
48
+ * @alias sap.ui.webc.base.UI5Element
56
49
  * @extends HTMLElement
57
50
  * @public
58
51
  */
59
52
  class UI5Element extends HTMLElement {
60
- constructor() {
61
- super();
62
-
63
- this._changedState = []; // Filled on each invalidation, cleared on re-render (used for debugging)
64
- this._suppressInvalidation = true; // A flag telling whether all invalidations should be ignored. Initialized with "true" because a UI5Element can not be invalidated until it is rendered for the first time
65
- this._inDOM = false; // A flag telling whether the UI5Element is currently in the DOM tree of the document or not
66
- this._fullyConnected = false; // A flag telling whether the UI5Element's onEnterDOM hook was called (since it's possible to have the element removed from DOM before that)
67
- this._childChangeListeners = new Map(); // used to store lazy listeners per slot for the child change event of every child inside that slot
68
- this._slotChangeListeners = new Map(); // used to store lazy listeners per slot for the slotchange event of all slot children inside that slot
69
- this._eventProvider = new EventProvider(); // used by parent components for listening to changes to child components
70
- let deferredResolve;
71
- this._domRefReadyPromise = new Promise(resolve => {
72
- deferredResolve = resolve;
73
- });
74
- this._domRefReadyPromise._deferredResolve = deferredResolve;
75
-
76
- this._initializeState();
77
- this._upgradeAllProperties();
78
-
79
- if (this.constructor._needsShadowDOM()) {
80
- this.attachShadow({ mode: "open" });
81
- }
82
- }
83
-
84
- /**
85
- * Returns a unique ID for this UI5 Element
86
- *
87
- * @deprecated - This property is not guaranteed in future releases
88
- * @protected
89
- */
90
- get _id() {
91
- if (!this.__id) {
92
- this.__id = `ui5wc_${++autoId}`;
93
- }
94
-
95
- return this.__id;
96
- }
97
-
98
- /**
99
- * Do not call this method from derivatives of UI5Element, use "onEnterDOM" only
100
- * @private
101
- */
102
- async connectedCallback() {
103
- this.setAttribute(this.constructor.getMetadata().getPureTag(), "");
104
- if (this.constructor.getMetadata().supportsF6FastNavigation()) {
105
- this.setAttribute("data-sap-ui-fastnavgroup", "true");
106
- }
107
-
108
- const slotsAreManaged = this.constructor.getMetadata().slotsAreManaged();
109
-
110
- this._inDOM = true;
111
-
112
- if (slotsAreManaged) {
113
- // always register the observer before yielding control to the main thread (await)
114
- this._startObservingDOMChildren();
115
- await this._processChildren();
116
- }
117
-
118
- if (!this._inDOM) { // Component removed from DOM while _processChildren was running
119
- return;
120
- }
121
-
122
- renderImmediately(this);
123
- this._domRefReadyPromise._deferredResolve();
124
- this._fullyConnected = true;
125
- if (typeof this.onEnterDOM === "function") {
126
- this.onEnterDOM();
127
- }
128
- }
129
-
130
- /**
131
- * Do not call this method from derivatives of UI5Element, use "onExitDOM" only
132
- * @private
133
- */
134
- disconnectedCallback() {
135
- const slotsAreManaged = this.constructor.getMetadata().slotsAreManaged();
136
-
137
- this._inDOM = false;
138
-
139
- if (slotsAreManaged) {
140
- this._stopObservingDOMChildren();
141
- }
142
-
143
- if (this._fullyConnected) {
144
- if (typeof this.onExitDOM === "function") {
145
- this.onExitDOM();
146
- }
147
- this._fullyConnected = false;
148
- }
149
-
150
- if (this.staticAreaItem && this.staticAreaItem.parentElement) {
151
- this.staticAreaItem.parentElement.removeChild(this.staticAreaItem);
152
- }
153
-
154
- cancelRender(this);
155
- }
156
-
157
- /**
158
- * @private
159
- */
160
- _startObservingDOMChildren() {
161
- const shouldObserveChildren = this.constructor.getMetadata().hasSlots();
162
- if (!shouldObserveChildren) {
163
- return;
164
- }
165
-
166
- const canSlotText = this.constructor.getMetadata().canSlotText();
167
- const mutationObserverOptions = {
168
- childList: true,
169
- subtree: canSlotText,
170
- characterData: canSlotText,
171
- };
172
- observeDOMNode(this, this._processChildren.bind(this), mutationObserverOptions);
173
- }
174
-
175
- /**
176
- * @private
177
- */
178
- _stopObservingDOMChildren() {
179
- unobserveDOMNode(this);
180
- }
181
-
182
- /**
183
- * Note: this method is also manually called by "compatibility/patchNodeValue.js"
184
- * @private
185
- */
186
- async _processChildren() {
187
- const hasSlots = this.constructor.getMetadata().hasSlots();
188
- if (hasSlots) {
189
- await this._updateSlots();
190
- }
191
- }
192
-
193
- /**
194
- * @private
195
- */
196
- async _updateSlots() {
197
- const slotsMap = this.constructor.getMetadata().getSlots();
198
- const canSlotText = this.constructor.getMetadata().canSlotText();
199
- const domChildren = Array.from(canSlotText ? this.childNodes : this.children);
200
-
201
- const slotsCachedContentMap = new Map(); // Store here the content of each slot before the mutation occurred
202
- const propertyNameToSlotMap = new Map(); // Used for reverse lookup to determine to which slot the property name corresponds
203
-
204
- // Init the _state object based on the supported slots and store the previous values
205
- for (const [slotName, slotData] of Object.entries(slotsMap)) { // eslint-disable-line
206
- const propertyName = slotData.propertyName || slotName;
207
- propertyNameToSlotMap.set(propertyName, slotName);
208
- slotsCachedContentMap.set(propertyName, [...this._state[propertyName]]);
209
- this._clearSlot(slotName, slotData);
210
- }
211
-
212
- const autoIncrementMap = new Map();
213
- const slottedChildrenMap = new Map();
214
-
215
- const allChildrenUpgraded = domChildren.map(async (child, idx) => {
216
- // Determine the type of the child (mainly by the slot attribute)
217
- const slotName = getSlotName(child);
218
- const slotData = slotsMap[slotName];
219
-
220
- // Check if the slotName is supported
221
- if (slotData === undefined) {
222
- const validValues = Object.keys(slotsMap).join(", ");
223
- console.warn(`Unknown slotName: ${slotName}, ignoring`, child, `Valid values are: ${validValues}`); // eslint-disable-line
224
- return;
225
- }
226
-
227
- // For children that need individual slots, calculate them
228
- if (slotData.individualSlots) {
229
- const nextIndex = (autoIncrementMap.get(slotName) || 0) + 1;
230
- autoIncrementMap.set(slotName, nextIndex);
231
- child._individualSlot = `${slotName}-${nextIndex}`;
232
- }
233
-
234
- // Await for not-yet-defined custom elements
235
- if (child instanceof HTMLElement) {
236
- const localName = child.localName;
237
- const isCustomElement = localName.includes("-");
238
- if (isCustomElement) {
239
- const isDefined = window.customElements.get(localName);
240
- if (!isDefined) {
241
- const whenDefinedPromise = window.customElements.whenDefined(localName); // Class registered, but instances not upgraded yet
242
- let timeoutPromise = elementTimeouts.get(localName);
243
- if (!timeoutPromise) {
244
- timeoutPromise = new Promise(resolve => setTimeout(resolve, 1000));
245
- elementTimeouts.set(localName, timeoutPromise);
246
- }
247
- await Promise.race([whenDefinedPromise, timeoutPromise]);
248
- }
249
- window.customElements.upgrade(child);
250
- }
251
- }
252
-
253
- child = this.constructor.getMetadata().constructor.validateSlotValue(child, slotData);
254
-
255
- // Listen for any invalidation on the child if invalidateOnChildChange is true or an object (ignore when false or not set)
256
- if (child.isUI5Element && slotData.invalidateOnChildChange) {
257
- const method = (child.attachInvalidate || child._attachChange).bind(child);
258
- method(this._getChildChangeListener(slotName));
259
- }
260
-
261
- // Listen for the slotchange event if the child is a slot itself
262
- if (isSlot(child)) {
263
- this._attachSlotChange(child, slotName);
264
- }
265
-
266
- const propertyName = slotData.propertyName || slotName;
267
-
268
- if (slottedChildrenMap.has(propertyName)) {
269
- slottedChildrenMap.get(propertyName).push({ child, idx });
270
- } else {
271
- slottedChildrenMap.set(propertyName, [{ child, idx }]);
272
- }
273
- });
274
-
275
- await Promise.all(allChildrenUpgraded);
276
-
277
- // Distribute the child in the _state object, keeping the Light DOM order,
278
- // not the order elements are defined.
279
- slottedChildrenMap.forEach((children, propertyName) => {
280
- this._state[propertyName] = children.sort((a, b) => a.idx - b.idx).map(_ => _.child);
281
- });
282
-
283
- // Compare the content of each slot with the cached values and invalidate for the ones that changed
284
- let invalidated = false;
285
- for (const [slotName, slotData] of Object.entries(slotsMap)) { // eslint-disable-line
286
- const propertyName = slotData.propertyName || slotName;
287
- if (!arraysAreEqual(slotsCachedContentMap.get(propertyName), this._state[propertyName])) {
288
- _invalidate.call(this, {
289
- type: "slot",
290
- name: propertyNameToSlotMap.get(propertyName),
291
- reason: "children",
292
- });
293
- invalidated = true;
294
- }
295
- }
296
-
297
- // If none of the slots had an invalidation due to changes to immediate children,
298
- // the change is considered to be text content of the default slot
299
- if (!invalidated) {
300
- _invalidate.call(this, {
301
- type: "slot",
302
- name: "default",
303
- reason: "textcontent",
304
- });
305
- }
306
- }
307
-
308
- /**
309
- * Removes all children from the slot and detaches listeners, if any
310
- * @private
311
- */
312
- _clearSlot(slotName, slotData) {
313
- const propertyName = slotData.propertyName || slotName;
314
- const children = this._state[propertyName];
315
-
316
- children.forEach(child => {
317
- if (child && child.isUI5Element) {
318
- const method = (child.detachInvalidate || child._detachChange).bind(child);
319
- method(this._getChildChangeListener(slotName));
320
- }
321
-
322
- if (isSlot(child)) {
323
- this._detachSlotChange(child, slotName);
324
- }
325
- });
326
-
327
- this._state[propertyName] = [];
328
- }
329
-
330
- /**
331
- * Attach a callback that will be executed whenever the component is invalidated
332
- *
333
- * @param callback
334
- * @public
335
- */
336
- attachInvalidate(callback) {
337
- this._eventProvider.attachEvent("invalidate", callback);
338
- }
339
-
340
- /**
341
- * Detach the callback that is executed whenever the component is invalidated
342
- *
343
- * @param callback
344
- * @public
345
- */
346
- detachInvalidate(callback) {
347
- this._eventProvider.detachEvent("invalidate", callback);
348
- }
349
-
350
- /**
351
- * Callback that is executed whenever a monitored child changes its state
352
- *
353
- * @param slotName the slot in which a child was invalidated
354
- * @param childChangeInfo the changeInfo object for the child in the given slot
355
- * @private
356
- */
357
- _onChildChange(slotName, childChangeInfo) {
358
- if (!this.constructor.getMetadata().shouldInvalidateOnChildChange(slotName, childChangeInfo.type, childChangeInfo.name)) {
359
- return;
360
- }
361
-
362
- // The component should be invalidated as this type of change on the child is listened for
363
- // However, no matter what changed on the child (property/slot), the invalidation is registered as "type=slot" for the component itself
364
- _invalidate.call(this, {
365
- type: "slot",
366
- name: slotName,
367
- reason: "childchange",
368
- child: childChangeInfo.target,
369
- });
370
- }
371
-
372
- /**
373
- * Do not override this method in derivatives of UI5Element
374
- * @private
375
- */
376
- attributeChangedCallback(name, oldValue, newValue) {
377
- const properties = this.constructor.getMetadata().getProperties();
378
- const realName = name.replace(/^ui5-/, "");
379
- const nameInCamelCase = kebabToCamelCase(realName);
380
- if (properties.hasOwnProperty(nameInCamelCase)) { // eslint-disable-line
381
- const propertyTypeClass = properties[nameInCamelCase].type;
382
- if (propertyTypeClass === Boolean) {
383
- newValue = newValue !== null;
384
- } else if (isDescendantOf(propertyTypeClass, DataType)) {
385
- newValue = propertyTypeClass.attributeToProperty(newValue);
386
- }
387
- this[nameInCamelCase] = newValue;
388
- }
389
- }
390
-
391
- /**
392
- * @private
393
- */
394
- _updateAttribute(name, newValue) {
395
- if (!this.constructor.getMetadata().hasAttribute(name)) {
396
- return;
397
- }
398
- const properties = this.constructor.getMetadata().getProperties();
399
- const propertyTypeClass = properties[name].type;
400
- const attrName = camelToKebabCase(name);
401
- const attrValue = this.getAttribute(attrName);
402
-
403
- if (propertyTypeClass === Boolean) {
404
- if (newValue === true && attrValue === null) {
405
- this.setAttribute(attrName, "");
406
- } else if (newValue === false && attrValue !== null) {
407
- this.removeAttribute(attrName);
408
- }
409
- } else if (isDescendantOf(propertyTypeClass, DataType)) {
410
- this.setAttribute(attrName, propertyTypeClass.propertyToAttribute(newValue));
411
- } else if (typeof newValue !== "object") {
412
- if (attrValue !== newValue) {
413
- this.setAttribute(attrName, newValue);
414
- }
415
- } // else { return; } // old object handling
416
- }
417
-
418
- /**
419
- * @private
420
- */
421
- _upgradeProperty(prop) {
422
- if (this.hasOwnProperty(prop)) { // eslint-disable-line
423
- const value = this[prop];
424
- delete this[prop];
425
- this[prop] = value;
426
- }
427
- }
428
-
429
- /**
430
- * @private
431
- */
432
- _upgradeAllProperties() {
433
- const allProps = this.constructor.getMetadata().getPropertiesList();
434
- allProps.forEach(this._upgradeProperty, this);
435
- }
436
-
437
- /**
438
- * @private
439
- */
440
- _initializeState() {
441
- this._state = { ...this.constructor.getMetadata().getInitialState() };
442
- }
443
-
444
- /**
445
- * Returns a singleton event listener for the "change" event of a child in a given slot
446
- *
447
- * @param slotName the name of the slot, where the child is
448
- * @returns {any}
449
- * @private
450
- */
451
- _getChildChangeListener(slotName) {
452
- if (!this._childChangeListeners.has(slotName)) {
453
- this._childChangeListeners.set(slotName, this._onChildChange.bind(this, slotName));
454
- }
455
- return this._childChangeListeners.get(slotName);
456
- }
457
-
458
- /**
459
- * Returns a singleton slotchange event listener that invalidates the component due to changes in the given slot
460
- *
461
- * @param slotName the name of the slot, where the slot element (whose slotchange event we're listening to) is
462
- * @returns {any}
463
- * @private
464
- */
465
- _getSlotChangeListener(slotName) {
466
- if (!this._slotChangeListeners.has(slotName)) {
467
- this._slotChangeListeners.set(slotName, this._onSlotChange.bind(this, slotName));
468
- }
469
- return this._slotChangeListeners.get(slotName);
470
- }
471
-
472
- /**
473
- * @private
474
- */
475
- _attachSlotChange(child, slotName) {
476
- child.addEventListener("slotchange", this._getSlotChangeListener(slotName));
477
- }
478
-
479
- /**
480
- * @private
481
- */
482
- _detachSlotChange(child, slotName) {
483
- child.removeEventListener("slotchange", this._getSlotChangeListener(slotName));
484
- }
485
-
486
- /**
487
- * Whenever a slot element is slotted inside a UI5 Web Component, its slotchange event invalidates the component
488
- *
489
- * @param slotName the name of the slot, where the slot element (whose slotchange event we're listening to) is
490
- * @private
491
- */
492
- _onSlotChange(slotName) {
493
- _invalidate.call(this, {
494
- type: "slot",
495
- name: slotName,
496
- reason: "slotchange",
497
- });
498
- }
499
-
500
- /**
501
- * A callback that is executed each time an already rendered component is invalidated (scheduled for re-rendering)
502
- *
503
- * @param changeInfo An object with information about the change that caused invalidation.
504
- * The object can have the following properties:
505
- * - type: (property|slot) tells what caused the invalidation
506
- * 1) property: a property value was changed either directly or as a result of changing the corresponding attribute
507
- * 2) slot: a slotted node(nodes) changed in one of several ways (see "reason")
508
- *
509
- * - name: the name of the property or slot that caused the invalidation
510
- *
511
- * - reason: (children|textcontent|childchange|slotchange) relevant only for type="slot" only and tells exactly what changed in the slot
512
- * 1) children: immediate children (HTML elements or text nodes) were added, removed or reordered in the slot
513
- * 2) textcontent: text nodes in the slot changed value (or nested text nodes were added or changed value). Can only trigger for slots of "type: Node"
514
- * 3) slotchange: a slot element, slotted inside that slot had its "slotchange" event listener called. This practically means that transitively slotted children changed.
515
- * Can only trigger if the child of a slot is a slot element itself.
516
- * 4) childchange: indicates that a UI5Element child in that slot was invalidated and in turn invalidated the component.
517
- * Can only trigger for slots with "invalidateOnChildChange" metadata descriptor
518
- *
519
- * - newValue: the new value of the property (for type="property" only)
520
- *
521
- * - oldValue: the old value of the property (for type="property" only)
522
- *
523
- * - child the child that was changed (for type="slot" and reason="childchange" only)
524
- *
525
- * @public
526
- */
527
- onInvalidation(changeInfo) {}
528
-
529
- /**
530
- * Do not call this method directly, only intended to be called by js
531
- * @protected
532
- */
533
- _render() {
534
- const hasIndividualSlots = this.constructor.getMetadata().hasIndividualSlots();
535
-
536
- // suppress invalidation to prevent state changes scheduling another rendering
537
- this._suppressInvalidation = true;
538
-
539
- if (typeof this.onBeforeRendering === "function") {
540
- this.onBeforeRendering();
541
- }
542
-
543
- // Intended for framework usage only. Currently ItemNavigation updates tab indexes after the component has updated its state but before the template is rendered
544
- if (this._onComponentStateFinalized) {
545
- this._onComponentStateFinalized();
546
- }
547
-
548
- // resume normal invalidation handling
549
- this._suppressInvalidation = false;
550
-
551
- // Update the shadow root with the render result
552
- /*
553
- if (this._changedState.length) {
554
- let element = this.localName;
555
- if (this.id) {
556
- element = `${element}#${this.id}`;
557
- }
558
- console.log("Re-rendering:", element, this._changedState.map(x => { // eslint-disable-line
559
- let res = `${x.type}`;
560
- if (x.reason) {
561
- res = `${res}(${x.reason})`;
562
- }
563
- res = `${res}: ${x.name}`;
564
- if (x.type === "property") {
565
- res = `${res} ${x.oldValue} => ${x.newValue}`;
566
- }
567
-
568
- return res;
569
- }));
570
- }
571
- */
572
- this._changedState = [];
573
-
574
- // Update shadow root and static area item
575
- if (this.constructor._needsShadowDOM()) {
576
- updateShadowRoot(this);
577
- }
578
- if (this.staticAreaItem) {
579
- this.staticAreaItem.update();
580
- }
581
-
582
- // Safari requires that children get the slot attribute only after the slot tags have been rendered in the shadow DOM
583
- if (hasIndividualSlots) {
584
- this._assignIndividualSlotsToChildren();
585
- }
586
-
587
- // Call the onAfterRendering hook
588
- if (typeof this.onAfterRendering === "function") {
589
- this.onAfterRendering();
590
- }
591
- }
592
-
593
- /**
594
- * @private
595
- */
596
- _assignIndividualSlotsToChildren() {
597
- const domChildren = Array.from(this.children);
598
-
599
- domChildren.forEach(child => {
600
- if (child._individualSlot) {
601
- child.setAttribute("slot", child._individualSlot);
602
- }
603
- });
604
- }
605
-
606
- /**
607
- * @private
608
- */
609
- _waitForDomRef() {
610
- return this._domRefReadyPromise;
611
- }
612
-
613
- /**
614
- * Returns the DOM Element inside the Shadow Root that corresponds to the opening tag in the UI5 Web Component's template
615
- * *Note:* For logical (abstract) elements (items, options, etc...), returns the part of the parent's DOM that represents this option
616
- * Use this method instead of "this.shadowRoot" to read the Shadow DOM, if ever necessary
617
- *
618
- * @public
619
- */
620
- getDomRef() {
621
- // If a component set _getRealDomRef to its children, use the return value of this function
622
- if (typeof this._getRealDomRef === "function") {
623
- return this._getRealDomRef();
624
- }
625
-
626
- if (!this.shadowRoot || this.shadowRoot.children.length === 0) {
627
- return;
628
- }
629
-
630
- const children = [...this.shadowRoot.children].filter(child => !["link", "style"].includes(child.localName));
631
- if (children.length !== 1) {
632
- console.warn(`The shadow DOM for ${this.constructor.getMetadata().getTag()} does not have a top level element, the getDomRef() method might not work as expected`); // eslint-disable-line
633
- }
634
-
635
- return children[0];
636
- }
637
-
638
- /**
639
- * Returns the DOM Element marked with "data-sap-focus-ref" inside the template.
640
- * This is the element that will receive the focus by default.
641
- * @public
642
- */
643
- getFocusDomRef() {
644
- const domRef = this.getDomRef();
645
- if (domRef) {
646
- const focusRef = domRef.querySelector("[data-sap-focus-ref]");
647
- return focusRef || domRef;
648
- }
649
- }
650
-
651
- /**
652
- * Waits for dom ref and then returns the DOM Element marked with "data-sap-focus-ref" inside the template.
653
- * This is the element that will receive the focus by default.
654
- * @public
655
- */
656
- async getFocusDomRefAsync() {
657
- await this._waitForDomRef();
658
- return this.getFocusDomRef();
659
- }
660
-
661
- /**
662
- * Set the focus to the element, returned by "getFocusDomRef()" (marked by "data-sap-focus-ref")
663
- * @public
664
- */
665
- async focus() {
666
- await this._waitForDomRef();
667
-
668
- const focusDomRef = this.getFocusDomRef();
669
-
670
- if (focusDomRef && typeof focusDomRef.focus === "function") {
671
- focusDomRef.focus();
672
- }
673
- }
674
-
675
- /**
676
- *
677
- * @public
678
- * @param name - name of the event
679
- * @param data - additional data for the event
680
- * @param cancelable - true, if the user can call preventDefault on the event object
681
- * @param bubbles - true, if the event bubbles
682
- * @returns {boolean} false, if the event was cancelled (preventDefault called), true otherwise
683
- */
684
- fireEvent(name, data, cancelable = false, bubbles = true) {
685
- const eventResult = this._fireEvent(name, data, cancelable, bubbles);
686
- const camelCaseEventName = kebabToCamelCase(name);
687
-
688
- if (camelCaseEventName !== name) {
689
- return eventResult && this._fireEvent(camelCaseEventName, data, cancelable);
690
- }
691
-
692
- return eventResult;
693
- }
694
-
695
- _fireEvent(name, data, cancelable = false, bubbles = true) {
696
- const noConflictEvent = new CustomEvent(`ui5-${name}`, {
697
- detail: data,
698
- composed: false,
699
- bubbles,
700
- cancelable,
701
- });
702
-
703
- // This will be false if the no-conflict event is prevented
704
- const noConflictEventResult = this.dispatchEvent(noConflictEvent);
705
-
706
- if (skipOriginalEvent(name)) {
707
- return noConflictEventResult;
708
- }
709
-
710
- const normalEvent = new CustomEvent(name, {
711
- detail: data,
712
- composed: false,
713
- bubbles,
714
- cancelable,
715
- });
716
-
717
- // This will be false if the normal event is prevented
718
- const normalEventResult = this.dispatchEvent(normalEvent);
719
-
720
- // Return false if any of the two events was prevented (its result was false).
721
- return normalEventResult && noConflictEventResult;
722
- }
723
-
724
- /**
725
- * Returns the actual children, associated with a slot.
726
- * Useful when there are transitive slots in nested component scenarios and you don't want to get a list of the slots, but rather of their content.
727
- * @public
728
- */
729
- getSlottedNodes(slotName) {
730
- return getSlottedElementsList(this[slotName]);
731
- }
732
-
733
- /**
734
- * Determines whether the component should be rendered in RTL mode or not.
735
- * Returns: "rtl", "ltr" or undefined
736
- *
737
- * @public
738
- * @returns {String|undefined}
739
- */
740
- get effectiveDir() {
741
- markAsRtlAware(this.constructor); // if a UI5 Element calls this method, it's considered to be rtl-aware
742
- return getEffectiveDir(this);
743
- }
744
-
745
- /**
746
- * Used to duck-type UI5 elements without using instanceof
747
- * @returns {boolean}
748
- * @public
749
- */
750
- get isUI5Element() {
751
- return true;
752
- }
753
-
754
- /**
755
- * Do not override this method in derivatives of UI5Element, use metadata properties instead
756
- * @private
757
- */
758
- static get observedAttributes() {
759
- return this.getMetadata().getAttributesList();
760
- }
761
-
762
- /**
763
- * @private
764
- */
765
- static _needsShadowDOM() {
766
- return !!this.template;
767
- }
768
-
769
- /**
770
- * @private
771
- */
772
- static _needsStaticArea() {
773
- return !!this.staticAreaTemplate;
774
- }
775
-
776
- /**
777
- * @public
778
- */
779
- getStaticAreaItemDomRef() {
780
- if (!this.constructor._needsStaticArea()) {
781
- throw new Error("This component does not use the static area");
782
- }
783
-
784
- if (!this.staticAreaItem) {
785
- this.staticAreaItem = StaticAreaItem.createInstance();
786
- this.staticAreaItem.setOwnerElement(this);
787
- }
788
- if (!this.staticAreaItem.parentElement) {
789
- getSingletonElementInstance("ui5-static-area").appendChild(this.staticAreaItem);
790
- }
791
-
792
- return this.staticAreaItem.getDomRef();
793
- }
794
-
795
- /**
796
- * @private
797
- */
798
- static _generateAccessors() {
799
- const proto = this.prototype;
800
- const slotsAreManaged = this.getMetadata().slotsAreManaged();
801
-
802
- // Properties
803
- const properties = this.getMetadata().getProperties();
804
- for (const [prop, propData] of Object.entries(properties)) { // eslint-disable-line
805
- if (!isValidPropertyName(prop)) {
806
- console.warn(`"${prop}" is not a valid property name. Use a name that does not collide with DOM APIs`); /* eslint-disable-line */
807
- }
808
-
809
- if (propData.type === Boolean && propData.defaultValue) {
810
- throw new Error(`Cannot set a default value for property "${prop}". All booleans are false by default.`);
811
- }
812
-
813
- if (propData.type === Array) {
814
- throw new Error(`Wrong type for property "${prop}". Properties cannot be of type Array - use "multiple: true" and set "type" to the single value type, such as "String", "Object", etc...`);
815
- }
816
-
817
- if (propData.type === Object && propData.defaultValue) {
818
- throw new Error(`Cannot set a default value for property "${prop}". All properties of type "Object" are empty objects by default.`);
819
- }
820
-
821
- if (propData.multiple && propData.defaultValue) {
822
- throw new Error(`Cannot set a default value for property "${prop}". All multiple properties are empty arrays by default.`);
823
- }
824
-
825
- Object.defineProperty(proto, prop, {
826
- get() {
827
- if (this._state[prop] !== undefined) {
828
- return this._state[prop];
829
- }
830
-
831
- const propDefaultValue = propData.defaultValue;
832
-
833
- if (propData.type === Boolean) {
834
- return false;
835
- } else if (propData.type === String) { // eslint-disable-line
836
- return propDefaultValue;
837
- } else if (propData.multiple) { // eslint-disable-line
838
- return [];
839
- } else {
840
- return propDefaultValue;
841
- }
842
- },
843
- set(value) {
844
- let isDifferent;
845
- value = this.constructor.getMetadata().constructor.validatePropertyValue(value, propData);
846
-
847
- const oldState = this._state[prop];
848
- if (propData.multiple && propData.compareValues) {
849
- isDifferent = !arraysAreEqual(oldState, value);
850
- } else if (isDescendantOf(propData.type, DataType)) {
851
- isDifferent = !propData.type.valuesAreEqual(oldState, value);
852
- } else {
853
- isDifferent = oldState !== value;
854
- }
855
-
856
- if (isDifferent) {
857
- this._state[prop] = value;
858
- _invalidate.call(this, {
859
- type: "property",
860
- name: prop,
861
- newValue: value,
862
- oldValue: oldState,
863
- });
864
- this._updateAttribute(prop, value);
865
- }
866
- },
867
- });
868
- }
869
-
870
- // Slots
871
- if (slotsAreManaged) {
872
- const slots = this.getMetadata().getSlots();
873
- for (const [slotName, slotData] of Object.entries(slots)) { // eslint-disable-line
874
- if (!isValidPropertyName(slotName)) {
875
- console.warn(`"${slotName}" is not a valid property name. Use a name that does not collide with DOM APIs`); /* eslint-disable-line */
876
- }
877
-
878
- const propertyName = slotData.propertyName || slotName;
879
- Object.defineProperty(proto, propertyName, {
880
- get() {
881
- if (this._state[propertyName] !== undefined) {
882
- return this._state[propertyName];
883
- }
884
- return [];
885
- },
886
- set() {
887
- throw new Error("Cannot set slot content directly, use the DOM APIs (appendChild, removeChild, etc...)");
888
- },
889
- });
890
- }
891
- }
892
- }
893
-
894
- /**
895
- * Returns the metadata object for this UI5 Web Component Class
896
- * @protected
897
- */
898
- static get metadata() {
899
- return {};
900
- }
901
-
902
- /**
903
- * Returns the CSS for this UI5 Web Component Class
904
- * @protected
905
- */
906
- static get styles() {
907
- return "";
908
- }
909
-
910
- /**
911
- * Returns the Static Area CSS for this UI5 Web Component Class
912
- * @protected
913
- */
914
- static get staticAreaStyles() {
915
- return "";
916
- }
917
-
918
- /**
919
- * Returns an array with the dependencies for this UI5 Web Component, which could be:
920
- * - composed components (used in its shadow root or static area item)
921
- * - slotted components that the component may need to communicate with
922
- *
923
- * @protected
924
- */
925
- static get dependencies() {
926
- return [];
927
- }
928
-
929
- /**
930
- * Returns a list of the unique dependencies for this UI5 Web Component
931
- *
932
- * @public
933
- */
934
- static getUniqueDependencies() {
935
- if (!uniqueDependenciesCache.has(this)) {
936
- const filtered = this.dependencies.filter((dep, index, deps) => deps.indexOf(dep) === index);
937
- uniqueDependenciesCache.set(this, filtered);
938
- }
939
-
940
- return uniqueDependenciesCache.get(this);
941
- }
942
-
943
- /**
944
- * Returns a promise that resolves whenever all dependencies for this UI5 Web Component have resolved
945
- *
946
- * @returns {Promise<any[]>}
947
- */
948
- static whenDependenciesDefined() {
949
- return Promise.all(this.getUniqueDependencies().map(dep => dep.define()));
950
- }
951
-
952
- /**
953
- * Hook that will be called upon custom element definition
954
- *
955
- * @protected
956
- * @returns {Promise<void>}
957
- */
958
- static async onDefine() {
959
- return Promise.resolve();
960
- }
961
-
962
- /**
963
- * Registers a UI5 Web Component in the browser window object
964
- * @public
965
- * @returns {Promise<UI5Element>}
966
- */
967
- static async define() {
968
- await boot();
969
-
970
- await Promise.all([
971
- this.whenDependenciesDefined(),
972
- this.onDefine(),
973
- ]);
974
-
975
- const tag = this.getMetadata().getTag();
976
- const altTag = this.getMetadata().getAltTag();
977
-
978
- const definedLocally = isTagRegistered(tag);
979
- const definedGlobally = customElements.get(tag);
980
-
981
- if (definedGlobally && !definedLocally) {
982
- recordTagRegistrationFailure(tag);
983
- } else if (!definedGlobally) {
984
- this._generateAccessors();
985
- registerTag(tag);
986
- window.customElements.define(tag, this);
987
- preloadLinks(this);
988
-
989
- if (altTag && !customElements.get(altTag)) {
990
- registerTag(altTag);
991
- window.customElements.define(altTag, getClassCopy(this, () => {
992
- console.log(`The ${altTag} tag is deprecated and will be removed in the next release, please use ${tag} instead.`); // eslint-disable-line
993
- }));
994
- }
995
- }
996
- return this;
997
- }
998
-
999
- /**
1000
- * Returns an instance of UI5ElementMetadata.js representing this UI5 Web Component's full metadata (its and its parents')
1001
- * Note: not to be confused with the "get metadata()" method, which returns an object for this class's metadata only
1002
- * @public
1003
- * @returns {UI5ElementMetadata}
1004
- */
1005
- static getMetadata() {
1006
- if (this.hasOwnProperty("_metadata")) { // eslint-disable-line
1007
- return this._metadata;
1008
- }
1009
-
1010
- const metadataObjects = [this.metadata];
1011
- let klass = this; // eslint-disable-line
1012
- while (klass !== UI5Element) {
1013
- klass = Object.getPrototypeOf(klass);
1014
- metadataObjects.unshift(klass.metadata);
1015
- }
1016
- const mergedMetadata = merge({}, ...metadataObjects);
1017
-
1018
- this._metadata = new UI5ElementMetadata(mergedMetadata);
1019
- return this._metadata;
1020
- }
53
+ constructor() {
54
+ super();
55
+ const ctor = this.constructor;
56
+ this._changedState = []; // Filled on each invalidation, cleared on re-render (used for debugging)
57
+ this._suppressInvalidation = true; // A flag telling whether all invalidations should be ignored. Initialized with "true" because a UI5Element can not be invalidated until it is rendered for the first time
58
+ this._inDOM = false; // A flag telling whether the UI5Element is currently in the DOM tree of the document or not
59
+ this._fullyConnected = false; // A flag telling whether the UI5Element's onEnterDOM hook was called (since it's possible to have the element removed from DOM before that)
60
+ this._childChangeListeners = new Map(); // used to store lazy listeners per slot for the child change event of every child inside that slot
61
+ this._slotChangeListeners = new Map(); // used to store lazy listeners per slot for the slotchange event of all slot children inside that slot
62
+ this._eventProvider = new EventProvider(); // used by parent components for listening to changes to child components
63
+ let deferredResolve;
64
+ this._domRefReadyPromise = new Promise(resolve => {
65
+ deferredResolve = resolve;
66
+ });
67
+ this._domRefReadyPromise._deferredResolve = deferredResolve;
68
+ this._doNotSyncAttributes = new Set(); // attributes that are excluded from attributeChangedCallback synchronization
69
+ this._state = { ...ctor.getMetadata().getInitialState() };
70
+ this._upgradeAllProperties();
71
+ if (ctor._needsShadowDOM()) {
72
+ this.attachShadow({ mode: "open" });
73
+ }
74
+ }
75
+ /**
76
+ * Returns a unique ID for this UI5 Element
77
+ *
78
+ * @deprecated - This property is not guaranteed in future releases
79
+ * @protected
80
+ */
81
+ get _id() {
82
+ if (!this.__id) {
83
+ this.__id = `ui5wc_${++autoId}`;
84
+ }
85
+ return this.__id;
86
+ }
87
+ render() {
88
+ const template = this.constructor.template;
89
+ return executeTemplate(template, this);
90
+ }
91
+ renderStatic() {
92
+ const template = this.constructor.staticAreaTemplate;
93
+ return executeTemplate(template, this);
94
+ }
95
+ /**
96
+ * Do not call this method from derivatives of UI5Element, use "onEnterDOM" only
97
+ * @private
98
+ */
99
+ async connectedCallback() {
100
+ const ctor = this.constructor;
101
+ this.setAttribute(`_ui5rt${getCurrentRuntimeIndex()}`, "");
102
+ this.setAttribute("_ui5host", "");
103
+ this.setAttribute(ctor.getMetadata().getPureTag(), "");
104
+ if (ctor.getMetadata().supportsF6FastNavigation()) {
105
+ this.setAttribute("data-sap-ui-fastnavgroup", "true");
106
+ }
107
+ const slotsAreManaged = ctor.getMetadata().slotsAreManaged();
108
+ this._inDOM = true;
109
+ if (slotsAreManaged) {
110
+ // always register the observer before yielding control to the main thread (await)
111
+ this._startObservingDOMChildren();
112
+ await this._processChildren();
113
+ }
114
+ if (!this._inDOM) { // Component removed from DOM while _processChildren was running
115
+ return;
116
+ }
117
+ renderImmediately(this);
118
+ this._domRefReadyPromise._deferredResolve();
119
+ this._fullyConnected = true;
120
+ this.onEnterDOM();
121
+ }
122
+ /**
123
+ * Do not call this method from derivatives of UI5Element, use "onExitDOM" only
124
+ * @private
125
+ */
126
+ disconnectedCallback() {
127
+ const ctor = this.constructor;
128
+ const slotsAreManaged = ctor.getMetadata().slotsAreManaged();
129
+ this._inDOM = false;
130
+ if (slotsAreManaged) {
131
+ this._stopObservingDOMChildren();
132
+ }
133
+ if (this._fullyConnected) {
134
+ this.onExitDOM();
135
+ this._fullyConnected = false;
136
+ }
137
+ if (this.staticAreaItem && this.staticAreaItem.parentElement) {
138
+ this.staticAreaItem.parentElement.removeChild(this.staticAreaItem);
139
+ }
140
+ cancelRender(this);
141
+ }
142
+ /**
143
+ * Called every time before the component renders.
144
+ * @public
145
+ */
146
+ onBeforeRendering() { }
147
+ /**
148
+ * Called every time after the component renders.
149
+ * @public
150
+ */
151
+ onAfterRendering() { }
152
+ /**
153
+ * Called on connectedCallback - added to the DOM.
154
+ * @public
155
+ */
156
+ onEnterDOM() { }
157
+ /**
158
+ * Called on disconnectedCallback - removed from the DOM.
159
+ * @public
160
+ */
161
+ onExitDOM() { }
162
+ /**
163
+ * @private
164
+ */
165
+ _startObservingDOMChildren() {
166
+ const ctor = this.constructor;
167
+ const shouldObserveChildren = ctor.getMetadata().hasSlots();
168
+ if (!shouldObserveChildren) {
169
+ return;
170
+ }
171
+ const canSlotText = ctor.getMetadata().canSlotText();
172
+ const mutationObserverOptions = {
173
+ childList: true,
174
+ subtree: canSlotText,
175
+ characterData: canSlotText,
176
+ };
177
+ observeDOMNode(this, this._processChildren.bind(this), mutationObserverOptions);
178
+ }
179
+ /**
180
+ * @private
181
+ */
182
+ _stopObservingDOMChildren() {
183
+ unobserveDOMNode(this);
184
+ }
185
+ /**
186
+ * Note: this method is also manually called by "compatibility/patchNodeValue.js"
187
+ * @private
188
+ */
189
+ async _processChildren() {
190
+ const hasSlots = this.constructor.getMetadata().hasSlots();
191
+ if (hasSlots) {
192
+ await this._updateSlots();
193
+ }
194
+ }
195
+ /**
196
+ * @private
197
+ */
198
+ async _updateSlots() {
199
+ const ctor = this.constructor;
200
+ const slotsMap = ctor.getMetadata().getSlots();
201
+ const canSlotText = ctor.getMetadata().canSlotText();
202
+ const domChildren = Array.from(canSlotText ? this.childNodes : this.children);
203
+ const slotsCachedContentMap = new Map(); // Store here the content of each slot before the mutation occurred
204
+ const propertyNameToSlotMap = new Map(); // Used for reverse lookup to determine to which slot the property name corresponds
205
+ // Init the _state object based on the supported slots and store the previous values
206
+ for (const [slotName, slotData] of Object.entries(slotsMap)) { // eslint-disable-line
207
+ const propertyName = slotData.propertyName || slotName;
208
+ propertyNameToSlotMap.set(propertyName, slotName);
209
+ slotsCachedContentMap.set(propertyName, [...this._state[propertyName]]);
210
+ this._clearSlot(slotName, slotData);
211
+ }
212
+ const autoIncrementMap = new Map();
213
+ const slottedChildrenMap = new Map();
214
+ const allChildrenUpgraded = domChildren.map(async (child, idx) => {
215
+ // Determine the type of the child (mainly by the slot attribute)
216
+ const slotName = getSlotName(child);
217
+ const slotData = slotsMap[slotName];
218
+ // Check if the slotName is supported
219
+ if (slotData === undefined) {
220
+ if (slotName !== "default") {
221
+ const validValues = Object.keys(slotsMap).join(", ");
222
+ console.warn(`Unknown slotName: ${slotName}, ignoring`, child, `Valid values are: ${validValues}`); // eslint-disable-line
223
+ }
224
+ return;
225
+ }
226
+ // For children that need individual slots, calculate them
227
+ if (slotData.individualSlots) {
228
+ const nextIndex = (autoIncrementMap.get(slotName) || 0) + 1;
229
+ autoIncrementMap.set(slotName, nextIndex);
230
+ child._individualSlot = `${slotName}-${nextIndex}`;
231
+ }
232
+ // Await for not-yet-defined custom elements
233
+ if (child instanceof HTMLElement) {
234
+ const localName = child.localName;
235
+ const shouldWaitForCustomElement = localName.includes("-") && !shouldIgnoreCustomElement(localName);
236
+ if (shouldWaitForCustomElement) {
237
+ const isDefined = window.customElements.get(localName);
238
+ if (!isDefined) {
239
+ const whenDefinedPromise = window.customElements.whenDefined(localName); // Class registered, but instances not upgraded yet
240
+ let timeoutPromise = elementTimeouts.get(localName);
241
+ if (!timeoutPromise) {
242
+ timeoutPromise = new Promise(resolve => setTimeout(resolve, 1000));
243
+ elementTimeouts.set(localName, timeoutPromise);
244
+ }
245
+ await Promise.race([whenDefinedPromise, timeoutPromise]);
246
+ }
247
+ window.customElements.upgrade(child);
248
+ }
249
+ }
250
+ child = ctor.getMetadata().constructor.validateSlotValue(child, slotData);
251
+ // Listen for any invalidation on the child if invalidateOnChildChange is true or an object (ignore when false or not set)
252
+ if (instanceOfUI5Element(child) && slotData.invalidateOnChildChange) {
253
+ const childChangeListener = this._getChildChangeListener(slotName);
254
+ if (childChangeListener) {
255
+ child.attachInvalidate.call(child, childChangeListener);
256
+ }
257
+ }
258
+ // Listen for the slotchange event if the child is a slot itself
259
+ if (child instanceof HTMLSlotElement) {
260
+ this._attachSlotChange(child, slotName);
261
+ }
262
+ const propertyName = slotData.propertyName || slotName;
263
+ if (slottedChildrenMap.has(propertyName)) {
264
+ slottedChildrenMap.get(propertyName).push({ child, idx });
265
+ }
266
+ else {
267
+ slottedChildrenMap.set(propertyName, [{ child, idx }]);
268
+ }
269
+ });
270
+ await Promise.all(allChildrenUpgraded);
271
+ // Distribute the child in the _state object, keeping the Light DOM order,
272
+ // not the order elements are defined.
273
+ slottedChildrenMap.forEach((children, propertyName) => {
274
+ this._state[propertyName] = children.sort((a, b) => a.idx - b.idx).map(_ => _.child);
275
+ });
276
+ // Compare the content of each slot with the cached values and invalidate for the ones that changed
277
+ let invalidated = false;
278
+ for (const [slotName, slotData] of Object.entries(slotsMap)) { // eslint-disable-line
279
+ const propertyName = slotData.propertyName || slotName;
280
+ if (!arraysAreEqual(slotsCachedContentMap.get(propertyName), this._state[propertyName])) {
281
+ _invalidate.call(this, {
282
+ type: "slot",
283
+ name: propertyNameToSlotMap.get(propertyName),
284
+ reason: "children",
285
+ });
286
+ invalidated = true;
287
+ }
288
+ }
289
+ // If none of the slots had an invalidation due to changes to immediate children,
290
+ // the change is considered to be text content of the default slot
291
+ if (!invalidated) {
292
+ _invalidate.call(this, {
293
+ type: "slot",
294
+ name: "default",
295
+ reason: "textcontent",
296
+ });
297
+ }
298
+ }
299
+ /**
300
+ * Removes all children from the slot and detaches listeners, if any
301
+ * @private
302
+ */
303
+ _clearSlot(slotName, slotData) {
304
+ const propertyName = slotData.propertyName || slotName;
305
+ const children = this._state[propertyName];
306
+ children.forEach(child => {
307
+ if (instanceOfUI5Element(child)) {
308
+ const childChangeListener = this._getChildChangeListener(slotName);
309
+ if (childChangeListener) {
310
+ child.detachInvalidate.call(child, childChangeListener);
311
+ }
312
+ }
313
+ if (child instanceof HTMLSlotElement) {
314
+ this._detachSlotChange(child, slotName);
315
+ }
316
+ });
317
+ this._state[propertyName] = [];
318
+ }
319
+ /**
320
+ * Attach a callback that will be executed whenever the component is invalidated
321
+ *
322
+ * @param {InvalidationInfo} callback
323
+ * @public
324
+ */
325
+ attachInvalidate(callback) {
326
+ this._eventProvider.attachEvent("invalidate", callback);
327
+ }
328
+ /**
329
+ * Detach the callback that is executed whenever the component is invalidated
330
+ *
331
+ * @param {InvalidationInfo} callback
332
+ * @public
333
+ */
334
+ detachInvalidate(callback) {
335
+ this._eventProvider.detachEvent("invalidate", callback);
336
+ }
337
+ /**
338
+ * Callback that is executed whenever a monitored child changes its state
339
+ *
340
+ * @param {sting} slotName the slot in which a child was invalidated
341
+ * @param { ChangeInfo } childChangeInfo the changeInfo object for the child in the given slot
342
+ * @private
343
+ */
344
+ _onChildChange(slotName, childChangeInfo) {
345
+ if (!this.constructor.getMetadata().shouldInvalidateOnChildChange(slotName, childChangeInfo.type, childChangeInfo.name)) {
346
+ return;
347
+ }
348
+ // The component should be invalidated as this type of change on the child is listened for
349
+ // However, no matter what changed on the child (property/slot), the invalidation is registered as "type=slot" for the component itself
350
+ _invalidate.call(this, {
351
+ type: "slot",
352
+ name: slotName,
353
+ reason: "childchange",
354
+ child: childChangeInfo.target,
355
+ });
356
+ }
357
+ /**
358
+ * Do not override this method in derivatives of UI5Element
359
+ * @private
360
+ */
361
+ attributeChangedCallback(name, oldValue, newValue) {
362
+ let newPropertyValue;
363
+ if (this._doNotSyncAttributes.has(name)) { // This attribute is mutated internally, not by the user
364
+ return;
365
+ }
366
+ const properties = this.constructor.getMetadata().getProperties();
367
+ const realName = name.replace(/^ui5-/, "");
368
+ const nameInCamelCase = kebabToCamelCase(realName);
369
+ if (properties.hasOwnProperty(nameInCamelCase)) { // eslint-disable-line
370
+ const propData = properties[nameInCamelCase];
371
+ const propertyType = propData.type;
372
+ let propertyValidator = propData.validator;
373
+ if (propertyType && propertyType.isDataTypeClass) {
374
+ propertyValidator = propertyType;
375
+ }
376
+ if (propertyValidator) {
377
+ newPropertyValue = propertyValidator.attributeToProperty(newValue);
378
+ }
379
+ else if (propertyType === Boolean) {
380
+ newPropertyValue = newValue !== null;
381
+ }
382
+ else {
383
+ newPropertyValue = newValue;
384
+ }
385
+ this[nameInCamelCase] = newPropertyValue;
386
+ }
387
+ }
388
+ /**
389
+ * @private
390
+ */
391
+ _updateAttribute(name, newValue) {
392
+ const ctor = this.constructor;
393
+ if (!ctor.getMetadata().hasAttribute(name)) {
394
+ return;
395
+ }
396
+ const properties = ctor.getMetadata().getProperties();
397
+ const propData = properties[name];
398
+ const propertyType = propData.type;
399
+ let propertyValidator = propData.validator;
400
+ const attrName = camelToKebabCase(name);
401
+ const attrValue = this.getAttribute(attrName);
402
+ if (propertyType && propertyType.isDataTypeClass) {
403
+ propertyValidator = propertyType;
404
+ }
405
+ if (propertyValidator) {
406
+ const newAttrValue = propertyValidator.propertyToAttribute(newValue);
407
+ if (newAttrValue === null) { // null means there must be no attribute for the current value of the property
408
+ this._doNotSyncAttributes.add(attrName); // skip the attributeChangedCallback call for this attribute
409
+ this.removeAttribute(attrName); // remove the attribute safely (will not trigger synchronization to the property value due to the above line)
410
+ this._doNotSyncAttributes.delete(attrName); // enable synchronization again for this attribute
411
+ }
412
+ else {
413
+ this.setAttribute(attrName, newAttrValue);
414
+ }
415
+ }
416
+ else if (propertyType === Boolean) {
417
+ if (newValue === true && attrValue === null) {
418
+ this.setAttribute(attrName, "");
419
+ }
420
+ else if (newValue === false && attrValue !== null) {
421
+ this.removeAttribute(attrName);
422
+ }
423
+ }
424
+ else if (typeof newValue !== "object") {
425
+ if (attrValue !== newValue) {
426
+ this.setAttribute(attrName, newValue);
427
+ }
428
+ } // else { return; } // old object handling
429
+ }
430
+ /**
431
+ * @private
432
+ */
433
+ _upgradeProperty(propertyName) {
434
+ if (this.hasOwnProperty(propertyName)) { // eslint-disable-line
435
+ const value = this[propertyName];
436
+ delete this[propertyName];
437
+ this[propertyName] = value;
438
+ }
439
+ }
440
+ /**
441
+ * @private
442
+ */
443
+ _upgradeAllProperties() {
444
+ const allProps = this.constructor.getMetadata().getPropertiesList();
445
+ allProps.forEach(this._upgradeProperty.bind(this));
446
+ }
447
+ /**
448
+ * Returns a singleton event listener for the "change" event of a child in a given slot
449
+ *
450
+ * @param slotName the name of the slot, where the child is
451
+ * @returns {ChildChangeListener}
452
+ * @private
453
+ */
454
+ _getChildChangeListener(slotName) {
455
+ if (!this._childChangeListeners.has(slotName)) {
456
+ this._childChangeListeners.set(slotName, this._onChildChange.bind(this, slotName));
457
+ }
458
+ return this._childChangeListeners.get(slotName);
459
+ }
460
+ /**
461
+ * Returns a singleton slotchange event listener that invalidates the component due to changes in the given slot
462
+ *
463
+ * @param slotName the name of the slot, where the slot element (whose slotchange event we're listening to) is
464
+ * @returns {SlotChangeListener}
465
+ * @private
466
+ */
467
+ _getSlotChangeListener(slotName) {
468
+ if (!this._slotChangeListeners.has(slotName)) {
469
+ this._slotChangeListeners.set(slotName, this._onSlotChange.bind(this, slotName));
470
+ }
471
+ return this._slotChangeListeners.get(slotName);
472
+ }
473
+ /**
474
+ * @private
475
+ */
476
+ _attachSlotChange(child, slotName) {
477
+ const slotChangeListener = this._getSlotChangeListener(slotName);
478
+ if (slotChangeListener) {
479
+ child.addEventListener("slotchange", slotChangeListener);
480
+ }
481
+ }
482
+ /**
483
+ * @private
484
+ */
485
+ _detachSlotChange(child, slotName) {
486
+ child.removeEventListener("slotchange", this._getSlotChangeListener(slotName));
487
+ }
488
+ /**
489
+ * Whenever a slot element is slotted inside a UI5 Web Component, its slotchange event invalidates the component
490
+ *
491
+ * @param slotName the name of the slot, where the slot element (whose slotchange event we're listening to) is
492
+ * @private
493
+ */
494
+ _onSlotChange(slotName) {
495
+ _invalidate.call(this, {
496
+ type: "slot",
497
+ name: slotName,
498
+ reason: "slotchange",
499
+ });
500
+ }
501
+ /**
502
+ * A callback that is executed each time an already rendered component is invalidated (scheduled for re-rendering)
503
+ *
504
+ * @param changeInfo An object with information about the change that caused invalidation.
505
+ * The object can have the following properties:
506
+ * - type: (property|slot) tells what caused the invalidation
507
+ * 1) property: a property value was changed either directly or as a result of changing the corresponding attribute
508
+ * 2) slot: a slotted node(nodes) changed in one of several ways (see "reason")
509
+ *
510
+ * - name: the name of the property or slot that caused the invalidation
511
+ *
512
+ * - reason: (children|textcontent|childchange|slotchange) relevant only for type="slot" only and tells exactly what changed in the slot
513
+ * 1) children: immediate children (HTML elements or text nodes) were added, removed or reordered in the slot
514
+ * 2) textcontent: text nodes in the slot changed value (or nested text nodes were added or changed value). Can only trigger for slots of "type: Node"
515
+ * 3) slotchange: a slot element, slotted inside that slot had its "slotchange" event listener called. This practically means that transitively slotted children changed.
516
+ * Can only trigger if the child of a slot is a slot element itself.
517
+ * 4) childchange: indicates that a UI5Element child in that slot was invalidated and in turn invalidated the component.
518
+ * Can only trigger for slots with "invalidateOnChildChange" metadata descriptor
519
+ *
520
+ * - newValue: the new value of the property (for type="property" only)
521
+ *
522
+ * - oldValue: the old value of the property (for type="property" only)
523
+ *
524
+ * - child the child that was changed (for type="slot" and reason="childchange" only)
525
+ *
526
+ * @public
527
+ */
528
+ onInvalidation(changeInfo) { } // eslint-disable-line
529
+ /**
530
+ * Do not call this method directly, only intended to be called by js
531
+ * @protected
532
+ */
533
+ _render() {
534
+ const ctor = this.constructor;
535
+ const hasIndividualSlots = ctor.getMetadata().hasIndividualSlots();
536
+ // suppress invalidation to prevent state changes scheduling another rendering
537
+ this._suppressInvalidation = true;
538
+ this.onBeforeRendering();
539
+ // Intended for framework usage only. Currently ItemNavigation updates tab indexes after the component has updated its state but before the template is rendered
540
+ if (this._onComponentStateFinalized) {
541
+ this._onComponentStateFinalized();
542
+ }
543
+ // resume normal invalidation handling
544
+ this._suppressInvalidation = false;
545
+ // Update the shadow root with the render result
546
+ /*
547
+ if (this._changedState.length) {
548
+ let element = this.localName;
549
+ if (this.id) {
550
+ element = `${element}#${this.id}`;
551
+ }
552
+ console.log("Re-rendering:", element, this._changedState.map(x => { // eslint-disable-line
553
+ let res = `${x.type}`;
554
+ if (x.reason) {
555
+ res = `${res}(${x.reason})`;
556
+ }
557
+ res = `${res}: ${x.name}`;
558
+ if (x.type === "property") {
559
+ res = `${res} ${JSON.stringify(x.oldValue)} => ${JSON.stringify(x.newValue)}`;
560
+ }
561
+
562
+ return res;
563
+ }));
564
+ }
565
+ */
566
+ this._changedState = [];
567
+ // Update shadow root and static area item
568
+ if (ctor._needsShadowDOM()) {
569
+ updateShadowRoot(this);
570
+ }
571
+ if (this.staticAreaItem) {
572
+ this.staticAreaItem.update();
573
+ }
574
+ // Safari requires that children get the slot attribute only after the slot tags have been rendered in the shadow DOM
575
+ if (hasIndividualSlots) {
576
+ this._assignIndividualSlotsToChildren();
577
+ }
578
+ // Call the onAfterRendering hook
579
+ this.onAfterRendering();
580
+ }
581
+ /**
582
+ * @private
583
+ */
584
+ _assignIndividualSlotsToChildren() {
585
+ const domChildren = Array.from(this.children);
586
+ domChildren.forEach((child) => {
587
+ if (child._individualSlot) {
588
+ child.setAttribute("slot", child._individualSlot);
589
+ }
590
+ });
591
+ }
592
+ /**
593
+ * @private
594
+ */
595
+ _waitForDomRef() {
596
+ return this._domRefReadyPromise;
597
+ }
598
+ /**
599
+ * Returns the DOM Element inside the Shadow Root that corresponds to the opening tag in the UI5 Web Component's template
600
+ * *Note:* For logical (abstract) elements (items, options, etc...), returns the part of the parent's DOM that represents this option
601
+ * Use this method instead of "this.shadowRoot" to read the Shadow DOM, if ever necessary
602
+ *
603
+ * @public
604
+ */
605
+ getDomRef() {
606
+ // If a component set _getRealDomRef to its children, use the return value of this function
607
+ if (typeof this._getRealDomRef === "function") {
608
+ return this._getRealDomRef();
609
+ }
610
+ if (!this.shadowRoot || this.shadowRoot.children.length === 0) {
611
+ return;
612
+ }
613
+ const children = [...this.shadowRoot.children].filter(child => !["link", "style"].includes(child.localName));
614
+ if (children.length !== 1) {
615
+ console.warn(`The shadow DOM for ${this.constructor.getMetadata().getTag()} does not have a top level element, the getDomRef() method might not work as expected`); // eslint-disable-line
616
+ }
617
+ return children[0];
618
+ }
619
+ /**
620
+ * Returns the DOM Element marked with "data-sap-focus-ref" inside the template.
621
+ * This is the element that will receive the focus by default.
622
+ * @public
623
+ */
624
+ getFocusDomRef() {
625
+ const domRef = this.getDomRef();
626
+ if (domRef) {
627
+ const focusRef = domRef.querySelector("[data-sap-focus-ref]");
628
+ return focusRef || domRef;
629
+ }
630
+ }
631
+ /**
632
+ * Waits for dom ref and then returns the DOM Element marked with "data-sap-focus-ref" inside the template.
633
+ * This is the element that will receive the focus by default.
634
+ * @public
635
+ */
636
+ async getFocusDomRefAsync() {
637
+ await this._waitForDomRef();
638
+ return this.getFocusDomRef();
639
+ }
640
+ /**
641
+ * Set the focus to the element, returned by "getFocusDomRef()" (marked by "data-sap-focus-ref")
642
+ * @param {FocusOptions} focusOptions additional options for the focus
643
+ * @public
644
+ */
645
+ async focus(focusOptions) {
646
+ await this._waitForDomRef();
647
+ const focusDomRef = this.getFocusDomRef();
648
+ if (focusDomRef && typeof focusDomRef.focus === "function") {
649
+ focusDomRef.focus(focusOptions);
650
+ }
651
+ }
652
+ /**
653
+ *
654
+ * @public
655
+ * @param name - name of the event
656
+ * @param data - additional data for the event
657
+ * @param cancelable - true, if the user can call preventDefault on the event object
658
+ * @param bubbles - true, if the event bubbles
659
+ * @returns {boolean} false, if the event was cancelled (preventDefault called), true otherwise
660
+ */
661
+ fireEvent(name, data, cancelable = false, bubbles = true) {
662
+ const eventResult = this._fireEvent(name, data, cancelable, bubbles);
663
+ const camelCaseEventName = kebabToCamelCase(name);
664
+ if (camelCaseEventName !== name) {
665
+ return eventResult && this._fireEvent(camelCaseEventName, data, cancelable);
666
+ }
667
+ return eventResult;
668
+ }
669
+ _fireEvent(name, data, cancelable = false, bubbles = true) {
670
+ const noConflictEvent = new CustomEvent(`ui5-${name}`, {
671
+ detail: data,
672
+ composed: false,
673
+ bubbles,
674
+ cancelable,
675
+ });
676
+ // This will be false if the no-conflict event is prevented
677
+ const noConflictEventResult = this.dispatchEvent(noConflictEvent);
678
+ if (skipOriginalEvent(name)) {
679
+ return noConflictEventResult;
680
+ }
681
+ const normalEvent = new CustomEvent(name, {
682
+ detail: data,
683
+ composed: false,
684
+ bubbles,
685
+ cancelable,
686
+ });
687
+ // This will be false if the normal event is prevented
688
+ const normalEventResult = this.dispatchEvent(normalEvent);
689
+ // Return false if any of the two events was prevented (its result was false).
690
+ return normalEventResult && noConflictEventResult;
691
+ }
692
+ /**
693
+ * Returns the actual children, associated with a slot.
694
+ * Useful when there are transitive slots in nested component scenarios and you don't want to get a list of the slots, but rather of their content.
695
+ * @public
696
+ */
697
+ getSlottedNodes(slotName) {
698
+ return getSlottedNodesList(this[slotName]);
699
+ }
700
+ /**
701
+ * Determines whether the component should be rendered in RTL mode or not.
702
+ * Returns: "rtl", "ltr" or undefined
703
+ *
704
+ * @public
705
+ * @returns {String|undefined}
706
+ */
707
+ get effectiveDir() {
708
+ markAsRtlAware(this.constructor); // if a UI5 Element calls this method, it's considered to be rtl-aware
709
+ return getEffectiveDir(this);
710
+ }
711
+ /**
712
+ * Used to duck-type UI5 elements without using instanceof
713
+ * @returns {boolean}
714
+ * @public
715
+ */
716
+ get isUI5Element() {
717
+ return true;
718
+ }
719
+ get classes() {
720
+ return {};
721
+ }
722
+ /**
723
+ * Do not override this method in derivatives of UI5Element, use metadata properties instead
724
+ * @private
725
+ */
726
+ static get observedAttributes() {
727
+ return this.getMetadata().getAttributesList();
728
+ }
729
+ /**
730
+ * @private
731
+ */
732
+ static _needsShadowDOM() {
733
+ return !!this.template || Object.prototype.hasOwnProperty.call(this.prototype, "render");
734
+ }
735
+ /**
736
+ * @private
737
+ */
738
+ static _needsStaticArea() {
739
+ return !!this.staticAreaTemplate || Object.prototype.hasOwnProperty.call(this.prototype, "renderStatic");
740
+ }
741
+ /**
742
+ * @public
743
+ */
744
+ getStaticAreaItemDomRef() {
745
+ if (!this.constructor._needsStaticArea()) {
746
+ throw new Error("This component does not use the static area");
747
+ }
748
+ if (!this.staticAreaItem) {
749
+ this.staticAreaItem = StaticAreaItem.createInstance();
750
+ this.staticAreaItem.setOwnerElement(this);
751
+ }
752
+ if (!this.staticAreaItem.parentElement) {
753
+ getSingletonElementInstance("ui5-static-area").appendChild(this.staticAreaItem);
754
+ }
755
+ return this.staticAreaItem.getDomRef();
756
+ }
757
+ /**
758
+ * @private
759
+ */
760
+ static _generateAccessors() {
761
+ const proto = this.prototype;
762
+ const slotsAreManaged = this.getMetadata().slotsAreManaged();
763
+ // Properties
764
+ const properties = this.getMetadata().getProperties();
765
+ for (const [prop, propData] of Object.entries(properties)) { // eslint-disable-line
766
+ if (!isValidPropertyName(prop)) {
767
+ console.warn(`"${prop}" is not a valid property name. Use a name that does not collide with DOM APIs`); /* eslint-disable-line */
768
+ }
769
+ if (propData.type === Boolean && propData.defaultValue) {
770
+ throw new Error(`Cannot set a default value for property "${prop}". All booleans are false by default.`);
771
+ }
772
+ if (propData.type === Array) {
773
+ throw new Error(`Wrong type for property "${prop}". Properties cannot be of type Array - use "multiple: true" and set "type" to the single value type, such as "String", "Object", etc...`);
774
+ }
775
+ if (propData.type === Object && propData.defaultValue) {
776
+ throw new Error(`Cannot set a default value for property "${prop}". All properties of type "Object" are empty objects by default.`);
777
+ }
778
+ if (propData.multiple && propData.defaultValue) {
779
+ throw new Error(`Cannot set a default value for property "${prop}". All multiple properties are empty arrays by default.`);
780
+ }
781
+ Object.defineProperty(proto, prop, {
782
+ get() {
783
+ if (this._state[prop] !== undefined) {
784
+ return this._state[prop];
785
+ }
786
+ const propDefaultValue = propData.defaultValue;
787
+ if (propData.type === Boolean) {
788
+ return false;
789
+ }
790
+ else if (propData.type === String) { // eslint-disable-line
791
+ return propDefaultValue;
792
+ }
793
+ else if (propData.multiple) { // eslint-disable-line
794
+ return [];
795
+ }
796
+ else {
797
+ return propDefaultValue;
798
+ }
799
+ },
800
+ set(value) {
801
+ let isDifferent;
802
+ const ctor = this.constructor;
803
+ const metadataCtor = ctor.getMetadata().constructor;
804
+ value = metadataCtor.validatePropertyValue(value, propData);
805
+ const propertyType = propData.type;
806
+ let propertyValidator = propData.validator;
807
+ const oldState = this._state[prop];
808
+ if (propertyType && propertyType.isDataTypeClass) {
809
+ propertyValidator = propertyType;
810
+ }
811
+ if (propertyValidator) {
812
+ isDifferent = !propertyValidator.valuesAreEqual(oldState, value);
813
+ }
814
+ else if (Array.isArray(oldState) && Array.isArray(value) && propData.multiple && propData.compareValues) { // compareValues is added for IE, test if needed now
815
+ isDifferent = !arraysAreEqual(oldState, value);
816
+ }
817
+ else {
818
+ isDifferent = oldState !== value;
819
+ }
820
+ if (isDifferent) {
821
+ this._state[prop] = value;
822
+ _invalidate.call(this, {
823
+ type: "property",
824
+ name: prop,
825
+ newValue: value,
826
+ oldValue: oldState,
827
+ });
828
+ this._updateAttribute(prop, value);
829
+ }
830
+ },
831
+ });
832
+ }
833
+ // Slots
834
+ if (slotsAreManaged) {
835
+ const slots = this.getMetadata().getSlots();
836
+ for (const [slotName, slotData] of Object.entries(slots)) { // eslint-disable-line
837
+ if (!isValidPropertyName(slotName)) {
838
+ console.warn(`"${slotName}" is not a valid property name. Use a name that does not collide with DOM APIs`); /* eslint-disable-line */
839
+ }
840
+ const propertyName = slotData.propertyName || slotName;
841
+ Object.defineProperty(proto, propertyName, {
842
+ get() {
843
+ if (this._state[propertyName] !== undefined) {
844
+ return this._state[propertyName];
845
+ }
846
+ return [];
847
+ },
848
+ set() {
849
+ throw new Error("Cannot set slot content directly, use the DOM APIs (appendChild, removeChild, etc...)");
850
+ },
851
+ });
852
+ }
853
+ }
854
+ }
855
+ /**
856
+ * Returns the CSS for this UI5 Web Component Class
857
+ * @protected
858
+ */
859
+ static get styles() {
860
+ return "";
861
+ }
862
+ /**
863
+ * Returns the Static Area CSS for this UI5 Web Component Class
864
+ * @protected
865
+ */
866
+ static get staticAreaStyles() {
867
+ return "";
868
+ }
869
+ /**
870
+ * Returns an array with the dependencies for this UI5 Web Component, which could be:
871
+ * - composed components (used in its shadow root or static area item)
872
+ * - slotted components that the component may need to communicate with
873
+ *
874
+ * @protected
875
+ */
876
+ static get dependencies() {
877
+ return [];
878
+ }
879
+ /**
880
+ * Returns a list of the unique dependencies for this UI5 Web Component
881
+ *
882
+ * @public
883
+ */
884
+ static getUniqueDependencies() {
885
+ if (!uniqueDependenciesCache.has(this)) {
886
+ const filtered = this.dependencies.filter((dep, index, deps) => deps.indexOf(dep) === index);
887
+ uniqueDependenciesCache.set(this, filtered);
888
+ }
889
+ return uniqueDependenciesCache.get(this) || [];
890
+ }
891
+ /**
892
+ * Returns a promise that resolves whenever all dependencies for this UI5 Web Component have resolved
893
+ *
894
+ * @returns {Promise}
895
+ */
896
+ static whenDependenciesDefined() {
897
+ return Promise.all(this.getUniqueDependencies().map(dep => dep.define()));
898
+ }
899
+ /**
900
+ * Hook that will be called upon custom element definition
901
+ *
902
+ * @protected
903
+ * @returns {Promise<void>}
904
+ */
905
+ static async onDefine() {
906
+ return Promise.resolve();
907
+ }
908
+ /**
909
+ * Registers a UI5 Web Component in the browser window object
910
+ * @public
911
+ * @returns {Promise<UI5Element>}
912
+ */
913
+ static async define() {
914
+ await boot();
915
+ await Promise.all([
916
+ this.whenDependenciesDefined(),
917
+ this.onDefine(),
918
+ ]);
919
+ const tag = this.getMetadata().getTag();
920
+ const definedLocally = isTagRegistered(tag);
921
+ const definedGlobally = customElements.get(tag);
922
+ if (definedGlobally && !definedLocally) {
923
+ recordTagRegistrationFailure(tag);
924
+ }
925
+ else if (!definedGlobally) {
926
+ this._generateAccessors();
927
+ registerTag(tag);
928
+ window.customElements.define(tag, this);
929
+ preloadLinks(this);
930
+ }
931
+ return this;
932
+ }
933
+ /**
934
+ * Returns an instance of UI5ElementMetadata.js representing this UI5 Web Component's full metadata (its and its parents')
935
+ * Note: not to be confused with the "get metadata()" method, which returns an object for this class's metadata only
936
+ * @public
937
+ * @returns {UI5ElementMetadata}
938
+ */
939
+ static getMetadata() {
940
+ if (this.hasOwnProperty("_metadata")) { // eslint-disable-line
941
+ return this._metadata;
942
+ }
943
+ const metadataObjects = [this.metadata];
944
+ let klass = this; // eslint-disable-line
945
+ while (klass !== UI5Element) {
946
+ klass = Object.getPrototypeOf(klass);
947
+ metadataObjects.unshift(klass.metadata);
948
+ }
949
+ const mergedMetadata = merge({}, ...metadataObjects);
950
+ this._metadata = new UI5ElementMetadata(mergedMetadata);
951
+ return this._metadata;
952
+ }
1021
953
  }
1022
-
954
+ /**
955
+ * Returns the metadata object for this UI5 Web Component Class
956
+ * @protected
957
+ */
958
+ UI5Element.metadata = {};
959
+ /**
960
+ * Always use duck-typing to cover all runtimes on the page.
961
+ * @returns {boolean}
962
+ */
963
+ const instanceOfUI5Element = (object) => {
964
+ return "isUI5Element" in object;
965
+ };
1023
966
  export default UI5Element;
967
+ export { instanceOfUI5Element };
968
+ //# sourceMappingURL=UI5Element.js.map