Saltar al contenido
Verificada

Directivas del runtime

El vocabulario completo de directivas xu-* que comparten Slim y el runtime de la plataforma.

Las directivas son la forma en que Slim convierte marcado simple, o nodos de runtime, en una superficie reactiva de Xuda. Todo el vocabulario de creación son 19 atributos más dos familias con sufijo.

Estado y salida

Expresiones

xu-exp:* evalúa una expresión con los valores de los campos y aplica el resultado a <attr>. Funciona igual con atributos HTML normales que con atributos 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 reemplaza, no combina

xu-exp:class reemplaza por completo el atributo class estático en lugar de combinarse con él. Si necesitas ambos, pon las clases estáticas dentro de la expresión, o usa xu-class para la parte condicional y deja class en paz.

Iteración y renderizado condicional

Usa xu-show cuando el nodo deba seguir montado y solo ocultarse, y xu-render cuando deba eliminarse del DOM activo si es falso.

Eventos y flujos de trabajo

xu-on:<event> siempre recibe un array de objetos manejadores, cada uno con un flujo de trabajo:

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

Ocho atributos abreviados se normalizan en flujos xu-on:* completos para actualizaciones simples de campos, de modo que un valor como xu-click="count++" funciona sin JSON de manejador: xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.

Directivas avanzadas

Orden

Los atributos se ejecutan por fases en cada elemento. xu-cdn, xu-style, xu-render, xu-for-key y xu-for-val se ejecutan antes de construir el nodo; xu-bind, xu-class, xu-script, xu-ui-plugin y xu-ref se ejecutan después. Ese orden es la razón por la que un recurso xu-cdn ya está disponible para un xu-script del mismo elemento.

Nombres de campo reservados

Nueve nombres no deben usarse nunca como id de campo, porque el runtime los asigna durante la iteración y la resolución de contexto: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.

Regla práctica

Usa la directiva más pequeña que cubra la necesidad: xu-text o xu-content para una salida simple, xu-click para una actualización simple, xu-on:* para lógica de flujo de trabajo completa, xu-exp:* para atributos calculados, y xu-for / xu-render / xu-show para el comportamiento estructural.

xu-if y la cadena de hermanos no están aquí

xu-if, xu-else-if y xu-else pertenecen al renderizador reactivo, distribuido solo en el paquete completo de la plataforma. Ni Slim ni el runtime incluido en la CLI llevan el motor reactivo, así que usa xu-render o xu-show con una expresión en cada rama. xu-route y xu-prog no son directivas en absoluto: aparecen en material de marketing pero no tienen ningún manejador en el runtime.