Manuel · 8

Liaisons et actions

Liaisons

Chaque propriété peut contenir une liaison : {{ expression }}. Seule, elle garde le type du résultat (nombre, liste, oui/non) ; dans un texte, elle est insérée comme texte – p. ex. Bonjour {{user.email}} ou {{query.tasks.total}} tâches.

Les expressions sont un sous-ensemble sûr de JavaScript, sans eval : nombres, textes, true/false/null, listes […], objets {…}, a.b, a[b], a?.b, ! - + * / %, comparaisons, && || ??, condition ? a : b et appels des fonctions utilitaires et de quelques méthodes de texte/liste (toUpperCase, includes, slice, join …). Il n’y a ni window, ni fetch, ni fonctions personnelles.

Nom Contenu
state.<nom> variables de l’app (onglet App → Variables)
el.<id> valeurs des éléments (voir Éléments)
query.<nom> records, record, total, loading, error, data de la dernière exécution
url.<nom> paramètres dans l’adresse de la page
user id, email, role – null dans les apps publiques sans connexion
page, app page actuelle (id, name, path), app (name, slug)
row, item, values, value dans les événements : ligne sélectionnée, entrée, valeurs du formulaire, nouvelle valeur

Fonctions utilitaires : len, upper, lower, str, num, round(x, décimales), min, max, json, isEmpty, contains, first, pluck(liste, champ), sum(liste, champ), count, now, today, date, datetime, number(x, décimales), currency(x, 'EUR', décimales), fileUrl(requête, fichier, miniature) – l’adresse d’un fichier d’une colonne de pièces jointes (fichier = ID du fichier ou le champ de pièces jointes lui-même, miniature = l’aperçu), p. ex. <img src="{{fileUrl('references', item.cover, true)}}"> ou comme cible de Ouvrir le lien. La requête doit être une requête de lecture de l’app qui atteint la table du fichier – dates et nombres dans la langue de l’interface.

Dans l’aperçu du brouillon, une barre en haut liste les liaisons erronées.

Actions

Les événements (clic, envoi, sélection, modification, entrée de menu) exécutent des étapes l’une après l’autre. Chaque étape peut avoir une condition Seulement si. Si une requête échoue, la chaîne s’arrête avec un message.

Étape Paramètres
Exécuter la requête requête, paramètres, formulaire (ses valeurs comme paramètres)
Recharger la requête requête (avec les derniers paramètres)
Définir une variable nom, valeur
Ouvrir une page page, paramètres (dans l’adresse)
Ouvrir / fermer un dialogue dialogue
Afficher un message texte, type (info, ok, error)
Ouvrir un lien adresse (http(s), mailto, tel ou chemin), nouvel onglet
Vider le formulaire formulaire
Remplir le formulaire Formulaire, valeurs (objet nom → valeur, p. ex. {{query.record.record}}) ; chaque saisie prend la valeur de son nom ou de son champ
Exporter en CSV Élément (tableau, liste ou graphique de la page actuelle) ; télécharge ses données en CSV, comme le bouton CSV
Demander une confirmation Titre, texte, libellé du bouton, dangereux ; arrête la chaîne en cas d’annulation
Script instructions

Scripts

Un script est fait d’instructions séparées par des sauts de ligne ou ; : affectations à state.… et el.<id>.value (aussi +=, -=) et if (…) { … } else { … }. Il s’exécute dans le navigateur dans le même bac à sable que les liaisons. Exemple d’interrupteur :

state.onlyOpen = !state.onlyOpen
if (!state.onlyOpen) { el.search.value = '' }

Grand éditeur : l’icône ⤢ à côté de Script ouvre l’éditeur de code dans une grande fenêtre – avec coloration, numéros de ligne et vérification de la syntaxe pendant la saisie (l’erreur est soulignée à son emplacement, la ligne est indiquée en haut). Ctrl+Espace propose des noms : après state. les variables de l’app, après el. les éléments, après query. les requêtes, sinon les fonctions. Appliquer (ou Ctrl+S) reprend le script, Annuler abandonne les modifications. La même icône se trouve à côté du champ HTML de l’élément HTML : avec coloration HTML et complétion des balises ; les espaces réservés {{ … }} sont vérifiés et complétés (Ctrl+Espace dans {{ propose record, state., el., query. et les fonctions).

La logique qui a besoin de données d’autres tables ou de systèmes externes a sa place sur le serveur : dans un workflow ou un endpoint personnalisé.