@ui5/webcomponents 2.0.0-rc.3 → 2.0.0-rc.4

package/dist/Form.d.ts

@@ -0,0 +1,198 @@
+import UI5Element from "@ui5/webcomponents-base/dist/UI5Element.js";
+import FormItemSpacing from "./types/FormItemSpacing.js";
+interface IFormItem extends HTMLElement {
+    labelSpan: string;
+    itemSpacing: `${FormItemSpacing}`;
+    readonly isGroup: boolean;
+    colsXl?: number;
+    colsL?: number;
+    colsM?: number;
+    colsS?: number;
+    columnSpan?: number;
+}
+type GroupItemsInfo = {
+    groupItem: IFormItem;
+    classes: string;
+    items: Array<ItemsInfo>;
+};
+type ItemsInfo = {
+    item: IFormItem;
+    classes: string;
+};
+/**
+ * @class
+ *
+ * ### Overview
+ *
+ * The Form is a layout component that arranges labels and form fields (like input fields) pairs
+ * into a specific number of columns.
+ *
+ * ### Structure
+ *
+ * - **Form** (`ui5-form`) is the top-level container component, responsible for the content layout and responsiveness.
+ * - **FormGroup** (`ui5-form-group`) enables the grouping of the Form content.
+ * - **FormItem** (`ui5-form-item`) is a pair of label and form fields and can be used directly in a Form, or as part of a FormGroup.
+ *
+ * The simplest Form (`ui5-form`) consists of a header area on top,
+ * displaying a header text (see the `headingText` property) and content below - an arbitrary number of FormItems (ui5-form-item),
+ * representing the pairs of label and form fields.
+ *
+ * And, there is also "grouping" available to assist the implementation of richer UIs.
+ * This is enabled by the FormGroup (`ui5-form-group`) component.
+ * In this case, the Form is structured into FormGroups and each FormGroup consists of FormItems.
+ *
+ *  ### Responsiveness
+ *
+ * The Form component reacts and changes its layout on predefined breakpoints.
+ * Depending on its size, the Form content (FormGroups and FormItems) gets divided into one or more columns as follows:
+ * - **S** (< 600px) – 1 column is recommended (default: 1)
+ * - **M** (600px - 1022px) – up to 2 columns are recommended (default: 1)
+ * - **L** (1023px - 1439px) - up to 3 columns are recommended (default: 2)
+ * - **XL** (> 1439px) – up to 6 columns are recommended (default: 2)
+ *
+ * To change the layout, use the `layout` property - f.e. layout="S1 M2 L3 XL6".
+ *
+ * ### Groups
+ *
+ * To make better use of screen space, there is built-in logic to determine how many columns should a FormGroup occupy.
+ *
+ * - **Example #1** (perfect match):
+ * 4 columns and 4 groups: each group will use 1 column.
+ *
+ * - **Example #2** (balanced distribution):
+ * 4 columns and 2 groups: each group will use 2 columns.
+ * 6 columns and 2 groups: each group will use 3 columns.
+ *
+ * - **Example #3** (unbalanced distribution):
+ * 3 columns and 2 groups: the larger one will use 2 columns, the smaller 1 column.
+ * 5 columns and 3 groups: two of the groups will use 2 columns each, the smallest 1 column.
+ *
+ * **Note:** The size of a group element is determined by the number of FormItems assigned to it.
+ * In the case of equality, the first in the DOM will use more columns, and the last - fewer columns.
+ *
+ * - **Example #4** (more groups than columns):
+ * 3 columns and 4 groups: each FormGroup uses only 1 column, the last FormGroup will wrap on the second row.
+ *
+ * ### Groups Column Span
+ *
+ * To influence the built-in group distribution, described in the previous section,
+ * you can use the FormGroup's `columnSpan` property, that defines how many columns the group should expand to.
+ *
+ * ### Items Column Span
+ *
+ * FormItem's columnSpan property defines how many columns the form item should expand to inside a form group or the form.
+ *
+ * ### Items Label Span
+ *
+ * The placement of the labels depends on the size of the used column.
+ * If there is enough space, the labels are next to their associated fields, otherwise  - above the fields.
+ * By default, the labels take 4/12 of the FormItem, leaving 8/12 parts to associated fields.
+ * You can control what space the labels should take via the `labelSpan` property.
+ *
+ * **For example:** To always place the labels on top set: `labelSpan="S12 M12 L12 XL12"` property.
+ *
+ * ### ES6 Module Import
+ *
+ * - import @ui5/webcomponents/dist/Form.js";
+ * - import @ui5/webcomponents/dist/FormGroup.js";
+ * - import @ui5/webcomponents/dist/FormItem.js";
+ *
+ * @csspart header - Used to style the wrapper of the header.
+ * @csspart layout - Used to style the element defining the form column layout.
+ * @csspart column - Used to style a single column of the form column layout.
+ *
+ * @public
+ * @since 2.0.0
+ */
+declare class Form extends UI5Element {
+    /**
+     * Defines the number of columns to distribute the form content by breakpoint.
+     *
+     * Supported values:
+     * - `S` - 1 column by default (1 column is recommended)
+     * - `M` - 1 column by default (up to 2 columns are recommended)
+     * - `L` - 2 columns by default (up to 3 columns are recommended)
+     * - `XL` - 2 columns by default (up to 6 columns  are recommended)
+     *
+     * @default "S1 M1 L2 XL2"
+     * @public
+     */
+    layout: string;
+    /**
+     * Defines the width proportion of the labels and fields of a FormItem by breakpoint.
+     *
+     * By default, the labels take 4/12 (or 1/3) of the form item in M,L and XL sizes,
+     * and 12/12 in S size, e.g in S the label is on top of its associated field.
+     *
+     * The supported values are between 1 and 12. Greater the number, more space the label will use.
+     *
+     * **Note:** If "12" is set, the label will be displayed on top of its assosiated field.
+     * @default "S12 M4 L4 XL4"
+     * @public
+     */
+    labelSpan: string;
+    /**
+     * Defines the header text of the component.
+     *
+     * **Note:** The property gets overridden by the `header` slot.
+     *
+     * @default ""
+     * @public
+     */
+    headerText: string;
+    /**
+     * Defines the vertical spacing between form items.
+     *
+     * **Note:** If the Form is meant to be switched between "non-edit" and "edit" modes,
+     * we recommend using "Large" item spacing in "non-edit" mode, and "Normal" - for "edit" mode,
+     * to avoid "jumping" effect, caused by the hight difference between texts in "non-edit" mode and the input fields in "edit" mode.
+     *
+     * @default "Normal"
+     * @public
+     */
+    itemSpacing: `${FormItemSpacing}`;
+    /**
+     * Defines the component header area.
+     *
+     * **Note:** When a `header` is provided, the `headerText` property is ignored.
+     * @public
+     */
+    header: Array<HTMLElement>;
+    /**
+     * Defines the component content - FormGroups or FormItems.
+     *
+     * **Note:** Mixing FormGroups and standalone FormItems (not belonging to a group) is not supported.
+     * Either use FormGroups and make sure all FormItems are part of a FormGroup, or use just FormItems without any FormGroups.
+     * @public
+     */
+    items: Array<IFormItem>;
+    /**
+     * @private
+     */
+    columnsS: number;
+    labelSpanS: number;
+    columnsM: number;
+    labelSpanM: number;
+    columnsL: number;
+    labelSpanL: number;
+    columnsXl: number;
+    labelSpanXl: number;
+    onBeforeRendering(): void;
+    onAfterRendering(): void;
+    setColumnLayout(): void;
+    setLabelSpan(): void;
+    setGroupsColSpan(): void;
+    getGroupsColSpan(cols: number, groups: number, index: number, group: IFormItem): number;
+    get hasGroupItems(): boolean;
+    get hasHeader(): boolean;
+    get hasCustomHeader(): boolean;
+    get ariaLabelledByID(): string | undefined;
+    get groupItemsInfo(): Array<GroupItemsInfo>;
+    get itemsInfo(): Array<ItemsInfo>;
+    getItemsInfo(items?: Array<IFormItem>): Array<ItemsInfo>;
+    createAdditionalCSSStyleSheet(): void;
+    getAdditionalCSS(step: string, colsNumber: number): string | undefined;
+    getCSSStyleSheet(cssText: string): CSSStyleSheet;
+}
+export default Form;
+export { IFormItem, };

