Pereiti prie turinio

Komponentai

Kompozicija

į rinkinį įtraukti UI komponentai skirti komponuoti kartu, o ne naudoti po vieną. Pasirinkimo sąrašas atsidaro dialogo lange, forma tikrinama šoniniame skydelyje, meniu yra lentelės eilutėje. Šiame puslapyje paaiškinama, kaip veikia šios sąsajos: kaip sudarytos sudėtinės komponentų grupės, kaip aktyvikliai perduoda mygtuko savybes, ką po paviršiumi daro Interactivity API ir kaip sluoksniavimo modelis padeda darniai sudėti persidengiančius elementus.

Sudėtinės komponentų grupės

Sudėtinį komponentą sudaro pagrindinis blokas ir antriniai blokai. Pagrindinis blokas valdo būseną, o kiekvienas antrinis blokas savo vietą grupėje nurodo per parent ir usesContext savo block.json:

JSON
{
  "name": "bsui/select-option",
  "parent": ["bsui/select-popup"],
  "usesContext": ["bsui/select"]
}

Pagrindiniai blokai pateikia InnerBlocks sritį su allowedBlocks sąrašu ir pradine template, todėl įterpus dialogą redaktoriuje automatiškai sukuriami jo aktyviklis, fonas ir iššokantis langas. Grupė veikia vienodai, nesvarbu, ar ji sudaryta redaktoriuje, puslapyje iš failų, ar naudojant žymas:

HTML
<bs:bsui-select name="role" placeholder="Pick a role">
  <bs:bsui-select-trigger />
  <bs:bsui-select-popup>
    <bs:bsui-select-option value="viewer" label="Viewer" />
    <bs:bsui-select-option value="editor" label="Editor" />
  </bs:bsui-select-popup>
</bs:bsui-select>

Iššokantys langai ir skydeliai yra tikros InnerBlocks sritys, o ne specialios sintaksės lizdai. bsui/dialog-popup priima įdėtinius blokus taip pat kaip grupės blokas, todėl į jį įdėti formą, pasirinkimo sąrašą ar kitą dialogą yra įprastas komponavimo veiksmas.

Plokšti duomenys ar komponuojami antriniai elementai

Kai kurių grupių turinys pateikiamas duomenimis, o ne antriniais elementais. Jei pateikiate options JSON masyvą, pasirinkimo sąrašas sukuria savo aktyviklį ir parinkčių sąrašą. Tai tinka parinktims, gaunamoms iš PHP:

PHP
bs_render_block([
  'name' => 'bsui/select',
  'data' => [
    'name' => 'role',
    'placeholder' => 'Pick a role',
    'options' => wp_json_encode([
      ['value' => 'viewer', 'label' => 'Viewer'],
      ['value' => 'editor', 'label' => 'Editor'],
    ]),
  ],
]);

Abu variantai sukuria tą pačią ženklinimo struktūrą ir veikia vienodai. Naudokite antrinius elementus, kai struktūra kuriama rankiniu būdu, o kai apskaičiuojama – options.

Aktyviklių savybių perdavimas

Perdangos komponentai atveriami mygtuku, kuris turėtų būti sistemos mygtukas. Užuot kiekvienam aktyvikliui kūrus atskirą, blokų bsui/dialog, bsui/alert-dialog, bsui/drawer, bsui/menu, bsui/popover, bsui/collapsible ir bsui/tooltip aktyvikliai įterpia bsui/button naudodami bloko lauką:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "trigger",
        "type": "block",
        "block": "bsui/button",
        "idStructure": "trigger_{id}"
      }
    ]
  }
}

idStructure išplečia mygtuko laukus aktyviklyje ir prideda priešdėlį trigger_. Prieinamos visos mygtuko savybės: trigger_label, trigger_variant, trigger_size, trigger_icon, trigger_iconPosition, trigger_href, trigger_disabled.

HTML
<bs:bsui-dialog-trigger trigger_label="Invite teammate" trigger_variant="outline" />

Aktyviklio šablone $a['trigger'] yra visiškai atvaizduotas mygtukas, todėl kartu su juo naudojamas mygtuko stiliaus lapas ir būsimi patobulinimai. Vykdymo metu bendra pagalbinė funkcija perduoda išorinio elemento ARIA susiejimą (aria-haspopup, aria-expanded, aria-controls, aria-describedby, aria-labelledby, id) vidiniam mygtukui ir sinchronizuoja jį per MutationObserver, todėl pagalbinės technologijos mato vieną vientisą valdiklį.

