X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

Controls

You use controls to issue information in the web application and process user input.

Default attributes

The following default attributes can be defined for all controls:

Attribute

Description

background

Defines a color for the background of the control.

Note:

  • This setting overrides the default color of the color scheme.

  • This attribute does not work for the <Button>, <HtmlDocument>, and <Map> controls.

Possible values:

  • Hexadecimal color value, e.g. ff5a00

Note:

  • Do not use a hash before the color value.

  • Do not use an abbreviated notation of the color value.

  • Color code from the color palette of the Web App, e.g. A200.
    For more information, see Theming.

foreground

Defines a color for the foreground (text, etc.) of the control.

Note:

  • This setting overrides the default color of the color scheme.

  • This attribute does not work for the <Button>, <HtmlDocument>, and <Map> controls.

Possible values:

  • Hexadecimal color value, e.g. ff5a00

Note:

  • Do not use a hash before the color value.

  • Do not use an abbreviated notation of the color value.

  • Color code from the color palette of the Web App, e.g. A200
    For more information, see Theming.

enabled

Specifies whether the user can interact with the control.

  • Data binding (Boolean) is possible

Possible values:

  • true/false

  • Expression for data binding

disabled

Specifies whether the user can interact with the control.

  • Data binding (Boolean) is possible

Possible values:

  • true/false

  • Expression for data binding

Note:

The disabled attribute is obsolete and will no longer be available in the future. The deprecated attribute is replaced by enabled. enabled="true" corresponds to the obsolete disabled="false" attribute.

fontFamily

Specifies the font family.

Note:

  • This attribute overwrites the default Web App font for the control.

  • If the attribute is defined on an element, the font family is inherited by any child elements unless the fontFamily attribute is explicitly defined for the child elements.

  • This attribute does not work for the <Button>, <HtmlDocument>, <Image>, and <Map> controls.

Possible values:

  • MainFont: stored main font

  • Font code from the font palette, e.g. Font04

fontSize

Sets the font size.

Note:

  • This attribute overrides the default Web App font size for the control.

  • This attribute does not work for the <Button>, <HtmlDocument>, <Image>, and <Map> controls.

Possible values:

  • Any integer or decimal number with a period as a decimal separator, e.g. 20, 20.8, .9

  • Font size in pixels, e.g. 20px

  • Font size in points, e.g. 18pt

  • Font size compared to the font size of the parent element, e.g. .8em or 120%

  • Keywords, e.g. small or larger

fontStretch

Defines the width of each character.

Note:

  • This attribute overrides the default character width for the control.

  • This attribute does not work for the <Button>, <HtmlDocument>, <Image>, and <Map> controls.

  • For <Accordion> controls, the default value is condensed.

Possible values:

  • Condensed

  • Expanded

  • ExtraCondensed

  • ExtraExpanded

  • Medium

  • Normal (default)

  • SemiCondensed

  • SemiExpanded

  • UltraCondensed

  • UltraExpanded

fontStyle

Defines the tilt of the font.

Note:

  • This attribute overrides the default font tilt for the control.

  • This attribute does not work for the <Button>, <HtmlDocument>, <Image>, and <Map> controls.

Possible values:

  • italic: Italic font

  • normal: Normal font (default)

  • oblique: Slanted font style (calculated)

fontWeight

Defines the font weight.

Note:

  • This attribute overrides the default font weight for the control.

  • This attribute does not work for the <Button>, <HtmlDocument>, <Image>, and <Map> controls.

  • For <Accordion> controls, the default value is Black.

Possible values:

  • Black

  • Bold

  • DemiBold

  • ExtraBlack

  • ExtraBold

  • ExtraLight

  • Heavy

  • Light

  • Medium

  • Normal (default)

  • Regular

  • SemiBold

  • Thin

  • UltraBlack

  • UltraBold

  • UltraLight

horizontalAlign

The direction in which the elements flow. The order of the elements corresponds to their declaration.

Possible values:

  • left (default)

  • center

  • right

textOverflow

Specifies what should happen when the control is full.

Note:

This attribute is not available in the <ListView> control.

Possible values:

  • ellipsis (default): Use ... to show that the text is not finished

  • hidden : Cancels the text, whole words are observed.

  • wordBreak: Cancels the text within the word.

  • allow: Wraps the text between the words.

visible

Defines if the control is visible.

  • Data binding (Boolean) is possible

Possible values:

  • true / false

  • String for data binding