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é.