package/dist/Form.js

@@ -0,0 +1,358 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import UI5Element from "@ui5/webcomponents-base/dist/UI5Element.js";
+import customElement from "@ui5/webcomponents-base/dist/decorators/customElement.js";
+import property from "@ui5/webcomponents-base/dist/decorators/property.js";
+import slot from "@ui5/webcomponents-base/dist/decorators/slot.js";
+import litRender from "@ui5/webcomponents-base/dist/renderer/LitRenderer.js";
+import Integer from "@ui5/webcomponents-base/dist/types/Integer.js";
+// Template
+import FormTemplate from "./generated/templates/FormTemplate.lit.js";
+// Styles
+import FormCss from "./generated/themes/Form.css.js";
+import Title from "./Title.js";
+import FormItemSpacing from "./types/FormItemSpacing.js";
+const additionalStylesMap = new Map();
+const StepColumn = {
+    "S": 1,
+    "M": 2,
+    "L": 3,
+    "XL": 6,
+};
+/**
+ * @class
+ *
+ * ### Overview
+ *
+ * The Form is a layout component that arranges labels and form fields (like input fields) pairs
+ * into a specific number of columns.
+ *
+ * ### Structure
+ *
+ * - **Form** (`ui5-form`) is the top-level container component, responsible for the content layout and responsiveness.
+ * - **FormGroup** (`ui5-form-group`) enables the grouping of the Form content.
+ * - **FormItem** (`ui5-form-item`) is a pair of label and form fields and can be used directly in a Form, or as part of a FormGroup.
+ *
+ * The simplest Form (`ui5-form`) consists of a header area on top,
+ * displaying a header text (see the `headingText` property) and content below - an arbitrary number of FormItems (ui5-form-item),
+ * representing the pairs of label and form fields.
+ *
+ * And, there is also "grouping" available to assist the implementation of richer UIs.
+ * This is enabled by the FormGroup (`ui5-form-group`) component.
+ * In this case, the Form is structured into FormGroups and each FormGroup consists of FormItems.
+ *
+ *  ### Responsiveness
+ *
+ * The Form component reacts and changes its layout on predefined breakpoints.
+ * Depending on its size, the Form content (FormGroups and FormItems) gets divided into one or more columns as follows:
+ * - **S** (< 600px) – 1 column is recommended (default: 1)
+ * - **M** (600px - 1022px) – up to 2 columns are recommended (default: 1)
+ * - **L** (1023px - 1439px) - up to 3 columns are recommended (default: 2)
+ * - **XL** (> 1439px) – up to 6 columns are recommended (default: 2)
+ *
+ * To change the layout, use the `layout` property - f.e. layout="S1 M2 L3 XL6".
+ *
+ * ### Groups
+ *
+ * To make better use of screen space, there is built-in logic to determine how many columns should a FormGroup occupy.
+ *
+ * - **Example #1** (perfect match):
+ * 4 columns and 4 groups: each group will use 1 column.
+ *
+ * - **Example #2** (balanced distribution):
+ * 4 columns and 2 groups: each group will use 2 columns.
+ * 6 columns and 2 groups: each group will use 3 columns.
+ *
+ * - **Example #3** (unbalanced distribution):
+ * 3 columns and 2 groups: the larger one will use 2 columns, the smaller 1 column.
+ * 5 columns and 3 groups: two of the groups will use 2 columns each, the smallest 1 column.
+ *
+ * **Note:** The size of a group element is determined by the number of FormItems assigned to it.
+ * In the case of equality, the first in the DOM will use more columns, and the last - fewer columns.
+ *
+ * - **Example #4** (more groups than columns):
+ * 3 columns and 4 groups: each FormGroup uses only 1 column, the last FormGroup will wrap on the second row.
+ *
+ * ### Groups Column Span
+ *
+ * To influence the built-in group distribution, described in the previous section,
+ * you can use the FormGroup's `columnSpan` property, that defines how many columns the group should expand to.
+ *
+ * ### Items Column Span
+ *
+ * FormItem's columnSpan property defines how many columns the form item should expand to inside a form group or the form.
+ *
+ * ### Items Label Span
+ *
+ * The placement of the labels depends on the size of the used column.
+ * If there is enough space, the labels are next to their associated fields, otherwise  - above the fields.
+ * By default, the labels take 4/12 of the FormItem, leaving 8/12 parts to associated fields.
+ * You can control what space the labels should take via the `labelSpan` property.
+ *
+ * **For example:** To always place the labels on top set: `labelSpan="S12 M12 L12 XL12"` property.
+ *
+ * ### ES6 Module Import
+ *
+ * - import @ui5/webcomponents/dist/Form.js";
+ * - import @ui5/webcomponents/dist/FormGroup.js";
+ * - import @ui5/webcomponents/dist/FormItem.js";
+ *
+ * @csspart header - Used to style the wrapper of the header.
+ * @csspart layout - Used to style the element defining the form column layout.
+ * @csspart column - Used to style a single column of the form column layout.
+ *
+ * @public
+ * @since 2.0.0
+ */
+let Form = class Form extends UI5Element {
+    onBeforeRendering() {
+        // Parse the layout and set it to the FormGroups/FormItems.
+        this.setColumnLayout();
+        // Parse the labelSpan and set it to the FormGroups/FormItems.
+        this.setLabelSpan();
+        // Define how many columns a group should take.
+        this.setGroupsColSpan();
+    }
+    onAfterRendering() {
+        // Create additional CSS for number of columns that are not supported by default.
+        this.createAdditionalCSSStyleSheet();
+    }
+    setColumnLayout() {
+        const layoutArr = this.layout.split(" ");
+        layoutArr.forEach((breakpoint) => {
+            if (breakpoint.startsWith("S")) {
+                this.columnsS = parseInt(breakpoint.slice(1));
+            }
+            else if (breakpoint.startsWith("M")) {
+                this.columnsM = parseInt(breakpoint.slice(1));
+            }
+            else if (breakpoint.startsWith("L")) {
+                this.columnsL = parseInt(breakpoint.slice(1));
+            }
+            else if (breakpoint.startsWith("XL")) {
+                this.columnsXl = parseInt(breakpoint.slice(2));
+            }
+        });
+    }
+    setLabelSpan() {
+        this.labelSpan.split(" ").forEach((breakpoint) => {
+            if (breakpoint.startsWith("S")) {
+                this.labelSpanS = parseInt(breakpoint.slice(1));
+            }
+            else if (breakpoint.startsWith("M")) {
+                this.labelSpanM = parseInt(breakpoint.slice(1));
+            }
+            else if (breakpoint.startsWith("L")) {
+                this.labelSpanL = parseInt(breakpoint.slice(1));
+            }
+            else if (breakpoint.startsWith("XL")) {
+                this.labelSpanXl = parseInt(breakpoint.slice(2));
+            }
+        });
+        this.items.forEach((item) => {
+            item.labelSpan = this.labelSpan;
+            item.itemSpacing = this.itemSpacing;
+        });
+    }
+    setGroupsColSpan() {
+        if (!this.hasGroupItems) {
+            return;
+        }
+        const itemsCount = this.items.length;
+        const sortedItems = [...this.items].sort((itemA, itemB) => {
+            return itemB?.items.length - itemA?.items.length;
+        });
+        sortedItems.forEach((item, idx) => {
+            item.colsXl = this.getGroupsColSpan(this.columnsXl, itemsCount, idx, item);
+            item.colsL = this.getGroupsColSpan(this.columnsL, itemsCount, idx, item);
+            item.colsM = this.getGroupsColSpan(this.columnsM, itemsCount, idx, item);
+            item.colsS = this.getGroupsColSpan(this.columnsS, itemsCount, idx, item);
+        });
+    }
+    getGroupsColSpan(cols, groups, index, group) {
+        // Case 0: column span is set from outside.
+        if (group.columnSpan) {
+            return group.columnSpan;
+        }
+        // CASE 1: The number of available columns match the number of groups, or only 1 column is available - each group takes 1 column.
+        // For example: 1 column - 1 group, 2 columns - 2 groups, 3 columns - 3 groups, 4columns - 4 groups
+        if (cols === 1 || cols <= groups) {
+            return 1;
+        }
+        // CASE 2: The number of available columns IS multiple of the number of groups.
+        // For example: 2 column - 1 group, 3 columns - 1 groups, 4 columns - 1 group, 4 columns - 2 groups
+        if (cols % groups === 0) {
+            return cols / groups;
+        }
+        // CASE 3: The number of available columns IS NOT multiple of the number of groups.
+        const MIN_COL_SPAN = 1;
+        const delta = cols - groups;
+        // 7 cols & 4 groups => 2, 2, 2, 1
+        if (delta <= groups) {
+            return index < delta ? MIN_COL_SPAN + 1 : MIN_COL_SPAN;
+        }
+        // 7 cols & 3 groups => 3, 2, 2
+        return index === 0 ? MIN_COL_SPAN + (delta - groups) + 1 : MIN_COL_SPAN + 1;
+    }
+    get hasGroupItems() {
+        return this.items.some((item) => item.isGroup);
+    }
+    get hasHeader() {
+        return this.hasCustomHeader || !!this.headerText;
+    }
+    get hasCustomHeader() {
+        return !!this.header.length;
+    }
+    get ariaLabelledByID() {
+        return this.hasCustomHeader ? undefined : `${this._id}-header-text`;
+    }
+    get groupItemsInfo() {
+        return this.items.map((groupItem) => {
+            return {
+                groupItem,
+                classes: `ui5-form-column-spanL-${groupItem.colsL} ui5-form-column-spanXL-${groupItem.colsXl} ui5-form-column-spanM-${groupItem.colsM} ui5-form-column-spanS-${groupItem.colsS}`,
+                items: this.getItemsInfo(Array.from(groupItem.children)),
+            };
+        });
+    }
+    get itemsInfo() {
+        return this.getItemsInfo();
+    }
+    getItemsInfo(items) {
+        return (items || this.items).map((item) => {
+            return {
+                item,
+                classes: item.columnSpan ? `ui5-form-item-span-${item.columnSpan}` : "",
+            };
+        });
+    }
+    createAdditionalCSSStyleSheet() {
+        [
+            { breakpoint: "S", columns: this.columnsS },
+            { breakpoint: "M", columns: this.columnsM },
+            { breakpoint: "L", columns: this.columnsL },
+            { breakpoint: "XL", columns: this.columnsXl },
+        ].forEach(step => {
+            const additionalStyle = this.getAdditionalCSS(step.breakpoint, step.columns);
+            if (additionalStyle) {
+                this.shadowRoot.adoptedStyleSheets = [...this.shadowRoot.adoptedStyleSheets, this.getCSSStyleSheet(additionalStyle)];
+            }
+        });
+    }
+    getAdditionalCSS(step, colsNumber) {
+        if (StepColumn[step] >= colsNumber) {
+            return;
+        }
+        const key = `${step}-${colsNumber}`;
+        if (!additionalStylesMap.has(key)) {
+            let containerQuery;
+            let supporedColumnsNumber;
+            let stepSpanCSS = "";
+            let cols = colsNumber;
+            if (step === "S") {
+                supporedColumnsNumber = StepColumn.S;
+                containerQuery = `@container (max-width: 599px) {`;
+            }
+            else if (step === "M") {
+                supporedColumnsNumber = StepColumn.M;
+                containerQuery = `@container (width > 599px) and (width < 1024px) {`;
+            }
+            else if (step === "L") {
+                supporedColumnsNumber = StepColumn.L;
+                containerQuery = `@container (width > 1023px) and (width < 1439px) {`;
+            }
+            else if (step === "XL") {
+                containerQuery = `@container (min-width: 1440px) {`;
+                supporedColumnsNumber = StepColumn.XL;
+            }
+            while (cols > supporedColumnsNumber) {
+                stepSpanCSS += `
+				:host([columns-${step.toLocaleLowerCase()}="${cols}"]) .ui5-form-layout {
+					grid-template-columns: repeat(${cols}, 1fr);
+				}
+				
+				.ui5-form-column-span${step}-${cols},
+				.ui5-form-item-span-${cols} {
+					grid-column: span ${cols};
+				}
+
+				.ui5-form-column-span${step}-${cols} .ui5-form-group-layout {
+					grid-template-columns: repeat(${cols}, 1fr);
+				}
+				`;
+                cols--;
+            }
+            const css = `${containerQuery}${stepSpanCSS}}`;
+            additionalStylesMap.set(key, css);
+        }
+        return additionalStylesMap.get(key);
+    }
+    getCSSStyleSheet(cssText) {
+        const style = new CSSStyleSheet();
+        style.replaceSync(cssText);
+        return style;
+    }
+};
+__decorate([
+    property({ type: String, defaultValue: "S1 M1 L2 XL2" })
+], Form.prototype, "layout", void 0);
+__decorate([
+    property({ type: String, defaultValue: "S12 M4 L4 XL4" })
+], Form.prototype, "labelSpan", void 0);
+__decorate([
+    property()
+], Form.prototype, "headerText", void 0);
+__decorate([
+    property({ type: FormItemSpacing, defaultValue: FormItemSpacing.Normal })
+], Form.prototype, "itemSpacing", void 0);
+__decorate([
+    slot({ type: HTMLElement })
+], Form.prototype, "header", void 0);
+__decorate([
+    slot({
+        type: HTMLElement,
+        "default": true,
+        individualSlots: true,
+        invalidateOnChildChange: true,
+    })
+], Form.prototype, "items", void 0);
+__decorate([
+    property({ validator: Integer, defaultValue: 1 })
+], Form.prototype, "columnsS", void 0);
+__decorate([
+    property({ validator: Integer, defaultValue: 12 })
+], Form.prototype, "labelSpanS", void 0);
+__decorate([
+    property({ validator: Integer, defaultValue: 1 })
+], Form.prototype, "columnsM", void 0);
+__decorate([
+    property({ validator: Integer, defaultValue: 4 })
+], Form.prototype, "labelSpanM", void 0);
+__decorate([
+    property({ validator: Integer, defaultValue: 2 })
+], Form.prototype, "columnsL", void 0);
+__decorate([
+    property({ validator: Integer, defaultValue: 4 })
+], Form.prototype, "labelSpanL", void 0);
+__decorate([
+    property({ validator: Integer, defaultValue: 2 })
+], Form.prototype, "columnsXl", void 0);
+__decorate([
+    property({ validator: Integer, defaultValue: 4 })
+], Form.prototype, "labelSpanXl", void 0);
+Form = __decorate([
+    customElement({
+        tag: "ui5-form",
+        renderer: litRender,
+        styles: FormCss,
+        template: FormTemplate,
+        dependencies: [Title],
+    })
+], Form);
+Form.define();
+export default Form;
+//# sourceMappingURL=Form.js.map

