Guida per sviluppatori

Un’app ReactiveNET è un documento Markdown. Non un progetto, non un bundle: un file di testo che qualunque editor legge, in cui alcune righe — le direttive — diventano campi, liste, tabelle, grafici e calcoli.

Questa guida è il riferimento di chi le scrive a mano. Chi preferisce descrivere l’app a parole può lasciarla scrivere all’assistente e tornare qui solo per capire cosa ha prodotto.

Da dove cominciare

  1. Sintassi — le tre forme di una direttiva, come si annidano, e la regola centrale: #ref contro un id nudo.
  2. Direttive dei dati — form, liste, tabelle, board, calendari, aggregazioni e Python: quello che dà a un’app i suoi dati.
  3. Componenti — i 92 componenti Adobe Spectrum, disponibili senza scrivere una riga di codice.
  4. Editor a blocchi — le stesse direttive modificate come blocchi, con il menu slash e il trascinamento.

Un’app completa

---
appId: spese
title: Spese condivise
icon: receipt
---

::form{path="spese"}
::input{field="cosa" legend="Voce" required}
::input{field="prezzo" legend="Prezzo" type="number" min="0"}
::save{label="Aggiungi"}
::/form

::if-empty{path="spese"}
Ancora niente. Aggiungi la prima voce qui sopra.
::/if-empty

::table{path="spese" search page-size="10" deletable editform}
::column{field="cosa" label="Voce"}
::column{field="prezzo" label="Prezzo" align="end"}
::column{field="createdAt" label="Aggiunta"}
::/table

Totale: :sum{path="spese" field="prezzo" decimals="2"}

Il form scrive righe nella collezione spese, la tabella le rilegge con ricerca, ordinamento e paginazione, l’aggregazione somma la colonna. Non c’è altro da configurare: il documento è l’app.