@ui5/webcomponents-base 0.0.0-e463d2345 → 0.0.0-e55c2cec6

package/src/delegate/ScrollEnablement.ts

@@ -0,0 +1,221 @@
+import { supportsTouch } from "../Device.js";
+import EventProvider from "../EventProvider.js";
+import scroll from "../animations/scroll.js";
+import type UI5Element from "../UI5Element.js";
+
+const scrollEventName = "scroll";
+const touchEndEventName = supportsTouch() ? "touchend" : "mouseup";
+
+type EventListenerParam = {
+	isLeft: boolean;
+	isRight: boolean
+}
+type EventListenerReturn = void;
+
+class ScrollEnablement extends EventProvider<EventListenerParam, EventListenerReturn> {
+	containerComponent: UI5Element;
+	mouseMove: (event: MouseEvent | TouchEvent) => void;
+	mouseUp: (event: MouseEvent | TouchEvent) => void;
+	touchStart: (event: MouseEvent | TouchEvent) => void;
+	cachedValue: { dragX: number, dragY: number };
+	startX: number;
+	startY: number;
+	_container?: HTMLElement;
+	supportsTouch = supportsTouch();
+	_canScroll?: boolean;
+	_prevDragX?: number;
+	_prevDragY?: number;
+
+	constructor(containerComponent: UI5Element) {
+		super();
+		this.containerComponent = containerComponent;
+		this.mouseMove = this.ontouchmove.bind(this);
+		this.mouseUp = this.ontouchend.bind(this);
+		this.touchStart = this.ontouchstart.bind(this);
+
+		this.supportsTouch = supportsTouch();
+
+		// On Android devices touchmove is thrown one more time than neccessary (together with touchend)
+		// so we have to cache the previus coordinates in order to provide correct parameters in the
+		// event for Android
+		this.cachedValue = { dragX: 0, dragY: 0 };
+
+		// In components like Carousel you need to know if the user has clicked on something or swiped
+		// in order to throw the needed event or not
+		this.startX = 0;
+		this.startY = 0;
+
+		if (this.supportsTouch) {
+			containerComponent.addEventListener("touchstart", this.touchStart, { passive: true });
+			containerComponent.addEventListener("touchmove", this.mouseMove, { passive: true });
+			containerComponent.addEventListener("touchend", this.mouseUp, { passive: true });
+		} else {
+			containerComponent.addEventListener("mousedown", this.touchStart, { passive: true });
+		}
+	}
+
+	set scrollContainer(container: HTMLElement) {
+		this._container = container;
+	}
+
+	get scrollContainer() {
+		return this._container!;
+	}
+
+	/**
+	 * Scrolls the container to the left/top position, retrying retryCount times, if the container is not yet painted
+	 *
+	 * @param left
+	 * @param top
+	 * @param retryCount
+	 * @param retryInterval
+	 * @returns {Promise<void>} resolved when scrolled successfully
+	 */
+	async scrollTo(left: number, top: number, retryCount = 0, retryInterval = 0) {
+		let containerPainted = this.scrollContainer.clientHeight > 0 && this.scrollContainer.clientWidth > 0;
+
+		/* eslint-disable no-loop-func, no-await-in-loop */
+		while (!containerPainted && retryCount > 0) {
+			await new Promise<void>(resolve => {
+				setTimeout(() => {
+					containerPainted = this.scrollContainer.clientHeight > 0 && this.scrollContainer.clientWidth > 0;
+					retryCount--;
+					resolve();
+				}, retryInterval);
+			});
+		}
+		/* eslint-disable no-loop-func, no-await-in-loop */
+
+		this._container!.scrollLeft = left;
+		this._container!.scrollTop = top;
+	}
+
+	move(dx: number, dy: number, disableAnimation: boolean) {
+		if (disableAnimation) {
+			this._container!.scrollLeft += dx;
+			this._container!.scrollTop += dy;
+			return;
+		}
+
+		if (this._container) {
+			return scroll(this._container, dx, dy);
+		}
+	}
+
+	getScrollLeft() {
+		return this._container!.scrollLeft;
+	}
+
+	getScrollTop() {
+		return this._container!.scrollTop;
+	}
+
+	_isTouchInside(event: TouchEvent | MouseEvent) {
+		let touch = null;
+		if (this.supportsTouch && event instanceof TouchEvent) {
+			touch = event.touches[0];
+		}
+
+		const rect = this._container!.getBoundingClientRect();
+		const x = this.supportsTouch ? (touch as TouchInit).clientX : (event as MouseEvent).x;
+		const y = this.supportsTouch ? (touch as TouchInit).clientY : (event as MouseEvent).y;
+
+		return x! >= rect.left && x! <= rect.right
+			&& y! >= rect.top && y! <= rect.bottom;
+	}
+
+	ontouchstart(event: TouchEvent | MouseEvent) {
+		let touch = null;
+		if (this.supportsTouch && event instanceof TouchEvent) {
+			touch = event.touches[0];
+		}
+
+		if (!this.supportsTouch) {
+			document.addEventListener("mouseup", this.mouseUp, { passive: true });
+			document.addEventListener("mousemove", this.mouseMove, { passive: true });
+		} else {
+			// Needed only on mobile
+			this.startX = touch!.pageX;
+			this.startY = touch!.pageY;
+		}
+
+		if (this.supportsTouch && event instanceof TouchEvent) {
+			this._prevDragX = touch!.pageX;
+			this._prevDragY = touch!.pageY;
+		}
+
+		if (event instanceof MouseEvent) {
+			this._prevDragX = event.x;
+			this._prevDragY = event.y;
+		}
+
+		this._canScroll = this._isTouchInside(event);
+	}
+
+	ontouchmove(event: TouchEvent | MouseEvent) {
+		if (!this._canScroll) {
+			return;
+		}
+
+		const container = this._container;
+		const touch = this.supportsTouch ? (event as TouchEvent).touches[0] : null;
+
+		const dragX = this.supportsTouch ? (touch as TouchInit).pageX : (event as MouseEvent).x;
+		const dragY = this.supportsTouch ? (touch as TouchInit).pageY : (event as MouseEvent).y;
+
+		container!.scrollLeft += this._prevDragX! - dragX!;
+		container!.scrollTop += this._prevDragY! - dragY!;
+
+		this.fireEvent(scrollEventName, {
+			isLeft: dragX! > this._prevDragX!,
+			isRight: dragX! < this._prevDragX!,
+		});
+
+		this.cachedValue.dragX = this._prevDragX!;
+		this.cachedValue.dragY = this._prevDragY!;
+
+		this._prevDragX = dragX;
+		this._prevDragY = dragY;
+	}
+
+	ontouchend(event: TouchEvent | MouseEvent) {
+		if (this.supportsTouch) {
+			const deltaX = Math.abs((event as TouchEvent).changedTouches[0].pageX - this.startX);
+			const deltaY = Math.abs((event as TouchEvent).changedTouches[0].pageY - this.startY);
+
+			if (deltaX < 10 && deltaY < 10) {
+				return;
+			}
+		}
+
+		if (!this._canScroll) {
+			return;
+		}
+
+		const container = this._container;
+		const dragX = this.supportsTouch ? (event as TouchEvent).changedTouches[0].pageX : (event as MouseEvent).x;
+		const dragY = this.supportsTouch ? (event as TouchEvent).changedTouches[0].pageY : (event as MouseEvent).y;
+
+		container!.scrollLeft += this._prevDragX! - dragX;
+		container!.scrollTop += this._prevDragY! - dragY;
+
+		const useCachedValues = dragX === this._prevDragX;
+		const _dragX = useCachedValues ? this.cachedValue.dragX : dragX;
+		// const _dragY = useCachedValues ? this.cachedValue.dragY : dragY; add if needed
+
+		this.fireEvent(touchEndEventName, {
+			isLeft: _dragX < this._prevDragX!,
+			isRight: _dragX > this._prevDragX!,
+		});
+
+		this._prevDragX = dragX;
+		this._prevDragY = dragY;
+
+		if (!this.supportsTouch) {
+			document.removeEventListener("mousemove", this.mouseMove);
+			document.removeEventListener("mouseup", this.mouseUp);
+		}
+	}
+}
+
+export default ScrollEnablement;

