Un site Wap
Les événements
HomeUpDown

Le Wml prend en compte des événements auxquels on pourra associer des actions. Ainsi lorsque l'événement se produit (accéder à une carte, fin d'un compte à rebours, sélection d'un élément d'une liste de choix), l'action associée sera automatiquement exécutée.

Sur le plan explicatif, cette distinction entre les événements et les actions est un peu artificielle tellement les deux notions sont liées. On fera don inévitablement appel aux actions abordées à la page suivante.


 

La balise <onevent> ... </onevent>

L'événement déclencheur sera spécifié dans l'attribut type=" ... " ;

type="ontimer" L'événement est déclenché par l'arrivée à 0 d'un compte à rebours mis en place par une balise <timer ... />.
type="onenterforward" Lorsque l'utilisateur est entré dans une carte au moyen d'une action <go>.
type="onenterbackward" Lorsque l'utilisateur est entré dans une carte au moyen d'une action <prev>.
type="onpick" L'événement est déclenché par la sélection d'un élément dans une liste d'options.

Cet attribut type=" ... " pourra également être un attribut de la balise <card>.

Exemple :

<onevent type="ontimer>
... action ...
</onevent>

On peut ainsi imaginer un site avec une carte servant de page d'accueil et une redirection automatique après x secondes vers une seconde carte.

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC " ...>
<wml>
<card id="ct1" title="Welcome to">
<onevent type="ontimer">
<go href="#ct2"/>
</onevent>
<timer value="100"/>
<p align="center">
<big><b>Wap @ Wml</b></big><br/>
<img src="logowap.wbmp" alt="Wap"/>
</p>
</card>
<card id="ct2" title="Wap @ Wml">
<p>
Ce site est dédié au protocole Wap
et au langage WML ...
</p>
</card>
</wml>

Après 10 secondes (à fin du compte à rebours de timer), l'utilisateur est alors redirigé
de façon automatiquement vers une autre carte.


 

La balise <do> ... </do>

Lorsque l'action ne peut être déclenchée par un des événements précédents, celle-ci peut être activée par l'utilisateur grâce à la balise <do>.

En voici quelques attributs :

type="accept" ou
type="prev"
Obligatoire ! Type="accept" réclamera une confirmation de la part de l'utilisateur tandis que type="prev" entraînera une action de retour à la carte précédente.
label="Texte" Le texte de la petite étiquette demandant la confirmation par l'utilisateur. On signale un maximum de 6 caractères.

Exemple :

<do type="accept>
... action ...
</do>

On imagine comme exemple que l'utilisateur doit confirmer sur l'étiquette "Encore" pour accéder à la carte suivante.

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC " ...>
<wml>
<card id="ct1" title="Carte 1">
<do type="accept" label="Encore">
<go href="#ct2"/>
</do>
<p>
Faire <i> Encore </i>
pour aller à la page suivante.
</p>
</card>
<card id="ct2" title="Carte 2">
<p>
Vous voici comme promis
à la page suivante.
</p>
</card>
</wml>

L'événement (<do>) est ici la confirmation sur Encore par l'utilisateur pour passer à la carte suivante.


 

La balise <timer/>

Cette balise permet la mise en place d'un minuterie. Arrivé à la fin du compte à rebours, une action sera déclenchée.

Les attributs sont :

name="variable" Nom de la variable à laquelle est affectée la durée restante du compte à rebours.
value="x " Où x est la durée totale, exprimée en 1/10ème de seconde à partir de laquelle commencera le compte à rebours. Obligatoire !

Exemple :

<timer value="100"/> : Un compte à rebours de 10 secondes débute.


   

Simulations d'après Nokia Wap Toolkit