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