Hoppa till innehåll

Canvas

Canvas ger en utzoomad översikt i Figma-stil över alla sidor som hanteras av Blockstudio. Varje sida visas som en aktiv iframe-arbetsyta i en enda horisontell rad. Panorera med styrplattan och zooma med nypgest eller Ctrl+rullning.

Aktivering

Canvas finns som en dold adminsida. Gå till:

Kod
/wp-admin/admin.php?page=blockstudio-canvas

Sidan är endast tillgänglig när dev.canvas.enabled är true och den aktuella användaren har behörigheten edit_posts.

Inställningar

Aktivera Canvas och konfigurera dess beteende i temats blockstudio.json:

JSON
{
  "dev": {
    "canvas": {
      "enabled": true,
      "adminBar": false
    }
  }
}
Egenskap Typ Standard Beskrivning
enabled boolean false Aktivera Canvas-funktionen.
adminBar boolean true Visa adminfältet för WordPress inuti arbetsytans iframes. Ange false för en renare förhandsvisning.

Båda inställningarna är också tillgängliga som filter:

PHP
add_filter('blockstudio/settings/dev/canvas/enabled', '__return_true');
add_filter('blockstudio/settings/dev/canvas/admin_bar', '__return_false');

Vyer

Växla mellan vyer med rullgardinsmenyn i det övre högra hörnet.

  • Sidor: alla sidor som hanteras av Blockstudio, som arbetsytor i full bredd på en enda rad.
  • Block: alla registrerade Blockstudio-block i ett rutnät, vart och ett renderat med sina standardvärden för attribut.

Offentlig inventering och dokument-API

Canvas tillhandahåller ett versionshanterat PHP-kontrakt som är oberoende av konsument, för verktyg som behöver samma registrerade innehåll utan att återskapa Blockstudios logik för upptäckt eller rendering:

PHP
use Blockstudio\Canvas;

$all = Canvas::inventory();

$changed = Canvas::inventory([
  'blocks' => ['theme/hero'],
  'pages' => ['about'],
]);

$documents = Canvas::documents([
  'patterns' => ['theme/featured'],
  'templates' => ['front-page'],
]);

Den aktuella versionen finns tillgänglig som Canvas::SCHEMA_VERSION. Inventeringsresultaten innehåller:

  • inventory: normaliserade pages, blocks, patterns, templates, parts och exempel från den offentliga ui-familjen
  • order: den stabila visningsordningen mellan typer
  • sources: exakta valda källsökvägar med proveniens för varje post; en sidposts source är dess stabila källidentitet, medan path är den fysiska sökvägen till renderingsmallen
  • warnings och errors: strukturerade problem i stället för genererad utdata
  • deleted: begärda identifierare som inte längre finns
  • selection: det normaliserade urvalet och om det var målinriktat

Canvas::documents() lägger till ett komplett renderingsdokument för varje vald post. Varje dokument innehåller sin brödtext, sammanställd HTML, blocknamn med stängda beroenden och exakta CSS, JavaScript, moduler, startkod för interaktivitet, paketerade globala UI och Tailwind-utdata. Sidokument använder en semantisk innehållsbehållare för <main>; anropare kan åsidosätta eller inaktivera den via de gemensamma alternativen för renderingsdokument. Varje vald sida renderas i sitt eget återställda frontend-WordPress-sammanhang, så frågevillkor, filter för body-klasser, kortkoder, layouter, omdirigeringar och återanropsfunktioner för wp_enqueue_scripts ser den sidan i stället för admin- eller REST-begäran som efterfrågade Canvas-resultatet. Body-klasser som anroparen tillhandahåller slås samman med sidans kontextuella klasser, och frontendens köregister isoleras mellan dokument. Canvas hittar dessa livscykelåteranrop via deras offentliga funktionsnamn för WordPress, så samma sammanhang bevaras när Blockstudio laddas via Composer eller ett omplacerat applikationsnamnområde.

Exakt urvalssemantik

Urvalet är strikt:

  • Inga igenkända typnycklar innebär att alla typer läses in.
  • true, null eller "*" läser in alla poster av den typen.
  • En sträng eller lista läser endast in exakta ID:n, namn, sluggar, sökvägar eller källsökvägar.
  • En tom sträng/lista eller false läser inte in något av den typen.
  • När en typnyckel väl finns upptäcks, synkroniseras, renderas eller kompileras inte utelämnade typer.

Detta gör begäranden som bara omfattar ändringar säkra för stora projekt. Befintliga block och sidor hittas via sina kanoniska register. När en frontendbegäran endast har den beständiga sidprojektionen inläst utför Canvas en skrivskyddad källupptäckt och sammanfogar matchande inläggs-ID:n och permalänkar utan att synkronisera innehåll. Samma identitetssammanfogning gäller när en logisk upptäcktskälla först fyller det källbaserade registret, så att kontextuell sidrendering fortfarande använder det matchande hanterade inlägget av typen WordPress. Ny topologi för den aktiva sessionen upptäcks endast runt den ändrade katalogen, medan valda mönster och mallkällor från Site Editor kompileras först efter urvalet.

Uppdateringsslutpunkten för REST följer samma regel för de befintliga frågeparametrarna blocks och pages. Till exempel returnerar ?blocks=theme/hero det blocket och inga sidor; använd båda parametrarna för ett blandat svar. Om slutpunkten anropas utan någon av parametrarna bevaras det fullständiga äldre svaret.

Live-läge

Live-läget använder Server-Sent Events (SSE) för att upptäcka filändringar och uppdatera Canvas i realtid. När du redigerar en blockmall, sidmall eller formatmall uppdateras berörda arbetsytor automatiskt inom ungefär en sekund.

Aktivera eller inaktivera live-läget från rullgardinsmenyn. En pulserande grön indikator visas när det är aktivt. Inställningen sparas mellan sessioner via localStorage.

Live-läget spårar ändringar i filer av typen .php, .json, .css, .scss, .js, .twig och .html i block- och sidkataloger. Kända ändringar uppdaterar endast det registrerade blocket eller den registrerade sidan. Ett helt nytt block eller en ny sida utlöser en enda topologigenomgång begränsad till katalogen, så att det fortfarande fungerar att skapa innehåll under en öppen livesession utan att orelaterade källor skannas igen.

Fokusläge

Klicka på en arbetsytetikett för att gå till fokusläge. Den valda arbetsytan fyller hela visningsområdet och bredden, med vertikal rullning. Tryck på Escape eller klicka på stängningsknappen för att återgå till översikten.

Kontroller

Åtgärd Inmatning
Panorera Rulla / dra med två fingrar på styrplattan
Zooma Ctrl+rullning eller nypgest
Anpassa till vy Rullgardinsmeny
Zooma till 100% Rullgardinsmeny
Fokusera arbetsyta Klicka på arbetsytans etikett
Avsluta fokus Escape / stängningsknapp

Säkerhet

Canvas-skriptet och siddata läses bara in när alla villkor är uppfyllda:

  • Inställningen dev.canvas.enabled är true.
  • Den aktuella användaren har behörigheten edit_posts.

Offentliga besökare ser aldrig canvas-skriptet eller sidmetadata.