package/src/features/F6Navigation.ts

@@ -0,0 +1,141 @@
+import { registerFeature } from "../FeaturesRegistry.js";
+import { isF6Next, isF6Previous } from "../Keys.js";
+import { instanceOfUI5Element } from "../UI5Element.js";
+import { getFirstFocusableElement } from "../util/FocusableElements.js";
+import getFastNavigationGroups from "../util/getFastNavigationGroups.js";
+
+class F6Navigation {
+	static _instance: F6Navigation;
+	keydownHandler: (event: KeyboardEvent) => void;
+	selectedGroup: HTMLElement | null = null;
+	groups: Array<HTMLElement> = [];
+
+	constructor() {
+		this.keydownHandler = this._keydownHandler.bind(this) as (event: KeyboardEvent) => void;
+		this.attachEventListeners();
+	}
+
+	attachEventListeners() {
+		document.addEventListener("keydown", this.keydownHandler);
+	}
+
+	async _keydownHandler(event: KeyboardEvent) {
+		if (isF6Next(event)) {
+			this.updateGroups();
+
+			if (this.groups.length < 1) {
+				return;
+			}
+
+			event.preventDefault();
+
+			let nextIndex = -1;
+			let nextElement;
+			if (this.selectedGroup) {
+				nextIndex = this.groups.indexOf(this.selectedGroup);
+			}
+
+			if (nextIndex > -1) {
+				if (nextIndex + 1 >= this.groups.length) {
+					nextElement = this.groups[0];
+				} else {
+					nextElement = this.groups[nextIndex + 1];
+				}
+			} else {
+				nextElement = this.groups[0];
+			}
+
+			const nextElementDomRef = instanceOfUI5Element(nextElement) ? nextElement.getDomRef() : nextElement;
+
+			if (nextElementDomRef) {
+				const elementToFocus = await getFirstFocusableElement(nextElementDomRef, true);
+				elementToFocus?.focus();
+			}
+		}
+
+		if (isF6Previous(event)) {
+			this.updateGroups();
+
+			if (this.groups.length < 1) {
+				return;
+			}
+
+			event.preventDefault();
+
+			let nextIndex = -1;
+			let nextElement;
+			if (this.selectedGroup) {
+				nextIndex = this.groups.indexOf(this.selectedGroup);
+			}
+
+			if (nextIndex > 0) {
+				// Handle the situation where the first focusable element of two neighbor groups is the same
+				// For example:
+				// <ui5-flexible-column-layout>
+				//     <ui5-list>
+				//         <ui5-li>List Item</ui5-li>
+				//     </ui5-list>
+				// </ui5-flexible-column-layout>
+				// Here for both FCL & List the firstFoccusableElement is the same (the ui5-li)
+
+				const firstFocusable = await getFirstFocusableElement(this.groups[nextIndex - 1], true);
+				const shouldSkipParent = firstFocusable === await getFirstFocusableElement(this.groups[nextIndex], true);
+
+				nextElement = this.groups[shouldSkipParent ? nextIndex - 2 : nextIndex - 1];
+			} else {
+				nextElement = this.groups[this.groups.length - 1];
+			}
+
+			const nextElementDomRef = instanceOfUI5Element(nextElement) ? nextElement.getDomRef() : nextElement;
+
+			if (nextElementDomRef) {
+				const elementToFocus = await getFirstFocusableElement(nextElementDomRef, true);
+				elementToFocus?.focus();
+			}
+		}
+	}
+
+	removeEventListeners() {
+		document.removeEventListener("keydown", this.keydownHandler);
+	}
+
+	updateGroups() {
+		this.setSelectedGroup();
+		this.groups = getFastNavigationGroups(document.body);
+	}
+
+	setSelectedGroup(root: DocumentOrShadowRoot = window.document) {
+		const htmlElement = window.document.querySelector("html");
+		let element: Element | null | ParentNode = this.deepActive(root);
+
+		while (element && (element as Element).getAttribute("data-sap-ui-fastnavgroup") !== "true" && element !== htmlElement) {
+		   element = element.parentElement ? element.parentNode : (element.parentNode as ShadowRoot).host;
+		}
+
+		this.selectedGroup = element as HTMLElement;
+	 }
+
+	 deepActive(root: DocumentOrShadowRoot): Element | null {
+		if (root.activeElement && root.activeElement.shadowRoot) {
+		   return this.deepActive(root.activeElement.shadowRoot);
+		}
+
+		return root.activeElement;
+	 }
+
+	destroy() {
+		this.removeEventListeners();
+	}
+
+	static init() {
+		if (!this._instance) {
+			this._instance = new F6Navigation();
+		}
+
+		return this._instance;
+	}
+}
+
+registerFeature("F6Navigation", F6Navigation);
+
+export default F6Navigation;

