Manuel · 8

É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 …), #hex ou 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 avec item.
  • Zones : le champ de zone contient un code pays (ISO 3166 alpha-2 comme DE ou alpha-3 comme DEU), un code de région (ISO 3166-2 comme DE-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 avec area (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 que values.
  • Tableau et liste : el.<id>.selected – le dernier enregistrement sélectionné ; dans l’événement sélection en tant que row (tableau) ou item (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.