Éléments
Chaque propriété peut être fixe ou calculée avec une liaison {{ … }}. Chaque élément a aussi Visible si (une liaison ; vide = toujours).
| Élément | Propriétés | Événement |
|---|---|---|
| Titre | texte, niveau 1–4, alignement | – |
| Texte | texte, markdown, atténué, alignement | – |
| Séparateur | libellé (facultatif), alignement du libellé, ligne (continue, tirets, pointillés), vertical | – |
| Espace | – (seulement de la place vide dans la grille) | – |
| HTML | HTML avec espaces réservés {{ … }}, éventuellement une requête et des paramètres (alors record et records), en carte |
– |
| Image | adresse de l’image (URL), texte alternatif, ajustement, coins arrondis | – |
| Bouton | libellé, style (primary, secondary, danger, ghost), alignement, pleine largeur, désactivé si | clic |
| Saisie | libellé, nom, type (texte, nombre, e-mail, téléphone, URL, mot de passe, multiligne), texte indicatif, valeur de départ, obligatoire, désactivé si, aide | modification |
| Liste déroulante | libellé, nom, options (une par ligne) ou une requête avec champ valeur et champ libellé, texte indicatif, valeur de départ, obligatoire | modification |
| Date | libellé, nom, avec l’heure, valeur de départ, obligatoire | modification |
| Case à cocher | libellé, nom, valeur de départ | modification |
| Interrupteur | libellé, nom, valeur de départ ; comme une case à cocher (oui/non), affiché en bascule | Modification |
| Options | libellé, nom, options ou une requête avec champ de valeur et de libellé, côte à côte, valeur de départ, obligatoire – exactement un choix | Modification |
| Choix multiple | comme Options, mais autant que l’on veut ; la valeur est une liste | Modification |
| Curseur | libellé, nom, minimum, maximum, pas, unité, valeur de départ ; la valeur est un nombre | Modification |
| Évaluation | libellé, nom, maximum (5 étoiles), valeur de départ ; un clic sur l’étoile actuelle l’efface, Flèche gauche/droite la modifie | Modification |
| Sélection avec recherche | libellé, nom, requête, paramètres, paramètre de recherche (par défaut q), champ de valeur et de libellé, libellé affiché, texte indicatif, obligatoire |
Modification |
| Fichier | libellé, nom, types autorisés (p. ex. image/*,.pdf), plusieurs fichiers, obligatoire, désactivé si, aide ; se place dans un formulaire |
Modification |
| Formulaire | titre, texte du bouton, vider après l’envoi ; contient des saisies | envoi |
| Tableau | titre, requête, paramètres, colonnes (champ, libellé, format), lignes par page, triable, texte si vide | sélection |
| Vue détaillée | titre, enregistrement (liaison, p. ex. {{el.leadsTable.selected}}) ou une requête avec paramètres, champs (champ, libellé, format ; vide = tous), colonnes (1–4), masquer les champs vides, texte si vide |
– |
| Liste | requête, paramètres, titre/texte/badge par entrée, colonnes 1–4, maximum, texte si vide | sélection |
| Graphique | titre, requête, paramètres, type (colonnes, barres horizontales, ligne, aire, secteurs, anneau), champs libellé, valeur et série, regrouper (par enregistrement, nombre, somme, moyenne), empilé, format des valeurs (nombre, devise, pourcentage, heures) | Sélection |
| Indicateur | titre, valeur (liaison) ou une requête avec champ de valeur et agrégation (premier enregistrement, nombre, somme, moyenne, minimum, maximum), format (nombre, devise, pourcentage, heures), décimales, unité, sous-titre, comparer avec (affiche la variation en % avec une flèche), texte de comparaison, une hausse est bonne/mauvaise, icône | Clic |
| Calendrier | titre, requête, paramètres, champs de début, de fin (facultatif), de titre et de couleur (couleur d’étiquette comme blue ou #hex), vue mois/semaine |
Sélection, clic sur un jour |
| Carte | titre, requête, paramètres, type (points, zones), champ latitude/longitude, titre/texte par point, champ de couleur, regrouper les points proches, champ de zone, champ de valeur, agréger, format, fond de carte, centre, zoom | sélection |
| Kanban | titre, requête, paramètres, champ des colonnes, colonnes (ordre ; vide = comme dans les données), titre/texte/badge par carte, champ de somme et format, texte si vide | Sélection, Déplacer |
| Galerie | titre, requête, paramètres, champ d’image (colonne de pièces jointes ou adresse d’image), titre/texte/badge par vignette, colonnes 2–6, format (paysage, carré, portrait), ajustement, texte si vide | Sélection |
| Badge | texte, couleur (couleur d’étiquette ; vide = selon le texte), alignement | – |
| Progression | libellé, valeur, maximum (100), masquer la valeur, texte de la valeur, couleur (vide = accent, ok, warn, danger – aussi en liaison) |
– |
| Conteneur | titre, style (carte, simple) ; grille propre | – |
| Onglets | onglets avec libellés ; une grille par onglet | – |
| Dialogue | titre, taille ; affiché avec l’étape Ouvrir un dialogue | – |
Champ (saisie, sélection, date, case à cocher) : la colonne dont Remplir le formulaire prend la valeur quand le nom de l’élément diffère (p. ex. nom due_date, champ due date).
Indicateur : pourcentage attend une valeur déjà en pour cent (42 → « 42 % »). Comparer avec est généralement une liaison vers la valeur précédente, p. ex. {{query.kpis.data.hoursPrev}} ; la variation s’affiche en vert lorsqu’elle va dans le bon sens (pour des coûts ou des impayés, choisir une hausse est mauvaise).
Graphique : le champ de série répartit les valeurs selon une deuxième colonne – colonnes et barres se placent alors côte à côte (ou les unes sur les autres avec empilé), chaque série reçoit sa propre ligne ou aire ; secteurs et anneau ne l’utilisent pas. Une série prend la couleur d’accent de l’app, plusieurs séries et les secteurs reçoivent jusqu’à huit couleurs fixes, distinguables aussi en cas de daltonisme (les suivantes passent dans « Autres »), toujours avec une légende – avec valeur et part pour les secteurs. Chaque colonne, point et secteur affiche ses valeurs au survol. Sélection s’exécute au clic, avec point = {label, series, value} – p. ex. Ouvrir la page avec le paramètre stage = {{point.label}} ; sur la page cible, {{url.stage}} lit la valeur.
Téléchargement CSV (tableaux, listes, graphiques ; désactivé tant qu’on ne l’active pas) : un bouton CSV en haut à droite de l’élément. Tableaux et listes chargent pour cela tous les enregistrements de leur requête (pas seulement la page affichée, dans le tri actuel), les tableaux avec leurs colonnes et titres, les listes avec tous les champs ; un graphique fournit ce qu’il affiche (une ligne par libellé, une colonne par série, valeur et part pour les secteurs). Le fichier est en UTF-8 et suit la langue de l’interface : virgule comme séparateur si le séparateur décimal est le point (anglais), sinon point-virgule et virgule décimale – Excel l’ouvre ainsi directement. Les valeurs sont brutes (nombres sans séparateur de milliers, dates au format 2026-11-12) ; un texte qui commence comme une formule (=, +, -, @) reçoit une apostrophe devant. L’action Exporter en CSV crée le même fichier – même sans bouton sur l’élément.
Calendrier : mois ou semaine, avec navigation et Aujourd’hui ; les entrées sur plusieurs jours apparaissent chaque jour, au-delà de trois par jour « +n autres » ouvre la semaine. el.<id>.from et el.<id>.to sont la période visible (AAAA-MM-JJ) – en paramètres de la requête, elle ne charge que celle-ci. Sélection s’exécute au clic sur une entrée (avec item, aussi el.<id>.selected), clic sur un jour avec date (p. ex. Remplir le formulaire avec {"day": "{{date}}"} et ouvrir une fenêtre pour créer).
HTML : du HTML libre pour vos propres tuiles, notes ou cartes. Les espaces réservés sont échappés avant d’être insérés – une valeur contenant <b> s’affiche comme texte, pas comme balisage. Le HTML est ensuite nettoyé : pas de scripts, pas de gestionnaires d’événements (onclick …), pas de liens javascript:, pas de blocs <style>, de formulaires ni de cadres ; les styles en ligne (style="…"), les liens (aussi mailto:, tel:) et les images restent. Les liens avec target="_blank" s’ouvrent sans accès à l’app. Le navigateur n’affiche les images d’autres adresses que si les paramètres de sécurité les autorisent. Avec une requête, l’élément charge lui-même ses données : {{record.name}} est l’enregistrement (ou le premier), {{records}} la liste.
Fichier : Exécuter la requête avec une requête Téléverser un fichier envoie chaque fichier choisi du formulaire (ou du champ de fichier choisi dans l’action) à l’enregistrement, un par un – avec une autorisation d’écriture sur exactement cette table, jamais plus que ce que le compte peut déjà. La taille (50 Mo au plus par fichier) et les types autorisés dépendent aussi de la colonne de pièces jointes ; c’est le contenu qui est vérifié, pas l’extension. Un nouvel enregistrement avec fichier : d’abord Créer un enregistrement, puis Téléverser un fichier avec {{query.<créer>.record.id}} comme enregistrement. el.<id>.value est la liste des fichiers choisis ; Réinitialiser le formulaire la vide.
Kanban : une colonne par valeur du champ des colonnes, l’en-tête affiche le nombre et (avec un champ de somme) la somme. Les cartes se glissent dans une autre colonne à la souris ou au doigt ; au clavier, Flèche gauche/droite déplace la carte active, Entrée la sélectionne. Déplacer s’exécute avec item (la carte), lane (la colonne cible) et from – typiquement Exécuter la requête avec une requête de modification {"id": "{{item.id}}", "stage": "{{lane}}"} puis Recharger la requête. La carte apparaît tout de suite dans la nouvelle colonne ; si une action échoue, elle revient. Les nombres, montants et pourcentages seuls en badge s’affichent en gris neutre.
Galerie : si le champ d’image est une colonne de pièces jointes, la vignette affiche la première image en miniature ; sans événement Sélection propre, un clic ouvre l’image en grand (Échap ferme). Les images et fichiers des colonnes de pièces jointes passent par l’adresse propre de l’app (voir fileUrl dans Liaisons et actions) – aussi pour les utilisateurs d’apps et les apps publiques, qui ne peuvent pas utiliser l’API REST.
Sélection avec recherche : cherche pendant la saisie – la requête reçoit le texte dans son paramètre de recherche, p. ex. une liste avec le filtre name contient {{params.q}} (texte vide = tout). Pour les clés étrangères de grandes tables, là où une Liste déroulante deviendrait trop longue. Obligatoire signifie une entrée de la liste, pas seulement du texte. Quand Remplir le formulaire définit une valeur, le libellé affiché (p. ex. {{query.lead.record.client_name}}) montre son nom ; el.<id>.label est le libellé du choix. Choix multiple fournit une liste – comme paramètre de type quelconque.
Séparateur et espace structurent une page : un séparateur est une ligne, si besoin avec un petit titre (à gauche, au centre ou à droite) ou vertical entre deux colonnes. Un espace est de la place vide, par exemple pour garder un bouton à droite. Sur un téléphone, où tous les éléments s’empilent, les espaces et les séparateurs verticaux disparaissent ; les séparateurs horizontaux restent.
Carte
La carte affiche des enregistrements sous forme de points ou colore pays et régions selon une valeur.
- Points : champ latitude et longitude (par défaut
latitude/longitude, degrés décimaux). Titre et texte par point avec espaces réservés ({{item.name}}) apparaissent au survol. Le champ de couleur accepte une couleur d’étiquette (red, blue …),#hexou une catégorie (jusqu’à huit, avec légende). Les points proches sont regroupés en un nombre ; un clic zoome, et s’ils sont au même endroit une liste de choix apparaît. Événement sélection avecitem. - Zones : le champ de zone contient un code pays (ISO 3166 alpha-2 comme
DEou alpha-3 commeDEU), un code de région (ISO 3166-2 commeDE-BY) ou un nom de pays ; plus champ de valeur et agréger (somme, nombre, moyenne). Cinq nuances d’une couleur, une légende avec la plus petite et la plus grande valeur et une info-bulle avec nom et valeur. Événement sélection avecarea(code,name,value). - Cadrage : s’adapte aux données (pour les zones, à la métropole, sans territoires d’outre-mer) ; centre (
lat, lng) et zoom le fixent. Glisser déplace ; double clic, + / − et Ctrl + molette zooment – la molette seule seulement après un clic dans la carte, sinon la page défile ; ⤢ affiche à nouveau tout. Clavier : flèches, + / −, 0. Sur écran tactile, un glissement vertical fait défiler la page jusqu’à ce que vous touchiez la carte ; deux doigts zooment. - Fond de carte : intégré, issu de Natural Earth (domaine public) : pays, côtes et à partir du zoom 5 les limites des régions – sans requête externe, même sans internet. Il n’affiche ni rues ni lieux. Si un serveur de tuiles est configuré (Paramètres → Sécurité → Cartes), ses tuiles se trouvent dessous ; fond de carte : outline utilise quand même celui intégré.
- Les coordonnées à partir d’adresses (géocodage) ne sont pas intégrées – les données les apportent, par exemple via un script ou un workflow avec votre propre service.
Valeurs des éléments
- Saisie, liste déroulante, date, case à cocher :
el.<id>.value– p. ex.{{el.search.value}}comme paramètre d’une requête. - Formulaire :
el.<id>.values– nom de la saisie (ou son ID) → valeur. Lors de l’envoi, le même contenu est disponible en tant quevalues. - Tableau et liste :
el.<id>.selected– le dernier enregistrement sélectionné ; dans l’événement sélection en tant querow(tableau) ouitem(liste). - Onglets :
el.<id>.tab– l’ID de l’onglet ouvert.
Éléments de données
Les tableaux, listes, graphiques et listes déroulantes avec requête chargent leurs données eux-mêmes : dès qu’un paramètre change (un champ de recherche, par exemple), ils interrogent à nouveau peu après. Sans liste de colonnes, un tableau affiche tous les champs de la requête. Formats : date, date et heure, nombre, devise, oui/non, badge (la valeur en pastille colorée) et progression (0–100 en barre). Sans couleur propre, les états courants reçoivent une couleur parlante : Done, Paid, Won, Approved, Active en vert, Overdue, Lost, Urgent, Blocked en rouge, Review, Sent, Proposal, In progress, High en ambre, Qualified, Scheduled, Medium en bleu, New, Open, To do, Backlog, Draft, Low en gris ; toute autre valeur toujours la même couleur.
La vue détaillée affiche un enregistrement sous forme de liste de champs avec libellés – par exemple l’enregistrement sélectionné dans un tableau ou le résultat d’une requête Un enregistrement (pour une liste, sa première entrée). Les colonnes s’organisent d’elles-mêmes : sur les surfaces étroites, les champs s’empilent. En plus des formats du tableau, il existe ici Markdown (pour les textes longs, sur toute la largeur). Les valeurs vides apparaissent comme « – », ou pas du tout avec Masquer les champs vides.