Komponentit
Koostaminen
Mukana tulevat UI-komponentit on suunniteltu koottaviksi, ei käytettäviksi yksitellen. Valintaluettelo avautuu valintaikkunassa, lomake validoidaan sivupaneelissa ja valikko sijoittuu taulukkoriville. Tällä sivulla selitetään, miten nämä osat toimivat yhdessä: miten yhdistelmäperheet on rakennettu, miten käynnistimet välittävät painikkeen ominaisuuksia, mitä Interactivity API tekee taustalla ja millä kerrosmallilla päällekkäiset pinnat pysyvät yhtenäisinä.
Yhdistelmäperheet
Yhdistelmäkomponentti koostuu juurilohkosta ja alilohkoista. Juuri hallitsee tilaa; kukin alilohko määrittää paikkansa perheessä parent- ja usesContext-arvoilla omassa block.json-tiedostossaan:
{
"name": "bsui/select-option",
"parent": ["bsui/select-popup"],
"usesContext": ["bsui/select"]
}
Juuret tarjoavat InnerBlocks-alueen, jossa on allowedBlocks-luettelo ja aloitus-template. Kun lisäät valintaikkunan editorissa, sen käynnistin, tausta ja ponnahdusikkuna luodaan automaattisesti. Perhe toimii samalla tavalla riippumatta siitä, kootko sen editorissa, tiedostopohjaisella sivulla vai tunnisteissa:
<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>
Ponnahdusikkunat ja paneelit ovat oikeita InnerBlocks-alueita, eivät erikoissyntaksia käyttäviä paikkoja. bsui/dialog-popup hyväksyy sisäkkäisiä lohkoja samalla tavalla kuin ryhmälohko, joten lomakkeen, valintaluettelon tai toisen valintaikkunan sijoittaminen sen sisään on tavallista koostamista.
Tasainen data tai kootut lapset
Joissakin perheissä sisältö annetaan datana lasten sijaan. Valintaluettelo luo oman käynnistimensä ja luettelonsa, kun sille annetaan options JSON -taulukko. Tämä sopii vaihtoehdoille, jotka tulevat lähteestä 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'],
]),
],
]);
Molemmat tavat tuottavat saman merkintärakenteen ja saman ajonaikaisen toiminnan. Käytä lapsia, kun rakenne kirjoitetaan käsin, ja optionsa, kun se lasketaan.
Käynnistimen ominaisuuksien välitys
Peittokomponentit avautuvat painikkeesta, ja painikkeen tulee olla järjestelmän painike. Sen sijaan, että kukin käynnistin toteuttaisi painikkeen uudelleen, komponenttien bsui/dialog, bsui/alert-dialog, bsui/drawer, bsui/menu, bsui/popover, bsui/collapsible ja bsui/tooltip käynnistinlohkot sisällyttävät bsui/buttonn lohkokentän avulla:
{
"blockstudio": {
"attributes": [
{
"id": "trigger",
"type": "block",
"block": "bsui/button",
"idStructure": "trigger_{id}"
}
]
}
}
idStructure laajentaa painikkeen kentät käynnistimeen etuliitteellä trigger_. Käytettävissä ovat kaikki painikkeen ominaisuudet: trigger_label, trigger_variant, trigger_size, trigger_icon, trigger_iconPosition, trigger_href, trigger_disabled.
<bs:bsui-dialog-trigger trigger_label="Invite teammate" trigger_variant="outline" />
Käynnistimen mallissa $a['trigger'] on kokonaan renderöity painike, joten painikkeen tyylitiedosto ja tulevat parannukset kulkevat sen mukana. Ajon aikana jaettu apufunktio välittää kääreen ARIA-määritykset (aria-haspopup, aria-expanded, aria-controls, aria-describedby, aria-labelledby, id) sisemmälle painikkeelle ja pitää sen synkronoituna MutationObservern avulla, jolloin avustava teknologia näkee yhden yhtenäisen ohjaimen.
Taustalla toimiva Interactivity API
Jokainen vuorovaikutteinen perhe on WordPress Interactivity API-kauppa, joka on nimetty juurilohkonsa mukaan: bsui/dialog, bsui/select, bsui/form, bsui/tabs ja niin edelleen. Tästä seuraa kolme asiaa.
Tila alustetaan palvelinpuolella. Juuren malli tulostaa alkutilansa muodossa data-wp-context suoraan lohkon määritteistä:
<div
data-wp-interactive="bsui/select"
data-wp-context='{"open":false,"value":"","placeholder":"Pick a role", ...}'
data-bsui-select-root
>
Ensimmäinen näkymä on oikein HTML ilman asiakaspuolen hydratoitumisvälähdystä, ponnahdusikkunat alkavat tilasta hidden, ja sama merkintä toimii editorin kanvaasissa, koska konteksti ei riipu vain käyttöliittymässä tehtävästä tilavaiheesta.
Toiminta määritellään direktiiveillä, ei omalla JavaScriptlläsi. Mallit yhdistävät merkinnän kauppoihin deklaratiivisesti. Kun valintaluettelon käynnistimestä poistetaan PHP, jäljelle jäävät vain direktiivit:
<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 ohjaa tapahtumat toimintoihin, data-wp-bind pitää määritteet synkronissa johdetun tilan kanssa, data-wp-text renderöi tilan tekstinä ja data-wp-on-document--click antaa juurille ulkopuolisen napsautuksen perusteella sulkeutumisen. Komponenttien koostaminen ei koskaan edellytä tapahtumankäsittelijän kirjoittamista; kauppa sisältyy lohkoon sisäisenä moduulina.
Kauppasi voivat liittyä näihin rajapintoihin. Lomakeohjaimet hyväksyvät direktiivilausekkeita määritteiksi, ja Interactivity APIn nimiavaruudellinen syntaksi voi kohdistaa ne mihin tahansa kauppaan. onChange ohjaa muutosten käsittelyn johonkin toimintoosi, checked sitoo ohjaimen tilan tilaasi ja bindText renderöi tunnisteen muodossa data-wp-text-väli, joka on sidottu mihin tahansa tilapolkuun:
<bs:bsui-switch label="Notifications" checked="myPlugin::state.notifications" onChange="myPlugin::actions.toggleNotifications" />
<bs:bsui-checkbox label="0 selected" bindText="myPlugin::state.selectionSummary" />
bindText on käytettävissä kohteissa bsui/label, bsui/checkbox, bsui/switch, bsui/toggle ja bsui/radio-group. Valintaruutu-, kytkin- ja valintanappikohteissa se kulkee jaettuun tunnisteperustaan, joten tilan mukaan vaihtuvassa tekstissä käytetään täsmälleen järjestelmän tunnisteen typografiaa. Valintaluettelot ja muut syötteet lähettävät lisäksi juurestaan kuplivan change-tapahtuman, jonka detail sisältää uuden arvon. Tämä sopii karkeamman tason integraatioihin.
Hallitut arvot
Jätä value tai checked määrittämättä, jos ohjaus hallitsee itse arvoaan. Määritä defaultValue, defaultChecked tai Toggle-ohjauksen defaultPressed sen alkutilan valintaa varten. Erillinen Toggle käsittelee hiiren ja näppäimistön syötteet ilman kuluttajan tilavarastoa.
Jos haluat hallita kenttää omasta tilavarastostasi, anna sekä sen sidonta että onChange-toiminto, joka päivittää sidotun arvon. value on direktiivipolku, ei kirjaimellinen oletusarvo. Input, Textarea, Password Input, Number Field, Slider, Radio Group, Color Picker, Rating ja Time Picker tukevat value-sidontaa.
Checkbox, Switch ja Toggle käyttävät sen sijaan checked-sidontaa.
Määritä polkuihin omistajan nimiavaruus, esimerkiksi my/settings::context.quantity tai my/settings::state.quantity. Yhdistelmäohjaimilla on oma nimiavaruutensa. Määrittämätön polku viittaa kyseiseen ohjaimeen, ei automaattisesti ylävirran tilavarastoon. Yhdistelmäohjainten arvosidonnat tukevat kontekstiin tai tilaan johtavia pistepolkuja ja numeerisia taulukkoavaimia, mutta eivät JavaScript-lausekkeita tai funktiokutsuja.
Tässä on täydellinen esimerkki Number Field -sidonnasta mukautetussa lohkossa, jossa Interactivity API -tuki on käytössä:
<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>
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;
}
},
},
});
Aseta vastaava oletusarvo palvelimella renderöitävälle alkuarvolle. Kun komponentti on alustettu, ylätason muutokset päivittävät jokaisen sidotun ilmentymän, myös arvoilla nolla, false ja tyhjä. Checkbox- ja Switch-ohjainten piilotetut lomakesyötekentät seuraavat myös niiden checked-sidontaa. Time Picker -arvot käyttävät 24 tunnin muotoa HH:MM tai tyhjää merkkijonoa.
Lue natiivien Input-, Textarea- ja Password Input -käsittelijöiden arvo kohdasta event.target.value. Yhdistelmäarvo-ohjaimet julkaisevat sen kohdassa event.detail.value.
Number Field -raja-arvot ovat valinnaisia: määrittämättömät min ja max jättävät arvon rajoittamattomaksi, kun taas nolla on kelvollinen raja-arvo.
Select, Date Input, Phone Input ja OTP Input julkaisevat muutokset onChange-kohdassa, mutta eivät tarjoa tätä hallittua value-sidontaa. Käytä niiden dokumentoituja oletusarvo-ominaisuuksia alkuarvojen määrittämiseen.
Koostaminen omista lohkoista
Koostaminen ei rajoitu sivuihin. Lohkotunnisteet renderöidään automaattisesti lohkomallien sisällä, joten projektin lohko voi tuottaa bsui-komponentteja suoraan ja kääriä ne omaan rakenteeseensa:
<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>
Sama toimii myös lähteestä PHP käyttäen bs_block()a, myös sisäkkäin content-avaimen kautta, kuten kohdassa ohjelmallinen renderöinti kuvataan. Kummassakin tapauksessa komponentin tyylitiedosto ja kauppa latautuvat sen mukana, ja lohkosi pysyy ohuena asettelukerroksena järjestelmän osien päällä.
Komponenttien asetteluun rinnakkain bsui/stack on yleiskäyttöinen joustorivi tai -sarake: direction, gap välistysasteikolla, align, justify ja wrap-kytkin. Lapset säilyttävät oletusarvoisesti luonnollisen kokonsa. grow-kytkin venyttää niitä niin, että ne jakavat pinon pituuden tasan. Näin alatunnisteen kaksi painiketta jakavat sen leveyden sen sijaan, että jäisivät vierekkäin toiseen reunaan.
Kenttäryhmät ja kortit
bsui/field-group renderöi kenttäryhmän. Oletusversio ryhmittelee toisiinsa liittyvät kentät lisäämättä taustapintaa. Käytä variant="card"-versiota himmennettyyn ulkokehykseen ja sijoita sitten kentät bsui/field-group-content-elementin sisään, jotta saat sisennetyn sisältöpinnan. Jätä otsikko ja kuvaus tämän sisältölohkon ulkopuolelle:
<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"-ryhmässä käyttää natiivin fieldset-elementin toimintaa lomakeohjainten poistamiseen käytöstä. Kortin tyylittely ei muuta oletusvarianttia.
Työkalurivin erottimet
Sijoita bsui/toolbar-separator työkalurivin kohteiden väliin. Se noudattaa ylätason työkalurivin orientation-asetusta: vaakasuora työkalurivi saa täyskorkean pystysuuntaisen erottimen, ja pystysuora työkalurivi täysleveän vaakasuuntaisen erottimen. Erottimet ulottuvat työkalurivin reunuksen sisäreunoihin muuttamatta ohjainten korkeutta. Vaakasuora työkalurivi vierittää sisältöään, kun se ylittää käytettävissä olevan leveyden.
Kerrosmalli
Päällekkäiset pinnat ovat usein kohta, jossa komponenttikirjastot hajoavat. Mukana tulevat komponentit noudattavat muutamaa sääntöä, jotka on tehty oikeita käyttöliittymiä rakentaville.
Modaali-ikkunat siirretään body-elementtiin
Kun valintaikkuna, hälytysvalintaikkuna tai sivupaneeli avataan, sen ponnahdusikkuna ja tausta siirretään kohteeseen document.body. Paikkamerkkikommentti merkitsee alkuperäisen paikan, johon ne palautetaan suljettaessa. Portaalin ansiosta modaali ei ole minkään yläelementin overflow-, muunnos- tai pinoamiskontekstin rajoittama. Avaaminen lukitsee myös sivun vierityksen: lukitukset lasketaan kaikissa peittokomponenteissa, ja vierityspalkin leveys huomioidaan, jotta sivu ei siirry. Tausta on tasolla z-index: 50, ponnahdusikkuna tasolla 51, kohdistus siirtyy ponnahdusikkunaan, sarkainnäppäin pysyy sen sisällä ja sulkeminen palauttaa kohdistuksen käynnistimeen.
Modaalit pinoutuvat. Kun valintaikkuna avataan toisen valintaikkunan sisältä, se lisätään samaan pinoon: taustanäyttö näkyy vain uloimmalle valintaikkunalle, ja ylimmän takana olevat valintaikkunat pienenevät ja pilkistävät sen takaa. Pino määrittää --bs-ui-nested-dialogs-mukautetun ominaisuuden jokaiselle taustalla olevalle ponnahdusikkunalle, joten pilkistävä siirtymä ja pienennys kasvavat jokaisella tasolla. Ylemmän valintaikkunan korkeus sovitetaan alemman korkeuteen, jotta tasot pilkistävät tasaisesti. Suljettaessa kaikki palautuu päinvastaisessa järjestyksessä, yksi taso kerrallaan.
Kun modaali suljetaan, kohdistus palautuu sen avaavaan elementtiin ja oikeaan kohteeseen. Jaettu getAnchor-apufunktio muuntaa avaavan kääreen sisällä olevan järjestelmäpainikkeen kohteeksi, jotta näkyvä ohjaus saa kohdistuksen näkymättömän kääreen sijaan.
Ylintä modaalista ei koskaan muunnella
Pilkistävä vaikutus muuntaa vain taustalla olevia valintaikkunoita. Ylin modaali jätetään tarkoituksella muuntamatta, koska muunnetusta elementistä tulee sen position: fixedjälkeläisten sisältävä lohko, mikä rikkoisi kaikki sen sisällä avattavat kelluvat ponnahdusikkunat.
Tämä sääntö saa koko tasomallin toimimaan yhdessä. Kaikki kelluvat tasot sijoittuvat kiinteillä koordinaateilla, jotka viittaavat näkymäalueeseen vain silloin, kun niiden ja näkymäalueen välissä ei ole muunnettua elementtiä:
- Valikko ja yhdistelmäruutu laskevat sijaintinsa laukaisimen perusteella Floating UI
fixed-strategialla: ne avautuvat sen alapuolelle ja kääntyvät tai siirtyvät, jos näkymäalue ei riitä. - Valintaluettelo toimii samoin, kun mitään ei ole valittuna. Jos valinta on jo tehty, ponnahdusikkuna kohdistetaan niin, että valittu vaihtoehto on suoraan laukaisimen yläpuolella näkymäalueen rajojen sisällä, kuten natiivissa valintaluettelossa macOS.
- Pikavalikko avautuu osoittimen kohdassa
clientX/clientY.
Koska ylin modaali on muuntamaton, kaikki nämä elementit ankkuroidaan oikein omiin laukaisimiinsa valintaikkunan, hälytysvalintaikkunan tai vetolaatikon sisällä millä tahansa sisäkkäisyyden tasolla. Ponnahdusikkunoiden ei tarvitse tietää olevansa modaalin sisällä.
Escape sulkee sisimmän tason ensin
Yksi Escape-näppäimen painallus sulkee täsmälleen yhden tason sisältä ulospäin:
- Avoin kelluva taso (valintaluettelo, valikko, ponnahdusikkuna tai päivämäärä- tai puhelinnumeroponnahdusikkuna) sulkeutuu ensin ja palauttaa kohdistuksen avaavaan elementtiinsä. Valintaluettelo pysäyttää tapahtuman etenemisen, ja modaalien käsittelijät pidättäytyvät toiminnasta aina, kun jokin kelluva taso on auki, joten alla oleva valintaikkuna ei havaitse painallusta.
- Ylin modaali sulkeutuu seuraavaksi.
- Jos modaaleja on pinossa, jokainen seuraava Escape sulkee pinosta yhden lisää.
Sulkeminen on käytäntö, ei sattumaa. dismissable="false"-määrityksellä renderöity valintaikkuna ohittaa sekä Escape-näppäimen että taustan napsautukset. bsui/alert-dialog reagoi Escape-näppäimeen kuten mikä tahansa modaali, mutta ohittaa tarkoituksella taustan napsautukset: tämän mallin tarkoitus on, että valinta tehdään erikseen eikä sisältö sulkeudu vahingossa. Tavallinen valintaikkuna sulkeutuu, kun taustaa napsautetaan, sillä dismissable on oletusarvoisesti true.
Lomake valintaikkunassa
Malli, joka testaa kaikki yllä olevat säännöt kerralla: laukaisin avaa modaalin, modaali sisältää validoitavan lomakkeen ja lomake sisältää kelluvan valintaluettelon.
<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>
Kaikki yllä olevat tunnisteet ja attribuutit ovat toiminnan kannalta olennaisia: laukaisin välittää toiminnon järjestelmäpainikkeelle, otsikko ja kuvaus saavat content-määrityksen, kentissä on lomakkeen sarjoittamat nimet ja required="true" muunnetaan tagien jäsentimessä oikeaksi boolean-arvoksi.
Kunkin tilan toiminta suorituksen aikana
bsui/dialog alustaa {"open":false,"dismissable":true}-arvon palvelimella kontekstiin. Laukaisimen napsautus suorittaa actions.open: ponnahdusikkuna ja taustanäyttö siirretään portaalilla body-elementtiin, vieritys lukitaan vierityspalkin tilan huomioivalla korjauksella, ponnahdusikkuna avautuu 150ms:n aikana, kohdistus siirtyy sen ensimmäiseen kohdistettavaan elementtiin ja sarkainnäppäimellä voi siirtyä vain sen sisällä. Ylätunnisteen, sisällön ja alatunnisteen alueet sijoittuvat modaalien välistysmerkkien mukaan.
bsui/select odottaa lomakkeen sisällä valintaluettelonsa hidden kanssa. Laukaisimen napsautus vaihtaa context.open-tilan, sijoittaa valintaluettelon kiinteillä näkymäalueen koordinaateilla ja, koska defaultValue="editor" on jo valittuna, kohdistaa ponnahdusikkunan niin, että Editor on suoraan laukaisimen päällä. Nuolinäppäimet, Home, End ja kirjoittamalla haku siirtävät aktiivista vaihtoehtoa; Enter tai napsautus valitsee vaihtoehdon; sarkainnäppäin ja napsautukset ulkopuolella sulkevat luettelon valitsematta. Laukaisimen näkyvä teksti päivittyy data-wp-text="state.displayValue"-arvon kautta, ja piilotettu <input name="role"> seuraa arvoa data-wp-bind--value="state.selectedValue"-määrityksen kautta, jolloin lomake voi myöhemmin sarjoittaa sen. Kaikki nämä elementit ankkuroidaan oikein valintaikkunan sisällä, koska ylin modaali on muuntamaton.
bsui/form käsittelee lähetyksen. Lomakkeen lopussa oleva bsui/button renderöi tavallisen button-elementin ilman type-attribuuttia, joten se on lomakkeen lähetysohjaus HTML-oletuksen mukaisesti. Peruuta-painike on alatunnisteessa form-elementin ulkopuolella, eikä se voi lähettää mitään. Lähetyksen yhteydessä tila sarjoittaa lomakkeen FormData-arvot ja lähettää ne lohkon block-määrityksessä nimetyn lohkon data-API-käsittelijälle. Tässä tapauksessa se luo rivin lohkon team/invite tietokantakaavioon. Validointivirheet palautetaan kenttäkohtaisesti: jokainen bsui/field saa oman name-arvonsa, merkitään virheelliseksi, saa kohdistusrenkaansa osoittamaan varoitusväriä ja näyttää viestin bsui/field-error-hälytyksessään. Onnistumisen jälkeen lomakkeen sisältö piilotetaan ja successMessage näytetään, molemmat data-wp-bind--hidden-määrityksen kautta.
Tasot sulkeutuvat järjestyksessä. Kun valintaluettelo on auki, Escape sulkee sen ja palauttaa kohdistuksen valintaluettelon laukaisimeen. Seuraava Escape sulkee valintaikkunan ja palauttaa kohdistuksen Kutsu työtoveri -painikkeeseen. Taustan napsautus sulkee valintaikkunan, koska dismissable jätettiin oletusarvoonsa. Sulkeminen vapauttaa vierityksen ja palauttaa ponnahdusikkunan portaalista takaisin alkuperäiseen paikkaansa dokumentissa.
Sama merkkaus tiedostopohjaiselle sivulle liitettynä synkronoidaan natiiveiksi lohkoiksi, ja editorissa koottu sama kokonaisuus näkyy vuorovaikutteisena esikatseluna kanvaasissa, koska kaikki yllä kuvatut toiminnot toteutetaan direktiiveillä ja tiloilla, jotka latautuvat molemmissa yhteyksissä.
Mikä pitää nämä rajapinnat toimivina
Yllä kuvatut rajapinnat eivät ole käytäntöjä, vaan kirjaston kaikkialla renderöidessä ylläpitämiä invariantteja: jokainen tunniste saa saman typografian, jokaisella modaalin ponnahdusikkunalla on sama pinta ja se himmentää sivua taustallaan, kelluvat ponnahdusikkunat pysyvät ankkuroituina laukaisimiinsa sivun vieriessä ja Escape sulkee täsmälleen yhden tason kerrallaan sisältä ulospäin. Takaukset pätevät sekä käyttöliittymässä että editorin kanvaasissa oletustokeneilla tai teemasi tokeneilla, joten yhdessä yhteydessä toimiva kokonaisuus toimii samalla tavalla myös muissa.
Esimerkkejä käytössä
Tämän sivun kokonaisuudet ovat kielioppi; /ui/examples on fraasisanakirja. Se kokoaa käytössä renderöityjä kokonaisuuksia kolmelta tasolta: kahden tai kolmen komponentin pareja, jotka havainnollistavat yhden rajapinnan toimintaa, muutamasta komponentista koottuja tunnistettavia tuoteratkaisuja sekä täydellisiä pieniä sovelluksia, jotka on koottu samalla tavalla kuin komponentit toimitetaan oikeiden tuotteiden mukana. Kunkin komponentin sivulla osoitteessa /ui on lisää käytännön esimerkkejä nimetyistä kentistä ponnahdusikkunan takana olevaan kalenteriin.
Direktiivi ja tila ovat perusta, jolle UI-komponentit rakentuvat. Tässä kerrotaan, miten niitä käytetään omissa lohkoissasi.