package/dist/Form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.js","sourceRoot":"","sources":["../src/Form.ts"],"names":[],"mappings":"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","sourcesContent":["import UI5Element from \"@ui5/webcomponents-base/dist/UI5Element.js\";\nimport customElement from \"@ui5/webcomponents-base/dist/decorators/customElement.js\";\nimport property from \"@ui5/webcomponents-base/dist/decorators/property.js\";\nimport slot from \"@ui5/webcomponents-base/dist/decorators/slot.js\";\nimport litRender from \"@ui5/webcomponents-base/dist/renderer/LitRenderer.js\";\nimport Integer from \"@ui5/webcomponents-base/dist/types/Integer.js\";\n\n// Template\nimport FormTemplate from \"./generated/templates/FormTemplate.lit.js\";\n\n// Styles\nimport FormCss from \"./generated/themes/Form.css.js\";\n\nimport Title from \"./Title.js\";\nimport FormItemSpacing from \"./types/FormItemSpacing.js\";\nimport type FormGroup from \"./FormGroup.js\";\n\nconst additionalStylesMap = new Map<string, string>();\n\nconst StepColumn = {\n\t\"S\": 1,\n\t\"M\": 2,\n\t\"L\": 3,\n\t\"XL\": 6,\n};\n\ninterface IFormItem extends HTMLElement {\n\tlabelSpan: string\n\titemSpacing: `${FormItemSpacing}`;\n\treadonly isGroup: boolean;\n\tcolsXl?: number;\n\tcolsL?: number;\n\tcolsM?: number;\n\tcolsS?: number;\n\tcolumnSpan?: number;\n}\n\ntype GroupItemsInfo = {\n\tgroupItem: IFormItem,\n\tclasses: string,\n\titems: Array<ItemsInfo>,\n}\n\ntype ItemsInfo = {\n\titem: IFormItem,\n\tclasses: string,\n}\n\n/**\n * @class\n *\n * ### Overview\n *\n * The Form is a layout component that arranges labels and form fields (like input fields) pairs\n * into a specific number of columns.\n *\n * ### Structure\n *\n * - **Form** (`ui5-form`) is the top-level container component, responsible for the content layout and responsiveness.\n * - **FormGroup** (`ui5-form-group`) enables the grouping of the Form content.\n * - **FormItem** (`ui5-form-item`) is a pair of label and form fields and can be used directly in a Form, or as part of a FormGroup.\n *\n * The simplest Form (`ui5-form`) consists of a header area on top,\n * displaying a header text (see the `headingText` property) and content below - an arbitrary number of FormItems (ui5-form-item),\n * representing the pairs of label and form fields.\n *\n * And, there is also \"grouping\" available to assist the implementation of richer UIs.\n * This is enabled by the FormGroup (`ui5-form-group`) component.\n * In this case, the Form is structured into FormGroups and each FormGroup consists of FormItems.\n *\n *  ### Responsiveness\n *\n * The Form component reacts and changes its layout on predefined breakpoints.\n * Depending on its size, the Form content (FormGroups and FormItems) gets divided into one or more columns as follows:\n * - **S** (< 600px) – 1 column is recommended (default: 1)\n * - **M** (600px - 1022px) – up to 2 columns are recommended (default: 1)\n * - **L** (1023px - 1439px) - up to 3 columns are recommended (default: 2)\n * - **XL** (> 1439px) – up to 6 columns are recommended (default: 2)\n *\n * To change the layout, use the `layout` property - f.e. layout=\"S1 M2 L3 XL6\".\n *\n * ### Groups\n *\n * To make better use of screen space, there is built-in logic to determine how many columns should a FormGroup occupy.\n *\n * - **Example #1** (perfect match):\n * 4 columns and 4 groups: each group will use 1 column.\n *\n * - **Example #2** (balanced distribution):\n * 4 columns and 2 groups: each group will use 2 columns.\n * 6 columns and 2 groups: each group will use 3 columns.\n *\n * - **Example #3** (unbalanced distribution):\n * 3 columns and 2 groups: the larger one will use 2 columns, the smaller 1 column.\n * 5 columns and 3 groups: two of the groups will use 2 columns each, the smallest 1 column.\n *\n * **Note:** The size of a group element is determined by the number of FormItems assigned to it.\n * In the case of equality, the first in the DOM will use more columns, and the last - fewer columns.\n *\n * - **Example #4** (more groups than columns):\n * 3 columns and 4 groups: each FormGroup uses only 1 column, the last FormGroup will wrap on the second row.\n *\n * ### Groups Column Span\n *\n * To influence the built-in group distribution, described in the previous section,\n * you can use the FormGroup's `columnSpan` property, that defines how many columns the group should expand to.\n *\n * ### Items Column Span\n *\n * FormItem's columnSpan property defines how many columns the form item should expand to inside a form group or the form.\n *\n * ### Items Label Span\n *\n * The placement of the labels depends on the size of the used column.\n * If there is enough space, the labels are next to their associated fields, otherwise  - above the fields.\n * By default, the labels take 4/12 of the FormItem, leaving 8/12 parts to associated fields.\n * You can control what space the labels should take via the `labelSpan` property.\n *\n * **For example:** To always place the labels on top set: `labelSpan=\"S12 M12 L12 XL12\"` property.\n *\n * ### ES6 Module Import\n *\n * - import @ui5/webcomponents/dist/Form.js\";\n * - import @ui5/webcomponents/dist/FormGroup.js\";\n * - import @ui5/webcomponents/dist/FormItem.js\";\n *\n * @csspart header - Used to style the wrapper of the header.\n * @csspart layout - Used to style the element defining the form column layout.\n * @csspart column - Used to style a single column of the form column layout.\n *\n * @public\n * @since 2.0.0\n */\n@customElement({\n\ttag: \"ui5-form\",\n\trenderer: litRender,\n\tstyles: FormCss,\n\ttemplate: FormTemplate,\n\tdependencies: [Title],\n})\nclass Form extends UI5Element {\n\t/**\n\t * Defines the number of columns to distribute the form content by breakpoint.\n\t *\n\t * Supported values:\n\t * - `S` - 1 column by default (1 column is recommended)\n\t * - `M` - 1 column by default (up to 2 columns are recommended)\n\t * - `L` - 2 columns by default (up to 3 columns are recommended)\n\t * - `XL` - 2 columns by default (up to 6 columns  are recommended)\n\t *\n\t * @default \"S1 M1 L2 XL2\"\n\t * @public\n\t */\n\t@property({ type: String, defaultValue: \"S1 M1 L2 XL2\" })\n\tlayout!: string;\n\n\t/**\n\t * Defines the width proportion of the labels and fields of a FormItem by breakpoint.\n\t *\n\t * By default, the labels take 4/12 (or 1/3) of the form item in M,L and XL sizes,\n\t * and 12/12 in S size, e.g in S the label is on top of its associated field.\n\t *\n\t * The supported values are between 1 and 12. Greater the number, more space the label will use.\n\t *\n\t * **Note:** If \"12\" is set, the label will be displayed on top of its assosiated field.\n\t * @default \"S12 M4 L4 XL4\"\n\t * @public\n\t */\n\t@property({ type: String, defaultValue: \"S12 M4 L4 XL4\" })\n\tlabelSpan!: string;\n\n\t/**\n\t * Defines the header text of the component.\n\t *\n\t * **Note:** The property gets overridden by the `header` slot.\n\t *\n\t * @default \"\"\n\t * @public\n\t */\n\t@property()\n\theaderText!: string;\n\n\t/**\n\t * Defines the vertical spacing between form items.\n\t *\n\t * **Note:** If the Form is meant to be switched between \"non-edit\" and \"edit\" modes,\n\t * we recommend using \"Large\" item spacing in \"non-edit\" mode, and \"Normal\" - for \"edit\" mode,\n\t * to avoid \"jumping\" effect, caused by the hight difference between texts in \"non-edit\" mode and the input fields in \"edit\" mode.\n\t *\n\t * @default \"Normal\"\n\t * @public\n\t */\n\t@property({ type: FormItemSpacing, defaultValue: FormItemSpacing.Normal })\n\titemSpacing!: `${FormItemSpacing}`;\n\n\t/**\n\t * Defines the component header area.\n\t *\n\t * **Note:** When a `header` is provided, the `headerText` property is ignored.\n\t * @public\n\t */\n\t@slot({ type: HTMLElement })\n\theader!: Array<HTMLElement>;\n\n\t/**\n\t * Defines the component content - FormGroups or FormItems.\n\t *\n\t * **Note:** Mixing FormGroups and standalone FormItems (not belonging to a group) is not supported.\n\t * Either use FormGroups and make sure all FormItems are part of a FormGroup, or use just FormItems without any FormGroups.\n\t * @public\n\t */\n\t@slot({\n\t\ttype: HTMLElement,\n\t\t\"default\": true,\n\t\tindividualSlots: true,\n\t\tinvalidateOnChildChange: true,\n\t})\n\titems!: Array<IFormItem>;\n\n\t/**\n\t * @private\n\t */\n\t@property({ validator: Integer, defaultValue: 1 })\n\tcolumnsS!: number;\n\t@property({ validator: Integer, defaultValue: 12 })\n\tlabelSpanS!: number;\n\n\t@property({ validator: Integer, defaultValue: 1 })\n\tcolumnsM!: number;\n\t@property({ validator: Integer, defaultValue: 4 })\n\tlabelSpanM!: number;\n\n\t@property({ validator: Integer, defaultValue: 2 })\n\tcolumnsL!: number;\n\t@property({ validator: Integer, defaultValue: 4 })\n\tlabelSpanL!: number;\n\n\t@property({ validator: Integer, defaultValue: 2 })\n\tcolumnsXl!: number;\n\t@property({ validator: Integer, defaultValue: 4 })\n\tlabelSpanXl!: number;\n\n\tonBeforeRendering() {\n\t\t// Parse the layout and set it to the FormGroups/FormItems.\n\t\tthis.setColumnLayout();\n\n\t\t// Parse the labelSpan and set it to the FormGroups/FormItems.\n\t\tthis.setLabelSpan();\n\n\t\t// Define how many columns a group should take.\n\t\tthis.setGroupsColSpan();\n\t}\n\n\tonAfterRendering() {\n\t\t// Create additional CSS for number of columns that are not supported by default.\n\t\tthis.createAdditionalCSSStyleSheet();\n\t}\n\n\tsetColumnLayout() {\n\t\tconst layoutArr = this.layout.split(\" \");\n\t\tlayoutArr.forEach((breakpoint: string) => {\n\t\t\tif (breakpoint.startsWith(\"S\")) {\n\t\t\t\tthis.columnsS = parseInt(breakpoint.slice(1));\n\t\t\t} else if (breakpoint.startsWith(\"M\")) {\n\t\t\t\tthis.columnsM = parseInt(breakpoint.slice(1));\n\t\t\t} else if (breakpoint.startsWith(\"L\")) {\n\t\t\t\tthis.columnsL = parseInt(breakpoint.slice(1));\n\t\t\t} else if (breakpoint.startsWith(\"XL\")) {\n\t\t\t\tthis.columnsXl = parseInt(breakpoint.slice(2));\n\t\t\t}\n\t\t});\n\t}\n\n\tsetLabelSpan() {\n\t\tthis.labelSpan.split(\" \").forEach((breakpoint: string) => {\n\t\t\tif (breakpoint.startsWith(\"S\")) {\n\t\t\t\tthis.labelSpanS = parseInt(breakpoint.slice(1));\n\t\t\t} else if (breakpoint.startsWith(\"M\")) {\n\t\t\t\tthis.labelSpanM = parseInt(breakpoint.slice(1));\n\t\t\t} else if (breakpoint.startsWith(\"L\")) {\n\t\t\t\tthis.labelSpanL = parseInt(breakpoint.slice(1));\n\t\t\t} else if (breakpoint.startsWith(\"XL\")) {\n\t\t\t\tthis.labelSpanXl = parseInt(breakpoint.slice(2));\n\t\t\t}\n\t\t});\n\n\t\tthis.items.forEach((item: IFormItem) => {\n\t\t\titem.labelSpan = this.labelSpan;\n\t\t\titem.itemSpacing = this.itemSpacing;\n\t\t});\n\t}\n\n\tsetGroupsColSpan() {\n\t\tif (!this.hasGroupItems) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst itemsCount = this.items.length;\n\t\tconst sortedItems = [...this.items].sort((itemA: IFormItem, itemB: IFormItem) => {\n\t\t\treturn (itemB as FormGroup)?.items.length - (itemA as FormGroup)?.items.length;\n\t\t});\n\n\t\tsortedItems.forEach((item: IFormItem, idx: number) => {\n\t\t\titem.colsXl = this.getGroupsColSpan(this.columnsXl, itemsCount, idx, item);\n\t\t\titem.colsL = this.getGroupsColSpan(this.columnsL, itemsCount, idx, item);\n\t\t\titem.colsM = this.getGroupsColSpan(this.columnsM, itemsCount, idx, item);\n\t\t\titem.colsS = this.getGroupsColSpan(this.columnsS, itemsCount, idx, item);\n\t\t});\n\t}\n\n\tgetGroupsColSpan(cols: number, groups: number, index: number, group: IFormItem): number {\n\t\t// Case 0: column span is set from outside.\n\t\tif (group.columnSpan) {\n\t\t\treturn group.columnSpan;\n\t\t}\n\n\t\t// CASE 1: The number of available columns match the number of groups, or only 1 column is available - each group takes 1 column.\n\t\t// For example: 1 column - 1 group, 2 columns - 2 groups, 3 columns - 3 groups, 4columns - 4 groups\n\t\tif (cols === 1 || cols <= groups) {\n\t\t\treturn 1;\n\t\t}\n\n\t\t// CASE 2: The number of available columns IS multiple of the number of groups.\n\t\t// For example: 2 column - 1 group, 3 columns - 1 groups, 4 columns - 1 group, 4 columns - 2 groups\n\t\tif (cols % groups === 0) {\n\t\t\treturn cols / groups;\n\t\t}\n\n\t\t// CASE 3: The number of available columns IS NOT multiple of the number of groups.\n\t\tconst MIN_COL_SPAN = 1;\n\t\tconst delta = cols - groups;\n\n\t\t// 7 cols & 4 groups => 2, 2, 2, 1\n\t\tif (delta <= groups) {\n\t\t\treturn index < delta ? MIN_COL_SPAN + 1 : MIN_COL_SPAN;\n\t\t}\n\n\t\t// 7 cols & 3 groups => 3, 2, 2\n\t\treturn index === 0 ? MIN_COL_SPAN + (delta - groups) + 1 : MIN_COL_SPAN + 1;\n\t}\n\n\tget hasGroupItems(): boolean {\n\t\treturn this.items.some((item: IFormItem) => item.isGroup);\n\t}\n\n\tget hasHeader(): boolean {\n\t\treturn this.hasCustomHeader || !!this.headerText;\n\t}\n\n\tget hasCustomHeader(): boolean {\n\t\treturn !!this.header.length;\n\t}\n\n\tget ariaLabelledByID(): string | undefined {\n\t\treturn this.hasCustomHeader ? undefined : `${this._id}-header-text`;\n\t}\n\n\tget groupItemsInfo(): Array<GroupItemsInfo> {\n\t\treturn this.items.map((groupItem: IFormItem) => {\n\t\t\treturn {\n\t\t\t\tgroupItem,\n\t\t\t\tclasses: `ui5-form-column-spanL-${groupItem.colsL} ui5-form-column-spanXL-${groupItem.colsXl} ui5-form-column-spanM-${groupItem.colsM} ui5-form-column-spanS-${groupItem.colsS}`,\n\t\t\t\titems: this.getItemsInfo((Array.from(groupItem.children) as Array<IFormItem>)),\n\t\t\t};\n\t\t});\n\t}\n\n\tget itemsInfo(): Array<ItemsInfo> {\n\t\treturn this.getItemsInfo();\n\t}\n\n\tgetItemsInfo(items?: Array<IFormItem>): Array<ItemsInfo> {\n\t\treturn (items || this.items).map((item: IFormItem) => {\n\t\t\treturn {\n\t\t\t\titem,\n\t\t\t\tclasses: item.columnSpan ? `ui5-form-item-span-${item.columnSpan}` : \"\",\n\t\t\t};\n\t\t});\n\t}\n\n\tcreateAdditionalCSSStyleSheet() {\n\t\t[\n\t\t\t{ breakpoint: \"S\", columns: this.columnsS },\n\t\t\t{ breakpoint: \"M\", columns: this.columnsM },\n\t\t\t{ breakpoint: \"L\", columns: this.columnsL },\n\t\t\t{ breakpoint: \"XL\", columns: this.columnsXl },\n\t\t].forEach(step => {\n\t\t\tconst additionalStyle: string | undefined = this.getAdditionalCSS(step.breakpoint, step.columns);\n\n\t\t\tif (additionalStyle) {\n\t\t\t\tthis.shadowRoot!.adoptedStyleSheets = [...this.shadowRoot!.adoptedStyleSheets, this.getCSSStyleSheet(additionalStyle)];\n\t\t\t}\n\t\t});\n\t}\n\n\tgetAdditionalCSS(step: string, colsNumber: number): string | undefined {\n\t\tif (StepColumn[step as keyof typeof StepColumn] >= colsNumber) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst key = `${step}-${colsNumber}`;\n\n\t\tif (!additionalStylesMap.has(key)) {\n\t\t\tlet containerQuery;\n\t\t\tlet supporedColumnsNumber!: number;\n\t\t\tlet stepSpanCSS = \"\";\n\t\t\tlet cols = colsNumber;\n\n\t\t\tif (step === \"S\") {\n\t\t\t\tsupporedColumnsNumber = StepColumn.S;\n\t\t\t\tcontainerQuery = `@container (max-width: 599px) {`;\n\t\t\t} else if (step === \"M\") {\n\t\t\t\tsupporedColumnsNumber = StepColumn.M;\n\t\t\t\tcontainerQuery = `@container (width > 599px) and (width < 1024px) {`;\n\t\t\t} else if (step === \"L\") {\n\t\t\t\tsupporedColumnsNumber = StepColumn.L;\n\t\t\t\tcontainerQuery = `@container (width > 1023px) and (width < 1439px) {`;\n\t\t\t} else if (step === \"XL\") {\n\t\t\t\tcontainerQuery = `@container (min-width: 1440px) {`;\n\t\t\t\tsupporedColumnsNumber = StepColumn.XL;\n\t\t\t}\n\n\t\t\twhile (cols > supporedColumnsNumber) {\n\t\t\t\tstepSpanCSS += `\n\t\t\t\t:host([columns-${step.toLocaleLowerCase()}=\"${cols}\"]) .ui5-form-layout {\n\t\t\t\t\tgrid-template-columns: repeat(${cols}, 1fr);\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\t.ui5-form-column-span${step}-${cols},\n\t\t\t\t.ui5-form-item-span-${cols} {\n\t\t\t\t\tgrid-column: span ${cols};\n\t\t\t\t}\n\n\t\t\t\t.ui5-form-column-span${step}-${cols} .ui5-form-group-layout {\n\t\t\t\t\tgrid-template-columns: repeat(${cols}, 1fr);\n\t\t\t\t}\n\t\t\t\t`;\n\t\t\t\tcols--;\n\t\t\t}\n\n\t\t\tconst css = `${containerQuery}${stepSpanCSS}}`;\n\t\t\tadditionalStylesMap.set(key, css);\n\t\t}\n\n\t\treturn additionalStylesMap.get(key)!;\n\t}\n\n\tgetCSSStyleSheet(cssText: string): CSSStyleSheet {\n\t\tconst style = new CSSStyleSheet();\n\t\tstyle.replaceSync(cssText);\n\t\treturn style;\n\t}\n}\n\nForm.define();\n\nexport default Form;\nexport {\n\tIFormItem,\n};\n"]}

