Vászon
A vászon távolabbról mutatott, Figma-szerű áttekintést nyújt az összes, Blockstudio által kezelt oldalról. Minden oldal élő iframe-alapú rajzfelületként jelenik meg egyetlen vízszintes sorban. A trackpaddel pásztázhat, a csippentéssel vagy a Ctrl+görgetéssel nagyíthat és kicsinyíthet.
Aktiválás
A vászon rejtett adminisztrációs oldalként érhető el. Navigáljon ide:
/wp-admin/admin.php?page=blockstudio-canvas
Az oldal csak akkor érhető el, ha a dev.canvas.enabled true értékű, és az aktuális felhasználó rendelkezik a edit_posts jogosultsággal.
Beállítások
A vászon engedélyezéséhez és működésének beállításához használja a téma blockstudio.json fájlját:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
| Tulajdonság | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
enabled |
boolean |
false |
A vászonfunkció engedélyezése. |
adminBar |
boolean |
true |
A WordPress adminisztrációs sáv megjelenítése a rajzfelületek iframe-jeiben. Állítsa false értékre a letisztultabb előnézethez. |
Mindkét beállítás szűrőként is elérhető:
add_filter('blockstudio/settings/dev/canvas/enabled', '__return_true');
add_filter('blockstudio/settings/dev/canvas/admin_bar', '__return_false');
Nézetek
A nézetek között a jobb felső sarokban lévő legördülő menüvel válthat.
- Oldalak: az összes, Blockstudio által kezelt oldal teljes szélességű rajzfelületként, egyetlen sorban.
- Blokkok: az összes regisztrált Blockstudio blokk rácsos elrendezésben, alapértelmezett attribútumértékeikkel megjelenítve.
Nyilvános leltár és dokumentum-API
A Canvas verziózott, fogyasztósemleges PHP szerződést tesz elérhetővé azoknak az eszközöknek, amelyeknek ugyanazokra a regisztrált tartalmakra van szükségük anélkül, hogy újra kellene építeniük a Blockstudio felderítési vagy renderelési logikáját:
use Blockstudio\Canvas;
$all = Canvas::inventory();
$changed = Canvas::inventory([
'blocks' => ['theme/hero'],
'pages' => ['about'],
]);
$documents = Canvas::documents([
'patterns' => ['theme/featured'],
'templates' => ['front-page'],
]);
Az aktuális verzió itt érhető el: Canvas::SCHEMA_VERSION. A leltár eredményei a következőket tartalmazzák:
inventory: normalizáltpages,blocks,patterns,templates,partsés nyilvánosuicsaládpéldákorder: a típusok közötti stabil megjelenítési sorrendsources: pontosan kiválasztott forrásútvonalak, minden rekordhoz származási adatokkal; egy oldalrekordsourceértéke a stabil forrásazonosság, míg apatha fizikai renderelési sablon útvonalawarningséserrors: strukturált problémák kimenet létrehozása helyettdeleted: a már nem létező kért azonosítókselection: a normalizált kiválasztás, és hogy célzott volt-e
A Canvas::documents() minden kiválasztott rekordhoz egy teljes renderelési dokumentumot ad hozzá. Minden dokumentum tartalmazza a törzsét, az összeállított HTML-t, a függőségekkel együtt feloldott blokkok neveit, valamint a pontos CSS, JavaScript, modulokat, interaktivitási inicializálást, csomagolt UI globális változókat és Tailwind kimenetet. Az oldaldokumentumok szemantikai <main> tartalomburkolót használnak; a hívók a közös Render dokumentum beállításaival felülbírálhatják vagy kikapcsolhatják. Minden kiválasztott oldal a helyreállított frontend-WordPress kontextusában renderelődik, így a lekérdezési feltételesek, törzsklasszis-szűrők, rövidkódok, elrendezések, átirányítások és wp_enqueue_scripts visszahívások az adott oldal környezetét látják, nem az adminisztrációét vagy a Canvas-eredményt kérő REST kérését. A hívó által megadott törzsklasszisok egyesülnek az oldal kontextuális osztályaival, a frontend betöltési regiszterei pedig dokumentumonként elkülönülnek. A Canvas ezeket az életciklus-visszahívásokat a nyilvános WordPress függvénynevek alapján oldja fel, így ugyanaz a kontextus marad érvényben akkor is, ha a Blockstudio betöltése Composer használatával vagy áthelyezett alkalmazás-névtérből történik.
A pontos kiválasztás szemantikája
A kiválasztás szigorú:
- Ha nincs felismert típus kulcs, minden típus betöltődik.
- A
true,nullvagy"*"az adott típus minden rekordját betölti. - Egy szöveg vagy lista csak pontos egyezésű azonosítókat, neveket, slugokat, útvonalakat vagy forrásútvonalakat tölt be.
- Üres szöveg/lista vagy
falseesetén az adott típusból semmi sem töltődik be. - Ha legalább egy típus kulcs szerepel, a kihagyott típusok felderítése, szinkronizálása, renderelése és fordítása nem történik meg.
Ez biztonságossá teszi a csak módosult elemeket kérő lekérdezéseket nagy projektek esetén is. A meglévő blokkok és oldalak a kanonikus regisztereken keresztül oldódnak fel. Ha egy frontendkérés csak a tartósan tárolt oldalprojekciót töltötte be, a Canvas csak olvasható forrásfelderítést végez, majd tartalomszinkronizálás nélkül egyesíti az egyező bejegyzésazonosítókat és permalinkeket. Ugyanez az identitásegyesítés akkor is érvényes, ha egy logikai felderítési forrás tölti fel először a forrásalapú regisztert, így az oldal kontextuális renderelése továbbra is a megfelelő, kezelt WordPress bejegyzést használja. Az új, élő munkamenet-topológia csak a módosult könyvtár körül kerül felderítésre, míg a kiválasztott minták és a Site Editor sablonforrásai csak a kiválasztás után fordulnak le.
A REST frissítési végpont ugyanezt a szabályt követi a meglévő blocks és pages lekérdezési paraméterek esetén. Például a ?blocks=theme/hero csak az adott blokkot adja vissza, oldalakat nem; vegyes válaszhoz használja mindkét paramétert. Ha a végpontot egyik paraméter nélkül hívja meg, a teljes, korábbi válasz marad érvényben.
Élő mód
Az élő mód Server-Sent Events (SSE) használatával érzékeli a fájlváltozásokat, és valós időben frissíti a vásznat. Blokksablon, oldalsablon vagy stíluslap szerkesztésekor az érintett rajzfelületek körülbelül egy másodpercen belül automatikusan frissülnek.
Az élő mód a legördülő menüből kapcsolható be és ki. Bekapcsolt állapotban zöld, pulzáló jelzőfény látható. A beállítás a localStorage segítségével munkamenetek között is megmarad.
Az élő mód a blokkok és oldalak könyvtárain belüli .php, .json, .css, .scss, .js, .twig és .html fájlok változásait figyeli. Az ismert szerkesztések csak a hozzájuk regisztrált blokkot vagy oldalt frissítik. Egy valóban új blokk vagy oldal egyszeri, könyvtárra korlátozott topológiai felderítést indít, így a tartalom létrehozása nyitott élő munkamenetben is működik, a nem kapcsolódó források újbóli átvizsgálása nélkül.
Fókusz mód
Kattintson bármelyik rajztábla címkéjére a fókuszmódba lépéshez. A kiválasztott rajztábla teljes szélességben kitölti a nézetet, függőleges görgetéssel. Az áttekintéshez az Escape billentyűvel vagy a bezárás gombra kattintva térhet vissza.
Vezérlők
| Művelet | Bevitel |
|---|---|
| Pásztázás | Görgetés / kétujjas húzás az érintőpadon |
| Nagyítás | Ctrl+görgetés vagy csippentés |
| Igazítás a nézethez | Legördülő menü |
| Nagyítás 100%-ra | Legördülő menü |
| Rajztábla fókuszba állítása | Kattintás a rajztábla címkéjére |
| Fókusz bezárása | Escape / bezárás gomb |
Biztonság
A vászon szkriptje és az oldal adatai csak akkor töltődnek be, ha minden feltétel teljesül:
- A
dev.canvas.enabledbeállítás értéketrue. - Az aktuális felhasználó rendelkezik a
edit_postsjogosultsággal.
A nyilvános látogatók soha nem látják a vászon szkriptjét vagy az oldal metaadatait.