package/src/features/OpenUI5Element.ts

@@ -0,0 +1,11 @@
+import UI5Element from "../UI5Element.js";
+
+class OpenUI5Element extends UI5Element {
+	__isBusy?: boolean;
+	isOpenUI5Component?: boolean;
+	__suppressFocusIn?: () => void;
+	__suppressFocusBack?: (e: KeyboardEvent) => void;
+	__redirectFocus?: boolean;
+}
+
+export default OpenUI5Element;

package/src/features/OpenUI5Enablement.ts

@@ -0,0 +1,117 @@
+import { TemplateResult } from "lit-html";
+import { registerFeature } from "../FeaturesRegistry.js";
+import BusyIndicatorStyles from "../generated/css/BusyIndicator.css.js";
+import merge from "../thirdparty/merge.js";
+import {
+	isTabPrevious,
+} from "../Keys.js";
+
+import type UI5Element from "../UI5Element.js";
+import type OpenUI5Element from "./OpenUI5Element.js";
+
+const busyIndicatorMetadata = {
+	properties: {
+		__isBusy: {
+			type: Boolean,
+		},
+	},
+};
+
+class OpenUI5Enablement {
+	static wrapTemplateResultInBusyMarkup(html: (strings: TemplateStringsArray, ...values: Array<unknown>) => TemplateResult, host: OpenUI5Element, templateResult: TemplateResult) {
+		if (host.isOpenUI5Component && host.__isBusy) {
+			templateResult = html`
+			<div class="busy-indicator-wrapper">
+				<span tabindex="0" busy-indicator-before-span @focusin=${host.__suppressFocusIn}></span>
+				${templateResult}
+				<div class="busy-indicator-overlay"></div>
+				<div busy-indicator
+					class="busy-indicator-busy-area"
+					tabindex="0"
+					role="progressbar"
+					@keydown=${host.__suppressFocusBack}
+					aria-valuemin="0"
+					aria-valuemax="100"
+					aria-valuetext="Busy">
+					<div>
+						<div class="busy-indicator-circle circle-animation-0"></div>
+						<div class="busy-indicator-circle circle-animation-1"></div>
+						<div class="busy-indicator-circle circle-animation-2"></div>
+					</div>
+				</div>
+			</div>`;
+		}
+
+		return templateResult;
+	}
+
+	static enrichBusyIndicatorSettings(klass: typeof UI5Element) {
+		OpenUI5Enablement.enrichBusyIndicatorMetadata(klass);
+		OpenUI5Enablement.enrichBusyIndicatorMethods(klass.prototype);
+	}
+
+	static enrichBusyIndicatorMetadata(klass: typeof UI5Element) {
+		klass.metadata = merge(klass.metadata, busyIndicatorMetadata);
+	}
+
+	static enrichBusyIndicatorMethods(UI5ElementPrototype: typeof OpenUI5Element.prototype) {
+		Object.defineProperties(UI5ElementPrototype, {
+			"__redirectFocus": { value: true, writable: true },
+			"__suppressFocusBack": {
+				get() {
+					return {
+						handleEvent: (e: KeyboardEvent) => {
+							if (isTabPrevious(e)) {
+								const beforeElem = this.shadowRoot.querySelector("[busy-indicator-before-span]");
+								this.__redirectFocus = false;
+								beforeElem.focus();
+								this.__redirectFocus = true;
+							}
+						},
+						capture: true,
+						passive: false,
+					};
+				},
+			},
+			"isOpenUI5Component": { get: () => { return true; } },
+		});
+
+		UI5ElementPrototype.__suppressFocusIn = function handleFocusIn() {
+			const busyIndicator = this.shadowRoot?.querySelector("[busy-indicator]") as HTMLElement;
+			if (busyIndicator && this.__redirectFocus) {
+				busyIndicator.focus();
+			}
+		};
+
+		UI5ElementPrototype.getDomRef = function getDomRef() {
+			// If a component set _getRealDomRef to its children, use the return value of this function
+			if (typeof this._getRealDomRef === "function") {
+				return this._getRealDomRef();
+			}
+
+			if (!this.shadowRoot || this.shadowRoot.children.length === 0) {
+				return;
+			}
+
+			const children = [...this.shadowRoot.children].filter(child => !["link", "style"].includes(child.localName));
+
+			if (children.length !== 1) {
+				console.warn(`The shadow DOM for ${(this.constructor as typeof UI5Element).getMetadata().getTag()} does not have a top level element, the getDomRef() method might not work as expected`); // eslint-disable-line
+			}
+
+			if (this.__isBusy) {
+				return children[0].querySelector(".busy-indicator-wrapper > :not([busy-indicator-before-span]):not(.busy-indicator-overlay):not(.busy-indicator-busy-area)") as HTMLElement;
+			}
+
+			return children[0] as HTMLElement;
+		};
+	}
+
+	static getBusyIndicatorStyles() {
+		return BusyIndicatorStyles;
+	}
+}
+
+registerFeature("OpenUI5Enablement", OpenUI5Enablement);
+
+export default OpenUI5Enablement;

