Saltar para o conteúdo
Verificado

Diretivas de runtime

O vocabulário completo de diretivas xu-* que o Slim e o runtime da plataforma partilham.

As diretivas são a forma como o Slim transforma marcação simples, ou nós de runtime, numa superfície reativa do Xuda. Todo o vocabulário de escrita são 19 atributos mais duas famílias com sufixo.

Estado e saída

Expressões

xu-exp:* avalia uma expressão sobre valores de campos e aplica o resultado a <attr>. Funciona tanto para atributos HTML simples como para 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 substitui, não funde

xu-exp:class substitui por completo o atributo class estático em vez de se fundir com ele. Se precisar dos dois, ponha as classes estáticas dentro da expressão, ou use xu-class para a parte condicional e deixe class em paz.

Iteração e renderização condicional

Use xu-show quando o nó deve continuar montado e apenas ocultar-se, e xu-render quando deve ser removido do DOM ativo quando for falso.

Eventos e fluxos de trabalho

xu-on:<event> recebe sempre um array de objetos de tratamento, cada um com um fluxo de trabalho:

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

Oito atributos abreviados normalizam-se em fluxos xu-on:* completos para atualizações simples de campos, por isso um valor como xu-click="count++" funciona sem JSON de tratador: xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.

Diretivas avançadas

Ordem

Os atributos executam-se por fases em cada elemento. xu-cdn, xu-style, xu-render, xu-for-key e xu-for-val executam-se antes de o nó ser construído; xu-bind, xu-class, xu-script, xu-ui-plugin e xu-ref executam-se depois. É essa ordem que explica porque um recurso xu-cdn já está disponível para um xu-script no mesmo elemento.

Nomes de campos reservados

Nove nomes nunca devem ser usados como id de campo, porque o runtime os atribui durante a iteração e a resolução de contexto: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.

Regra prática

Use a menor diretiva que corresponda à necessidade: xu-text ou xu-content para saída simples, xu-click para uma atualização simples, xu-on:* para lógica de fluxo de trabalho completa, xu-exp:* para atributos calculados, e xu-for / xu-render / xu-show para comportamento estrutural.

xu-if e a cadeia de irmãos não estão aqui

xu-if, xu-else-if e xu-else pertencem ao renderizador reativo, fornecido apenas no bundle completo da plataforma. Nem o Slim nem o runtime incluído na CLI trazem o motor reativo, por isso use xu-render ou xu-show com uma expressão em cada ramo. xu-route e xu-prog não são diretivas de todo: aparecem em material de marketing mas não têm tratador em lado nenhum do runtime.