Gilt für:
- Winshuttle Foundation
jQuery-Funktionen
JavaScript-Referenzleitfäden
Zusätzlich zur integrierten jQuery- und jQuery-UI-Funktionalität können die folgenden Hilfsfunktionen innerhalb von Composer Regeln verwendet werden.
Klicken Sie auf eine der unten stehenden Funktionen, um weitere Informationen anzuzeigen.
- jQuery.alert(message,title,callback)
- jQuery.confirm (message,title,callback,noCallback, yesLabel, noLabel, cancelLabel)
- jQuery.prompt(message,title,initialValue, validateCallback, okCallback)
- jQuery.promptTextArea(message,title,initialValue, validateCallback, okCallback)
- jQuery.choice(message,title,values,okCallback)
- jQuery.choiceTree(message,title,values,okCallback)
jQuery.alert(message,title,callback)
Stellt ein modales jQuery-Dialogfeld dar.
Parameter
- message – im Hauptnachrichtenfeld anzuzeigende Nachricht
- title – (optional) Titel des Nachrichtenfelds (Standard ist „Fehler“)
- callback – (optional) aufzurufende Funktion, nachdem der Benutzer auf OK geklickt hat
Beispiel
jQuery.alert('The format of this field in incorrect', 'Format Error');
jQuery.choice(message,title,values,okCallback)
Stellt ein modales jQuery-Dialogfeld mit einer Dropdown-Liste mit Werten zur Auswahl dar.
Parameter
- message – im Hauptnachrichtenfeld anzuzeigende Nachricht
- title – Titel des Nachrichtenfelds
- values – große Auswahl an Zeichenfolgewerten zum Einfügen in die Dropdownliste
- okCallback – (optional) aufzurufende Funktion, nachdem der Benutzer auf OK geklickt hat
Beispiel
jQuery.choice('Choose a size', 'Choice', ['Small', 'Medium', 'Large'],
function(value) {
$form.setValue('/my:myFields/my:size', value);
});
jQuery.choiceTree(message,title,values,okCallback)
Stellt ein modales jQuery-Dialogfeld mit einer Struktursteuerung mit Werten zur Auswahl dar.
Parameter
- message – im Hauptnachrichtenfeld anzuzeigende Nachricht
- title – Titel des Nachrichtenfelds
- values – große Auswahl an dynatree-Knotenwerten zum Einfügen in die Struktursteuerung (siehe dynatree-Dokumentation für Einzelheiten)
- okCallback – (optional) aufzurufende Funktion, nachdem der Benutzer auf OK geklickt hat
Beispiel
jQuery.choiceTree('Please choose an item', 'Tree Choice',
[ {
title: 'node 1', key: 'node1', isFolder: true,
children: [ {title: 'node 1.1', key: 'node1_1', isFolder: false},
{title: 'node 1.2', key: 'node1_2', isFolder: false},
{title: 'node 1.3', key: 'node1_3', isFolder: false}
]
},
{
title: 'node 2', key: 'node1', isFolder: true,
children: [ {title: 'node 2.1', key: 'node2_1', isFolder: false},
{title: 'node 2.2', key: 'node2_2', isFolder: false},
{title: 'node 2.3', key: 'node2_3', isFolder: false}
]
}], function(selectedNode) {
jQuery.alert('You chose: '+ selectedNode.data.key);
});
jQuery.confirm (message,title,callback,noCallback, yesLabel, noLabel, cancelLabel)
Stellt ein modales jQuery-Dialogfeld mit den Schaltflächen „Yes“, „No“ und „Cancel“ dar.
Parameter
- message – im Hauptnachrichtenfeld anzuzeigende Nachricht
- title – (optional) Titel des Nachrichtenfelds (Standard ist „Bestätigung“)
- callback – (optional) aufzurufende Funktion, nachdem der Benutzer auf „Ja“ geklickt hat
- noCallback – (optional) aufzurufende Funktion, nachdem der Benutzer auf „Nein“ geklickt hat
- yesLabel – (optional) Text der Ja-Schaltfläche (Standard ist „Ja“)
- noLabel – (optional) Text der Nein-Schaltfläche (Standard ist „Nein“)
- cancelLabel – (optional) Text der Abbrechen-Schaltfläche (Standard ist „Abbrechen“)
Beispiel
jQuery.confirm('Are you sure you want to do that?',
'Confirm Creation',
function() {
$form.executeWebService('createSomethingInSAP');
});
jQuery.prompt (message,title,initialValue, validateCallback, okCallback)
Stellt ein modales jQuery-Dialogfeld mit einem Textfeld für die Eingabe durch Benutzer dar.
Parameter
- message – im Hauptnachrichtenfeld anzuzeigende Nachricht
- title – Titel des Nachrichtenfelds
- initialValue – (optional) Anfangswert zum Einfügen in das Textfeld
- validateCallback – (optional) für die Validierung der Eingabe aufzurufende Funktion Die Funktion sollte „true“ für gültige Eingaben und „false“ für ungültige Eingaben ausgeben (verwenden Sie „Null“ für keine Validierung).
- okCallback – (optional) aufzurufende Funktion, nachdem der Benutzer auf „OK“ geklickt hat und die Eingabe gültig ist
Beispiel
jQuery.prompt('Please enter a number between 1 and 10',
'Enter a Number',
'',
function(value) {
if ( typeof value === 'number' && value % 1 == 0) {
if (value>=1 && value<=10) {
return true;
} else {
jQuery.alert('Value must be >= 1 or <= 10');
}
} else {
jQuery.alert('Enter an integer please');
}
return false;
},
function(value) { $form.setValue('/my:myFields/my:field_1', value); });
jQuery.promptTextArea(message,title,initialValue, validateCallback, okCallback)
Stellt ein modales jQuery-Dialogfeld mit einem Textbereich (mehrzeiliges Eingabefeld) für die Eingabe durch Benutzer dar.
Parameter
- message – im Hauptnachrichtenfeld anzuzeigende Nachricht
- title – Titel des Nachrichtenfelds „initialValue“ – (optional) Anfangswert zum Einfügen in das Textfeld
- validateCallback – (optional) für die Validierung der Eingabe aufzurufende Funktion Die Funktion sollte „true“ für gültige Eingaben und „false“ für ungültige Eingaben ausgeben (verwenden Sie „Null“ für keine Validierung).
- okCallback – (optional) aufzurufende Funktion, nachdem der Benutzer auf „OK“ geklickt hat und die Eingabe gültig ist
Beispiel
jQuery.promptTextArea('Please enter some text', 'Prompt', '', null,
function(value) {
$form.setValue('/my:myFields/my:bigTextField', value);
});