Interactivity API veikimas po paviršiumi

Kiekviena interaktyvi grupė naudoja WordPress Interactivity API saugyklą, pavadintą pagal pagrindinį bloką: bsui/dialog, bsui/select, bsui/form, bsui/tabs ir taip toliau. Iš to kyla trys pasekmės.

Pradinė būsena nustatoma serveryje. Pagrindinio bloko šablonas pradinę būseną išveda kaip data-wp-context tiesiai iš bloko atributų:

HTML
<div
  data-wp-interactive="bsui/select"
  data-wp-context='{"open":false,"value":"","placeholder":"Pick a role", ...}'
  data-bsui-select-root
>

Pirmasis atvaizdavimas iškart teisingas HTML – nėra jokio kliento pusės hidratacijos mirgėjimo, iššokantys langai pradeda veikti hidden, o tas pats ženklinimas veikia ir redaktoriaus drobėje, nes kontekstas nepriklauso nuo tik priekinei daliai skirto būsenos apdorojimo.

Elgsena susiejama direktyvomis, o ne jūsų JavaScript. Šablonai deklaratyviai susieja ženklinimą su saugyklomis. Pašalinus pasirinkimo sąrašo aktyviklio PHP, lieka tik direktyvos:

HTML
<button
  data-wp-interactive="bsui/select"
  data-wp-on--click="actions.toggle"
  data-wp-on--keydown="actions.handleTriggerKeyDown"
  data-wp-bind--aria-expanded="state.ariaExpanded"
  data-wp-text="state.displayValue"
  data-bsui-select-trigger
  aria-haspopup="listbox"
>

data-wp-on nukreipia įvykius veiksmams, data-wp-bind sinchronizuoja atributus su išvestine būsena, data-wp-text atvaizduoja būseną kaip tekstą, o data-wp-on-document--click suteikia pagrindiniams blokams galimybę užverti elementą spustelėjus už jo ribų. Komponuojant komponentus nereikia rašyti įvykių apdorojimo funkcijų – saugykla pateikiama kartu su bloku kaip įterptinis modulis.

Jūsų saugyklas galima prijungti prie šių sąsajų. Formų valdikliai priima direktyvų išraiškas kaip atributus, o Interactivity API vardų erdvės sintaksė leidžia susieti juos su bet kuria saugykla. onChange nukreipia pakeitimo apdorojimą į vieną iš jūsų veiksmų, checked susieja valdiklio būseną su jūsų būsena, o bindText atvaizduoja etiketę kaip data-wp-text elementą, susietą su bet kuriuo būsenos keliu:

HTML
<bs:bsui-switch label="Notifications" checked="myPlugin::state.notifications" onChange="myPlugin::actions.toggleNotifications" />
<bs:bsui-checkbox label="0 selected" bindText="myPlugin::state.selectionSummary" />

bindText galima naudoti su bsui/label, bsui/checkbox, bsui/switch, bsui/toggle ir bsui/radio-group elementais. Žymimojo langelio, jungiklio ir parinkties elementuose ji perduodama bendrai etiketės pagrindinei funkcijai, todėl būsena valdomas tekstas išlaiko tikslią sisteminės etiketės tipografiją. Pasirinkimo sąrašai ir kiti įvesties laukai taip pat išsiunčia iš savo pagrindinio elemento sklindantį change įvykį, kurio detail yra nauja reikšmė; tai patogiau platesnio masto integracijoms.

Valdomos reikšmės

Jei valdiklis pats tvarko savo reikšmę, nepalikite nustatytų value arba checked. Pradinei parinkčiai naudokite defaultValue, defaultChecked arba Toggle valdiklio defaultPressed. Atskiras Toggle valdiklis apdoroja pelės ir klaviatūros įvestį be vartotojo saugyklos.

Norėdami valdyti lauką iš savo saugyklos, pateikite ir jo susiejimą, ir onChange veiksmą, kuris atnaujina susietą reikšmę. value yra direktyvos kelias, o ne numatytoji reikšmė. Input, Textarea, Password Input, Number Field, Slider, Radio Group, Color Picker, Rating ir Time Picker palaiko value. Checkbox, Switch ir Toggle vietoj to naudoja checked.

Kelius nurodykite su savininko vardų sritimi, pavyzdžiui, my/settings::context.quantity arba my/settings::state.quantity. Sudėtiniai valdikliai turi savo vardų sritį; nenurodytas kelias nurodo į tą valdiklį, o ne automatiškai į jūsų pirminę saugyklą. Sudėtinės reikšmės susiejimai palaiko taškų kelius į kontekstą arba būseną, įskaitant skaitinius masyvų raktus, bet nepalaiko JavaScript išraiškų ar funkcijų iškvietimų.

