X4 Produktdokumentation

Button

Mit <Button>-Controls können Sie Schaltflächen zum Auslösen einer Aktion oder zum Navigieren in einer Web App erzeugen. Die Schaltflächen können in der Web App frei platziert werden.

Hinweise zur Verwendung

Ein <Button>-Control wird mit dem Element <Button> erzeugt.

<Button>
...
</Button>

<Button>-Controls können in allen verfügbaren Layouttypen verwendet werden. Weitere Informationen finden Sie unter Layouts.

Attribute

Sie können die folgenden Attribute für <Button>-Controls definieren.

Hinweis:

  • Alle weiteren Attribute für die Schaltfächen definieren Sie in der jeweiligen Action.

  • In Form Components dient das Element <Button> lediglich als Container für die Action <CustomAction>. Hier legen Sie alle Attribute ausschließlich über das Element <CustomAction> fest.

Attribut

Beschreibung

disabled

Legt fest, ob der Nutzer mit dem Control interagieren kann.

  • Data Binding (Boolean) möglich

Mögliche Werte: 

  • true/false 

  • Ausdruck für Data Binding

Hinweis:

Das Attribut disabled ist veraltet und wird in Zukunft nicht mehr verfügbar sein. Das veraltete Attribut wird durch enabled ersetzt. enabled="true" entspricht damit dem veralteten Attribut disabled="false".

enabled

Legt fest, ob der Nutzer mit dem Control interagieren kann.

  • Data Binding (Boolean) möglich

Mögliche Werte:

  • true/false

  • Ausdruck für Data Binding

horizontalAlign

Richtung, in die die Elemente fließen. Die Reihenfolge der Elemente entspricht ihrer Deklaration.

Mögliche Werte:

  • left (Standard)

  • center

  • right

textOverflow

Gibt an, was passieren soll, wenn das Control voll ist.

Mögliche Werte:

  • ellipsis (Standard): Zeigt mit ..., dass der Text nicht zu Ende ist.

  • hidden : Bricht den Text ab, ganze Wörter werden beachtet.

  • wordBreak : Bricht den Text innerhalb des Wortes ab.

  • allow: Bricht den Text zwischen den Wörtern um.

visible

Legt fest, ob das Control sichtbar ist.

  • Data Binding (Boolean) möglich

Mögliche Werte:

  • true false 

  • Zeichenkette für Data Binding

Actions

Wenn Sie eine Aktions-Schaltfläche immer am oberen Rand vor dem Inhalt der Component anzeigen möchten, erzeugen Sie eine Schaltfläche mit Actions.

Das Element <Button> kann folgende Actions enthalten:

  • <CustomAction/>

  • <DeleteAction/>

  • <DownloadAction/>

  • <ForgotPasswordAction/>

  • <LoginAction/>

  • <LogoutAction/>

  • <NewAction/>

  • <ReloadAction/>

  • <SaveAction/>

  • <SaveViewAction/>

  • <UploadAction/>

Hinweis:

In einer Form Component können Sie nur die Action <CustomAction> verwenden.

Beispiel

Button-Control in der DetailComponent
XML
<DetailComponent>
	<FlowLayout>
		<Button><SaveAction displayName="Save changes" iconPosition="right" background="A700"></SaveAction></Button>
	</FlowLayout>
</DetailComponent>
image-20251105-093030.png