@ui5/webcomponents 1.0.0-rc.8 → 1.0.2

package/dist/ColorPalette.js

@@ -0,0 +1,493 @@
+import UI5Element from "@ui5/webcomponents-base/dist/UI5Element.js";
+import litRender from "@ui5/webcomponents-base/dist/renderer/LitRenderer.js";
+import { getI18nBundle } from "@ui5/webcomponents-base/dist/i18nBundle.js";
+import ItemNavigation from "@ui5/webcomponents-base/dist/delegate/ItemNavigation.js";
+import CSSColor from "@ui5/webcomponents-base/dist/types/CSSColor.js";
+import ItemNavigationBehavior from "@ui5/webcomponents-base/dist/types/ItemNavigationBehavior.js";
+import { isPhone } from "@ui5/webcomponents-base/dist/Device.js";
+import {
+	isSpace,
+	isEnter,
+	isDown,
+	isUp,
+	isTabNext,
+} from "@ui5/webcomponents-base/dist/Keys.js";
+import { getFeature } from "@ui5/webcomponents-base/dist/FeaturesRegistry.js";
+import ColorPaletteTemplate from "./generated/templates/ColorPaletteTemplate.lit.js";
+import ColorPaletteDialogTemplate from "./generated/templates/ColorPaletteDialogTemplate.lit.js";
+import ColorPaletteItem from "./ColorPaletteItem.js";
+import {
+	COLORPALETTE_CONTAINER_LABEL,
+	COLOR_PALETTE_MORE_COLORS_TEXT,
+} from "./generated/i18n/i18n-defaults.js";
+
+// Styles
+import ColorPaletteCss from "./generated/themes/ColorPalette.css.js";
+import ColorPaletteStaticAreaCss from "./generated/themes/ColorPaletteStaticArea.css.js";
+
+/**
+ * @public
+ */
+const metadata = {
+	tag: "ui5-color-palette",
+	managedSlots: true,
+	properties: /** @lends sap.ui.webcomponents.main.ColorPalette.prototype */ {
+
+		/**
+		 * Defines whether the user can see the last used colors in the bottom of the component
+		 * @type {boolean}
+		 * @private
+		 * @since 1.0.0-rc.15
+		 */
+		showRecentColors: {
+			type: Boolean,
+		},
+
+		/**
+		 * Defines whether the user can choose a custom color from a color picker
+		 * <b>Note:</b> In order to use this property you need to import the following module: <code>"@ui5/webcomponents/dist/features/ColorPaletteMoreColors.js"</code>
+		 * @type {boolean}
+		 * @private
+		 * @since 1.0.0-rc.15
+		 */
+		showMoreColors: {
+			type: Boolean,
+		},
+
+		/**
+		 * Defines whether the user can choose the default color from a button.
+		 * @type {boolean}
+		 * @defaultvalue false
+		 * @private
+		 * @since 1.0.0-rc.16
+		 */
+		showDefaultColor: {
+			type: Boolean,
+		},
+
+		/**
+		 * Defines the default color of the color palette
+		 * <b>Note:</b> The default color should be a part of the ColorPalette colors</code>
+		 * @type {CSSColor}
+		 * @private
+		 * @since 1.0.0-rc.16
+		 */
+		defaultColor: {
+			type: CSSColor,
+		},
+
+		/**
+		 * Defines the selected color.
+		 * @type {CSSColor}
+		 * @private
+		 */
+		_selectedColor: {
+			type: CSSColor,
+		},
+
+		/**
+		 * Defines if the palette is in Popup or Embeded mode.
+		 * @type {CSSColor}
+		 * @private
+		 */
+		popupMode: {
+			type: Boolean,
+		},
+	},
+	slots: /** @lends sap.ui.webcomponents.main.ColorPalette.prototype */ {
+		/**
+		 * Defines the <code>ui5-color-palette-item</code> elements.
+		 * @type {sap.ui.webcomponents.main.IColorPaletteItem[]}
+		 * @slot colors
+		 * @public
+		 */
+		"default": {
+			propertyName: "colors",
+			type: HTMLElement,
+			invalidateOnChildChange: true,
+			individualSlots: true,
+		},
+	},
+	events: /** @lends sap.ui.webcomponents.main.ColorPalette.prototype */ {
+		/**
+		 * Fired when the user selects a color.
+		 *
+		 * @event sap.ui.webcomponents.main.ColorPalette#item-click
+		 * @public
+		 * @since 1.0.0-rc.15
+		 * @param {String} color the selected color
+		 */
+		"item-click": {
+			details: {
+				color: {
+					type: String,
+				},
+			},
+		 },
+	},
+};
+
+/**
+ * @class
+ *
+ * <h3 class="comment-api-title">Overview</h3>
+ * The <code>ui5-color-palette</code> provides the users with a range of predefined colors. The colors are fixed and do not change with the theme.
+ *
+ * <h3>Usage</h3>
+ *
+ * The <code>ui5-color-palette</code> is meant for users that need to select a color from a predefined set.
+ * To define the colors, use the <code>ui5-color-palette-item</code> component inside the default slot of the <code>ui5-color-palette</code>.
+ *
+ * <h3>ES6 Module Import</h3>
+ *
+ * <code>import "@ui5/webcomponents/dist/ColorPalette.js";</code>
+ *
+ * @constructor
+ * @author SAP SE
+ * @alias sap.ui.webcomponents.main.ColorPalette
+ * @extends UI5Element
+ * @tagname ui5-color-palette
+ * @since 1.0.0-rc.12
+ * @appenddocs ColorPaletteItem
+ * @public
+ */
+class ColorPalette extends UI5Element {
+	static get metadata() {
+		return metadata;
+	}
+
+	static get render() {
+		return litRender;
+	}
+
+	static get styles() {
+		return ColorPaletteCss;
+	}
+
+	static get staticAreaStyles() {
+		return ColorPaletteStaticAreaCss;
+	}
+
+	static get template() {
+		return ColorPaletteTemplate;
+	}
+
+	static get staticAreaTemplate() {
+		return ColorPaletteDialogTemplate;
+	}
+
+	static get dependencies() {
+		const ColorPaletteMoreColors = getFeature("ColorPaletteMoreColors");
+		return [ColorPaletteItem].concat(ColorPaletteMoreColors ? ColorPaletteMoreColors.dependencies : []);
+	}
+
+	static async onDefine() {
+		const ColorPaletteMoreColors = getFeature("ColorPaletteMoreColors");
+
+		[ColorPalette.i18nBundle] = await Promise.all([
+			getI18nBundle("@ui5/webcomponents"),
+			ColorPaletteMoreColors ? ColorPaletteMoreColors.init() : Promise.resolve(),
+		]);
+	}
+
+	constructor() {
+		super();
+		this._itemNavigation = new ItemNavigation(this, {
+			getItemsCallback: () => this.displayedColors,
+			rowSize: this.rowSize,
+			behavior: ItemNavigationBehavior.Cyclic,
+		});
+
+		this._itemNavigationRecentColors = new ItemNavigation(this, {
+			getItemsCallback: () => this.recentColorsElements,
+			rowSize: this.rowSize,
+			behavior: ItemNavigationBehavior.Static,
+		});
+
+		this._recentColors = [];
+	}
+
+	onBeforeRendering() {
+		this.displayedColors.forEach((item, index) => {
+			item.index = index + 1;
+		});
+
+		if (this.showMoreColors) {
+			const ColorPaletteMoreColors = getFeature("ColorPaletteMoreColors");
+			if (ColorPaletteMoreColors) {
+				this.moreColorsFeature = new ColorPaletteMoreColors();
+			} else {
+				throw new Error(`You have to import "@ui5/webcomponents/dist/features/ColorPaletteMoreColors.js" module to use the more-colors functionality.`);
+			}
+		}
+	}
+
+	selectColor(item) {
+		if (!item.value) {
+			return;
+		}
+
+		item.focus();
+
+		if (this.displayedColors.includes(item)) {
+			this._itemNavigation.setCurrentItem(item);
+		}
+
+		this._setColor(item.value);
+	}
+
+	_setColor(color) {
+		this._selectedColor = color;
+		if (this._recentColors[0] !== this._selectedColor) {
+			if (this._recentColors.includes(this._selectedColor)) {
+				this._recentColors.unshift(this._recentColors.splice(this._recentColors.indexOf(this._selectedColor), 1)[0]);
+			} else {
+				this._recentColors.unshift(this._selectedColor);
+			}
+		}
+
+		this.fireEvent("item-click", {
+			color: this._selectedColor,
+		});
+	}
+
+	_onclick(event) {
+		if (event.target.localName === "ui5-color-palette-item") {
+			this.selectColor(event.target);
+		}
+	}
+
+	_onkeyup(event) {
+		if (isSpace(event) && event.target.localName === "ui5-color-palette-item") {
+			event.preventDefault();
+			this.selectColor(event.target);
+		}
+	}
+
+	_onkeydown(event) {
+		if (isEnter(event) && event.target.localName === "ui5-color-palette-item") {
+			this.selectColor(event.target);
+		}
+	}
+
+	_onDefaultColorKeyDown(event) {
+		if (isTabNext(event) && this.popupMode) {
+			event.preventDefault();
+			this._onDefaultColorClick();
+		}
+
+		if (isDown(event)) {
+			event.stopPropagation();
+
+			this.focusColorElement(this.colorPaletteNavigationElements[1], this._itemNavigation);
+		} else if (isUp(event)) {
+			event.stopPropagation();
+			const lastElementInNavigation = this.colorPaletteNavigationElements[this.colorPaletteNavigationElements.length - 1];
+
+			if (this.hasRecentColors) {
+				this.focusColorElement(lastElementInNavigation, this._itemNavigationRecentColors);
+			} else if (this.showMoreColors) {
+				lastElementInNavigation.focus();
+			} else {
+				const colorPaletteFocusIndex = (this.displayedColors.length % this.rowSize) * this.rowSize;
+
+				this.focusColorElement(this.displayedColors[colorPaletteFocusIndex], this._itemNavigation);
+			}
+		}
+	}
+
+	_onMoreColorsKeyDown(event) {
+		const index = this.colorPaletteNavigationElements.indexOf(event.target);
+		const colorPaletteFocusIndex = (this.displayedColors.length % this.rowSize) * this.rowSize;
+
+		if (isUp(event)) {
+			event.stopPropagation();
+
+			this.focusColorElement(this.displayedColors[colorPaletteFocusIndex], this._itemNavigation);
+		} else if (isDown(event)) {
+			event.stopPropagation();
+
+			if (this.hasRecentColors) {
+				this.focusColorElement(this.colorPaletteNavigationElements[index + 1], this._itemNavigationRecentColors);
+			} else if (this.showDefaultColor) {
+				this.colorPaletteNavigationElements[0].focus();
+			} else {
+				this.focusColorElement(this.displayedColors[0], this._itemNavigation);
+			}
+		}
+	}
+
+	_onColorContainerKeyDown(event) {
+		const lastElementInNavigation = this.colorPaletteNavigationElements[this.colorPaletteNavigationElements.length - 1];
+		if (isTabNext(event) && this.popupMode) {
+			event.preventDefault();
+			this.selectColor(event.target);
+		}
+
+		if (isUp(event) && event.target === this.displayedColors[0] && this.colorPaletteNavigationElements.length > 1) {
+			event.stopPropagation();
+			if (this.showDefaultColor) {
+				this.colorPaletteNavigationElements[0].focus();
+			} else if (!this.showDefaultColor && this.hasRecentColors) {
+				this.focusColorElement(lastElementInNavigation, this._itemNavigationRecentColors);
+			} else if (!this.showDefaultColor && this.showMoreColors) {
+				lastElementInNavigation.focus();
+			}
+		} else if (isDown(event) && event.target === this.displayedColors[this.displayedColors.length - 1] && this.colorPaletteNavigationElements.length > 1) {
+			event.stopPropagation();
+			const isRecentColorsNextElement = (this.showDefaultColor && !this.showMoreColors && this.hasRecentColors) || (!this.showDefaultColor && !this.showMoreColors && this.hasRecentColors);
+
+			if (this.showDefaultColor && this.showMoreColors) {
+				this.colorPaletteNavigationElements[2].focus();
+			} else if (this.showDefaultColor && !this.showMoreColors && (!this.showRecentColors || !this.recentColors[0])) {
+				this.colorPaletteNavigationElements[0].focus();
+			} else if (isRecentColorsNextElement) {
+				this.focusColorElement(lastElementInNavigation, this._itemNavigationRecentColors);
+			} else if (!this.showDefaultColor && this.showMoreColors) {
+				this.colorPaletteNavigationElements[1].focus();
+			}
+		}
+	}
+
+	_onRecentColorsContainerKeyDown(event) {
+		if (isUp(event)) {
+			if (this.showMoreColors) {
+				this.colorPaletteNavigationElements[1 + this.showDefaultColor].focus();
+			} else if (!this.showMoreColors && this.colorPaletteNavigationElements.length > 1) {
+				const colorPaletteFocusIndex = (this.displayedColors.length % this.rowSize) * this.rowSize;
+				event.stopPropagation();
+
+				this.focusColorElement(this.displayedColors[colorPaletteFocusIndex], this._itemNavigation);
+			}
+		} else if (isDown(event)) {
+			if (this.showDefaultColor) {
+				this.colorPaletteNavigationElements[0].focus();
+			} else {
+				event.stopPropagation();
+				this.focusColorElement(this.displayedColors[0], this._itemNavigation);
+			}
+		}
+	}
+
+	focusColorElement(element, itemNavigation) {
+		itemNavigation.setCurrentItem(element);
+		itemNavigation._focusCurrentItem();
+	}
+
+	async _chooseCustomColor() {
+		const colorPicker = await this.getColorPicker();
+		this._setColor(colorPicker.color);
+		this._closeDialog();
+	}
+
+	async _closeDialog() {
+		const dialog = await this._getDialog();
+		dialog.close();
+	}
+
+	async _openMoreColorsDialog() {
+		const dialog = await this._getDialog();
+		dialog.show();
+	}
+
+	_onDefaultColorClick() {
+		if (this.defaultColor) {
+			this._setColor(this.defaultColor);
+		}
+	}
+
+	/**
+	 * Returns the selected color.
+	 */
+	get selectedColor() {
+		return this._selectedColor;
+	}
+
+	get displayedColors() {
+		return this.getSlottedNodes("colors").filter(item => item.value).slice(0, 15);
+	}
+
+	get colorContainerLabel() {
+		return ColorPalette.i18nBundle.getText(COLORPALETTE_CONTAINER_LABEL);
+	}
+
+	get colorPaleteMoreColorsText() {
+		return ColorPalette.i18nBundle.getText(COLOR_PALETTE_MORE_COLORS_TEXT);
+	}
+
+	get _showMoreColors() {
+		return this.showMoreColors && this.moreColorsFeature;
+	}
+
+	get rowSize() {
+		return 5;
+	}
+
+	get hasRecentColors() {
+		return this.showRecentColors && this.recentColors[0];
+	}
+
+	get recentColors() {
+		if (this._recentColors.length > this.rowSize) {
+			this._recentColors = this._recentColors.slice(0, this.rowSize);
+		}
+
+		while (this._recentColors.length < this.rowSize) {
+			this._recentColors.push("");
+		}
+
+		return this._recentColors;
+	}
+
+	get recentColorsElements() {
+		if (this.getDomRef()) {
+			return Array.from(this.getDomRef().querySelectorAll(".ui5-cp-recent-colors-wrapper [ui5-color-palette-item]")).filter(x => x.value !== "");
+		}
+
+		return [];
+	}
+
+	get colorPaletteNavigationElements() {
+		const navigationElements = [];
+		const rootElement = this.shadowRoot.querySelector(".ui5-cp-root");
+
+		if (this.showDefaultColor) {
+			navigationElements.push(rootElement.querySelector(".ui5-cp-default-color-button"));
+		}
+
+		navigationElements.push(this.displayedColors[0]);
+
+		if (this.showMoreColors) {
+			navigationElements.push(rootElement.querySelector(".ui5-cp-more-colors"));
+		}
+
+		if (this.showRecentColors && !!this.recentColorsElements.length) {
+			navigationElements.push(this.recentColorsElements[0]);
+		}
+
+		return navigationElements;
+	}
+
+	get classes() {
+		return {
+			colorPaletteRoot: {
+				"ui5-cp-root": true,
+				"ui5-cp-root-phone": isPhone(),
+			},
+		};
+	}
+
+	async _getDialog() {
+		const staticAreaItem = await this.getStaticAreaItemDomRef();
+		return staticAreaItem.querySelector("[ui5-dialog]");
+	}
+
+	async getColorPicker() {
+		const dialog = await this._getDialog();
+		return dialog.content[0].querySelector("[ui5-color-picker]");
+	}
+}
+
+ColorPalette.define();
+
+export default ColorPalette;