Štai visas Number Field susiejimo pavyzdys pasirinktiniame bloke, kuriame įjungtas Interactivity API palaikymas:

PHP
<div
  data-wp-interactive="my/settings"
  data-wp-context='<?php echo esc_attr(wp_json_encode(['quantity' => 2])); ?>'
>
  <bs:bsui-number-field
    nameAlt="quantity"
    defaultValue="2"
    value="my/settings::context.quantity"
    onChange="my/settings::actions.setQuantity"
  />
  <output data-wp-text="context.quantity"></output>
</div>
JavaScript
import { getContext, store } from '@wordpress/interactivity';

store('my/settings', {
  actions: {
    setQuantity(event) {
      // Compound controls publish their normalized value in a custom change event.
      if (event.detail?.value !== undefined) {
        getContext().quantity = event.detail.value;
      }
    },
  },
});

Nustatykite atitinkamą numatytąją reikšmę, kuri bus naudojama pradinei reikšmei atvaizduoti serveryje. Kai duomenys įkeliami, pirminio elemento pakeitimai atnaujina kiekvieną susietą egzempliorių, įskaitant nulį, false ir tuščias reikšmes. Paslėpti Checkbox ir Switch formos įvesties laukai taip pat seka savo checked susiejimą. Time Picker reikšmės naudoja HH:MM 24 valandų formatu arba tuščią eilutę. Naudodami savųjų Input, Textarea ir Password Input įvykių apdorojimo funkcijas, nuskaitykite event.target.value; sudėtiniai reikšmių valdikliai pateikia event.detail.value. Number Field ribos neprivalomos: jei min ir max nenurodytos, laukas neturi ribų, o aiškiai nurodytas nulis laikomas galiojančia riba.

Select, Date Input, Phone Input ir OTP Input praneša apie pakeitimus per onChange, tačiau neatskleidžia šio valdomo value susiejimo. Pradinėms reikšmėms nustatyti naudokite dokumentuotas numatytąsias savybes.

Komponavimas iš savo blokų

Komponuoti galima ne tik puslapiuose. Blokų žymos automatiškai atvaizduojamos blokų šablonuose, todėl projekto blokas gali tiesiogiai išvesti bsui komponentus ir apgaubti juos savo struktūra:

PHP
<div useBlockProps class="settings-panel">
  <bs:bsui-switch label="Public profile" name="public" />
  <bs:bsui-space size="4" />
  <bs:bsui-button label="Save" variant="default" />
</div>

Tą patį galima daryti ir naudojant PHP bei bs_block(), įskaitant įdėjimą per raktą content, kaip aprašyta skiltyje programinis atvaizdavimas. Abiem atvejais kartu įkeliami komponento stiliaus lapas ir saugykla, o jūsų blokas lieka plonu išdėstymo sluoksniu virš sistemos dalių.

Norėdami išdėstyti komponentus vieną šalia kito, naudokite bsui/stack – universalų eilutės arba stulpelio „flex“ išdėstymą su direction, gap tarpų skalėje, align, justify ir wrap perjungikliu. Pagal numatytuosius nustatymus antriniai elementai išlaiko natūralų dydį. Įjungus grow perjungiklį, jie ištempiami ir vienodai užpildo visą išdėstymo ilgį. Taip pora poraštėje esančių mygtukų padalija jos plotį, užuot susiglaudę viename gale.

Laukų grupės ir kortelės

bsui/field-group atvaizduoja laukų rinkinį. Numatytoji varianto parinktis sugrupuoja susijusius laukus nepridėdama fono. Naudokite variant="card", jei norite blankesnio išorinio rėmelio, tada įdėkite laukus į bsui/field-group-content, kad turinys būtų atvaizduotas įdėtame fone. Pavadinimą ir aprašą palikite už šio turinio bloko ribų:

HTML
<bs:bsui-field-group variant="card">
  <bs:bsui-field-group-title text="Account settings" />
  <bs:bsui-field-group-description text="Manage your account preferences." />
  <bs:bsui-field-group-content>
    <bs:bsui-field>
      <bs:bsui-field-label text="Display name" />
      <bs:bsui-input nameAlt="display_name" placeholder="Enter display name" />
    </bs:bsui-field>
    <bs:bsui-field>
      <bs:bsui-field-label text="Email" />
      <bs:bsui-input nameAlt="email" type="email" placeholder="Enter email" />
    </bs:bsui-field>
  </bs:bsui-field-group-content>
