S’applique à :
- Winshuttle Foundation
Fonctions JQuery
Guides de référence JavaScript
Outre la fonctionnalité jQuery complètement intégrée et la fonctionnalité IU jQuery, les fonctions auxiliaires suivantes peuvent être utilisées dans les règles Composer.
Cliquez sur une fonction ci-dessous pour afficher plus d’informations à son sujet.
- 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)
Affiche une boîte de dialogue modale jQuery
Paramètres
- message : Message à afficher dans la zone de message principale
- title (facultatif) : Titre de la zone de message (la valeur par défaut est « Error »)
- callback (facultatif) : Fonction à appeler lorsque l’utilisateur clique sur OK.
Exemple
jQuery.alert('The format of this field in incorrect', 'Format Error');
jQuery.choice(message,title,values,okCallback)
Affiche une boîte de dialogue modale jQuery avec une liste déroulante de valeurs à sélectionner.
Paramètres
- message : Message à afficher dans la zone de message principale
- title : Titre de la zone de message
- values : Tableau de valeurs de chaîne à insérer dans la liste déroulante
- okCallback (facultatif) : Fonction à appeler lorsque l’utilisateur clique sur OK
Exemple
jQuery.choice('Choose a size', 'Choice', ['Small', 'Medium', 'Large'],
function(value) {
$form.setValue('/my:myFields/my:size', value);
});
jQuery.choiceTree(message,title,values,okCallback)
Présente une boîte de dialogue modale jQuery avec un contrôle d’arborescent de valeurs à sélectionner.
Paramètres
- message : Message à afficher dans la zone de message principale
- title : Titre de la zone de message
- values : Tableau de valeurs Nœud dynatree à insérer dans le contrôle d’arborescence (voir la documentation dynatree pour plus d'informations)
- okCallback (facultatif) : Fonction à appeler lorsque l’utilisateur clique sur OK
Exemple
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)
Affiche une boîte de dialogue modale jQuery avec les boutons Oui, Non, Annuler
Paramètres
- message : Message à afficher dans la zone de message principale
- title (facultatif) : Titre de la zone de message (la valeur par défaut est Confirmation)
- callback (facultatif) : Fonction à appeler lorsque l’utilisateur clique sur Oui.
- noCallback (facultatif) : Fonction à appeler lorsque l’utilisateur clique sur Non.
- yesLabel (facultatif) : Texte du bouton Oui (la valeur par défaut est Oui)
- noLabel (facultatif) : Texte du bouton Non (la valeur par défaut est Non)
- cancelLabel (facultatif) : Texte du bouton Annuler (la valeur par défaut est Annuler)
Exemple
jQuery.confirm('Are you sure you want to do that?',
'Confirm Creation',
function() {
$form.executeWebService('createSomethingInSAP');
});
jQuery.prompt (message,title,initialValue, validateCallback, okCallback)
Affiche une boîte de dialogue modale jQuery avec une zone de texte pour que l’utilisateur entre du texte
Paramètres
- message : Message à afficher dans la zone de message principale
- title : Titre de la zone de message
- initialValue (facultatif) : Valeur initiale à insérer dans la zone de texte
- validateCallback (facultatif) : Fonction à appeler pour la validation de l’entrée. La fonction doit renvoyer true pour une entrée valide (utilise « null » pour la validation)
- okCallback (facultatif) Fonction à appeler lorsque l’utilisateur clique sur OK et entre des données valide.
Exemple
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)
Affiche une boîte de dialogue modale jQuery avec une zone de texte (champ d’entrée multiligne) pour que l’utilisateur entre du texte
Paramètres
- message : Message à afficher dans la zone de message principale
- title : Titre du message boxinitial (facultatif) : valeur initiale à insérer dans la zone de texte
- validateCallback (facultatif) : Fonction à appeler pour la validation de l’entrée. La fonction doit renvoyer true pour une entrée valide (utilise « null » pour la validation)
- okCallback (facultatif) Fonction à appeler lorsque l’utilisateur clique sur OK et entre des données valide.
Exemple
jQuery.promptTextArea('Please enter some text', 'Prompt', '', null,
function(value) {
$form.setValue('/my:myFields/my:bigTextField', value);
});