Class sap.ui.layout.BlockLayoutCellModule: sap/ui/layout/BlockLayoutCell
The BlockLayoutCell is used as an aggregation of the BlockLayoutRow. It contains Controls. The BlockLayoutCell should be used only as aggregation of the BlockLayoutRow.
Since: 1.34.
sClassName and enriches it with the information contained in oClassInfo. Accepts an object literal mSettings that defines initial property values, aggregated and associated objects as well as event handlers. See sap.ui.base.ManagedObject for a general description of the syntax of the settings object.
The supported settings are:
- Properties
- title : string
- titleAlignment : sap.ui.core.HorizontalAlign (default: Begin)
- titleLevel : sap.ui.core.TitleLevel (default: Auto)
- width : int (default: 0)
- Aggregations
- content : sap.ui.core.Control[] (default)
In addition, all settings applicable to the base type sap.ui.core.Control can be used as well.
| {string} | sId? | ID for the new control, generated automatically if no ID is given |
| {object} | mSettings? | Initial settings for the new control |
sClassName and enriches it with the information contained in oClassInfo. oClassInfo might contain the same kind of information as described in sap.ui.core.Control.extend.
| {string} | sClassName | Name of the class being created |
| {object} | oClassInfo? | Object literal with information about the class |
| {function} | FNMetaImpl? | Constructor function for the metadata object; if not given, it defaults to sap.ui.core.ElementMetadata |
| {function} | Created class / constructor function |
| {sap.ui.base.Metadata} | Metadata object describing this class |
content. | {sap.ui.core.Control} | oContent | the content to add; if empty, nothing is inserted |
| {sap.ui.layout.BlockLayoutCell} | Reference to this in order to allow method chaining |
content. | {sap.ui.layout.BlockLayoutCell} | Reference to this in order to allow method chaining |
content. The content to be included inside the cell
| {sap.ui.core.Control[]} |
title. Defines the title of the cell
| {string} | Value of property title |
titleAlignment. Defines the alignment of the cell title
Default value is Begin.
| {sap.ui.core.HorizontalAlign} | Value of property titleAlignment |
titleLevel. Defines the aria level of the title This information is e.g. used by assistive technologies like screenreaders to create a hierarchical site map for faster navigation.
Default value is Auto.
| {sap.ui.core.TitleLevel} | Value of property titleLevel |
width. Defines the width of the cell. Depending on the context of the cell - whether it's in scrollable, or non scrollable row, this property is interpreted in two different ways. If the cell is placed inside a scrollable row - this property defines the width of the cell in percentages. If no value is provided - the default is 40%. If the cell is placed inside a non scrollable row - this property defines the grow factor of the cell compared to the whole row. For example: If you have 2 cells, each with width of 1, this means that they should be of equal size, and they need to fill the whole row. This results in 50% width for each cell. If you have 2 cells, one with width of 1, the other with width of 3, this means that the whole row width is 4, so the first cell will have a width of 25%, the second - 75%. According to the visual guidelines, it is suggested that you only use 25%, 50%, 75% or 100% cells in you applications. For example, 12,5% width is not desirable (1 cell with width 1, and another with width 7)
Default value is 0.
| {int} | Value of property width |
sap.ui.core.Control in the aggregation content. and returns its index if found or -1 otherwise. | {sap.ui.core.Control} | oContent | The content whose index is looked for |
| {int} | The index of the provided control in the aggregation if found, or -1 otherwise |
content. | {sap.ui.core.Control} | oContent | the content to insert; if empty, nothing is inserted |
| {int} | iIndex | the 0-based index the content should be inserted at; for a negative value of iIndex, the content is inserted at position 0; for a value greater than the current size of the aggregation, the content is inserted at the last position |
| {sap.ui.layout.BlockLayoutCell} | Reference to this in order to allow method chaining |
content. Additionally, it unregisters them from the hosting UIArea.
| {sap.ui.core.Control[]} | An array of the removed elements (might be empty) |
content. | {int|string|sap.ui.core.Control} | vContent | The contentto remove or its index or id |
| {sap.ui.core.Control} | The removed content or null |
title. Defines the title of the cell
When called with a value of null or undefined, the default value of the property will be restored.
| {string} | sTitle | New value for property title |
| {sap.ui.layout.BlockLayoutCell} | Reference to this in order to allow method chaining |
titleAlignment. Defines the alignment of the cell title
When called with a value of null or undefined, the default value of the property will be restored.
Default value is Begin.
| {sap.ui.core.HorizontalAlign} | sTitleAlignment | New value for property titleAlignment |
| {sap.ui.layout.BlockLayoutCell} | Reference to this in order to allow method chaining |
titleLevel. Defines the aria level of the title This information is e.g. used by assistive technologies like screenreaders to create a hierarchical site map for faster navigation.
When called with a value of null or undefined, the default value of the property will be restored.
Default value is Auto.
| {sap.ui.core.TitleLevel} | sTitleLevel | New value for property titleLevel |
| {sap.ui.layout.BlockLayoutCell} | Reference to this in order to allow method chaining |