</bs:bsui-field-group>

disabled="true" grupėje naudojamas savasis lauko rinkinio veikimas, kad būtų išjungti jo formos valdikliai. Kortelės stilius numatytojo varianto nekeičia.

Įrankių juostos skirtukai

Įterpkite bsui/toolbar-separator tarp įrankių juostos elementų. Jis vadovaujasi pirminės įrankių juostos orientation: horizontali įrankių juosta gauna viso aukščio vertikalų skirtuką, o vertikali įrankių juosta – viso pločio horizontalų skirtuką. Skirtukai išsitempia iki vidinių įrankių juostos kraštinės kraštų nekeisdami valdiklių aukščio. Horizontali įrankių juosta slenka, kai jos turinys viršija galimą plotį.

Sluoksniavimo modelis

Sluoksniuotos sąsajos dažnai tampa komponentų bibliotekų silpnąja vieta. Į rinkinį įtraukti komponentai laikosi kelių taisyklių, skirtų kuriantiems tikras vartotojo sąsajas.

Modaliniai langai perkeliami į body

Atidarius dialogą, įspėjamąjį dialogą arba šoninį skydelį, jo iššokantis langas ir fonas perkeliami į document.body, o vietą, į kurią reikia grįžti uždarius, pažymi komentaras-vietaženklis. Taip modalinis langas atskiriamas nuo bet kurio jo protėvio overflow, transformacijos arba sluoksniavimo konteksto. Atidarius taip pat užrakinamas puslapio slinkimas: užraktas skaičiuojamas pagal visus perdangos komponentus, o slinkties juostos plotis kompensuojamas, kad puslapis nepasislinktų. Fonas yra ties z-index: 50, iššokantis langas – ties 51, fokusas perkeliamas į jį, Tab klavišas lieka jo viduje, o uždarius fokusas grąžinamas aktyvikliui.

Modaliai sudedami vienas ant kito. Atidarius dialogą kitame dialoge, jis įtraukiamas į bendrą steką: foną rodo tik išorinis dialogas, o po viršutiniu dialogu esantys dialogai sumažinami ir išlenda iš už jo. Stekas kiekviename fone esančiame iššokančiame lange nustato tinkintąją savybę --bs-ui-nested-dialogs, todėl kiekviename lygyje išlindimo poslinkis ir mastelis didėja, o pirminio dialogo aukštis priderinamas prie vaikinio, kad visi sluoksniai išlįstų vienodai. Uždarant viskas atkuriama atvirkštine tvarka, po vieną sluoksnį.

Uždarius modalą, židinys grąžinamas jo aktyvikliui – tinkamam elementui. Bendra pagalbinė funkcija getAnchor aktyviklio apvalkalą susieja su sistemos mygtuku jo viduje, todėl židinį vėl gauna matomas valdiklis, o ne nematomas apvalkalas.

Viršutinis modalas niekada netransformuojamas

Šis išlindimo efektas transformuoja tik fone esančius dialogus. Viršutinis modalas sąmoningai paliekamas netransformuotas, nes transformuotas elementas tampa position: fixed palikuonių pozicionavimo kontekstu, o tai sugadintų kiekvieną jo viduje atidarytą slankųjį iššokantį langą.

Ši taisyklė leidžia derinti visą sluoksniavimo modelį. Visi slankieji sluoksniai pozicionuojami fiksuotomis koordinatėmis, kurios nurodo rodinio sritį tik tada, kai tarp jų ir jos nėra transformuoto protėvinio elemento:

  • Meniu ir kombinuotasis laukelis apskaičiuoja savo poziciją pagal aktyviklį, taikydami Floating UI strategiją fixed: atsidaro po juo, o pritrūkus vietos rodinio srityje persikelia į kitą pusę arba pasislenka.
  • Pasirinkimo sąrašas elgiasi taip pat, kai niekas nepasirinkta. Jei pasirinkimas jau yra, iššokantis langas lygiuojamas taip, kad pasirinktas variantas atsidurtų tiesiai virš aktyviklio, o jo padėtis apribojama rodinio sritimi – kaip vietiniuose pasirinkimo sąrašuose sistemoje macOS.
  • Kontekstinis meniu atsidaro ties žymeklio clientX/clientY koordinatėmis.

