Zeigt eine Schaltfläche an, auf die der Benutzer klicken kann, um eine Aktion auszuführen
Kategorie
Kernsteuerelemente
Syntax
<xp:button attributes>Inhalt</xp:button>
Tabelle 1. Wesentliche Eigenschaften| Eigenschaft |
Beschreibung |
|---|
| id |
Nimmt standardmäßig die Werte button1, button2 usw. an. |
| value |
Gibt die Beschriftung für die Schaltfläche an |
| eventHandler |
Gibt die Aktion an, die beim Aktivieren der Schaltfläche ausgeführt wird. Weitere Informationen finden Sie im Abschnitt zur Verwendung. |
Tabelle 2. Alle Eigenschaften| Kategorie |
Eigenschaften |
|---|
| Eingabehilfen |
accesskey, iconAlt, role, tabindex, title |
| Allgemein |
attrs, binding, dir, disabled, disableValidators, execId, execMode, icon, id, lang, loaded, navigate, refreshId, refreshMode, rendered, rendererType, save, type, value |
| Dojo |
dojoAttributes, dojoType |
| Ereignisse |
action, actionListener, actionListeners, immediate,onblur, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup |
| Darstellung |
disableTheme, outerStyleClass, style, styleClass, themeId |
Verwendung
Zur Ausführungszeit wird eine Schaltfläche auf der Seite angezeigt. Der Benutzer kann auf diese Schaltfläche klicken.
Es gibt drei Typen von Schaltflächen:
- Schaltfläche (Standard) reagiert auf Ereignishandler, die Sie erstellen können, z. B. für onclick.
- Übergeben speichert Daten und schließt die Seite.
- Abbrechen schließt die Seite.
Wird eine Seite geschlossen, so wird die nächste geladene Seite durch die Eigenschaft
navigationRules für die Seite bestimmt. Auf der Benutzeroberfläche ist dies
Nächste Seite (Erfolg oder Abbruch).
Zum Festlegen des Schaltflächentyps über die Benutzeroberfläche klicken Sie unter
Eigenschaften auf
Schaltfläche und suchen Sie nach
Schaltflächentyp. Die generierte Eigenschaft
eventHandler weist die folgenden Attribute auf. Folgen Sie diesen Regeln, wenn Sie die Eigenschaft
eventHandler manuell erstellen.
| Schaltfläche |
Übergeben |
Abbrechen |
|---|
| event=any |
event="onclick" |
event="onclick" |
| submit=any |
submit="true" |
submit="true" |
| refreshMode=any |
refreshMode="complete" |
refreshMode="complete" |
| immediate=any |
immediate="false" |
immediate="true" |
| save=any |
save="true" |
save="false" |
| action=simple action or event handler |
action=none |
action=none |
Beispiele
Dieses Schaltflächensteuerelement ist vom Typ "Übergeben".
<xp:button id="button1" value="Submit">
<xp:eventHandler event="onclick"
submit="true" refreshMode="complete" immediate="false" save="true">
</xp:eventHandler>
</xp:button>
Dieses Schaltflächensteuerelement ist vom Typ "Abbrechen".
<xp:button id="button2" value="Cancel">
<xp:eventHandler event="onclick"
submit="true" refreshMode="complete" immediate="true" save="false">
</xp:eventHandler>
</xp:button>
Dieses Schaltflächensteuerelement ist vom Typ "Schaltfläche" und führt beim Anklicken die einfache Aktion "Daten speichern" aus.
<xp:button id="button1" value="Save and Exit">
<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
<xp:this.action>
<xp:save name="/xpage2.xsp"></xp:save>
</xp:this.action>
</xp:eventHandler>
</xp:button>