@ui5/webcomponents 0.0.0-4821618b2 → 0.0.0-49bade48d

package/dist/Form.js

@@ -0,0 +1,490 @@
+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;
+};
+var Form_1;
+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 i18n from "@ui5/webcomponents-base/dist/decorators/i18n.js";
+import slot from "@ui5/webcomponents-base/dist/decorators/slot-strict.js";
+import jsxRenderer from "@ui5/webcomponents-base/dist/renderer/JsxRenderer.js";
+import { getEffectiveAriaLabelText } from "@ui5/webcomponents-base/dist/util/AccessibilityTextsHelper.js";
+// Utils
+import { getFormItemLayoutValue, getGroupsColSpan } from "./form-utils/FormUtils.js";
+// Template
+import FormTemplate from "./FormTemplate.js";
+// Styles
+import FormCss from "./generated/themes/Form.css.js";
+import { FORM_ACCESSIBLE_NAME } from "./generated/i18n/i18n-defaults.js";
+/**
+ * @class
+ *
+ * ### Overview
+ *
+ * The Form is a layout component that arranges labels and form fields (like input fields) pairs
+ * into a specific number of columns.
+ *
+ * **Note:** The Form web component is a layout component, it isn't a replacement for the native `form` HTML element.
+ * The Form web component does not provide any APIs for form submission.
+ *
+ * ### 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** (0 - 599px) – 1 column is recommended (default: 1)
+ * - **M** (600px - 1023px) – up to 2 columns are recommended (default: 1)
+ * - **L** (1024px - 1439px) - up to 3 columns are recommended (default: 2)
+ * - **XL** (>= 1440px) – up to 6 columns are recommended (default: 3)
+ *
+ * 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.
+ *
+ * ### Items Empty Span
+ *
+ * By default, a form item spans 12 cells, fully divided between its label and field, with no empty space at the end:
+ * - **Label:** occupies 4 cells.
+ * - **Field:** occupies 8 cells.
+ *
+ * The `emptySpan` property provides additional layout flexibility by defining empty space at the form item’s end.
+ *
+ * **For example:** Setting "S0 M0 L3 XL3" (or just "L3 XL3") adjusts the layout as follows:
+ * - **Label:** remains 4 cells.
+ * - **Field:** is reduced to 5 cells.
+ * - **Empty space:** 3 cells are added at the end.
+ *
+ * Greater values increase the empty space at the end of the form item, reducing the space available for the label and its field.
+ * However, setting `emptySpan` to 1 cell is recommended and typically sufficient to achieve a balanced layout.
+ *
+ * ### Navigation flow
+ *
+ * Items are grouped into `ui5-form-group` elements, allowing the following navigation:
+ *
+ * - **Single-Column Group**: Focus moves vertically down from one item to the next.
+ *   ```
+ *   | 1 |
+ *   | 2 |
+ *   | 3 |
+ *   ```
+ *
+ * - **Multi-Column Group**: Focus moves horizontally within each row, advancing to the next row after completing the current one.
+ *   ```
+ *   | 1 | 4 |
+ *   | 2 | 5 |
+ *   | 3 | 6 |
+ *   ```
+ *
+ * ### Keyboard Handling
+ *
+ * - [Tab] - Moves the focus to the next interactive element within the Form/FormGroup (if available) or to the next element in the tab chain outside the Form
+ * - [Shift] + [Tab] - Moves the focus to the previous interactive element within the Form/FormGroup (if available) or to the previous element in the tab chain outside the Form
+ * - [F6] - Moves the focus to the first interactive element of the next FormGroup (if available) or to the next element in the tab chain outside the Form
+ * - [Shift] + [F6] - Moves the focus to the first interactive element of the previous FormGroup (if available) or to the previous element in the tab chain outside the Form
+ *
+ * ### 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
+ * @extends UI5Element
+ */
+let Form = Form_1 = class Form extends UI5Element {
+    constructor() {
+        super(...arguments);
+        /**
+         * Defines the accessibility mode of the component in "edit" and "display" use-cases.
+         *
+         * Based on the mode, the component renders different HTML elements and ARIA attributes,
+         * which are appropriate for the use-case.
+         *
+         * **Usage:**
+         * - Set this property to "Display", when the form consists of non-editable (e.g. texts) form items.
+         * - Set this property to "Edit", when the form consists of editable (e.g. input fields) form items.
+         *
+         * @default "Display"
+         * @since 2.16.0
+         * @public
+         */
+        this.accessibleMode = "Display";
+        /**
+         * 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` - 3 columns by default (up to 6 columns  are recommended)
+         *
+         * @default "S1 M1 L2 XL3"
+         * @public
+         */
+        this.layout = "S1 M1 L2 XL3";
+        /**
+         * Defines the width proportion of the labels and fields of a form item 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
+         */
+        this.labelSpan = "S12 M4 L4 XL4";
+        /**
+         * Defines the number of cells that are empty at the end of each form item, configurable by breakpoint.
+         *
+         * By default, a form item spans 12 cells, fully divided between its label (4 cells) and field (8 cells), with no empty space at the end.
+         * The `emptySpan` provides additional layout flexibility by defining empty space at the form item’s end.
+         *
+         * **Note:**
+         * - The maximum allowable empty space is 10 cells. At least 1 cell each must remain for the label and the field.
+         * - When `emptySpan` is specified (greater than 0), ensure that the combined value of `emptySpan` and `labelSpan` does not exceed 11. This guarantees a minimum of 1 cell for the field.
+         *
+         * @default "S0 M0 L0 XL0"
+         * @since 2.5.0
+         * @public
+         */
+        this.emptySpan = "S0 M0 L0 XL0";
+        /**
+         * Defines the compoennt heading level,
+         * set by the `headerText`.
+         * @default "H2"
+         * @since 2.10.0
+         * @public
+        */
+        this.headerLevel = "H2";
+        /**
+         * Defines the vertical spacing between form items.
+         *
+         * **Note:** If the Form is meant to be switched between "display"("non-edit") and "edit" modes,
+         * we recommend using "Large" item spacing in "display"("non-edit") mode, and "Normal" - for "edit" mode,
+         * to avoid "jumping" effect, caused by the hight difference between texts in "display"("non-edit") mode and the input fields in "edit" mode.
+         *
+         * @default "Normal"
+         * @public
+         */
+        this.itemSpacing = "Normal";
+        /**
+         * @private
+         */
+        this.columnsS = 1;
+        this.labelSpanS = 12;
+        this.emptySpanS = 0;
+        this.columnsM = 1;
+        this.labelSpanM = 4;
+        this.emptySpanM = 0;
+        this.columnsL = 2;
+        this.labelSpanL = 4;
+        this.emptySpanL = 0;
+        this.columnsXl = 3;
+        this.labelSpanXl = 4;
+        this.emptySpanXl = 0;
+    }
+    onBeforeRendering() {
+        // Parse the layout and set it to the FormGroups/FormItems.
+        this.parseLayoutConfiguration();
+        // Define how many columns a group should take.
+        this.setGroupsColSpan();
+        // Set item spacing
+        this.setItemsState();
+    }
+    onAfterRendering() {
+        this.setFastNavGroup();
+    }
+    parseLayoutConfiguration() {
+        this.layout.split(" ").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));
+            }
+        });
+        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.emptySpan.split(" ").forEach((breakpoint) => {
+            if (breakpoint.startsWith("S")) {
+                this.emptySpanS = parseInt(breakpoint.slice(1));
+            }
+            else if (breakpoint.startsWith("M")) {
+                this.emptySpanM = parseInt(breakpoint.slice(1));
+            }
+            else if (breakpoint.startsWith("L")) {
+                this.emptySpanL = parseInt(breakpoint.slice(1));
+            }
+            else if (breakpoint.startsWith("XL")) {
+                this.emptySpanXl = parseInt(breakpoint.slice(2));
+            }
+        });
+    }
+    getFormItemLayout(breakpoint) {
+        let labelSpan, emptySpan;
+        if (breakpoint === "S") {
+            labelSpan = this.labelSpanS;
+            emptySpan = this.emptySpanS;
+        }
+        else if (breakpoint === "M") {
+            labelSpan = this.labelSpanM;
+            emptySpan = this.emptySpanM;
+        }
+        else if (breakpoint === "L") {
+            labelSpan = this.labelSpanL;
+            emptySpan = this.emptySpanL;
+        }
+        else if (breakpoint === "XL") {
+            labelSpan = this.labelSpanXl;
+            emptySpan = this.emptySpanXl;
+        }
+        return getFormItemLayoutValue(breakpoint, labelSpan, emptySpan);
+    }
+    setFastNavGroup() {
+        if (this.hasGroupItems) {
+            this.removeAttribute("data-sap-ui-fastnavgroup");
+        }
+        else {
+            this.setAttribute("data-sap-ui-fastnavgroup", "true");
+        }
+    }
+    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 = getGroupsColSpan(this.columnsXl, itemsCount, idx, item, "XL");
+            item.colsL = getGroupsColSpan(this.columnsL, itemsCount, idx, item, "L");
+            item.colsM = getGroupsColSpan(this.columnsM, itemsCount, idx, item, "M");
+            item.colsS = getGroupsColSpan(this.columnsS, itemsCount, idx, item, "S");
+        });
+    }
+    setItemsState() {
+        this.items.forEach((item) => {
+            item.itemSpacing = this.itemSpacing;
+            item.accessibleMode = this.accessibleMode;
+        });
+    }
+    get hasGroupItems() {
+        return this.items.some((item) => item.isGroup);
+    }
+    get hasHeader() {
+        return this.hasCustomHeader || this.hasHeaderText;
+    }
+    get hasHeaderText() {
+        return !!this.headerText;
+    }
+    get hasCustomHeader() {
+        return !!this.header.length;
+    }
+    get effectiveAccessibleName() {
+        if (this.accessibleName || this.accessibleNameRef) {
+            return getEffectiveAriaLabelText(this);
+        }
+        return this.hasHeader ? undefined : Form_1.i18nBundle.getText(FORM_ACCESSIBLE_NAME);
+    }
+    get effectiveАccessibleNameRef() {
+        if (this.accessibleName || this.accessibleNameRef) {
+            return;
+        }
+        return this.hasHeaderText && !this.hasCustomHeader ? `${this._id}-header-text` : undefined;
+    }
+    get effectiveAccessibleRole() {
+        return this.hasGroupItems ? "region" : "form";
+    }
+    get groupItemsInfo() {
+        return this.items.map((groupItem, index) => {
+            const accessibleNameRef = groupItem.effectiveAccessibleNameRef;
+            return {
+                groupItem,
+                accessibleName: this.accessibleMode === "Edit" ? groupItem.getEffectiveAccessibleName(index) : undefined,
+                accessibleNameInner: this.accessibleMode === "Edit" ? undefined : groupItem.getEffectiveAccessibleName(index),
+                accessibleNameRef: this.accessibleMode === "Edit" ? accessibleNameRef : undefined,
+                accessibleNameRefInner: this.accessibleMode === "Edit" ? undefined : accessibleNameRef,
+                items: this.getItemsInfo(Array.from(groupItem.children)),
+                role: this.accessibleMode === "Edit" ? "form" : undefined,
+            };
+        });
+    }
+    get itemsInfo() {
+        return this.getItemsInfo();
+    }
+    getItemsInfo(items) {
+        return (items || this.items).map((item) => {
+            return {
+                item,
+            };
+        });
+    }
+};
+__decorate([
+    property()
+], Form.prototype, "accessibleName", void 0);
+__decorate([
+    property()
+], Form.prototype, "accessibleNameRef", void 0);
+__decorate([
+    property()
+], Form.prototype, "accessibleMode", void 0);
+__decorate([
+    property()
+], Form.prototype, "layout", void 0);
+__decorate([
+    property()
+], Form.prototype, "labelSpan", void 0);
+__decorate([
+    property()
+], Form.prototype, "emptySpan", void 0);
+__decorate([
+    property()
+], Form.prototype, "headerText", void 0);
+__decorate([
+    property()
+], Form.prototype, "headerLevel", void 0);
+__decorate([
+    property()
+], Form.prototype, "itemSpacing", void 0);
+__decorate([
+    slot()
+], Form.prototype, "header", void 0);
+__decorate([
+    slot({
+        type: HTMLElement,
+        "default": true,
+        individualSlots: true,
+        invalidateOnChildChange: true,
+    })
+], Form.prototype, "items", void 0);
+__decorate([
+    property({ type: Number, noAttribute: true })
+], Form.prototype, "columnsS", void 0);
+__decorate([
+    property({ type: Number, noAttribute: true })
+], Form.prototype, "labelSpanS", void 0);
+__decorate([
+    property({ type: Number, noAttribute: true })
+], Form.prototype, "emptySpanS", void 0);
+__decorate([
+    property({ type: Number, noAttribute: true })
+], Form.prototype, "columnsM", void 0);
+__decorate([
+    property({ type: Number, noAttribute: true })
+], Form.prototype, "labelSpanM", void 0);
+__decorate([
+    property({ type: Number, noAttribute: true })
+], Form.prototype, "emptySpanM", void 0);
+__decorate([
+    property({ type: Number, noAttribute: true })
+], Form.prototype, "columnsL", void 0);
+__decorate([
+    property({ type: Number, noAttribute: true })
+], Form.prototype, "labelSpanL", void 0);
+__decorate([
+    property({ type: Number, noAttribute: true })
+], Form.prototype, "emptySpanL", void 0);
+__decorate([
+    property({ type: Number, noAttribute: true })
+], Form.prototype, "columnsXl", void 0);
+__decorate([
+    property({ type: Number, noAttribute: true })
+], Form.prototype, "labelSpanXl", void 0);
+__decorate([
+    property({ type: Number, noAttribute: true })
+], Form.prototype, "emptySpanXl", void 0);
+__decorate([
+    i18n("@ui5/webcomponents")
+], Form, "i18nBundle", void 0);
+Form = Form_1 = __decorate([
+    customElement({
+        tag: "ui5-form",
+        renderer: jsxRenderer,
+        styles: FormCss,
+        template: FormTemplate,
+    })
+], 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 type { Slot, DefaultSlot } 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 i18n from \"@ui5/webcomponents-base/dist/decorators/i18n.js\";\nimport slot from \"@ui5/webcomponents-base/dist/decorators/slot-strict.js\";\nimport jsxRenderer from \"@ui5/webcomponents-base/dist/renderer/JsxRenderer.js\";\nimport type { AriaRole } from \"@ui5/webcomponents-base\";\nimport type I18nBundle from \"@ui5/webcomponents-base/dist/i18nBundle.js\";\nimport { getEffectiveAriaLabelText } from \"@ui5/webcomponents-base/dist/util/AccessibilityTextsHelper.js\";\n\n// Utils\nimport { getFormItemLayoutValue, getGroupsColSpan } from \"./form-utils/FormUtils.js\";\nimport type { Breakpoint } from \"./form-utils/FormUtils.js\";\n\n// Template\nimport FormTemplate from \"./FormTemplate.js\";\n\n// Styles\nimport FormCss from \"./generated/themes/Form.css.js\";\n\nimport type FormItemSpacing from \"./types/FormItemSpacing.js\";\nimport type FormAccessibleMode from \"./types/FormAccessibleMode.js\";\nimport type FormGroup from \"./FormGroup.js\";\nimport type TitleLevel from \"./types/TitleLevel.js\";\n\nimport { FORM_ACCESSIBLE_NAME } from \"./generated/i18n/i18n-defaults.js\";\n\n/**\n * Interface for components that can be slotted inside `ui5-form` as items.\n * @public\n * @since 2.0.0\n */\ninterface IFormItem extends UI5Element {\n\titemSpacing: `${FormItemSpacing}`;\n\treadonly isGroup: boolean;\n\tcolsXl?: number;\n\tcolsL?: number;\n\tcolsM?: number;\n\tcolsS?: number;\n\tcolSpan?: string;\n\tcolumnSpan?: number;\n\theaderText?: string;\n\theaderLevel?: `${TitleLevel}`;\n\taccessibleMode?: `${FormAccessibleMode}`;\n}\n\ntype GroupItemsInfo = {\n\tgroupItem: IFormItem,\n\titems: Array<ItemsInfo>,\n\taccessibleName: string | undefined,\n\taccessibleNameInner: string | undefined,\n\taccessibleNameRef: string | undefined,\n\taccessibleNameRefInner: string | undefined,\n\trole: AriaRole | undefined,\n}\n\ntype ItemsInfo = {\n\titem: IFormItem,\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 * **Note:** The Form web component is a layout component, it isn't a replacement for the native `form` HTML element.\n * The Form web component does not provide any APIs for form submission.\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** (0 - 599px) – 1 column is recommended (default: 1)\n * - **M** (600px - 1023px) – up to 2 columns are recommended (default: 1)\n * - **L** (1024px - 1439px) - up to 3 columns are recommended (default: 2)\n * - **XL** (>= 1440px) – up to 6 columns are recommended (default: 3)\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 * ### Items Empty Span\n *\n * By default, a form item spans 12 cells, fully divided between its label and field, with no empty space at the end:\n * - **Label:** occupies 4 cells.\n * - **Field:** occupies 8 cells.\n *\n * The `emptySpan` property provides additional layout flexibility by defining empty space at the form item’s end.\n *\n * **For example:** Setting \"S0 M0 L3 XL3\" (or just \"L3 XL3\") adjusts the layout as follows:\n * - **Label:** remains 4 cells.\n * - **Field:** is reduced to 5 cells.\n * - **Empty space:** 3 cells are added at the end.\n *\n * Greater values increase the empty space at the end of the form item, reducing the space available for the label and its field.\n * However, setting `emptySpan` to 1 cell is recommended and typically sufficient to achieve a balanced layout.\n *\n * ### Navigation flow\n *\n * Items are grouped into `ui5-form-group` elements, allowing the following navigation:\n *\n * - **Single-Column Group**: Focus moves vertically down from one item to the next.\n *   ```\n *   | 1 |\n *   | 2 |\n *   | 3 |\n *   ```\n *\n * - **Multi-Column Group**: Focus moves horizontally within each row, advancing to the next row after completing the current one.\n *   ```\n *   | 1 | 4 |\n *   | 2 | 5 |\n *   | 3 | 6 |\n *   ```\n *\n * ### Keyboard Handling\n *\n * - [Tab] - Moves the focus to the next interactive element within the Form/FormGroup (if available) or to the next element in the tab chain outside the Form\n * - [Shift] + [Tab] - Moves the focus to the previous interactive element within the Form/FormGroup (if available) or to the previous element in the tab chain outside the Form\n * - [F6] - Moves the focus to the first interactive element of the next FormGroup (if available) or to the next element in the tab chain outside the Form\n * - [Shift] + [F6] - Moves the focus to the first interactive element of the previous FormGroup (if available) or to the previous element in the tab chain outside the Form\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 * @extends UI5Element\n */\n@customElement({\n\ttag: \"ui5-form\",\n\trenderer: jsxRenderer,\n\tstyles: FormCss,\n\ttemplate: FormTemplate,\n})\nclass Form extends UI5Element {\n\t/**\n\t * Defines the accessible ARIA name of the component.\n\t * @default undefined\n\t * @public\n\t * @since 2.10.0\n\t */\n\t@property()\n\taccessibleName?: string;\n\n\t/**\n\t * Defines id (or many ids) of the element (or elements) that label the component.\n\t * @default undefined\n\t * @public\n\t * @since 2.16.0\n\t */\n\t@property()\n\taccessibleNameRef?: string;\n\n\t/**\n\t * Defines the accessibility mode of the component in \"edit\" and \"display\" use-cases.\n\t *\n\t * Based on the mode, the component renders different HTML elements and ARIA attributes,\n\t * which are appropriate for the use-case.\n\t *\n\t * **Usage:**\n\t * - Set this property to \"Display\", when the form consists of non-editable (e.g. texts) form items.\n\t * - Set this property to \"Edit\", when the form consists of editable (e.g. input fields) form items.\n\t *\n\t * @default \"Display\"\n\t * @since 2.16.0\n\t * @public\n\t */\n\t@property()\n\taccessibleMode: `${FormAccessibleMode}` = \"Display\";\n\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` - 3 columns by default (up to 6 columns  are recommended)\n\t *\n\t * @default \"S1 M1 L2 XL3\"\n\t * @public\n\t */\n\t@property()\n\tlayout = \"S1 M1 L2 XL3\"\n\n\t/**\n\t * Defines the width proportion of the labels and fields of a form item 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 *\n\t * @default \"S12 M4 L4 XL4\"\n\t * @public\n\t */\n\t@property()\n\tlabelSpan = \"S12 M4 L4 XL4\";\n\n\t/**\n\t * Defines the number of cells that are empty at the end of each form item, configurable by breakpoint.\n\t *\n\t * By default, a form item spans 12 cells, fully divided between its label (4 cells) and field (8 cells), with no empty space at the end.\n\t * The `emptySpan` provides additional layout flexibility by defining empty space at the form item’s end.\n\t *\n\t * **Note:**\n\t * - The maximum allowable empty space is 10 cells. At least 1 cell each must remain for the label and the field.\n\t * - When `emptySpan` is specified (greater than 0), ensure that the combined value of `emptySpan` and `labelSpan` does not exceed 11. This guarantees a minimum of 1 cell for the field.\n\t *\n\t * @default \"S0 M0 L0 XL0\"\n\t * @since 2.5.0\n\t * @public\n\t */\n\t@property()\n\temptySpan = \"S0 M0 L0 XL0\";\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 undefined\n\t * @public\n\t */\n\t@property()\n\theaderText?: string;\n\n\t/**\n\t * Defines the compoennt heading level,\n\t * set by the `headerText`.\n\t * @default \"H2\"\n\t * @since 2.10.0\n\t * @public\n\t*/\n\t@property()\n\theaderLevel: `${TitleLevel}` = \"H2\";\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 \"display\"(\"non-edit\") and \"edit\" modes,\n\t * we recommend using \"Large\" item spacing in \"display\"(\"non-edit\") mode, and \"Normal\" - for \"edit\" mode,\n\t * to avoid \"jumping\" effect, caused by the hight difference between texts in \"display\"(\"non-edit\") mode and the input fields in \"edit\" mode.\n\t *\n\t * @default \"Normal\"\n\t * @public\n\t */\n\t@property()\n\titemSpacing: `${FormItemSpacing}` = \"Normal\";\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()\n\theader!: Slot<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 *\n\t * **Note:** As of version 2.23.0 the support for standalone FormItems (not belonging to a group) is deprecated.\n\t * We recommend using FormGroups, as they provide better accessibility and layout options.\n\t *\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!: DefaultSlot<IFormItem>;\n\n\t@i18n(\"@ui5/webcomponents\")\n\tstatic i18nBundle: I18nBundle;\n\n\t/**\n\t * @private\n\t */\n\t@property({ type: Number, noAttribute: true })\n\tcolumnsS = 1;\n\t@property({ type: Number, noAttribute: true })\n\tlabelSpanS = 12\n\t@property({ type: Number, noAttribute: true })\n\temptySpanS = 0\n\n\t@property({ type: Number, noAttribute: true })\n\tcolumnsM = 1;\n\t@property({ type: Number, noAttribute: true })\n\tlabelSpanM = 4;\n\t@property({ type: Number, noAttribute: true })\n\temptySpanM = 0\n\n\t@property({ type: Number, noAttribute: true })\n\tcolumnsL = 2;\n\t@property({ type: Number, noAttribute: true })\n\tlabelSpanL = 4;\n\t@property({ type: Number, noAttribute: true })\n\temptySpanL = 0\n\n\t@property({ type: Number, noAttribute: true })\n\tcolumnsXl = 3;\n\t@property({ type: Number, noAttribute: true })\n\tlabelSpanXl = 4;\n\t@property({ type: Number, noAttribute: true })\n\temptySpanXl = 0;\n\n\tonBeforeRendering() {\n\t\t// Parse the layout and set it to the FormGroups/FormItems.\n\t\tthis.parseLayoutConfiguration();\n\n\t\t// Define how many columns a group should take.\n\t\tthis.setGroupsColSpan();\n\n\t\t// Set item spacing\n\t\tthis.setItemsState();\n\t}\n\n\tonAfterRendering() {\n\t\tthis.setFastNavGroup();\n\t}\n\n\tparseLayoutConfiguration() {\n\t\tthis.layout.split(\" \").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\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.emptySpan.split(\" \").forEach((breakpoint: string) => {\n\t\t\tif (breakpoint.startsWith(\"S\")) {\n\t\t\t\tthis.emptySpanS = parseInt(breakpoint.slice(1));\n\t\t\t} else if (breakpoint.startsWith(\"M\")) {\n\t\t\t\tthis.emptySpanM = parseInt(breakpoint.slice(1));\n\t\t\t} else if (breakpoint.startsWith(\"L\")) {\n\t\t\t\tthis.emptySpanL = parseInt(breakpoint.slice(1));\n\t\t\t} else if (breakpoint.startsWith(\"XL\")) {\n\t\t\t\tthis.emptySpanXl = parseInt(breakpoint.slice(2));\n\t\t\t}\n\t\t});\n\t}\n\n\tgetFormItemLayout(breakpoint: Breakpoint) {\n\t\tlet labelSpan,\n\t\t\temptySpan;\n\n\t\tif (breakpoint === \"S\") {\n\t\t\tlabelSpan = this.labelSpanS;\n\t\t\temptySpan = this.emptySpanS;\n\t\t} else if (breakpoint === \"M\") {\n\t\t\tlabelSpan = this.labelSpanM;\n\t\t\temptySpan = this.emptySpanM;\n\t\t} else if (breakpoint === \"L\") {\n\t\t\tlabelSpan = this.labelSpanL;\n\t\t\temptySpan = this.emptySpanL;\n\t\t} else if (breakpoint === \"XL\") {\n\t\t\tlabelSpan = this.labelSpanXl;\n\t\t\temptySpan = this.emptySpanXl;\n\t\t}\n\n\t\treturn getFormItemLayoutValue(breakpoint, labelSpan, emptySpan);\n\t}\n\n\tsetFastNavGroup() {\n\t\tif (this.hasGroupItems) {\n\t\t\tthis.removeAttribute(\"data-sap-ui-fastnavgroup\");\n\t\t} else {\n\t\t\tthis.setAttribute(\"data-sap-ui-fastnavgroup\", \"true\");\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 = getGroupsColSpan(this.columnsXl, itemsCount, idx, item, \"XL\");\n\t\t\titem.colsL = getGroupsColSpan(this.columnsL, itemsCount, idx, item, \"L\");\n\t\t\titem.colsM = getGroupsColSpan(this.columnsM, itemsCount, idx, item, \"M\");\n\t\t\titem.colsS = getGroupsColSpan(this.columnsS, itemsCount, idx, item, \"S\");\n\t\t});\n\t}\n\n\tsetItemsState() {\n\t\tthis.items.forEach((item: IFormItem) => {\n\t\t\titem.itemSpacing = this.itemSpacing;\n\t\t\titem.accessibleMode = this.accessibleMode;\n\t\t});\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.hasHeaderText;\n\t}\n\n\tget hasHeaderText(): boolean {\n\t\treturn !!this.headerText;\n\t}\n\n\tget hasCustomHeader(): boolean {\n\t\treturn !!this.header.length;\n\t}\n\n\tget effectiveAccessibleName() {\n\t\tif (this.accessibleName || this.accessibleNameRef) {\n\t\t\treturn getEffectiveAriaLabelText(this);\n\t\t}\n\n\t\treturn this.hasHeader ? undefined : Form.i18nBundle.getText(FORM_ACCESSIBLE_NAME);\n\t}\n\n\tget effectiveАccessibleNameRef(): string | undefined {\n\t\tif (this.accessibleName || this.accessibleNameRef) {\n\t\t\treturn;\n\t\t}\n\n\t\treturn this.hasHeaderText && !this.hasCustomHeader ? `${this._id}-header-text` : undefined;\n\t}\n\n\tget effectiveAccessibleRole() {\n\t\treturn this.hasGroupItems ? \"region\" : \"form\";\n\t}\n\n\tget groupItemsInfo(): Array<GroupItemsInfo> {\n\t\treturn this.items.map((groupItem: IFormItem, index: number) => {\n\t\t\tconst accessibleNameRef = (groupItem as FormGroup).effectiveAccessibleNameRef;\n\n\t\t\treturn {\n\t\t\t\tgroupItem,\n\t\t\t\taccessibleName: this.accessibleMode === \"Edit\" ? (groupItem as FormGroup).getEffectiveAccessibleName(index) : undefined,\n\t\t\t\taccessibleNameInner: this.accessibleMode === \"Edit\" ? undefined : (groupItem as FormGroup).getEffectiveAccessibleName(index),\n\t\t\t\taccessibleNameRef: this.accessibleMode === \"Edit\" ? accessibleNameRef : undefined,\n\t\t\t\taccessibleNameRefInner: this.accessibleMode === \"Edit\" ? undefined : accessibleNameRef,\n\t\t\t\titems: this.getItemsInfo((Array.from(groupItem.children) as Array<IFormItem>)),\n\t\t\t\trole: this.accessibleMode === \"Edit\" ? \"form\" : undefined,\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};\n\t\t});\n\t}\n}\n\nForm.define();\n\nexport default Form;\nexport type {\n\tIFormItem,\n};\n"]}