Kadangi viršutinis modalas netransformuotas, visi šie elementai teisingai prisitvirtina prie savo aktyviklių dialogo, įspėjamojo dialogo ar šoninio skydelio viduje, kad ir koks būtų įdėjimo gylis. Iššokantiems langams nereikia žinoti, kad jie yra modalo viduje.

Escape pirmiausia uždaro giliausiai įdėtą sluoksnį

Paspaudus Escape, uždaromas tik vienas sluoksnis, pradedant nuo giliausiai įdėto:

  1. Pirmiausia uždaromas atviras slankusis sluoksnis (pasirinkimo sąrašas, meniu, iššokantis langas, datos ar telefono numerio langas), o židinys grąžinamas jo aktyvikliui. Pasirinkimo sąrašas sustabdo įvykio sklidimą, o modalo apdorojimo funkcijos taip pat neveikia, kol atidarytas kuris nors slankusis sluoksnis, todėl apačioje esantis dialogas šio klavišo paspaudimo nepastebi.
  2. Tada uždaromas viršutinis modalas.
  3. Jei modalai sudėti į steką, kiekvienas kitas Escape paspaudimas pašalina iš jo dar po vieną modalą.

Uždarymas yra numatyta taisyklė, o ne atsitiktinumas. Dialogas, pateiktas su dismissable="false", nepaiso nei Escape, nei fono paspaudimų. bsui/alert-dialog į Escape reaguoja kaip bet kuris modalas, bet sąmoningai nepaiso fono paspaudimų: šio šablono esmė – kad pasirinkimas būtų sąmoningas, o ne atsitiktinis uždarymas. Įprastas dialogas uždaromas paspaudus foną, nes dismissable pagal numatytąsias nuostatas yra true.

Forma dialoge

Šis šablonas iš karto išbando visas anksčiau aprašytas taisykles: aktyviklis atidaro modalą, jame yra formos tikrinimas, o formoje – slankusis pasirinkimo sąrašas.

HTML
<bs:bsui-dialog>
  <bs:bsui-dialog-trigger trigger_label="Invite teammate" trigger_variant="outline" />
  <bs:bsui-dialog-backdrop />
  <bs:bsui-dialog-popup>
    <bs:bsui-dialog-header>
      <bs:bsui-dialog-title content="Invite a teammate" />
      <bs:bsui-dialog-description content="They receive an email with a join link." />
    </bs:bsui-dialog-header>
    <bs:bsui-dialog-content>
      <bs:bsui-form block="team/invite" successMessage="Invitation sent.">
        <bs:bsui-field name="email">
          <bs:bsui-field-label text="Email" />
          <bs:bsui-input name="email" type="email" placeholder="colleague@example.com" required="true" />
          <bs:bsui-field-error />
        </bs:bsui-field>
        <bs:bsui-field name="role">
          <bs:bsui-field-label text="Role" />
          <bs:bsui-select name="role" defaultValue="editor" placeholder="Pick a role">
            <bs:bsui-select-trigger />
            <bs:bsui-select-popup>
              <bs:bsui-select-option value="viewer" label="Viewer" />
              <bs:bsui-select-option value="editor" label="Editor" />
              <bs:bsui-select-option value="admin" label="Admin" />
            </bs:bsui-select-popup>
          </bs:bsui-select>
        </bs:bsui-field>
        <bs:bsui-space size="2" />
        <bs:bsui-button label="Send invite" />
      </bs:bsui-form>
    </bs:bsui-dialog-content>
    <bs:bsui-dialog-footer>
      <bs:bsui-dialog-close label="Cancel" />
    </bs:bsui-dialog-footer>
  </bs:bsui-dialog-popup>
</bs:bsui-dialog>

Kiekviena pirmiau pateikta žyma ir atributas yra svarbūs: aktyviklis nukreipia į sistemos mygtuką, pavadinimas ir aprašymas perduodami per content, laukai turi pavadinimus, kuriuos forma serializuoja, o required="true" žymų analizatoriuje paverčiamas tikra logine reikšme.

Ką kiekviena saugykla daro vykdymo metu

bsui/dialog serveryje įrašo {"open":false,"dismissable":true} į kontekstą. Aktyviklio paspaudimas paleidžia actions.open: iššokantis langas ir fonas perkeliami į body, slinkimas užrakinamas kompensuojant slinkties juostos plotį, iššokantis langas per 150ms animuotai atidaromas, židinys perkeliamas į pirmą fokusuojamą elementą, o Tab klavišas cikliškai perkelia židinį jo viduje. Antraštės, turinio ir poraštės sritys išdėstomos pagal modalo tarpų žetonus.

