Direttive del runtime
Il vocabolario completo delle direttive xu-* condiviso da Slim e dal runtime della piattaforma.
Le direttive sono il modo in cui Slim trasforma il semplice markup, o i nodi del runtime, in una superficie Xuda reattiva. L'intero vocabolario di scrittura è fatto di 19 attributi più due famiglie con suffisso.
Stato e output
Espressioni
xu-exp:* valuta un'espressione sui valori dei campi e applica il risultato a <attr>. Funziona sia per i normali attributi HTML sia per gli attributi xu-*.
xu-exp:class sostituisce interamente l'attributo class statico invece di unirsi a esso. Se ti servono entrambi, metti le classi statiche dentro l'espressione, oppure usa xu-class per la parte condizionale e lascia stare class.
Iterazione e rendering condizionale
Usa xu-show quando il nodo deve restare montato e solo nascondersi, e xu-render quando deve essere rimosso dal DOM attivo quando la condizione è falsa.
Eventi e flussi di lavoro
xu-on:<event> accetta sempre un array di oggetti gestore, ciascuno con un flusso di lavoro:
Otto attributi abbreviati vengono normalizzati in flussi di lavoro xu-on:* completi per semplici aggiornamenti di campo, quindi un valore come xu-click="count++" funziona senza JSON del gestore: xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.
Direttive avanzate
Ordine
Gli attributi vengono eseguiti per fasi su ogni elemento. xu-cdn, xu-style, xu-render, xu-for-key e xu-for-val vengono eseguiti prima che il nodo venga costruito; xu-bind, xu-class, xu-script, xu-ui-plugin e xu-ref dopo. Questo ordine è il motivo per cui una risorsa xu-cdn è già disponibile per un xu-script sullo stesso elemento.
Nomi di campo riservati
Nove nomi non vanno mai usati come id di un campo, perché il runtime li assegna durante l'iterazione e la risoluzione del contesto: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.
Regola pratica
Usa la direttiva più piccola che soddisfa l'esigenza: xu-text o xu-content per un semplice output, xu-click per un semplice aggiornamento, xu-on:* per una logica di flusso completa, xu-exp:* per gli attributi calcolati, e xu-for / xu-render / xu-show per il comportamento strutturale.
xu-if, xu-else-if e xu-else appartengono al renderer reattivo, distribuito solo nel bundle completo della piattaforma. Né Slim né il runtime incluso nella CLI contengono il motore reattivo, quindi usa invece xu-render o xu-show con un'espressione su ogni ramo. xu-route e xu-prog non sono affatto direttive: compaiono nel materiale di marketing ma non hanno alcun gestore in nessun punto del runtime.