eventHandler - Gestionnaire d'événements (propriété)

Catégorie

événements

Syntaxe

Pour un événement serveur :

<xp:eventHandler event="eventname" submit="true|false"
	refreshMode="complete|partial|norefresh" refreshId="controlid"
	immediate="true|false"	execMode="partial|full">
	<xp:this.action>
	<!--For a script:-->
		<![CDATA[#{javascript:script}]]> <!--where script is the text of the script-->
	<!--For a simple action:-->
		<xp:simpleactionname attributes>content</xp:simpleactionname>
	<!--For a simple action group:-->
	</xp:this.action>
		<xp:actionGroup condition="#{javascript:script}">
			<xp:simpleactionname attributes>content</xp:simpleactionname>
			...
			<!--Can embed simple action groups-->
		</xp:actionGroup>
	<xp:this.parameters>
		<xp:parameter name="name" value="value"></xp:parameter>
		...
	</xp:this.parameters>
</xp:eventHandler>

Pour un événement client :

<xp:eventHandler event="eventname" submit="false">
	<xp:this.script>
	<!--For a script:-->
		<![CDATA[script]]> <!--where script is the text of the script-->
	<!--For a simple action:-->
		<xp:simpleactionname attributes>content</xp:simpleactionname>
	<!--For a simple action group:-->
		<xp:scriptGroup conditionScript="script">
			<xp:simpleactionname attributes>content</xp:simpleactionname>
			...
			<!--Can embed simple action groups-->
		</xp:scriptGroup>
	</xp:this.script>
</xp:eventHandler>

Où :

• eventname spécifie le nom de l'événement, onblur ou onclick, par exemple. En mode Conception, sélectionnez l'événement approprié.
• submit="true" provoque l'envoi d'une requête au serveur quand l'utilisateur active l'événement. Toute autre valeur attribuée à submit désactive l'événement. En mode Conception, cliquez sur Sans soumission pour supprimer l'événement.
• refreshMode prend l'une des valeurs suivantes :
  • complete recharge toute la page sur le client une fois que le serveur a traité la requête. En mode Conception, cliquez sur Mise à jour complète.
  • partial recharge une partie sélectionnée de la page en utilisant la technologie AJAX (Asynchronous JavaScript and XML). En mode Conception, cliquez sur Mise à jour partielle.
  • norefresh ne recharge pas la page. En mode Conception, cliquez sur Aucune mise à jour.
• refreshId, qui ne s'applique qu'à refreshMode="partial", spécifie le contrôle à mettre à jour. En mode Conception, cliquez sur Sélectionner élément.
• immediate="true" supprime le traitement des données sur le serveur. Pour le traitement des données, omettez cet attribut ou spécifiez autre chose que true. En mode Conception, cliquez sur Ne pas valider ou mettre à jour les données.
• execMode="partial" spécifie une actualisation partielle quand un fragment de code est exécuté. Pour une actualisation totale, omettez cet attribut ou spécifiez autre chose que partial. En mode Conception, cliquez sur Définir le mode d'exécution partielle.
• action spécifie soit :
  • le script où script est votre code. En mode Conception, cliquez sur Editeur de script. Entrez le script dans la fenêtre de script ou ouvrez la boîte de dialogue de script.
  • le nom de l'action simple et ses arguments. En mode Conception, cliquez sur Actions simples. Utilisez les différents boutons et listes pour créer et éditer des actions simples.
  • actionGroup qui peut contenir des actions simples ou d'autres groupes d'action. La condition est facultative.
• parameters spécifie le nom et les valeurs des éventuels paramètres d'événement. En mode Conception, cliquez sur Editer paramètres d'événement.

Utilisation

Les événements sont des actions qu'un utilisateur peut exécuter, comme le fait de cliquer sur un bouton ou de supprimer la mise en évidence d'une zone d'édition. Les gestionnaires d'événements sont des actions que vous, le concepteur, exécutez en réponse à ces événements. Un gestionnaire d'événements peut être un script serveur, un script client, une action simple ou un groupe d'actions simples.

En mode Conception, avec la mise en évidence sur le contrôle ou la page, cliquez sur l'onglet Evénements. Les événements sont traités comme des propriétés et apparaissent sur l'onglet Toutes les propriétés sous Propriétés. Il n'est toutefois pas recommandé de créer ou de modifier un événement à partir de Toutes les propriétés.

<xp:button value="Create document" id="button4">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
		<xp:this.action>
			<![CDATA[#{javascript:var doc = database.createDocument();
			doc.replaceItemValue("subject", requestScope.subject);
			doc.save();
			requestScope.subject = null}]]>
		</xp:this.action>
	</xp:eventHandler>
</xp:button>

<xp:button id="button5" value="Main page">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
		<xp:this.action>
			<xp:openPage name="/main.xsp" target="newDocument"></xp:openPage>
		</xp:this.action>
	</xp:eventHandler>
</xp:button>

<xp:button value="Create document" id="button6">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
		<xp:this.action>
			<xp:actionGroup condition="#{javascript:true}">
				<xp:executeScript>
					<xp:this.script><![CDATA[#{javascript:var doc = database.createDocument();
					doc.replaceItemValue("subject", requestScope.subject);
					doc.save();
					requestScope.subject = null}]]>
					</xp:this.script>
				</xp:executeScript>
				<xp:openPage name="/main.xsp" target="newDocument"></xp:openPage>
			</xp:actionGroup>
		</xp:this.action>
	</xp:eventHandler>
</xp:button>

<xp:inputText id="inputText2" value="#{requestScope.subject}">
	<xp:eventHandler event="onblur" submit="true" refreshMode="complete">
		<xp:this.script>
		<![CDATA[var e = window.document.getElementById("#{id:inputText2}");
		if(e.value.indexOf(" ") > -1) {
		window.alert("You should not have spaces in this value.")}]]>
		</xp:this.script>
	</xp:eventHandler>
</xp:inputText>