bsui/select formos viduje laukia savo sąrašo hidden. Paspaudus aktyviklį, perjungiama context.open, sąrašas pozicionuojamas fiksuotomis rodinio srities koordinatėmis. Kadangi defaultValue="editor" jau pasirinkta, iššokantis langas lygiuojamas taip, kad Editor atsidurtų tiesiai virš aktyviklio. Rodyklių klavišais, Home, End ir rašant tekstą pakeičiamas aktyvus variantas; Enter arba paspaudimas jį pasirenka; Tab ir paspaudimai išorėje uždaro sąrašą nieko nepasirinkę. Matomas aktyviklio tekstas atnaujinamas per data-wp-text="state.displayValue", o paslėptas <input name="role"> seka reikšmę per data-wp-bind--value="state.selectedValue" – ją forma vėliau serializuoja. Visi šie elementai teisingai prisitvirtina dialogo viduje, nes viršutinis modalas netransformuotas.

bsui/form perima formos pateikimą. Formos gale esantis bsui/button pateikia paprastą button elementą be atributo type, todėl pagal numatytąsias HTML nuostatas jis tampa formos pateikimo valdikliu; mygtukas Cancel yra poraštėje, už form elemento ribų, todėl nieko pateikti negali. Pateikus formą, saugykla serializuoja jos FormData ir siunčia juos per duomenų API bloko, nurodyto block, – šiuo atveju sukuriama eilutė bloko team/invite duomenų bazės schemoje. Tikrinimo klaidos grąžinamos kiekvienam laukui atskirai: kiekvienas bsui/field turi savo name, pažymimas kaip netinkamas, židinio žiedo spalva pakeičiama į destruktyvaus veiksmo spalvą, o pranešimas rodomas jo bsui/field-error įspėjime. Pavykus, formos turinys paslepiamas, o rodomas successMessage; abu veiksmai atliekami per data-wp-bind--hidden.

Sluoksniai uždaromi eilės tvarka. Kai sąrašas atidarytas, Escape jį uždaro ir grąžina židinį pasirinkimo aktyvikliui; dar kartą paspaudus Escape, uždaromas dialogas ir židinys grąžinamas Invite teammate. Dialogas uždaromas paspaudus foną, nes dismissable paliktas pagal numatytąsias nuostatas. Uždarius dialogą, slinkimas atrakinamas, o iššokantis langas grąžinamas į pradinę vietą dokumente.

Tą patį kodą įklijavus į failais pagrįstą puslapį, jis sinchronizuojamas kaip vietiniai blokai; tą pačią kompoziciją surinkus redaktoriuje, jos interaktyvi peržiūra pateikiama drobėje. Taip yra todėl, kad visą pirmiau aprašytą elgseną apibrėžia direktyvos ir saugyklos, įkeliamos abiejuose kontekstuose.

Kas užtikrina sklandų šių sąsajų veikimą

Pirmiau aprašytos sąsajos nėra susitarimai – tai bibliotekos užtikrinami nekintami principai, kad ir kur ji būtų atvaizduojama: kiekviena etiketė susieta su vienoda tipografija, visi modalų iššokantys langai naudoja tą patį paviršių ir pritemdo už jų esantį puslapį, slankieji iššokantys langai slenkant puslapiui išlaiko ryšį su aktyvikliu, o Escape kiekvieną kartą uždaro tik vieną sluoksnį, pradedant nuo giliausiai įdėto. Šios garantijos galioja ir svetainės sąsajoje, ir redaktoriaus drobėje, naudojant numatytuosius žetonus arba jūsų temos žetonus. Todėl viename kontekste veikianti kompozicija taip pat veiks ir kituose.

Veikiantys pavyzdžiai

Šio puslapio kompozicijos yra gramatika, o /ui/examples – frazių rinkinys. Jame pateikiamos veikiančios, atvaizduotos kompozicijos trimis lygiais: poros, parodančios dviejų ar trijų komponentų sąsają; atpažįstami produktų šablonai, sukurti iš kelių komponentų; ir visos mažosios programėlės, sudėtos taip, kaip komponentai naudojami tikruose produktuose. Kiekvieno komponento puslapyje /ui pateikiama daugiau praktinių pavyzdžių – nuo laukelio su etikete iki kalendoriaus iššokančiame lange.

Interaktyvumas

Direktyvomis ir saugyklomis pagrįstas modelis, kuriuo kuriami UI komponentai, ir kaip jį naudoti savo blokuose.