Přejít k obsahu

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:

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

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

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

PHP
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, parts a ukázky veřejné rodiny ui
  • order: stabilní pořadí zobrazení napříč typy
  • sources: přesně vybrané zdrojové cesty s původem u každého záznamu; source záznamu stránky je stabilní identita jejího zdroje, zatímco path označuje fyzickou cestu šablony vykreslování
  • warnings a errors: strukturované problémy namísto emitovaného výstupu
  • deleted: 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, null nebo "*" 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 false nenač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.enabled je true.
  • 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.