@ui5/webcomponents 1.0.0-rc.8 → 1.0.2

package/src/TableCell.js

@@ -12,7 +12,7 @@ const metadata = {
 	tag: "ui5-table-cell",
 	slots: /** @lends sap.ui.webcomponents.main.TableCell.prototype */ {
 		/**
-		 * Specifies the content of the <code>ui5-table-cell</code>.
+		 * Specifies the content of the component.
 		 *
 		 * @type {Node[]}
 		 * @slot
@@ -23,14 +23,6 @@ const metadata = {
 		},
 	},
 	properties: /** @lends sap.ui.webcomponents.main.TableCell.prototype */ {
-
-		/**
-		 * @private
-		 */
-		firstInRow: {
-			type: Boolean,
-		},
-
 		/**
 		 * @private
 		 */
@@ -56,11 +48,21 @@ const metadata = {
  *
  * The <code>ui5-table-cell</code> component defines the structure of the data in a single <code>ui5-table</code> cell.
  *
+ * <h3>CSS Shadow Parts</h3>
+ *
+ * <ui5-link target="_blank" href="https://developer.mozilla.org/en-US/docs/Web/CSS/::part">CSS Shadow Parts</ui5-link> allow developers to style elements inside the Shadow DOM.
+ * <br>
+ * The <code>ui5-table-cell</code> exposes the following CSS Shadow Parts:
+ * <ul>
+ * <li>cell - Used to style the native <code>td</code> element</li>
+ * </ul>
+ *
  * @constructor
  * @author SAP SE
  * @alias sap.ui.webcomponents.main.TableCell
  * @extends sap.ui.webcomponents.base.UI5Element
  * @tagname ui5-table-cell
+ * @implements sap.ui.webcomponents.main.ITableCell
  * @public
  */
 class TableCell extends UI5Element {

package/src/TableColumn.hbs

@@ -1,6 +1,8 @@
 <th
 	scope="col"
 	part="column"
+	role="columnheader"
+	dir="{{effectiveDir}}"
 >
 	<slot></slot>
 </th>

package/src/TableColumn.js

@@ -27,11 +27,11 @@ const metadata = {
 		 * Defines the minimum table width required to display this column. By default it is always displayed.
 		 * <br><br>
 		 * The responsive behavior of the <code>ui5-table</code> is determined by this property. As an example, by setting
-		 * <code>minWidth</code> property to <code>40em</code> shows this column on tablet (and desktop) but hides it on mobile.
+		 * <code>minWidth</code> property to <code>400</code> sets the minimum width to 400 pixels, and	shows this column on tablet (and desktop) but hides it on mobile.
 		 * <br>
 		 * For further responsive design options, see <code>demandPopin</code> property.
 		 *
-		 * @type {number}
+		 * @type {Integer}
 		 * @defaultvalue Infinity
 		 * @public
 		 */
@@ -52,7 +52,7 @@ const metadata = {
 		},
 
 		/**
-		 * According to your <code>minWidth</code> settings, the <code>ui5-table-column</code> can be hidden
+		 * According to your <code>minWidth</code> settings, the component can be hidden
 		 * in different screen sizes.
 		 * <br><br>
 		 * Setting this property to <code>true</code>, shows this column as pop-in instead of hiding it.
@@ -96,11 +96,21 @@ const metadata = {
  * The <code>ui5-table-column</code> component allows to define column specific properties that are applied
  * when rendering the <code>ui5-table</code> component.
  *
+ * <h3>CSS Shadow Parts</h3>
+ *
+ * <ui5-link target="_blank" href="https://developer.mozilla.org/en-US/docs/Web/CSS/::part">CSS Shadow Parts</ui5-link> allow developers to style elements inside the Shadow DOM.
+ * <br>
+ * The <code>ui5-table-column</code> exposes the following CSS Shadow Parts:
+ * <ul>
+ * <li>column - Used to style the native <code>th</code> element</li>
+ * </ul>
+ *
  * @constructor
  * @author SAP SE
  * @alias sap.ui.webcomponents.main.TableColumn
  * @extends sap.ui.webcomponents.base.UI5Element
  * @tagname ui5-table-column
+ * @implements sap.ui.webcomponents.main.ITableColumn
  * @public
  */
 class TableColumn extends UI5Element {

package/src/TableGroupRow.hbs

@@ -0,0 +1,12 @@
+<tr
+	class="ui5-table-group-row-root"
+	part="group-row"
+	role="row"
+	aria-label={{ariaLabelText}}
+	tabindex="{{_tabIndex}}"
+	dir="{{effectiveDir}}"
+>
+	<td colspan={{colSpan}}>
+		<slot></slot>
+	</td>
+</tr>

package/src/TableGroupRow.js

@@ -0,0 +1,160 @@
+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 CheckBox from "./CheckBox.js";
+import TableGroupRowTemplate from "./generated/templates/TableGroupRowTemplate.lit.js";
+import TableMode from "./types/TableMode.js";
+
+// Texts
+import {
+	TABLE_GROUP_ROW_ARIA_LABEL,
+} from "./generated/i18n/i18n-defaults.js";
+
+// Styles
+import styles from "./generated/themes/TableGroupRow.css.js";
+
+/**
+ * @public
+ */
+const metadata = {
+	tag: "ui5-table-group-row",
+	slots: /** @lends sap.ui.webcomponents.main.TableGroupRow.prototype */ {
+		/**
+		 * Defines the text of the component.
+		 * <br>
+		 * <b>Note:</b> Although this slot accepts HTML Elements, it is strongly recommended that you only use text in order to preserve the intended design.
+		 *
+		 * @type {Node[]}
+		 * @slot
+		 * @public
+		 */
+		"default": {
+			type: Node,
+		},
+	},
+	properties: /** @lends sap.ui.webcomponents.main.TableGroupRow.prototype */ {
+		/**
+		 * Defines the mode of the row
+		 *
+		 * <br><br>
+		 * <b>Note:</b>
+		 * Available options are:
+		 * <ul>
+		 * <li><code>None</code></li>
+		 * <li><code>SingleSelect</code></li>
+		 * <li><code>MultiSelect</code></li>
+		 * </ul>
+		 * @type {TableMode}
+		 * @defaultvalue "None"
+		 * @private
+		 */
+		mode: {
+			type: TableMode,
+			defaultValue: TableMode.None,
+		},
+		_columnsInfo: {
+			type: Object,
+			multiple: true,
+		},
+		_tabIndex: {
+			type: String,
+			defaultValue: "-1",
+		},
+		_busy: {
+			type: Boolean,
+		},
+		_ariaPosition: {
+			type: String,
+			defaultValue: "",
+			noAttribute: true,
+		},
+	},
+};
+
+/**
+ * @class
+ *
+ * <h3 class="comment-api-title">Overview</h3>
+ *
+ * The <code>ui5-table-group-row</code> component represents a group row in the <code>ui5-table</code>.
+ *
+ * <h3>CSS Shadow Parts</h3>
+ *
+ * <ui5-link target="_blank" href="https://developer.mozilla.org/en-US/docs/Web/CSS/::part">CSS Shadow Parts</ui5-link> allow developers to style elements inside the Shadow DOM.
+ * <br>
+ * The <code>ui5-table-group-row</code> exposes the following CSS Shadow Parts:
+ * <ul>
+ * <li>group-row - Used to style the native <code>tr</code> element.</li>
+ * </ul>
+ *
+ * @constructor
+ * @author SAP SE
+ * @alias sap.ui.webcomponents.main.TableGroupRow
+ * @extends sap.ui.webcomponents.base.UI5Element
+ * @tagname ui5-table-group-row
+ * @since 1.0.0-rc.15
+ * @implements sap.ui.webcomponents.main.ITableRow
+ * @public
+ */
+class TableGroupRow extends UI5Element {
+	static get metadata() {
+		return metadata;
+	}
+
+	static get styles() {
+		return styles;
+	}
+
+	static get render() {
+		return litRender;
+	}
+
+	static get template() {
+		return TableGroupRowTemplate;
+	}
+
+	static get dependencies() {
+		return [
+			CheckBox,
+		];
+	}
+
+	constructor() {
+		super();
+	}
+
+	get colSpan() {
+		return this._colSpan;
+	}
+
+	get ariaLabelText() {
+		return `${TableGroupRow.i18nBundle.getText(TABLE_GROUP_ROW_ARIA_LABEL)} ${this.innerText}. ${this._ariaPosition}`;
+	}
+
+	visibleColCount() {
+		let count = this._columnsInfo.reduce((acc, column) => {
+			return column.visible ? ++acc : acc;
+		}, 0);
+
+		if (this.mode === TableMode.MultiSelect) {
+			count++;
+		}
+
+		return count;
+	}
+
+	onBeforeRendering() {
+		if (!this._columnsInfo || this._columnsInfo.length === 0) {
+			return;
+		}
+		this._colSpan = this.visibleColCount();
+	}
+
+	static async onDefine() {
+		TableGroupRow.i18nBundle = await getI18nBundle("@ui5/webcomponents");
+	}
+}
+
+TableGroupRow.define();
+
+export default TableGroupRow;

package/src/TableRow.hbs

@@ -3,9 +3,34 @@
 	tabindex="{{_tabIndex}}"
 	@focusin="{{_onfocusin}}"
 	@click="{{_onrowclick}}"
+	@keydown="{{_onkeydown}}"
+	@keyup="{{_onkeyup}}"
+	@mouseup="{{_onmouseup}}"
+	@touchstart="{{_ontouchstart}}"
+	@touchend="{{_ontouchend}}"
+	aria-label="{{ariaLabelText}}"
+	aria-selected="{{this.selected}}"
 	data-sap-focus-ref
 	part="row"
+	role="row"
 >
+
+	{{#if isMultiSelect}}
+		<td 
+			class="ui5-table-multi-select-cell" 
+			aria-hidden="true" 
+			role="presentation"
+		>
+			<ui5-checkbox
+				class="ui5-multi-select-checkbox"
+				?checked="{{this.selected}}"
+				aria-label="{{ariaLabelRowSelection}}"
+				@ui5-change="{{_handleSelection}}"
+			>
+			</ui5-checkbox>
+		</td>
+	{{/if}}
+
 	{{#if shouldPopin}}
 		{{#each visibleCells}}
 			<slot name="{{this._individualSlot}}"></slot>
@@ -19,8 +44,11 @@
 
 {{#if shouldPopin}}
 	{{#each popinCells}}
-		<tr part="popin-row" class="{{this.classes}}" @click="{{../_onrowclick}}">
-			<td colspan="{{../visibleCellsCount}}">
+		<tr part="popin-row" role="row" class="{{this.classes}}"
+			@click="{{../_onrowclick}}"
+			@keydown="{{../_onkeydown}}"
+			@keyup="{{../_onkeyup}}">
+			<td colspan="{{../visibleCellsCount}}" role="cell">
 				{{#if this.popinText}}
 					<span class="ui5-table-row-popin-title">{{this.popinText}}:</span>
 				{{/if}}

package/src/TableRow.js

@@ -1,6 +1,11 @@
 import UI5Element from "@ui5/webcomponents-base/dist/UI5Element.js";
+import { isSpace, isEnter } from "@ui5/webcomponents-base/dist/Keys.js";
+import { getI18nBundle } from "@ui5/webcomponents-base/dist/i18nBundle.js";
 import litRender from "@ui5/webcomponents-base/dist/renderer/LitRenderer.js";
+import TableMode from "./types/TableMode.js";
+import TableRowType from "./types/TableRowType.js";
 import TableRowTemplate from "./generated/templates/TableRowTemplate.lit.js";
+import { ARIA_LABEL_ROW_SELECTION } from "./generated/i18n/i18n-defaults.js";
 
 // Styles
 import styles from "./generated/themes/TableRow.css.js";
@@ -13,12 +18,12 @@ const metadata = {
 	managedSlots: true,
 	slots: /** @lends sap.ui.webcomponents.main.TableRow.prototype */ {
 		/**
-		 * Defines the cells of the <code>ui5-table-row</code>.
+		 * Defines the cells of the component.
 		 * <br><br>
 		 * <b>Note:</b> Use <code>ui5-table-cell</code> for the intended design.
 		 *
-		 * @type {HTMLElement[]}
-		 * @slot
+		 * @type {sap.ui.webcomponents.main.ITableCell[]}
+		 * @slot cells
 		 * @public
 		 */
 		"default": {
@@ -28,6 +33,63 @@ const metadata = {
 		},
 	},
 	properties: /** @lends sap.ui.webcomponents.main.TableRow.prototype */ {
+		/**
+		 * Defines the mode of the row (None, SingleSelect, MultiSelect).
+		 * @type {TableMode}
+		 * @defaultvalue "None"
+		 * @since 1.0.0-rc.15
+		 * @private
+		 */
+		mode: {
+			type: TableMode,
+			defaultValue: TableMode.None,
+		},
+		/**
+		 * Defines the visual indication and behavior of the component.
+		 * <br><br>
+		 * Available options are:
+		 * <ul>
+		 * <li><code>Active</code></li>
+		 * <li><code>Inactive</code></li>
+		 * </ul>
+		 * <br><br>
+		 * <b>Note:</b> When set to <code>Active</code>, the item will provide visual response upon press,
+		 * while with type <code>Inactive</code> - will not.
+		 *
+		 * @type {TableRowType}
+		 * @defaultvalue "Inactive"
+		 * @since 1.0.0-rc.15
+		 * @public
+		*/
+		type: {
+			type: TableRowType,
+			defaultValue: TableRowType.Inactive,
+		},
+
+		/**
+		 * Defines the row's selected state.
+		 *
+		 * @type {boolean}
+		 * @defaultvalue false
+		 * @since 1.0.0-rc.15
+		 * @public
+		 */
+		selected: {
+			type: Boolean,
+		},
+
+		/**
+		 * Indicates if the table row is active.
+		 *
+		 * @type {boolean}
+		 * @defaultvalue false
+		 * @since 1.0.0-rc.15
+		 * @private
+		*/
+		active: {
+			type: Boolean,
+		},
+
 		_columnsInfo: {
 			type: Object,
 			multiple: true,
@@ -36,10 +98,33 @@ const metadata = {
 			type: String,
 			defaultValue: "-1",
 		},
+		_busy: {
+			type: Boolean,
+		},
+		_ariaPosition: {
+			type: String,
+			defaultValue: "",
+			noAttribute: true,
+		},
 	},
 	events: /** @lends sap.ui.webcomponents.main.TableRow.prototype */ {
+		/**
+		 * Fired when a row in <code>Active</code> mode is clicked or <code>Enter</code> key is pressed.
+		 *
+		 * @event sap.ui.webcomponents.main.TableRow#row-click
+		 * @since 1.0.0-rc.15
+		 * @private
+		 */
 		"row-click": {},
 		_focused: {},
+		/**
+		 * Fired on selection change of an active row.
+		 *
+		 * @event sap.ui.webcomponents.main.TableRow#selection-requested
+		 * @since 1.0.0-rc.15
+		 * @private
+		 */
+		"selection-requested": {},
 	},
 };
 
@@ -50,11 +135,22 @@ const metadata = {
  *
  * The <code>ui5-table-row</code> component represents a row in the <code>ui5-table</code>.
  *
+ * <h3>CSS Shadow Parts</h3>
+ *
+ * <ui5-link target="_blank" href="https://developer.mozilla.org/en-US/docs/Web/CSS/::part">CSS Shadow Parts</ui5-link> allow developers to style elements inside the Shadow DOM.
+ * <br>
+ * The <code>ui5-table-row</code> exposes the following CSS Shadow Parts:
+ * <ul>
+ * <li>row - Used to style the native <code>tr</code> element</li>
+ * <li>popin-row - Used to style the <code>tr</code> element when a row pops in</li>
+ * </ul>
+ *
  * @constructor
  * @author SAP SE
  * @alias sap.ui.webcomponents.main.TableRow
  * @extends sap.ui.webcomponents.base.UI5Element
  * @tagname ui5-table-row
+ * @implements sap.ui.webcomponents.main.ITableRow
  * @public
  */
 class TableRow extends UI5Element {
@@ -74,33 +170,114 @@ class TableRow extends UI5Element {
 		return TableRowTemplate;
 	}
 
+	_onmouseup() {
+		this.deactivate();
+	}
+
+	_onkeydown(event) {
+		const itemActive = this.type === TableRowType.Active;
+		const isSingleSelect = this.isSingleSelect;
+		const itemSelectable = isSingleSelect || this.isMultiSelect;
+		const isRowFocused = this._getActiveElementTagName() === "ui5-table-row";
+		const checkboxPressed = event.target.classList.contains("ui5-multi-select-checkbox");
+
+		if (isSpace(event) && event.target.tagName.toLowerCase() === "tr") {
+			event.preventDefault();
+		}
+
+		if (isRowFocused && !checkboxPressed) {
+			if ((isSpace(event) && itemSelectable) || (isEnter(event) && isSingleSelect)) {
+				this.fireEvent("selection-requested", { row: this });
+			}
+
+			if (isEnter(event) && itemActive) {
+				this.fireEvent("row-click", { row: this });
+				if (!isSingleSelect) {
+					this.activate();
+				}
+			}
+		}
+	}
+
+	_onkeyup(event) {
+		if (isSpace(event) || isEnter(event)) {
+			this.deactivate();
+		}
+	}
+
+	_ontouchstart(event) {
+		this.activate();
+	}
+
+	_ontouchend() {
+		this.deactivate();
+	}
+
+	_onfocusout() {
+		this.deactivate();
+	}
+
 	_onfocusin(event, forceSelfFocus = false) {
 		if (forceSelfFocus || this._getActiveElementTagName() === "ui5-table-cell") {
-			this.getDomRef().focus();
+			this.shadowRoot.querySelector(".ui5-table-row-root").focus();
+			this.activate();
 		}
 
 		this.fireEvent("_focused", event);
 	}
 
 	_onrowclick(event) {
-		if (this._getActiveElementTagName() === "body") {
+		const checkboxPressed = event.target.classList.contains("ui5-multi-select-checkbox");
+		// If the user tab over a button on IOS device, the document.activeElement
+		// is the ui5-table-row. The check below ensure that, if a button within the row is pressed,
+		// the row will not be selected.
+		if (event.isMarked === "button") {
+			return;
+		}
+
+		if (!this.contains(this.getRootNode().activeElement)) {
 			// If the user clickes on non-focusable element within the ui5-table-cell,
 			// the focus goes to the body, se we have to bring it back to the row.
 			// If the user clicks on input, button or similar clickable element,
 			// the focus remains on that element.
 			this._onfocusin(event, true /* force row focus */);
+			this.deactivate();
+		}
+
+		if (this._getActiveElementTagName() === "ui5-table-row") {
+			if (this.isSingleSelect) {
+				this._handleSelection();
+			}
+
+			if (this.type === TableRowType.Active && !checkboxPressed) {
+				this.fireEvent("row-click", { row: this });
+			}
 		}
+	}
 
-		this.fireEvent("row-click", { row: this });
+	_handleSelection() {
+		this.fireEvent("selection-requested", { row: this });
 	}
 
 	_getActiveElementTagName() {
-		return document.activeElement.localName.toLocaleLowerCase();
+		return this.getRootNode().activeElement.localName.toLocaleLowerCase();
+	}
+
+	activate() {
+		if (this.type === TableRowType.Active) {
+			this.active = true;
+		}
+	}
+
+	deactivate() {
+		if (this.active) {
+			this.active = false;
+		}
 	}
 
 	get shouldPopin() {
 		return this._columnsInfo.filter(el => {
-			return el.demandPopin;
+			return el.demandPopin || !el.visible;
 		}).length;
 	}
 
@@ -130,7 +307,6 @@ class TableRow extends UI5Element {
 
 			if (info.visible) {
 				this.visibleCells.push(cell);
-				cell.firstInRow = (index === 0);
 				cell.popined = false;
 			} else if (info.demandPopin) {
 				const popinHeaderClass = this.popinCells.length === 0 ? "popin-header" : "";
@@ -154,7 +330,56 @@ class TableRow extends UI5Element {
 	}
 
 	get visibleCellsCount() {
-		return this.visibleCells.length;
+		let visibleCellsCount = this.visibleCells.length;
+
+		if (this.isMultiSelect) {
+			visibleCellsCount += 1;
+		}
+
+		return visibleCellsCount;
+	}
+
+	get ariaLabelText() {
+		const ariaLabel = this.cells.map((cell, index) => {
+			const columText = this.getColumnTextByIdx(index);
+			const cellText = this.getCellText(cell);
+			return `${columText} ${cellText}`;
+		}).join(" ");
+		return `${ariaLabel}. ${this._ariaPosition}`;
+	}
+
+	get ariaLabelRowSelection() {
+		return TableRow.i18nBundle.getText(ARIA_LABEL_ROW_SELECTION);
+	}
+
+	get isSingleSelect() {
+		return this.mode === "SingleSelect";
+	}
+
+	get isMultiSelect() {
+		return this.mode === "MultiSelect";
+	}
+
+	getCellText(cell) {
+		return this.getNormilzedTextContent(cell.textContent);
+	}
+
+	getColumnTextByIdx(index) {
+		const columnInfo = this._columnsInfo[index];
+
+		if (!columnInfo) {
+			return "";
+		}
+
+		return this.getNormilzedTextContent(columnInfo.text);
+	}
+
+	getNormilzedTextContent(textContent) {
+		return textContent.replace(/[\n\r\t]/g, "").trim();
+	}
+
+	static async onDefine() {
+		TableRow.i18nBundle = await getI18nBundle("@ui5/webcomponents");
 	}
 }
 

package/src/TextArea.hbs

@@ -5,7 +5,6 @@
 	@focusin="{{_onfocusin}}"
 	@focusout="{{_onfocusout}}"
 >
-
 	{{#if growing}}
 		<div id="{{_id}}-mirror" style="{{styles.mirror}}" class="ui5-textarea-mirror" aria-hidden="true">
 			{{#each _mirrorText}}
@@ -22,9 +21,10 @@
 		placeholder="{{placeholder}}"
 		?disabled="{{disabled}}"
 		?readonly="{{readonly}}"
-		?required="{{required}}"
+		aria-label="{{ariaLabelText}}"
+		aria-describedby="{{ariaDescribedBy}}"
+		aria-required="{{required}}"
 		maxlength="{{_exceededTextProps.calcedMaxLength}}"
-		aria-labelledby={{ariaLabelledBy}}
 		.value="{{value}}"
 		@input="{{_oninput}}"
 		@change="{{_onchange}}"
@@ -37,7 +37,11 @@
 	{{> afterTextarea}}
 
 	{{#if showExceededText}}
-		<span id="{{_id}}-exceededText" class="ui5-textarea-exceeded-text">{{_exceededTextProps.exceededText}}</span>
+		<span class="ui5-textarea-exceeded-text">{{_exceededTextProps.exceededText}}</span>
+	{{/if}}
+
+	{{#if hasValueState}}
+		<span id="{{_id}}-valueStateDesc" class="ui5-hidden-text">{{ariaValueStateHiddenText}}</span>
 	{{/if}}
 
 	<slot name="formSupport"></slot>