Changes for doc/client.md: 2 added lines, 2 removed lines.
Original line number
Diff line number
Diff line
@@ -82,6 +82,6 @@ unicaenVue.axios.get(
});
```
Lorsqu'il reçoit une réponse du serveur, si cette dernière comporte des messages issus du flashMessenger, il va les afficher sous formes d'alertes.
Les alertes sont personnalisées selon qu'il s'agit de success, warning, info ou error. Elles sont affichées pendant 5 secondes, sauf les erreurs qu'il faut fermer
Lorsqu'il reçoit une réponse du serveur, si cette dernière comporte des messages issus du flashMessenger, il va les afficher sous formes de toasts.
Les toasts sont personnalisées selon qu'il s'agit de success, warning, info ou error. Ils sont affichés pendant 3 secondes, sauf les erreurs qu'il faut fermer
manuellement afin d'avoir le temps de lire le message et de le traiter.
Changes for doc/serveur.md: 85 added lines, 0 removed lines.
Original line number
Diff line number
Diff line
@@ -112,6 +112,11 @@ Ce dernier va :
- collecter les éventuels messages issus du `flashMessenger`
- convertir le tout en Json pour envoi au client
AxiosModel peut prendre en construction kjusqu'à 3 paramètres :
1. Les données en tant que telles
2. Les prioriétés (utiles seulement si on traite des objets et facultatives si on transmet des objets implémentant AxiosInterface)
3. Les triggers (si nécessaire). Vous trouverez [plus d'infos sur les triggers ici](#les-triggers).
Voici un exemple d'action de contrôleur qui envoie des données au client en mode Ajax vers Axios :
```php
@@ -133,6 +138,7 @@ use UnicaenVue\View\Model\AxiosModel;
$this->flashMessenger()->addSuccessMessage('Tout va bien!');
// Et on retourne un AxiosModel qui présente le tout au client
// Ici, nous traitons un tableau en entrée, donc pas besoin de préciser des propriétés à extraire et nous n'avons pas besoin de triggers
returnnewAxiosModel($contacts[$monId]);
// Si on exporte un objet ou un tableau d'objets, on peut aussi fournir une lisye de propriétés, cf. ExiosExtractor
@@ -361,6 +367,85 @@ var_dump($extracted);
// 'ville' => string 'Caen' (length=4)
```
#### Les triggers
Il est possible de transformer les données traitées via Axios au moyen de triggers.
Ce sera utile si, par exemple, on veut ajouter des propriétés à la volée à un objet qui n'en était pas pourvu ou si on veut modifier
après coup la valeur de certaines données.
Il s'agit d'un usage avancé du dispositif.
Les triggers sont un tableau de fonctions dont les clés sont les chemins qui vont permettre de déterminer sur quelles données nous
voudrons agir, et les valeurs sont des fonctions anonymes dotées de deux paramètres $original : les données originales, c'est-à-dire avant extractions et $extracted, c'est-à-dire le résultat extrait de l'original.
La fonction anonyme devra renvoyer un résultat qui remplacera $extracted dans l'arborescence finale.
Les chemins sont définis de la manière suivante :
* Si on a une liste d'objets, alors `'/'` permettra d'atteindre chaque occurence du tableau renvoyé.
* Si on y ajoute `[]`, ce qui donnera `'/[]'`, alors on pourra agir sur tout le tableau de données (à condition toutefois que ce soit bien une liste de données qu'on manipule).
* Si on veut accéder à des données plus en avant dans l'arborescence, alors on la parcourera avec des slashs `/``, comme des répertoires.
Exemple de chemin plus complexe : prenons la structure de données citée [ci-dessous](#depuis-doctrine).
Si nous voulons agir sur les créateurs des volumes horaires, il faudra utiliser le chemin suivant :
`/volumesHoraires/histoCreateur`.
Nous pourrons ainsi traiter les créateurs des volumes horaires, et pas les créateurs des missions.
Exemple d'utilisation des triggers :
Prenons la structure de données ci-dessus, à savoir une liste de personnes ayant une adresse.
Voici un exemple de trigger qui va ajouter l'âge aux personnes :