Ugrás a tartalomhoz

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:

Kód
/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:

JSON
{
  "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ő:

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

PHP
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ált pages, blocks, patterns, templates, parts és nyilvános ui családpéldák
  • order: a típusok közötti stabil megjelenítési sorrend
  • sources: pontosan kiválasztott forrásútvonalak, minden rekordhoz származási adatokkal; egy oldalrekord source értéke a stabil forrásazonosság, míg a path a fizikai renderelési sablon útvonala
  • warnings és errors: strukturált problémák kimenet létrehozása helyett
  • deleted: a már nem létező kért azonosítók
  • selection: 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, null vagy "*" 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 false eseté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.enabled beállítás értéke true.
  • Az aktuális felhasználó rendelkezik a edit_posts jogosultsággal.

A nyilvános látogatók soha nem látják a vászon szkriptjét vagy az oldal metaadatait.