MallaDocs

Variables

L’état de la page et du site, lu par les liaisons et écrit par les workflows, conservé dans l’URL ou le navigateur.

Guide utilisateur

Les variables contiennent l’état d’une page ou d’un site entier : l’onglet actif, un terme de recherche, des filtres, un panier. Les liaisons les lisent sous la forme vars.name, et les workflows les modifient avec Set variable et Reset variable.

Créer une variable

Ouvrez l’espace de travail Data et ajoutez une variable, ou cliquez sur Create variable depuis une liaison. Choisissez un nom (en camelCase), un type et une valeur par défaut. Le type est string, number, boolean, object ou array.

Page ou site

  • Les variables de page existent sur une seule page et se réinitialisent quand le visiteur la quitte.
  • Les variables de site sont partagées par toutes les pages du site.
  • Si les deux portent le même nom, la variable de page l’emporte sur sa page.

Persistance

PersistConservée dansIdéal pour
nonela mémoire uniquementl’état de l’interface, comme un menu ouvert
urlla chaîne de requêteles recherches et filtres que l’on peut partager ou mettre en favori
locallocalStorageun panier ou des préférences qui survivent aux visites
sessionsessionStorageun état propre à l’onglet en cours
json
// A search variable kept in the URL (?search=…)
{ "name": "search", "type": "string", "default": "", "persist": "url" }

// A cart kept in localStorage across visits
{ "name": "cart", "type": "array", "default": [], "persist": "local" }

Valeurs imbriquées

Modifiez un seul champ d’une variable objet avec un chemin à points, comme filters.category. Les champs de saisie peuvent aussi se lier dans les deux sens à un chemin : vars.filters.category.

Ensuite : alimentez des requêtes avec des variables pour que les données se rechargent quand elles changent.