@ui5/webcomponents-base 0.0.0-cc312800a → 0.0.0-ce98ce2bb

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