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:
/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:
{
"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:
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:
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: normaliseradepages,blocks,patterns,templates,partsoch exempel från den offentligaui-familjenorder: den stabila visningsordningen mellan typersources: exakta valda källsökvägar med proveniens för varje post; en sidpostssourceär dess stabila källidentitet, medanpathär den fysiska sökvägen till renderingsmallenwarningsocherrors: strukturerade problem i stället för genererad utdatadeleted: begärda identifierare som inte längre finnsselection: 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,nulleller"*"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
falselä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ärtrue. - Den aktuella användaren har behörigheten
edit_posts.
Offentliga besökare ser aldrig canvas-skriptet eller sidmetadata.