package/dist/FormGroup.d.ts

@@ -0,0 +1,63 @@
+import UI5Element from "@ui5/webcomponents-base/dist/UI5Element.js";
+import type FormItem from "./FormItem.js";
+import type { IFormItem } from "./Form.js";
+import FormItemSpacing from "./types/FormItemSpacing.js";
+/**
+ * @class
+ *
+ * ### Overview
+ *
+ * The FormGroup (ui5-form-group) represents a group inside the Form (ui5-form) component
+ * and it consists of FormItem (ui5-form-item) components.
+ *
+ * The layout of the FormGroup is mostly defined and controlled by the overarching Form (ui5-form) component.
+ * Still, one can influence the layout via the FormGroup's `columnSpan` property,
+ * that defines how many columns the group should expand to.
+ *
+ * ### Usage
+ *
+ * Тhe FormGroup (ui5-form-group) allows to split a Form into groups,
+ * e.g to group FormItems that logically belong together.
+ *
+ * ### ES6 Module Import
+ *
+ * - import @ui5/webcomponents/dist/FormGroup.js";
+ *
+ * @public
+ * @since 2.0.0
+ */
+declare class FormGroup extends UI5Element implements IFormItem {
+    /**
+     * Defines header text of the component.
+     *
+     * @default ""
+     * @public
+     */
+    headerText: string;
+    /**
+     * Defines column span of the component,
+     * e.g how many columns the group should span to.
+     *
+     * @default undefined
+     * @public
+     */
+    columnSpan?: number;
+    /**
+     * Defines the items of the component.
+     * @public
+     */
+    items: Array<FormItem>;
+    /**
+     * @private
+     */
+    colsS: number;
+    colsM: number;
+    colsL: number;
+    colsXl: number;
+    itemSpacing: `${FormItemSpacing}`;
+    labelSpan: string;
+    onBeforeRendering(): void;
+    processFormItems(): void;
+    get isGroup(): boolean;
+}
+export default FormGroup;