package/dist/FormGroup.d.ts

@@ -0,0 +1,103 @@
+import UI5Element from "@ui5/webcomponents-base/dist/UI5Element.js";
+import type { DefaultSlot } from "@ui5/webcomponents-base/dist/UI5Element.js";
+import type I18nBundle from "@ui5/webcomponents-base/dist/i18nBundle.js";
+import type FormItem from "./FormItem.js";
+import type { IFormItem } from "./Form.js";
+import type FormItemSpacing from "./types/FormItemSpacing.js";
+import type TitleLevel from "./types/TitleLevel.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
+ * @implements {IFormItem}
+ * @since 2.0.0
+ * @extends UI5Element
+ */
+declare class FormGroup extends UI5Element implements IFormItem {
+    /**
+     * Defines header text of the component.
+     *
+     * @default undefined
+     * @public
+     */
+    headerText?: string;
+    /**
+     * Defines the compoennt heading level,
+     * set by the `headerText`.
+     * @default "H3"
+     * @public
+     * @since 2.10.0
+    */
+    headerLevel: `${TitleLevel}`;
+    /**
+     * Defines column span of the component,
+     * e.g how many columns the group should span to.
+     *
+     * **Note:** If this property is set, it has higher priority than `colSpan` and `colSpan` will be ignored.
+     *
+     * @default undefined
+     * @public
+     */
+    columnSpan?: number;
+    /**
+     * Defines the number of columns to distribute the form content by breakpoint (S1 M2 L3 XL4 for example).
+     *
+     * **Note:** This property is ignored if `columnSpan` is set, as it is expected that the column span is defined.
+     *
+     * @default undefined
+     * @public
+     */
+    colSpan?: string;
+    /**
+     * Defines the accessible ARIA name of the component.
+     * @default undefined
+     * @public
+     * @since 2.16.0
+     */
+    accessibleName?: string;
+    /**
+     * Defines id (or many ids) of the element (or elements) that label the component.
+     * @default undefined
+     * @public
+     * @since 2.16.0
+     */
+    accessibleNameRef?: string;
+    /**
+     * Defines the items of the component.
+     * @public
+     */
+    items: DefaultSlot<FormItem>;
+    /**
+     * @private
+     */
+    colsS: number;
+    colsM: number;
+    colsL: number;
+    colsXl: number;
+    itemSpacing: `${FormItemSpacing}`;
+    static i18nBundle: I18nBundle;
+    onBeforeRendering(): void;
+    processFormItems(): void;
+    getEffectiveAccessibleName(index: number): string | undefined;
+    get effectiveAccessibleNameRef(): string | undefined;
+    get isGroup(): boolean;
+}
+export default FormGroup;