Siirry sisältöön
Tarkistettu

Suoritusaikaiset direktiivit

Koko xu-*-direktiivisanasto, jonka Slim ja alustan suoritusympäristö jakavat.

Direktiivit ovat tapa, jolla Slim muuttaa tavallisen merkinnän tai suoritusaikaiset solmut reaktiiviseksi Xuda-pinnaksi. Koko kirjoitussanasto on 19 attribuuttia sekä kaksi päätteellistä perhettä.

Tila ja tuloste

Lausekkeet

xu-exp:* arvioi lausekkeen kenttäarvoja vasten ja soveltaa tuloksen <attr>-attribuuttiin. Se toimii tavallisille HTML-attribuuteille ja xu-*-attribuuteille.

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 korvaa, se ei yhdistä

xu-exp:class korvaa staattisen class-attribuutin kokonaan sen sijaan, että yhdistäisi sen kanssa. Jos tarvitset molempia, laita staattiset luokat lausekkeen sisään tai käytä xu-class:ia ehdolliseen osaan ja jätä class rauhaan.

Iterointi ja ehdollinen renderöinti

Käytä xu-show:ta, kun solmun pitää pysyä liitettynä ja vain piiloutua, ja xu-render:iä, kun sen pitää poistua elävästä DOMista epätotena.

Tapahtumat ja työnkulut

xu-on:<event> ottaa aina taulukon käsittelijäolioita, joista jokaisella on työnkulku:

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

Kahdeksan lyhennysattribuuttia normalisoituu täysiksi xu-on:*-työnkuluiksi yksinkertaisia kenttäpäivityksiä varten, joten arvo kuten xu-click="count++" toimii ilman käsittelijä-JSONia: xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.

Edistyneet direktiivit

Järjestys

Attribuutit ajetaan vaiheittain elementtiä kohden. xu-cdn, xu-style, xu-render, xu-for-key ja xu-for-val ajetaan ennen solmun rakentamista, xu-bind, xu-class, xu-script, xu-ui-plugin ja xu-ref sen jälkeen. Siksi xu-cdn-resurssi on jo saatavilla samalla elementillä olevalle xu-script:ille.

Varatut kenttänimet

Yhdeksää nimeä ei saa koskaan käyttää kenttätunnisteena, koska suoritusympäristö antaa ne iteroinnin ja kontekstin ratkaisun aikana: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.

Käytännön sääntö

Käytä pienintä direktiiviä, joka vastaa tarvetta: xu-text tai xu-content yksinkertaiseen tulosteeseen, xu-click yksinkertaiseen päivitykseen, xu-on:* täyteen työnkulkulogiikkaan, xu-exp:* laskettuihin attribuutteihin ja xu-for / xu-render / xu-show rakenteelliseen käyttäytymiseen.

xu-if ja sisarketju eivät ole täällä

xu-if, xu-else-if ja xu-else kuuluvat reaktiiviseen renderöijään, joka toimitetaan vain täydessä alustapaketissa. Slim ja CLI:n mukana tuleva suoritusympäristö eivät sisällä reaktiivista moottoria, joten käytä sen sijaan xu-render:iä tai xu-show:ta lausekkeen kanssa jokaisessa haarassa. xu-route ja xu-prog eivät ole direktiivejä lainkaan: ne esiintyvät markkinointimateriaalissa, mutta niillä ei ole käsittelijää missään suoritusympäristössä.