Platno
Platno omogoča pomanjšan pregled vseh strani, ki jih upravlja Blockstudio, podoben okolju Figma. Vsaka stran je prikazana kot živa delovna površina iframe v eni vodoravni vrstici. Pomikajte se s sledilno ploščico, povečujte s približevanjem prstov ali s Ctrl+scroll.
Aktivacija
Platno je na voljo kot skrita skrbniška stran. Odprite:
/wp-admin/admin.php?page=blockstudio-canvas
Stran je dostopna samo, če je dev.canvas.enabled true in ima trenutni uporabnik zmožnost edit_posts.
Nastavitve
Omogočite platno in konfigurirajte njegovo delovanje v temi blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
| Lastnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
enabled |
boolean |
false |
Omogoči funkcijo platna. |
adminBar |
boolean |
true |
Prikaži skrbniško orodno vrstico WordPress znotraj iframe delovne površine. Nastavite na false za čistejši predogled. |
Obe nastavitvi sta na voljo tudi kot filtra:
add_filter('blockstudio/settings/dev/canvas/enabled', '__return_true');
add_filter('blockstudio/settings/dev/canvas/admin_bar', '__return_false');
Pogledi
Med pogledi preklapljajte z uporabo spustnega menija v zgornjem desnem kotu.
- Strani: vse strani, ki jih upravlja Blockstudio, prikazane kot delovne površine polne širine v eni vrstici.
- Bloki: vsi registrirani bloki Blockstudio v mrežni postavitvi, vsak upodobljen s privzetimi vrednostmi atributov.
Javni inventar in dokument API
Canvas razkriva različico PHP pogodbe, neodvisne od porabnika, za orodja, ki potrebujejo isto registrirano vsebino, ne da bi znova ustvarjala logiko za odkrivanje ali upodabljanje Blockstudio:
use Blockstudio\Canvas;
$all = Canvas::inventory();
$changed = Canvas::inventory([
'blocks' => ['theme/hero'],
'pages' => ['about'],
]);
$documents = Canvas::documents([
'patterns' => ['theme/featured'],
'templates' => ['front-page'],
]);
Trenutna različica je na voljo kot Canvas::SCHEMA_VERSION. Rezultati inventarja vsebujejo:
inventory: normaliziranepages,blocks,patterns,templates,partsin primere javne družineuiorder: stabilni vrstni red prikaza med vrstamisources: natančno izbrane izvorne poti s podatki o izvoru za vsak zapis; vrednostsourcezapisa strani je njegova stabilna izvorna identiteta, medtem ko jepathpot do fizične predloge za upodabljanjewarningsinerrors: strukturirane težave namesto ustvarjenega izhodadeleted: zahtevani identifikatorji, ki ne obstajajo večselection: normaliziran izbor in podatek, ali je bil ciljno usmerjen
Canvas::documents() doda en celoten dokument za upodabljanje za vsak izbrani zapis.
Vsak dokument vsebuje svoje telo, sestavljeni HTML, imena blokov z zaprtimi odvisnostmi in natančne CSS, JavaScript, module, zagonsko kodo za interaktivnost, globalne spremenljivke v paketu UI in izhod Tailwind. Dokumenti strani uporabljajo pomensko ovojnico vsebine <main>; klicatelji jo lahko preglasijo ali onemogočijo prek skupnih možnosti dokumenta Render.
Vsaka izbrana stran se upodobi v lastnem obnovljenem kontekstu WordPress za sprednji del, zato pogojniki poizvedb, filtri razredov telesa, kratke kode, postavitve, preusmeritve in povratni klici wp_enqueue_scripts zaznajo kontekst te strani, ne pa skrbniške zahteve ali zahteve REST, ki je zahtevala rezultat Canvas. Razredi telesa, ki jih poda klicatelj, se združijo s kontekstnimi razredi strani, registri za dodajanje elementov v čakalno vrsto v sprednjem delu pa so med dokumenti ločeni. Canvas te povratne klice življenjskega cikla poišče po javnih imenih funkcij WordPress, zato se isti kontekst ohrani tudi, ko se Blockstudio naloži prek Composer ali prestavljenega imenskega prostora aplikacije.
Semantika natančnega izbora
Izbor je strog:
- Če ni prepoznan noben ključ vrste, se naložijo vse vrste.
true,nullali"*"naloži vse zapise te vrste.- Niz ali seznam naloži samo natančne ID-je, imena, sluge, poti ali izvorne poti.
- Prazen niz/seznam ali
falsene naloži ničesar za to vrsto. - Ko je prisoten kateri koli ključ vrste, se izpuščene vrste ne odkrijejo, sinhronizirajo, upodobijo ali prevedejo.
Zato so zahteve samo za spremenjene elemente varne pri velikih projektih. Obstoječi bloki in strani se razrešijo prek svojih kanoničnih registrov. Če je pri zahtevi iz sprednjega dela naložena samo trajno shranjena projekcija strani, Canvas izvede odkrivanje izvornih virov samo za branje in združi ujemajoče se ID-je objav ter stalne povezave, ne da bi sinhroniziral vsebino. Enako združevanje identitet velja, kadar logični vir odkrivanja najprej napolni register, vezan na izvor; zato kontekstno upodabljanje strani še vedno uporablja ustrezno upravljano objavo WordPress. Nova topologija seje v živo se odkrije samo okoli spremenjenega imenika, medtem ko se izbrani viri vzorcev in predlog urejevalnika spletnega mesta prevedejo šele po izboru.
Končna točka za osveževanje REST upošteva isto pravilo za obstoječa parametra poizvedbe blocks in pages. Na primer,
?blocks=theme/hero vrne ta blok in nobene strani; za mešani odgovor uporabite oba parametra. Klic končne točke brez katerega koli od njiju ohrani celoten podedovani odgovor.
Način v živo
Način v živo uporablja dogodke, ki jih pošilja strežnik (SSE), za zaznavanje sprememb datotek in sprotno posodabljanje platna. Ko uredite predlogo bloka, predlogo strani ali slogovno datoteko, se prizadete delovne površine samodejno osvežijo v približno eni sekundi.
Način v živo vklopite ali izklopite v spustnem meniju. Ko je aktiven, se prikaže utripajoč zeleni indikator. Nastavitev se ohrani med sejami prek localStorage.
Način v živo spremlja spremembe datotek .php, .json, .css, .scss, .js, .twig in .html v imenikih blokov in strani. Znane spremembe osvežijo samo registrirani blok ali stran. Resnično nov blok ali stran sproži en prehod za pregled topologije, omejen na imenik, zato ustvarjanje vsebine med odprto sejo v živo deluje brez ponovnega pregleda nepovezanih virov.
Način osredotočanja
Kliknite katero koli oznako delovne površine, da vstopite v način osredotočanja. Izbrana delovna površina zapolni pogled s polno širino in navpičnim drsenjem. Pritisnite Escape ali kliknite gumb za zapiranje, da se vrnete na pregled.
Kontrolniki
| Dejanje | Vnos |
|---|---|
| Pomik | Pomikanje / vlečenje z dvema prstoma po sledilni ploščici |
| Povečava | Ctrl+scroll ali približevanje prstov |
| Prilagodi pogledu | Spustni meni |
| Povečava na 100% | Spustni meni |
| Osredotoči delovno površino | Kliknite oznako delovne površine |
| Zapusti način osredotočanja | Escape / gumb za zapiranje |
Varnost
Skripta platna in podatki strani se naložijo samo, ko so izpolnjeni vsi pogoji:
- Nastavitev
dev.canvas.enabledjetrue. - Trenutni uporabnik ima zmožnost
edit_posts.
Javni obiskovalci nikoli ne vidijo skripte platna ali metapodatkov strani.