Vai al contenuto
Verificata

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-*.

html
<div xu-exp:xu-content="'Hello ' + @first_name"></div>
<div xu-exp:class="@is_active ? 'text-green-500' : 'text-gray-500'"></div>
xu-exp:class sostituisce, non unisce

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:

html
<button
  xu-on:click='[
    { "handler": "custom", "workflow": [
      { "data": { "action": "update", "name": { "value": "@count_v: @count_v + 1" }, "enabled": true } }
    ] }
  ]'
>
  Increment
</button>

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 e la catena di fratelli non sono qui

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.