Przejdź do treści
Zweryfikowano

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

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 zastępuje, nie łączy

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:

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

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.

Nie ma tu xu-if ani łańcucha sąsiadów

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.