Elementi
Ogni proprietà può essere fissa o calcolata con un binding {{ … }}. Ogni elemento ha inoltre Visibile se (un binding; vuoto = sempre).
| Elemento | Proprietà | Evento |
|---|---|---|
| Titolo | testo, livello 1–4, allineamento | – |
| Testo | testo, markdown, attenuato, allineamento | – |
| Separatore | etichetta (facoltativa), allineamento dell’etichetta, linea (continua, tratteggiata, punteggiata), verticale | – |
| Spazio | – (solo spazio vuoto nella griglia) | – |
| HTML | HTML con segnaposto {{ … }}, facoltativamente una query e parametri (allora record e records), come scheda |
– |
| Immagine | indirizzo immagine (URL), testo alternativo, adattamento, angoli arrotondati | – |
| Pulsante | etichetta, stile (primary, secondary, danger, ghost), allineamento, larghezza piena, disattivato se | clic |
| Campo | etichetta, nome, tipo (testo, numero, e-mail, telefono, URL, password, multiriga), segnaposto, valore iniziale, obbligatorio, disattivato se, aiuto | modifica |
| Selezione | etichetta, nome, opzioni (una per riga) oppure una query con campo valore e campo etichetta, segnaposto, valore iniziale, obbligatorio | modifica |
| Data | etichetta, nome, con ora, valore iniziale, obbligatorio | modifica |
| Casella | etichetta, nome, valore iniziale | modifica |
| Interruttore | etichetta, nome, valore iniziale; come una casella (sì/no), mostrato come levetta | Modifica |
| Opzioni | etichetta, nome, opzioni oppure una query con campo valore ed etichetta, affiancate, valore iniziale, obbligatorio – esattamente una scelta | Modifica |
| Scelta multipla | come Opzioni, ma quante se ne vuole; il valore è un elenco | Modifica |
| Cursore | etichetta, nome, minimo, massimo, passo, unità, valore iniziale; il valore è un numero | Modifica |
| Valutazione | etichetta, nome, massimo (5 stelle), valore iniziale; un clic sulla stella attuale la azzera, Freccia sinistra/destra la cambia | Modifica |
| Selezione con ricerca | etichetta, nome, query, parametri, parametro di ricerca (predefinito q), campo valore ed etichetta, etichetta mostrata, segnaposto, obbligatorio |
Modifica |
| File | etichetta, nome, tipi consentiti (ad es. image/*,.pdf), più file, obbligatorio, disattivato se, testo di aiuto; sta in un modulo |
Modifica |
| Modulo | titolo, testo pulsante, svuota dopo l’invio; contiene campi | invio |
| Tabella | titolo, query, parametri, colonne (campo, etichetta, formato), righe per pagina, ordinabile, testo se vuota | selezione |
| Vista dettaglio | titolo, record (binding, ad es. {{el.leadsTable.selected}}) oppure una query con parametri, campi (campo, etichetta, formato; vuoto = tutti), colonne (1–4), nascondi i campi vuoti, testo se vuota |
– |
| Elenco | query, parametri, titolo/testo/badge per voce, colonne 1–4, massimo, testo se vuoto | selezione |
| Grafico | titolo, query, parametri, tipo (colonne, barre orizzontali, linea, area, torta, anello), campi etichetta, valore e serie, raggruppa (per record, conteggio, somma, media), in pila, formato dei valori (numero, valuta, percentuale, ore) | Selezione |
| Indicatore | titolo, valore (binding) oppure una query con campo valore e aggregazione (primo record, numero, somma, media, minimo, massimo), formato (numero, valuta, percentuale, ore), decimali, unità, sottotitolo, confronta con (mostra la variazione in % con una freccia), testo del confronto, in aumento è positivo/negativo, icona | Clic |
| Calendario | titolo, query, parametri, campi inizio, fine (facoltativo), titolo e colore (colore etichetta come blue o #hex), vista mese/settimana |
Selezione, clic su un giorno |
| Mappa | titolo, query, parametri, tipo (punti, aree), campo latitudine/longitudine, titolo/testo per punto, campo colore, raggruppa i punti vicini, campo area, campo valore, aggrega, formato, mappa di base, centro, zoom | selezione |
| Kanban | titolo, query, parametri, campo colonne, colonne (ordine; vuoto = come nei dati), titolo/testo/badge per scheda, campo somma e formato, testo se vuoto | Selezione, Sposta |
| Galleria | titolo, query, parametri, campo immagine (colonna allegati o indirizzo immagine), titolo/testo/badge per riquadro, colonne 2–6, proporzioni (orizzontale, quadrato, verticale), adattamento, testo se vuoto | Selezione |
| Badge | testo, colore (colore etichetta; vuoto = in base al testo), allineamento | – |
| Avanzamento | etichetta, valore, massimo (100), nascondi valore, testo del valore, colore (vuoto = accento, ok, warn, danger – anche come binding) |
– |
| Contenitore | titolo, stile (scheda, semplice); griglia propria | – |
| Schede | schede con etichette; una griglia per scheda | – |
| Finestra | titolo, dimensione; mostrata con il passo Apri finestra | – |
Campo (input, selezione, data, casella): la colonna da cui Compila modulo prende il valore quando il nome dell’elemento è diverso (p. es. nome due_date, campo due date).
Indicatore: percentuale si aspetta il valore già in percentuale (42 → «42 %»). Confronta con è di solito un binding al valore precedente, ad es. {{query.kpis.data.hoursPrev}}; la variazione appare in verde quando va nella direzione giusta (per costi o insoluti scegli in aumento è negativo).
Grafico: il campo serie suddivide i valori secondo una seconda colonna – colonne e barre stanno allora affiancate (o una sopra l’altra con in pila), ogni serie ha la propria linea o area; torta e anello non lo usano. Una serie prende il colore d’accento dell’app, più serie e le fette ricevono fino a otto colori fissi, distinguibili anche con deficit nella visione dei colori (le successive finiscono in «Altro»), sempre con una legenda – con valore e quota per la torta. Ogni colonna, punto e fetta mostra i valori al passaggio del mouse. Selezione scatta al clic, con point = {label, series, value} – ad es. Apri pagina con il parametro stage = {{point.label}}; nella pagina di destinazione {{url.stage}} legge il valore.
Download CSV (tabelle, elenchi, grafici; disattivato finché non lo attivi): un pulsante CSV in alto a destra dell’elemento. Tabelle ed elenchi caricano tutti i record della loro query (non solo la pagina mostrata, nell’ordinamento attuale), le tabelle con colonne e intestazioni, gli elenchi con tutti i campi; un grafico fornisce ciò che mostra (una riga per etichetta, una colonna per serie, valore e quota per la torta). Il file è UTF-8 e segue la lingua dell’interfaccia: virgola come separatore se il separatore decimale è il punto (inglese), altrimenti punto e virgola e virgola decimale – così Excel lo apre direttamente. I valori sono grezzi (numeri senza separatore delle migliaia, date come 2026-11-12); un testo che inizia come una formula (=, +, -, @) riceve un apostrofo davanti. L’azione Esporta CSV crea lo stesso file – anche senza pulsante sull’elemento.
Calendario: mese o settimana, con navigazione e Oggi; le voci su più giorni compaiono in ogni giorno, oltre tre in un giorno «+n altri» apre la settimana. el.<id>.from e el.<id>.to sono il periodo visibile (AAAA-MM-GG) – come parametri della query carica solo quello. Selezione scatta al clic su una voce (con item, anche el.<id>.selected), clic su un giorno con date (ad es. Compila modulo con {"day": "{{date}}"} e apri una finestra per creare).
HTML: HTML libero per riquadri, note o schede personalizzati. I segnaposto vengono codificati prima dell’inserimento – un valore con <b> appare come testo, non come markup. Poi l’HTML viene ripulito: niente script, niente gestori di eventi (onclick …), niente link javascript:, niente blocchi <style>, moduli o frame; stili in linea (style="…"), link (anche mailto:, tel:) e immagini restano. I link con target="_blank" si aprono senza accesso all’app. Il browser mostra immagini da altri indirizzi solo se le impostazioni di sicurezza lo consentono. Con una query l’elemento carica i dati da sé: {{record.name}} è il record (o il primo), {{records}} l’elenco.
File: Esegui query con una query Carica un file invia ogni file scelto del modulo (o del campo file scelto nell’azione) al record, uno alla volta – con un’autorizzazione di scrittura proprio su quella tabella, mai più di quanto l’account possa già. Dimensione (al massimo 50 MB per file) e tipi consentiti dipendono anche dalla colonna allegati; viene controllato il contenuto, non l’estensione. Un nuovo record con file: prima Crea record, poi Carica un file con {{query.<crea>.record.id}} come record. el.<id>.value è l’elenco dei file scelti; Svuota modulo lo svuota.
Kanban: una colonna per valore del campo colonne, l’intestazione mostra il numero e (con un campo somma) la somma. Le schede si trascinano in un’altra colonna con mouse o dito; da tastiera Freccia sinistra/destra sposta la scheda attiva, Invio la seleziona. Sposta parte con item (la scheda), lane (la colonna di destinazione) e from – di solito Esegui query con una query di modifica {"id": "{{item.id}}", "stage": "{{lane}}"} e poi Ricarica query. La scheda appare subito nella nuova colonna; se un’azione fallisce, torna indietro. Numeri, importi e percentuali da soli come badge appaiono in grigio neutro.
Galleria: se il campo immagine è una colonna allegati, il riquadro mostra la prima immagine come anteprima; senza un proprio evento Selezione, un clic apre l’immagine in grande (Esc chiude). Immagini e file delle colonne allegati passano dall’indirizzo proprio dell’app (vedi fileUrl in Binding e azioni) – anche per utenti app e app pubbliche, che non possono usare l’API REST.
Selezione con ricerca: cerca mentre digiti – la query riceve il testo nel suo parametro di ricerca, ad es. un elenco con il filtro name contiene {{params.q}} (testo vuoto = tutti). Per chiavi esterne in tabelle grandi, dove una Selezione diventerebbe troppo lunga. Obbligatorio significa una voce dell’elenco, non solo testo. Quando Compila modulo imposta un valore, l’etichetta mostrata (ad es. {{query.lead.record.client_name}}) ne mostra il nome; el.<id>.label è l’etichetta della scelta. Scelta multipla fornisce un elenco – come parametro di tipo qualsiasi.
Separatore e spazio strutturano una pagina: un separatore è una linea, a richiesta con un piccolo titolo (a sinistra, al centro o a destra) oppure verticale tra due colonne. Uno spazio è spazio vuoto, ad esempio per tenere un pulsante a destra. Sul telefono, dove tutti gli elementi si impilano, spazi e separatori verticali spariscono; i separatori orizzontali restano.
Mappa
La mappa mostra i record come punti oppure colora paesi e regioni in base a un valore.
- Punti: campo latitudine e longitudine (predefinito
latitude/longitude, gradi decimali). Titolo e testo per punto con segnaposto ({{item.name}}) compaiono al passaggio del mouse. Il campo colore accetta un colore etichetta (red, blue …),#hexo una categoria (fino a otto, con legenda). I punti vicini vengono raggruppati in un numero; un clic ingrandisce, e se si trovano nello stesso posto compare un elenco tra cui scegliere. Evento selezione conitem. - Aree: il campo area contiene un codice paese (ISO 3166 alpha-2 come
DEo alpha-3 comeDEU), un codice regione (ISO 3166-2 comeDE-BY) o il nome di un paese; più campo valore e aggrega (somma, numero, media). Cinque tonalità di un colore, una legenda con il valore minimo e massimo e un tooltip con nome e valore. Evento selezione conarea(code,name,value). - Inquadratura: si adatta ai dati (per le aree alla parte continentale, senza territori d’oltremare); centro (
lat, lng) e zoom la fissano. Trascinare sposta; doppio clic, + / − e Ctrl + rotellina ingrandiscono – la rotellina da sola solo dopo un clic nella mappa, altrimenti scorre la pagina; ⤢ mostra di nuovo tutto. Tastiera: frecce, + / −, 0. Sui touchscreen uno scorrimento verticale fa scorrere la pagina finché non tocchi la mappa; due dita ingrandiscono. - Mappa di base: integrata, da Natural Earth (pubblico dominio): paesi, coste e dallo zoom 5 i confini delle regioni – senza richieste esterne, anche senza internet. Non mostra strade né luoghi. Se è impostato un server di tile (Impostazioni → Sicurezza → Mappe), i suoi tile stanno sotto; mappa di base: outline usa comunque quella integrata.
- Le coordinate dagli indirizzi (geocodifica) non sono integrate – le portano i dati, ad esempio tramite uno script o un workflow con il tuo servizio.
Valori degli elementi
- Campo, selezione, data, casella:
el.<id>.value– es.{{el.search.value}}come parametro di una query. - Modulo:
el.<id>.values– nome del campo (o il suo ID) → valore. All’invio lo stesso contenuto è disponibile comevalues. - Tabella ed elenco:
el.<id>.selected– l’ultimo record selezionato; nell’evento selezione comerow(tabella) oitem(elenco). - Schede:
el.<id>.tab– l’ID della scheda aperta.
Elementi di dati
Tabelle, elenchi, grafici e selezioni con query caricano i dati da soli: appena cambia un parametro (per esempio un campo di ricerca), interrogano di nuovo poco dopo. Senza elenco di colonne una tabella mostra tutti i campi della query. Formati: data, data e ora, numero, valuta, sì/no, badge (il valore come pillola colorata) e avanzamento (0–100 come barra). Senza un colore proprio gli stati comuni ricevono un colore eloquente: Done, Paid, Won, Approved, Active verde, Overdue, Lost, Urgent, Blocked rosso, Review, Sent, Proposal, In progress, High ambra, Qualified, Scheduled, Medium blu, New, Open, To do, Backlog, Draft, Low grigio; ogni altro valore sempre lo stesso colore.
La vista dettaglio mostra un record come elenco di campi con etichette – ad esempio il record selezionato in una tabella o il risultato di una query Un record (per un elenco, la prima voce). Le colonne si dispongono da sole: sulle superfici strette i campi si impilano. Oltre ai formati della tabella c’è qui Markdown (per testi lunghi, su tutta la larghezza). I valori vuoti appaiono come «–», oppure non appaiono con Nascondi i campi vuoti.