Preskoči na vsebino

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:

Koda
/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:

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:

PHP
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:

PHP
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: normalizirane pages, blocks, patterns, templates, parts in primere javne družine ui
  • order: stabilni vrstni red prikaza med vrstami
  • sources: natančno izbrane izvorne poti s podatki o izvoru za vsak zapis; vrednost source zapisa strani je njegova stabilna izvorna identiteta, medtem ko je path pot do fizične predloge za upodabljanje
  • warnings in errors: strukturirane težave namesto ustvarjenega izhoda
  • deleted: 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, null ali "*" 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 false ne 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.enabled je true.
  • Trenutni uporabnik ima zmožnost edit_posts.

Javni obiskovalci nikoli ne vidijo skripte platna ali metapodatkov strani.