Plátno
Plátno nabízí oddálený přehled všech stránek spravovaných nástrojem Blockstudio, podobný Figma. Každá stránka se zobrazí jako živá kreslicí plocha v rámci iframe v jediném vodorovném řádku. Posouvejte plochu trackpadem, přibližujte a oddalujte sevřením prstů nebo stisknutím Ctrl při posouvání.
Aktivace
Plátno je dostupné jako skrytá stránka administrace. Přejděte na:
/wp-admin/admin.php?page=blockstudio-canvas
Stránka je přístupná pouze tehdy, když je dev.canvas.enabled true a aktuální uživatel má oprávnění edit_posts.
Nastavení
Povolte plátno a nastavte jeho chování v souboru blockstudio.json své šablony:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
| Vlastnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
enabled |
boolean |
false |
Povolí funkci plátna. |
adminBar |
boolean |
true |
Zobrazí panel administrace WordPress uvnitř iframe kreslicích ploch. Pro čistší náhled nastavte false. |
Obě nastavení jsou dostupná také jako filtry:
add_filter('blockstudio/settings/dev/canvas/enabled', '__return_true');
add_filter('blockstudio/settings/dev/canvas/admin_bar', '__return_false');
Zobrazení
Mezi zobrazeními přepínejte pomocí rozevírací nabídky vpravo nahoře.
- Stránky: všechny stránky spravované nástrojem Blockstudio jako kreslicí plochy přes celou šířku v jediném řádku.
- Bloky: všechny registrované bloky Blockstudio v mřížce, každý s výchozími hodnotami atributů.
Veřejný inventář a API dokument
Canvas zpřístupňuje verzované rozhraní PHP nezávislé na konkrétním konzumentovi pro nástroje, které potřebují stejný registrovaný obsah, aniž by znovu vytvářely logiku zjišťování nebo vykreslování nástroje Blockstudio:
use Blockstudio\Canvas;
$all = Canvas::inventory();
$changed = Canvas::inventory([
'blocks' => ['theme/hero'],
'pages' => ['about'],
]);
$documents = Canvas::documents([
'patterns' => ['theme/featured'],
'templates' => ['front-page'],
]);
Aktuální verze je dostupná jako Canvas::SCHEMA_VERSION. Výsledky inventáře obsahují:
inventory: normalizovanépages,blocks,patterns,templates,partsa ukázky veřejné rodinyuiorder: stabilní pořadí zobrazení napříč typysources: přesně vybrané zdrojové cesty s původem u každého záznamu;sourcezáznamu stránky je stabilní identita jejího zdroje, zatímcopathoznačuje fyzickou cestu šablony vykreslováníwarningsaerrors: strukturované problémy namísto emitovaného výstupudeleted: požadované identifikátory, které už neexistujíselection: normalizovaný výběr a informaci o tom, zda byl cílený
Canvas::documents() přidá jeden úplný dokument vykreslení pro každý vybraný záznam. Každý dokument obsahuje své tělo, sestavené HTML, názvy bloků včetně všech jejich závislostí a přesné CSS, JavaScript, moduly, zaváděcí kód interaktivity, zabalené globální proměnné UI a výstup Tailwind. Dokumenty stránek používají sémantický obal obsahu <main>; volající jej mohou přepsat nebo vypnout prostřednictvím sdílených možností dokumentu Render. Každá vybraná stránka se vykreslí ve vlastním obnoveném kontextu WordPress frontendu, takže podmínky dotazu, filtry tříd těla, shortcody, rozvržení, přesměrování a zpětná volání wp_enqueue_scripts pracují s danou stránkou, nikoli s administrací nebo požadavkem REST, který si vyžádal výsledek plátna. Třídy těla zadané volajícím se spojí s kontextovými třídami stránky a registry frontendových položek se izolují mezi dokumenty. Plátno tato zpětná volání životního cyklu vyhledává podle veřejných názvů funkcí WordPress, takže se tentýž kontext zachová i při načtení Blockstudio přes Composer nebo přes přemístěný jmenný prostor aplikace.
Přesná pravidla výběru
Výběr je striktní:
- Pokud nejsou rozpoznány žádné klíče typů, načtou se všechny typy.
true,nullnebo"*"načte všechny záznamy daného typu.- Řetězec nebo seznam načte pouze přesná ID, názvy, slugy, cesty nebo zdrojové cesty.
- Prázdný řetězec/seznam nebo
falsenenačte žádný záznam daného typu. - Jakmile je uveden klíč některého typu, vynechané typy se nezjišťují, nesynchronizují, nevykreslují ani nekompilují.
Díky tomu jsou požadavky pouze na změněné položky bezpečné i pro velké projekty. Existující bloky a stránky se vyhledají v kanonických registrech. Pokud požadavek frontendu načte pouze trvalou projekci stránky, plátno provede zjišťování zdrojů pouze pro čtení a sloučí odpovídající ID příspěvků a trvalé odkazy bez synchronizace obsahu. Stejné sloučení identit platí, když logický zdroj zjišťování nejprve naplní registr spravovaný ze zdrojů. Kontextové vykreslení stránky tak nadále používá odpovídající spravovaný příspěvek WordPress. Nová topologie aktivní relace se zjišťuje pouze v okolí změněného adresáře a vybrané zdroje vzorů a šablon Site Editoru se kompilují až po výběru.
Koncový bod aktualizace REST dodržuje stejné pravidlo pro existující parametry dotazu blocks a pages. Například ?blocks=theme/hero vrátí daný blok bez stránek; pro smíšenou odpověď použijte oba parametry. Volání koncového bodu bez obou parametrů zachová úplnou odpověď původního formátu.
Živý režim
Živý režim pomocí Server-Sent Events (SSE) detekuje změny souborů a aktualizuje plátno v reálném čase. Když upravíte šablonu bloku, šablonu stránky nebo stylopis, dotčené kreslicí plochy se automaticky obnoví přibližně do jedné sekundy.
Živý režim zapnete či vypnete v rozevírací nabídce. Při aktivaci se zobrazí zelený pulzující indikátor. Nastavení se uchovává mezi relacemi pomocí localStorage.
Živý režim sleduje změny souborů .php, .json, .css, .scss, .js, .twig a .html v adresářích bloků a stránek. Známé úpravy obnoví pouze příslušný registrovaný blok nebo stránku. U skutečně nového bloku či stránky se jednou zkontroluje topologie daného adresáře, takže přidávání obsahu funguje i během otevřené živé relace, aniž by se znovu prohledávaly nesouvisející zdroje.
Režim zaostření
Kliknutím na libovolný štítek kreslicí plochy přejdete do režimu zaměření. Vybraná kreslicí plocha vyplní zobrazovanou oblast v celé šířce a lze ji procházet svisle. Stisknutím Escape nebo kliknutím na tlačítko zavření se vrátíte do přehledu.
Ovládání
| Akce | Vstup |
|---|---|
| Posun | Posouvání / tažení dvěma prsty na trackpadu |
| Přiblížení | Ctrl+posouvání nebo gesto sevření |
| Přizpůsobit zobrazení | Rozbalovací nabídka |
| Přiblížit na 100% | Rozbalovací nabídka |
| Zaměřit kreslicí plochu | Kliknutí na její štítek |
| Ukončit zaměření | Escape / tlačítko zavření |
Zabezpečení
Skript plátna a data stránky se načtou pouze při splnění všech těchto podmínek:
- Nastavení
dev.canvas.enabledjetrue. - Aktuální uživatel má oprávnění
edit_posts.
Veřejní návštěvníci nikdy neuvidí skript plátna ani metadata stránky.