Dyrektywy środowiska
Pełne słownictwo dyrektyw xu-*, wspólne dla Slim i środowiska platformy.
Dyrektywy to sposób, w jaki Slim zamienia zwykły znacznik lub węzły środowiska w reaktywną powierzchnię Xuda. Całe słownictwo tworzenia to 19 atrybutów plus dwie rodziny z przyrostkami.
Stan i wynik
Wyrażenia
xu-exp:* oblicza wyrażenie na wartościach pól i stosuje wynik do <attr>. Działa tak samo dla
zwykłych atrybutów HTML i atrybutów xu-*.
xu-exp:class całkowicie zastępuje statyczny atrybut class, zamiast się z nim łączyć. Jeśli
potrzebujesz obu, umieść klasy statyczne wewnątrz wyrażenia albo użyj xu-class dla części
warunkowej i zostaw class w spokoju.
Iteracja i renderowanie warunkowe
Użyj xu-show, gdy węzeł ma pozostać zamontowany i tylko się ukryć, a xu-render, gdy ma zostać
usunięty z żywego DOM, kiedy warunek jest fałszywy.
Zdarzenia i przepływy pracy
xu-on:<event> zawsze przyjmuje tablicę obiektów obsługi, z których każdy niesie przepływ pracy:
Osiem atrybutów skrótowych normalizuje się do pełnych przepływów xu-on:* dla prostych aktualizacji
pól, więc wartość taka jak xu-click="count++" działa bez JSON-a obsługi: xu-click, xu-dblclick,
xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.
Dyrektywy zaawansowane
Kolejność
Atrybuty uruchamiają się w fazach dla każdego elementu. xu-cdn, xu-style, xu-render,
xu-for-key i xu-for-val uruchamiają się przed zbudowaniem węzła; xu-bind, xu-class,
xu-script, xu-ui-plugin i xu-ref po nim. Dlatego zasób z xu-cdn jest już dostępny dla
xu-script na tym samym elemencie.
Zarezerwowane nazwy pól
Dziewięciu nazw nigdy nie wolno używać jako identyfikatora pola, ponieważ środowisko przypisuje je
podczas iteracji i rozwiązywania kontekstu: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO,
_ROWID, _ROWDOC, _KEY, _VAL.
Praktyczna zasada
Używaj najmniejszej dyrektywy, która pasuje do potrzeby: xu-text lub xu-content do prostego
wyniku, xu-click do prostej aktualizacji, xu-on:* do pełnej logiki przepływu pracy, xu-exp:* do
obliczanych atrybutów, a xu-for / xu-render / xu-show do zachowań strukturalnych.
xu-if, xu-else-if i xu-else należą do reaktywnego renderera, dostarczanego tylko w pełnym
pakiecie platformy. Ani Slim, ani środowisko dołączone do CLI nie niesie silnika reaktywnego, więc
zamiast tego użyj xu-render lub xu-show z wyrażeniem w każdej gałęzi. xu-route i xu-prog w
ogóle nie są dyrektywami: pojawiają się w materiałach marketingowych, ale nigdzie w środowisku nie
mają obsługi.