Actions sur les blocsDifférentes actions peuvent servir à ouvrir/fermer ou montrer/masquer un bloc (<bloc>, <toc>, <formulaire>, <valves>...), pour autant que ce bloc possède une ancre donnée par un attribut ancre="xxx". Ces actions sont: ouvrirFermer:xxx | pour alternativement ouvrir et fermer le bloc | ouvrir:xxx | pour ouvrir le bloc (rien ne se passe s'il est déjà ouvert) | fermer:xxx | pour fermer le bloc (rien ne se passe s'il est déjà fermé) | montrerMasquer:xxx | pour alternativement montrer et masquer le bloc | montrer:xxx | pour montrer le bloc (rien ne se passe s'il est déjà visible) | masquer:xxx | pour masquer le bloc (rien ne se passe s'il est déjà masqué) |
Dans le cas où l'action est déclenchée par un lien hypertexte et si cette action porte sur le bloc qui contient ce lien hypertexte, il n'est pas nécessaire de mentionner le bloc à l'aide d'une ancre. On peut alors utiliser les actions suivantes: ouvrirFermer | pour alternativement ouvrir et fermer le bloc qui contient le lien | ouvrir | pour ouvrir le bloc qui contient le lien (rien ne se passe s'il est déjà ouvert) | fermer | pour fermer le bloc qui contient le lien (rien ne se passe s'il est déjà fermé) | montrerMasquer | pour alternativement montrer et masquer le bloc qui contient le lien | montrer | pour montrer le bloc qui contient le lien (rien ne se passe s'il est déjà ouvert) | masquer | pour masquer le bloc qui contient le lien (rien ne se passe s'il est déjà masqué) |
Actions sur les optionsDifférentes actions peuvent servir à activer/désactiver une option (utilisée à son tour notamment pour afficher/masquer une section). Ces actions sont: activer:xxx | pour activer l'option xxx | désactiver:xxx | pour désactiver l'option xxx | inverser:xxx | pour inverser l'option xxx (c'est-à-dire l'activer si elle était désactivée ou inexistante, ou la désactiver si elle était activée) |
Actions sur les formulairesLes actions suivantes permettent d'interagir avec un formulaire, pour autant que ce formulaire possède une ancre donnée par un attribut ancre="xxx". Actions sur le formulaire completrecharger:xxxx | Recharge le formulaire dont l'ancre est xxxx: tous les champs seront réinitialisés et modifiés en reprenant leur valeur par défaut (celle utilisée lors du chargement de la page ou celle précédemment sauvée par une action sauver) | initialiser:xxxx | Réinitialise le formulaire dont l'ancre est xxxx: tous les champs garderont le même contenu, mais les messages d'erreur affichés lors d'une précédente validation éventuelles seront effacés (voir action activer) | formater:xxxx | Formate le formulaire dont l'ancre est xxxx: tous les champs seront reformatés en tenant compte des contrôles imposés (supprimer les espaces, mettre en majuscules, en minuscules...). Ne procède pas à la validation des champs | valider:xxxx | Valide le formulaire dont l'ancre est xxxx: tous les champs seront d'abord formatés puis validés. Si une erreur est découverte par rapport aux contrôles imposés (champ obligatoire, format imposé, valeur minimale, valeur maximale...), le libellé du champ sera écrit en rouge et un message d'erreur sera affiché | sauver:xxxx | Sauve le formulaire dont l'ancre est xxxx: la valeur par défaut de tous les champs sera remplacée par celle qui est affichée dans le formulaire. L'action recharger, si elle est utilisée, récupèrera cette valeur plutôt que celle qui était affichée lors du chargement de la page | envoyer:xxxx | envoie le contenu du formulaire dont l'ancre est xxxx: tous les champs seront d'abord formatés, puis validés. Si aucune erreur n'est rencontrée, l'action ou le groupe d'actions qui ne possède pas d'ancre sera déclenché. Ces actions vont généralement procéder à l'envoi du contenu du formulaire à une application Cette action va s'exécuter de manière asynchrone | envoyer:xxxx:yyyy | envoie le contenu du formulaire dont l'ancre est xxxx: tous les champs seront d'abord formatés, puis validés. Si aucune erreur n'est rencontrée, l'action ou le groupe d'actions possédant l'ancre yyyy sera déclenché. Ces actions vont généralement procéder à l'envoi du contenu du formulaire à une application Cette action va s'exécuter de manière asynchrone |
Dans le cas où les actions sont définies à l'intérieur du formulaire (par exemple dans un lien présent quelque part entre les balises <formulaire> et </formulaire>), il n'est pas nécessaire de mentionner l'ancre du formulaire. Les actions précédentes peuvent alors s'écrire: recharger | Recharge le formulaire courant: tous les champs seront réinitialisés et modifiés en reprenant leur valeur par défaut (celle utilisée lors du chargement de la page ou celle précédemment sauvée par une action sauver) | initialiser | Réinitialise le formulaire courant: tous les champs garderont le même contenu, mais les messages d'erreur affichés lors d'une précédente validation éventuelle seront effacés (voir action valider) | formater | Formate le formulaire courant: tous les champs seront reformatés en tenant compte des contrôles imposés (supprimer les espaces, mettre en majuscules, en minuscules...). Ne procède pas à la validation des champs | valider | Valide le formulaire courant: tous les champs seront d'abord formatés puis validés. Si une erreur est découverte par rapport aux contrôles imposés (champ obligatoire, format imposé, valeur minimale, valeur maximale...), le libellé du champ sera écrit en rouge et un message d'erreur sera affiché | sauver | Sauve le formulaire courant: la valeur par défaut de tous les champs sera remplacée par celle qui est affichée dans le formulaire. L'action recharger, si elle est utilisée, récupèrera cette valeur plutôt que celle qui était affichée lors du chargement de la page | envoyer | Envoie le contenu du formulaire courant: tous les champs seront d'abord formatés, puis validés. Si aucune erreur n'est rencontrée, l'action ou le groupe d'actions ne possédant pas d'ancre sera déclenché. Ces actions vont généralement procéder à l'envoi du contenu du formulaire à une application Cette action va s'exécuter de manière asynchrone | envoyer:yyyy | Envoie le contenu du formulaire courant: tous les champs seront d'abord formatés, puis validés. Si aucune erreur n'est rencontrée, l'action ou le groupe d'actions possédant l'ancre yyyy sera déclenché. Ces actions vont généralement procéder à l'envoi du contenu du formulaire à une application Cette action va s'exécuter de manière asynchrone |
Actions sur un champ en particulier du formulairerecharger:xxxx:yyyy | Dans le formulaire dont l'ancre est xxxx: le champ yyyy sera réinitialisé et modifié en reprenant sa valeur par défaut (celle utilisée lors du chargement de la page ou celle précédemment sauvée par une action sauver) | initialiser:xxxx:yyyy | Dans le formulaire dont l'ancre est xxxx: le champ yyyy gardera le même contenu mais le message d'erreur affiché lors d'une précédente validation éventuelle sera effacé (voir action valider) |
initialiser:xxxx:yyyy/libellé
initialiser:xxxx:yyyy/erreur
| Deux variantes de l'action initialiser:xxxx:yyyy:
/libellé ne supprimera que la couleur du libellé (le message d'erreur reste inchangé)
/erreur ne supprimera que le message d'erreur (le libellé reste inchangé)
| formater:xxxx:yyyy | Dans le formulaire dont l'ancre est xxxx: le champ yyyy sera reformaté en tenant compte des contrôles imposés (supprimer les espaces, mettre en majuscules, en minuscules...). Ne procède pas à la validation du champ | valider:xxxx:yyyy | Dans le formulaire dont l'ancre est xxxx: formate puis valide le champ yyyy. Si une erreur est découverte par rapport aux contrôles imposés (champ obligatoire, format imposé, valeur minimale, valeur maximale...), le libellé du champ sera écrit en rouge et un message d'erreur sera affiché Cette action active une condition qui pourra être testée avec l'action si (true si le champ est validé, false si le champ n'est pas validé |
valider:xxxx:yyyy/libellé
valider:xxxx:yyyy/erreur
valider:xxxx:yyyy/aucun
| Trois variantes de l'action valider:xxxx:yyyy:
/libellé ne changera que la couleur du libellé (pas de message d'erreur affiché)
/erreur n'affichera que l'erreur (la couleur du libellé sera inchangée)
/aucun ne changera ni la couleur du label ni le message d'erreur | sauver:xxxx:yyyy | Dans le formulaire dont l'ancre est xxxx: sauve le contenu du champ yyyy. Sa valeur par défaut sera remplacée par celle qui est affichée dans le formulaire. L'action recharger, si elle est utilisée, récupèrera cette valeur plutôt que celle qui était affichée lors du chargement de la page | modifier:xxxx:yyyy=valeur | Dans le formulaire dont l'ancre est xxxx: modifie le champ yyyy avec la valeur mentionnée (la valeur yyyy est le nom du paramètre associé au champ). Si la valeur contient (ou est susceptible de contenir) une virgule, la valeur doit être encodée au format URL (URL encoding: il faut remplacer la , par %2C) | remplacer:xxxx:yyyy=valeur | Dans le formulaire dont l'ancre est xxxx: idem que modifier:xxxx:yyyy=valeur mais remplace également la valeur par défaut. L'action recharger, si elle est utilisée, récupèrera cette valeur plutôt que celle qui était affichée lors du chargement de la page |
Dans le cas où les actions sont définies à l'intérieur du formulaire (par exemple dans un lien présent quelque part entre les balises <formulaire> et </formulaire>), il n'est pas nécessaire de mentionner l'ancre du formulaire. Les actions précédentes peuvent alors s'écrire: recharger:yyyy | dans le formulaire courant: le champ yyyy sera réinitialisé et modifié en reprenant sa valeur par défaut (celle utilisée lors du chargement de la page ou celle précédemment sauvée par une action sauver) | initialiser:yyyy | dans le formulaire courant: le champ yyyy gardera le même contenu mais le message d'erreur affiché lors d'une précédente validation éventuelle sera effacé (voir action valider) | formater:yyyy | dans le formulaire courant: le champ yyyy sera reformaté en tenant compte des contrôles imposés (supprimer les espaces, mettre en majuscules, en minuscules...). Ne procède pas à la validation du champ | valider:yyyy | dans le formulaire courant: formate puis valide le champ yyyy. Si une erreur est découverte par rapport aux contrôles imposés (champ obligatoire, format imposé, valeur minimale, valeur maximale...), le libellé du champ sera écrit en rouge et un message d'erreur sera affiché | sauver:yyyy | dans le formulaire courant: sauve le contenu du champ yyyy. Sa valeur par défaut sera remplacée par celle qui est affichée dans le formulaire. L'action recharger, si elle est utilisée, récupèrera cette valeur plutôt que celle qui était affichée lors du chargement de la page | modifier:yyyy=valeur | Dans le formulaire courant: modifie le champ yyyy avec la valeur mentionnée (la valeur yyyy est le nom du paramètre associé au champ). Si la valeur contient (ou est susceptible de contenir) une virgule, la valeur doit être encodée au format URL (URL encoding: il faut remplacer la , par %2C) | remplacer:yyyy=valeur | Dans le formulaire courant: idem que modifier:yyyy=valeur mais remplace également la valeur par défaut. L'action recharger, si elle est utilisée, récupèrera cette valeur plutôt que celle qui était affichée lors du chargement de la page |
Actions sur les présentationsUne action peut servir à afficher un onglet particulier dans une présentation: présentation:xxxx | pour afficher un onglet xxxx dans la première présentation ou xxxx est trouvé (xxxx peut être soit l'ancre associée à cet onglet, soit une position en comptant à partir de 1) | présentation:yyyy:xxxx | pour afficher un onglet xxxx dans la présentation possédant une ancre yyyy (xxxx peut être soit l'ancre associée à cet onglet, soit une position en comptant à partir de 1) | présentation:yyyy:suivant | pour afficher l'onglet suivant dans la présentation possédant une ancre yyyy | présentation:yyyy:précédent | pour afficher l'onglet précédent dans la présentation possédant une ancre yyyy | suspendre:yyyy | pour suspendre le déroulement automatique de la présentation possédant une ancre yyyy | redémarrer:yyyy | pour redémarrer le déroulement automatique de la présentation possédant une ancre yyyy |
Actions sur les fenêtres popupL'action suivante permet d'afficher une fenêtre popup: popup:xxxx | pour afficher la fenêtre popup dont l'identificateur est xxxx |
Actions sur les valvesLes actions suivantes permettent de gérer les informations dans une valve (actualités, publications, évènements...): recharger:xxxx | pour recharger le contenu de la valve à partir de la version stockée sur le serveur Cette action va s'exécuter de manière asynchrone. | reconstruire:xxxx | pour reconstruire le contenu de la valve directement à partir des sources (bcp plus lent) Cette action va s'exécuter de manière asynchrone. |
Actions sur la connexion IntranetLes actions suivante permettent d'interagir avec l'Intranet de l'ULB: intranet:login | pour se connecter à l'Intranet de l'ULB et revenir ensuite à la page courante | intranet:logout | pour se déconnecter de l'Intranet et revenir ensuite à la page courante | intranet:statut | pour afficher son statut et revenir ensuite à la page courante |
Attention, prenez garde au fait que ces trois actions amène l'utilisateur sur une page de l'application Intranet, en quittant la page courante. Si cette action est suivie d'autres actions, ces dernières seront ignorées.
Actions sur un ensemble de paramètresLorsque les actions sont éxécutées à partir d'un élément <interaction> et que celui-ci possède un attribut set="xxxx", un ensemble de paramètres sera créé (un paramètre yyyy sera désigné par le code {xxxx:yyyy}). ajouter:nom=valeur | Ajoute le paramètre nom=valeur. Si la valeur contient (ou est susceptible de contenir) une virgule, la valeur doit être encodée au format URL (URL encoding: il faut remplacer la , par %2C) | finaliser | Finalise la création de l'ensemble de paramètres xxxx et permet son utilisation au sein de la page. Si les actions contenue dans l'élément <interaction> se terminent, l'ensemble de paramètres est automatiquement finalisé (cette action est donc inutile la plupart du temps) |
Il est également possible de créer un nouvel ensemble de paramètres à l'aide d'une action, ou d'aller ajouter des paramètres dans celui d'un autre élément <interaction> grâce aux actions suivantes: créer:xxxx | Crée un nouvel ensemble de paramètres xxxx | ajouter:xxxx:nom=valeur | Ajoute à l'ensemble de paramètres xxxx un paramètre nom=valeur (il s'utilisera, après que l'ensemble de champs paramétrable sera finalisé, en écrivant {xxxx:XXXnom}) | finaliser:xxxx | Finalise la création de l'ensemble de paramètres xxxx et permet son utilisation au sein de la page |
Actions pour interagir avec l'utilisateurLes actions qui suivent permettent d'afficher un message à l'utilisateur ou de lui demander une confirmation avant de poursuivre l'exécution des actions: alerte(texte) | Ouvre une boîte de dialogue (prompt) et affiche le texte mentionné. Les actions reprendront leur cours normal après la fermeture de cette boîte de dialogue | confirmation(texte) | Ouvre une boîte de dialogue (prompt) affichant le texte mentionné et deux boutons [ok] et [annuler]. Le choix de l'utilisateur, ok ou annuler, peut être testé avec une action si (true si ok, false si annuler). |
Actions sur le déroulement des actionsLorsqu'on déclenche un ensemble d'actions (en cliquant sur un lien hypertexte cible, par exemple), ces actions vont normalement s'exécuter les unes après les autres, sans délai entre-elles. Tout se termine après l'exécution de la dernière action de la liste. Dans le cas d'un élément <interaction> ou d'un <formulaire>, plusieurs groupes d'actions peuvent s'enchaîner: le groupe d'actions éventuel défini avec exécuter="avant" le groupe d'actions éventuel provenant d'une application distante le groupe d'actions éventuel défini avec exécuter="après"
A chaque fois, les actions se dérouleront les unes après les autres, en respectant l'ordre des groupes et l'ordre des actions au sein de ces groupes. On peut modifier cet ordre d'exécution à l'aide des actions suivantes: terminer | Stoppe le déroulement des actions, sans erreur. Les actions qui suivent (dans le même groupe ou dans les groupes qui suivent) ne seront pas exécutées. Si un ensemble de paramètres est associé, finalise la création de cet ensemble. | arrêter | Stoppe le déroulement des actions, en indiquant une erreur. Les actions qui suivent (dans le même groupe ou dans les groupes qui suivent) ne seront pas exécutées. Ne finalise pas la création de l'ensemble de paramètres associé, s'il existe. | fin vers-fin | N'exécute pas les actions qui suivent dans le même groupe et continue l'exécution à la première action du groupe suivant (s'il existe). | suspendre | Suspend le déroulement des actions. Celles-ci pourront être relancées (par un autre élément <interaction>, par exemple) à l'aide de redémarrer:xxxx, vers-début:xxxx ou vers-label:xxxx:yyyy | délai:xxxx | Stoppe le déroulement des actions durant xxxx milli-secondes, avant de poursuivre avec les actions suivantes | label:xxxx | N'exécute aucune action. Elle permet simplement de placer un label xxxx à un certain endroit dans la liste des actions afin d'être utilisé par une action vers-label (voir ci-après) | vers-label:xxxx | La prochaine action qui sera exécutée sera l'action qui se trouve après label:xxxx dans la liste des actions. Si ce label n'existe pas, le déroulement des actions se termine, en erreur (comme avec l'action arrêter) Le label sera recherché parmi toutes les actions de tous les groupes ("avant", dans l'application distante et "après"). | début vers-début | La prochaine action qui sera exécutée sera la première action du premier groupe d'actions qui existe ("avant", l'application distante ou "après"). Cette action permet d'exécuter une liste d'action en boucle |
si:xxxx:yyyy
si:xxxx
si::yyyy
| Teste une condition et oriente le déroulement des actions vers l'un ou l'autre label, ou exécute l'une ou l'autre actions en fonction de cette condition. La condition est déterminée par l'une des actions suivantes: confirmation, valider, ok, nok Si la condition est vrai (true), les actions continueront à se dérouler à partir du label xxxx. Dans le cas contraire (false) les actions continueront à se dérouler à partir du label yyyy. Si le label xxxx ou yyyy ne sont pas mentionnés, les actions continueront leur cours normalement (avec l'action suivante). Ces deux labels peuvent également être remplacés par: suivant: continue à l'action suivante début: continue à la première action (voir action début ou vers-début) vers-début: continue à la première action (voir action début ou vers-début) fin: continue à la première action du groupe suivant (voir action fin ou vers-fin) vers-fin: continue à la première action du groupe suivant (voir action fin ou vers-fin) terminer: stoppe le déroulement des actions et finalise l'ensemble de paramètres (voir action terminer) arrêter: stoppe le déroulement des actions (voir action arrêter) suspendre: suspend le déroulement des actions (voir action suspendre)
|
si(options):xxxx:yyyy
si(options):xxxx
si(options)::yyyy
| Idem que ci-dessus, mais la condition est donnée par un ensemble d'options, similaire à celle utilisée dans l'attribut options d'une section conditionnelle | ok | Initialise la condition à vrai. Cette condition peut ensuite être testée avec l'action si | nok | Initialise la condition à faux. Cette condition peut ensuite être testée avec l'action si | ok(options) | Initialise la condition à vrai si les options mentionnées entre les parenthèses sont vérifiées (la syntaxe est identique à celle utilisée dans l'attribut options dans une section conditionnelle). Cette condition peut ensuite être testée avec l'action si | nok(options) | Initialise la condition à faux si les options mentionnées entre les parenthèses sont vérifiées (la syntaxe est identique à celle utilisée dans l'attribut options dans une section conditionnelle). Cette condition peut ensuite être testée avec l'action si |
Un complément d'informations est donné dans cet exemple complet.
Actions sur le déroulement des actions d'un autre élément <interaction>Une action peut servir à déclencher et gérer les actions contenue dans n'importe quel autre élément <interaction>. Pour cela, il faut placer une ancre sur celui-ci et utiliser les actions suivantes: exécuter:xxxx | déclenche les actions définies dans l'élément <interaction> possédant l'ancre xxxx Cette action va s'exécuter de manière asynchrone. | arrêter:xxxx | Stoppe le déroulement des actions éventuellement déclenchées via un élément <interaction> ayant xxxx comme ancre. Celles-ci ne pourront plus être relancées (sauf en réactivant l'élément <interaction>) | suspendre:xxxx | Suspend le déroulement des actions éventuellement déclenchées via un élément <interaction> ayant xxxx comme ancre. Celles-ci pourront être relancées (par un autre élément <interaction>, par exemple) à l'aide de redémarrer:xxxx, vers-début:xxxx ou vers-label:xxxx:yyyy | redémarrer:xxxx | Relance le déroulement des actions déclenchées via un élément <interaction> ayant xxxx comme ancre à l'endroit où elles avaient été arrêtée (voir suspendre:xxxx) Cette action va s'exécuter de manière asynchrone. | vers-début:xxxx | Si les actions d'un élément <interaction> ayant xxxx comme ancre sont déclenchées, La prochaine action qui sera exécutée sera la première action de la liste des actions définies par cet élément (elle sera exécutée après l'action en cours) Cette action va s'exécuter de manière asynchrone. | vers-label:xxxx:yyyy | Si les actions d'un élément <interaction> ayant xxxx comme ancre sont déclenchées, La prochaine action qui sera exécutée sera la première action qui suit le label donné par label:yyyy (elle sera exécutée après l'action en cours) Cette action va s'exécuter de manière asynchrone. |
Un complément d'informations est donné dans cet exemple complet.
Actions en javascriptLes actions suivantes permettent d'exécuter du code javascript: javascript:code | pour executer du code javascript Cette action va s'exécuter de manière asynchrone. | javascript:{code} | pour executer du code javascript (les accolades seront supprimées dans le code à exécuter) Cette action va s'exécuter de manière asynchrone. |
Par défaut, le javascript n'est pas autorisé dans les projets de Sitemanager. Si tel est le cas, les actions ci-dessus génèreront un message d'erreur. Cette autorisation est à demander à la Cellule web, à condition que votre demande soit motivée et fondée. La virgule est normalement utilisée pour séparer deux options. Si votre code Javascript contient lui-même une virgule, il faut que celle-ci soit correctement entourée d'une paire de parenthèses '(' et ')', d'accolades '{' et '}' ou de crochets '[' et ']'. Prenez donc soin de correctement fermer ces paires de caractères. Par exemple: Dans cet exemple, deux actions seront exécutées: l'appel à la fonction startAnim('bloc1',0); (la virgule placée entre les deux parenthèses fera partie du code Javascript); montrer:bloc1 pour afficher le bloc bloc1 (la virgule, juste avant le mot montrer (qui n'est pas placée entre deux parenthèses, accolades ou crochets) sert à séparer les deux actions).
Actions sur une balise <html>Les actions suivantes servent à contrôler l'affichage et le contenu d'une balise <html>: montrerMasquer:xxx | pour alternativement montrer et masquer le contenu de la balise html; | montrer:xxx | pour montrer le contenu de la balise html | masquer:xxx | pour masquer le contenu de la balise html | effacer:xxx | pour effacer le contenu de la balise html | html:xxx:yyy | pour remplacer le contenu de la balise html par le contenu se trouvant à l'URL yyy (ce contenu est récupérer en utilisant une connexion AJAX) Cette action va s'exécuter de manière asynchrone. |
Le code html n'est pas autorisé par défaut dans les projets de Sitemanager. Si tel est le cas, les actions ci-dessus génèreront un message d'erreur. Pour pouvoir les utiliser, contactez la Cellule web. Si votre demande est fondée, elle activera le code html (et l'utilisation de la balise <html>) dans certaines de vos pages. Si les actions sont déclenchées à partir d'un attribut cible placé sur un lien hypertexte, et si ce lien possède un attribut hypertexte autre que cible (href, docref...), alors le contenu récupéré en suivant le lien est récupéré en AJAX pourra venir remplacer le contenu d'une balise <html>, à l'aide de l'action suivante: html:xxxx | pour se connecter en ajax à l'URL donnée par un lien hypertexte, récupérer le contenu renvoyé par cette URL et venir le placer dans la balise <html ancre="xxxx">...</html>; Cette action va s'exécuter de manière asynchrone. |
|