1- // For Library Version: 1.133 .0
1+ // For Library Version: 1.134 .0
22
33declare module "sap/tnt/library" {
44 export interface IToolHeader {
@@ -167,6 +167,26 @@ declare module "sap/f/library" {
167167 __implements__sap_f_IDynamicPageStickyContent: boolean;
168168 }
169169
170+ /**
171+ * Interface for controls suitable for the `items` aggregation of `{@link sap.f.GridContainer}`.
172+ *
173+ * Classes implementing this interface should use the accessibility role provided by the `sap.f.IGridContainerItem.getGridItemRole`
174+ * method.
175+ *
176+ * @since 1.134
177+ */
178+ export interface IGridContainerItem {
179+ __implements__sap_f_IGridContainerItem: boolean;
180+
181+ /**
182+ * Returns the accessibility role for the `sap.f.GridContainer` item.
183+ *
184+ *
185+ * @returns The accessibility role for the `sap.f.GridContainer` item
186+ */
187+ getGridItemRole(): string;
188+ }
189+
170190 /**
171191 * Available `Illustration` sizes for the {@link sap.f.IllustratedMessage} control.
172192 *
@@ -1459,7 +1479,7 @@ declare module "sap/f/Card" {
14591479declare module "sap/f/CardBase" {
14601480 import { default as Control, $ControlSettings } from "sap/ui/core/Control";
14611481
1462- import { ICard, cards } from "sap/f/library";
1482+ import { ICard, IGridContainerItem, cards } from "sap/f/library";
14631483
14641484 import { IBadge } from "sap/m/library";
14651485
@@ -1474,9 +1494,13 @@ declare module "sap/f/CardBase" {
14741494 /**
14751495 * A base class for controls that represent a container with a predefined header and content.
14761496 */
1477- export default class CardBase extends Control implements ICard, IBadge {
1497+ export default class CardBase
1498+ extends Control
1499+ implements ICard, IBadge, IGridContainerItem
1500+ {
14781501 __implements__sap_f_ICard: boolean;
14791502 __implements__sap_m_IBadge: boolean;
1503+ __implements__sap_f_IGridContainerItem: boolean;
14801504 /**
14811505 * Constructor for a new `CardBase`.
14821506 *
@@ -1545,7 +1569,8 @@ declare module "sap/f/CardBase" {
15451569 * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
15461570 * otherwise it will be bound to this `sap.f.CardBase` itself.
15471571 *
1548- * Fired when action is added on card level. Note: Can be used only if `semanticRole` is `sap.f.cards.SemanticRole.ListItem`.
1572+ * Fired when action is added on card level. *Note**: Can be used only if `semanticRole` is `sap.f.cards.SemanticRole.ListItem`
1573+ * or the control is placed inside a `sap.f.GridContainer`.
15491574 *
15501575 * @experimental As of version 1.131.
15511576 *
@@ -1572,7 +1597,8 @@ declare module "sap/f/CardBase" {
15721597 * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
15731598 * otherwise it will be bound to this `sap.f.CardBase` itself.
15741599 *
1575- * Fired when action is added on card level. Note: Can be used only if `semanticRole` is `sap.f.cards.SemanticRole.ListItem`.
1600+ * Fired when action is added on card level. *Note**: Can be used only if `semanticRole` is `sap.f.cards.SemanticRole.ListItem`
1601+ * or the control is placed inside a `sap.f.GridContainer`.
15761602 *
15771603 * @experimental As of version 1.131.
15781604 *
@@ -1629,6 +1655,13 @@ declare module "sap/f/CardBase" {
16291655 * @returns Returns the DOM Element that should get the focus
16301656 */
16311657 getFocusDomRef(): Element;
1658+ /**
1659+ * Returns the accessibility role for the `sap.f.GridContainer` item.
1660+ *
1661+ *
1662+ * @returns The accessibility role for the `sap.f.GridContainer` item
1663+ */
1664+ getGridItemRole(): string;
16321665 /**
16331666 * Gets current value of property {@link #getHeight height}.
16341667 *
@@ -1643,7 +1676,8 @@ declare module "sap/f/CardBase" {
16431676 /**
16441677 * Gets current value of property {@link #getSemanticRole semanticRole}.
16451678 *
1646- * Defines the role of the Card Header.
1679+ * Defines the accessibility role of the control. *Note:** When the control is placed inside a `sap.f.GridContainer`,
1680+ * its accessibility role is overridden by the accessibility role specified by the `sap.f.GridContainer`.
16471681 *
16481682 * Default value is `Region`.
16491683 *
@@ -1684,7 +1718,8 @@ declare module "sap/f/CardBase" {
16841718 /**
16851719 * Sets a new value for property {@link #getSemanticRole semanticRole}.
16861720 *
1687- * Defines the role of the Card Header.
1721+ * Defines the accessibility role of the control. *Note:** When the control is placed inside a `sap.f.GridContainer`,
1722+ * its accessibility role is overridden by the accessibility role specified by the `sap.f.GridContainer`.
16881723 *
16891724 * When called with a value of `null` or `undefined`, the default value of the property will be restored.
16901725 *
@@ -1734,7 +1769,10 @@ declare module "sap/f/CardBase" {
17341769 height?: CSSSize | PropertyBindingInfo | `{${string}}`;
17351770
17361771 /**
1737- * Defines the role of the Card Header.
1772+ * Defines the accessibility role of the control.
1773+ *
1774+ * **Note:** When the control is placed inside a `sap.f.GridContainer`, its accessibility role is overridden
1775+ * by the accessibility role specified by the `sap.f.GridContainer`.
17381776 *
17391777 * @experimental As of version 1.131.
17401778 */
@@ -1744,7 +1782,10 @@ declare module "sap/f/CardBase" {
17441782 | `{${string}}`;
17451783
17461784 /**
1747- * Fired when action is added on card level. Note: Can be used only if `semanticRole` is `sap.f.cards.SemanticRole.ListItem`.
1785+ * Fired when action is added on card level.
1786+ *
1787+ * **Note**: Can be used only if `semanticRole` is `sap.f.cards.SemanticRole.ListItem` or the control is
1788+ * placed inside a `sap.f.GridContainer`.
17481789 *
17491790 * @experimental As of version 1.131.
17501791 */
@@ -11815,6 +11856,9 @@ declare module "sap/f/GridContainer" {
1181511856 * All rows have the same height and all columns have the same width. Their sizes can be configured with
1181611857 * the use of the `layout` aggregation and `{@link sap.f.GridContainerSettings}`.
1181711858 *
11859+ * **Note:** To ensure better keyboard and accessibility support, child items should implement `sap.f.IGridContainerItem`
11860+ * interface.
11861+ *
1181811862 * Usage:
1181911863 *
1182011864 * When to use
0 commit comments