package/dist/ColorPaletteItem.js

@@ -0,0 +1,137 @@
+import UI5Element from "@ui5/webcomponents-base/dist/UI5Element.js";
+import litRender from "@ui5/webcomponents-base/dist/renderer/LitRenderer.js";
+import { getI18nBundle } from "@ui5/webcomponents-base/dist/i18nBundle.js";
+import CSSColor from "@ui5/webcomponents-base/dist/types/CSSColor.js";
+import { isPhone } from "@ui5/webcomponents-base/dist/Device.js";
+import ColorPaletteItemTemplate from "./generated/templates/ColorPaletteItemTemplate.lit.js";
+import {
+	COLORPALETTE_COLOR_LABEL,
+} from "./generated/i18n/i18n-defaults.js";
+
+// Styles
+import ColorPaletteItemCss from "./generated/themes/ColorPaletteItem.css.js";
+
+/**
+* @public
+*/
+const metadata = {
+	tag: "ui5-color-palette-item",
+	managedSlots: true,
+	properties: /** @lends  sap.ui.webcomponents.main.ColorPaletteItem.prototype */ {
+		/**
+		 * Defines the colour of the component.
+		 * <br><br>
+		 * <b>Note:</b> The value should be a valid CSS color.
+		 *
+		 * @type {CSSColor}
+		 * @public
+		 */
+		value: {
+			type: CSSColor,
+		},
+
+		/**
+		 * Defines the tab-index of the element, helper information for the ItemNavigation.
+		 * @private
+		 */
+		_tabIndex: {
+			type: String,
+			defaultValue: "-1",
+			noAttribute: true,
+		},
+
+		/**
+		 * Defines the index of the item inside of the ColorPalette.
+		 * @private
+		 * @type {String}
+		 */
+		index: {
+			type: String,
+		},
+
+		/**
+		 * Defines if the ColorPalette is on phone mode.
+		 * @private
+		 * @type {Boolean}
+		 */
+		phone: {
+			type: Boolean,
+		},
+
+		/**
+		 * @private
+		 * @type {boolean}
+		 * @since 1.0.0-rc.15
+		 */
+		_disabled: {
+			type: Boolean,
+		},
+	},
+	slots: /** @lends sap.ui.webcomponents.main.ColorPaletteItem.prototype */ {
+	},
+	events: /** @lends sap.ui.webcomponents.main.ColorPaletteItem.prototype */ {
+	},
+};
+
+/**
+ * @class
+ *
+ * <h3 class="comment-api-title">Overview</h3>
+ *
+ * The <code>ui5-color-palette-item</code> component represents a color in the the <code>ui5-color-palette</code>.
+ *
+ * @constructor
+ * @author SAP SE
+ * @alias sap.ui.webcomponents.main.ColorPaletteItem
+ * @extends sap.ui.webcomponents.base.UI5Element
+ * @tagname ui5-color-palette-item
+ * @since 1.0.0-rc.12
+ * @implements sap.ui.webcomponents.main.IColorPaletteItem
+ * @public
+ */
+class ColorPaletteItem extends UI5Element {
+	static get metadata() {
+		return metadata;
+	}
+
+	static get render() {
+		return litRender;
+	}
+
+	static get styles() {
+		return ColorPaletteItemCss;
+	}
+
+	static get template() {
+		return ColorPaletteItemTemplate;
+	}
+
+	static async onDefine() {
+		ColorPaletteItem.i18nBundle = await getI18nBundle("@ui5/webcomponents");
+	}
+
+	constructor() {
+		super();
+	}
+
+	onBeforeRendering() {
+		this._disabled = !this.value;
+		this.phone = isPhone();
+	}
+
+	get colorLabel() {
+		return ColorPaletteItem.i18nBundle.getText(COLORPALETTE_COLOR_LABEL);
+	}
+
+	get styles() {
+		return {
+			root: {
+				"background-color": this.value,
+			},
+		};
+	}
+}
+
+ColorPaletteItem.define();
+
+export default ColorPaletteItem;