package/src/features/OpenUI5Support.ts

@@ -0,0 +1,148 @@
+import { registerFeature } from "../FeaturesRegistry.js";
+import { setTheme } from "../config/Theme.js";
+import { getCurrentZIndex } from "../util/PopupUtils.js";
+import { CLDRData } from "../asset-registries/LocaleData.js";
+
+type OpenUI5Popup = {
+	setInitialZIndex: (zIndex: number) => void,
+	getNextZIndex: () => number,
+};
+
+type OpenUI5Core = {
+	attachInit: (callback: () => void) => void,
+	attachThemeChanged: (callback: () => Promise<void>) => void,
+	getConfiguration: () => OpenUI5CoreConfiguration,
+};
+
+type OpenUI5CoreConfiguration = {
+	getAnimationMode: () => string,
+	getLanguage: () => string,
+	getTheme: () => string,
+	getThemeRoot: () => string,
+	getRTL: () => string,
+	getCalendarType: () => string,
+	getLocale: () => string,
+};
+
+type LocaleData = {
+	getInstance: (locale: string) => Locale,
+}
+
+type Locale = {
+	getFirstDayOfWeek: () => number,
+	_get: () => CLDRData,
+};
+
+const getCore = () => {
+	return window.sap?.ui?.getCore?.() as OpenUI5Core;
+};
+
+class OpenUI5Support {
+	static isLoaded() {
+		return !!getCore();
+	}
+
+	static init() {
+		const core = getCore();
+		if (!core) {
+			return Promise.resolve();
+		}
+
+		return new Promise<void>(resolve => {
+			core.attachInit(() => {
+				window.sap.ui.require(["sap/ui/core/LocaleData", "sap/ui/core/Popup"], (LocaleData: LocaleData, Popup: OpenUI5Popup) => {
+					Popup.setInitialZIndex(getCurrentZIndex());
+					resolve();
+				});
+			});
+		});
+	}
+
+	static getConfigurationSettingsObject() {
+		const core = getCore();
+		if (!core) {
+			return;
+		}
+
+		const config = core.getConfiguration();
+		const LocaleData = window.sap.ui.require("sap/ui/core/LocaleData");
+
+		return {
+			animationMode: config.getAnimationMode(),
+			language: config.getLanguage(),
+			theme: config.getTheme(),
+			themeRoot: config.getThemeRoot(),
+			rtl: config.getRTL(),
+			calendarType: config.getCalendarType(),
+			formatSettings: {
+				firstDayOfWeek: LocaleData ? LocaleData.getInstance(config.getLocale()).getFirstDayOfWeek() : undefined,
+			},
+		};
+	}
+
+	static getLocaleDataObject() {
+		const core = getCore();
+		if (!core) {
+			return;
+		}
+
+		const config = core.getConfiguration();
+		const LocaleData = window.sap.ui.require("sap/ui/core/LocaleData") as LocaleData;
+		return LocaleData.getInstance(config.getLocale())._get();
+	}
+
+	static _listenForThemeChange() {
+		const core = getCore();
+		const config = core.getConfiguration();
+		core.attachThemeChanged(async () => {
+			await setTheme(config.getTheme());
+		});
+	}
+
+	static attachListeners() {
+		const core = getCore();
+		if (!core) {
+			return;
+		}
+
+		OpenUI5Support._listenForThemeChange();
+	}
+
+	static cssVariablesLoaded() {
+		const core = getCore();
+		if (!core) {
+			return;
+		}
+
+		const link = [...document.head.children].find(el => el.id === "sap-ui-theme-sap.ui.core") as HTMLLinkElement; // more reliable than querySelector early
+		if (!link) {
+			return;
+		}
+
+		return !!link.href.match(/\/css(-|_)variables\.css/);
+	}
+
+	static getNextZIndex() {
+		const core = getCore();
+		if (!core) {
+			return;
+		}
+
+		const Popup = window.sap.ui.require("sap/ui/core/Popup") as OpenUI5Popup;
+		return Popup.getNextZIndex();
+	}
+
+	static setInitialZIndex() {
+		const core = getCore();
+		if (!core) {
+			return;
+		}
+
+		const Popup = window.sap.ui.require("sap/ui/core/Popup") as OpenUI5Popup;
+		Popup.setInitialZIndex(getCurrentZIndex());
+	}
+}
+
+registerFeature("OpenUI5Support", OpenUI5Support);
+
+export default OpenUI5Support;

package/src/getSharedResource.ts

@@ -0,0 +1,30 @@
+import getSingletonElementInstance from "./util/getSingletonElementInstance.js";
+
+const getSharedResourcesInstance = () => getSingletonElementInstance("ui5-shared-resources", document.head);
+
+/**
+ * Use this method to initialize/get resources that you would like to be shared among UI5 Web Components runtime instances.
+ * The data will be accessed via a singleton "ui5-shared-resources" HTML element in the "head" element of the page.
+ *
+ * @public
+ * @param namespace Unique ID of the resource, may contain "." to denote hierarchy
+ * @param initialValue Object or primitive that will be used as an initial value if the resource does not exist
+ * @returns {*}
+ */
+const getSharedResource = <T>(namespace: string, initialValue: T): T => {
+	const parts = namespace.split(".");
+	let current = getSharedResourcesInstance() as Record<string, any>;
+
+	for (let i = 0; i < parts.length; i++) {
+		const part = parts[i];
+		const lastPart = i === parts.length - 1;
+		if (!Object.prototype.hasOwnProperty.call(current, part)) {
+			current[part] = lastPart ? initialValue : {};
+		}
+		current = current[part];
+	}
+
+	return current as T;
+};
+
+export default getSharedResource;