Dennis · 19 maggio 2026
Blockstudio 7.3
Blockstudio 7.3 aggiunge un nuovo livello al framework: componenti UI riutilizzabili, visualizzabili come qualsiasi altro blocco.
Se la versione 7.1 ha trasformato i blocchi in applicazioni full-stack e la 7.2 ha reso più facile ispezionare, convalidare e distribuire i progetti più grandi, la 7.3 si concentra sull’esperienza quotidiana di creazione e modifica di queste applicazioni.
In breve:
- Componenti UI: una libreria di componenti
bsui/*integrata e facoltativa, basata sul WordPress Interactivity API. - App: esempi
app/*integrati che mostrano come i componenti UI si combinano in interfacce più ampie. - Editor ampliato: un pannello laterale più ampio per modificare i campi Blockstudio quando la barra laterale è troppo stretta.
- Selettori di risorse con ambito: le risorse CSS e SCSS possono usare
%selector%per selezionare direttamente la classe contenitore del blocco. - Dipendenze dei plugin: i blocchi possono richiedere plugin WordPress attivi, con vincoli di versione facoltativi.
- Criteri dell’editor:
blockstudio.jsonpuò configurare blocchi, pattern e comportamento dei media globali usando gli hook dell’editor basati su WordPress PHP. - Alias dei tag dei blocchi: alias personalizzati per la creazione dei tag dei blocchi.
- Analisi statica e documentazione: maggiore copertura PHPStan per le librerie di blocchi esterne, oltre alla documentazione generata per impostazioni e hook.
- Correzioni per pagine ed editor: analisi più affidabile delle pagine basate su file, rilevamento dei candidati Tailwind, modalità di ripristino, isolamento della cache di rendering e precaricamenti dell’editor.
Libreria UI
La versione 7.3 include una libreria di componenti integrata e app di esempio basate su di essa.
Componenti UI
Blockstudio 7.3 include una libreria UI integrata nello spazio dei nomi bsui/*. I componenti sono normali blocchi Blockstudio, quindi possono essere visualizzati nei template, nelle pagine basate su file, nei pattern e nei contenuti dei post con la stessa sintassi dei tag dei blocchi che già usate.
La libreria di componenti UI è in beta mentre raccogliamo ulteriori feedback. L’obiettivo per 7.3 è rendere disponibile il primo set di componenti, imparare dai progetti reali e perfezionare nomi, comportamento e impostazioni predefinite prima di dichiarare stabile la superficie API.
La libreria è facoltativa:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Una volta attivata, i componenti semplici possono essere visualizzati direttamente:
<block name="bsui/button" label="Save" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
name="bsui/input"
nameAlt="email"
type="email"
placeholder="Email"
></block>
Funziona anche la sintassi più breve bs::
<bs:bsui-button label="Save" variant="default" />
L’obiettivo non è trasformare Blockstudio in un kit UI per la creazione di pagine. Vogliamo rendere disponibili come blocchi gli elementi di base delle interfacce più comuni, così le applicazioni realizzate con Blockstudio non devono ricreare pulsanti, finestre di dialogo, schede, menu di selezione, campi modulo, menu, barre degli strumenti e componenti di feedback in ogni progetto.
Il primo insieme di componenti include elementi di base per layout, azioni, input, sovrapposizioni, navigazione, feedback, moduli e visualizzazione dei dati:
bsui/button,bsui/button-group,bsui/toggle,bsui/toggle-group,bsui/toolbarbsui/input,bsui/textarea,bsui/select,bsui/checkbox,bsui/radio-group,bsui/slider,bsui/switch,bsui/number-field,bsui/password-input,bsui/phone-input,bsui/otp-input,bsui/date-input,bsui/time-pickerbsui/dialog,bsui/drawer,bsui/popover,bsui/menu,bsui/context-menu,bsui/menubar,bsui/tooltip,bsui/alert-dialogbsui/tabs,bsui/accordion,bsui/breadcrumb,bsui/pagination,bsui/navigation-menubsui/card,bsui/table,bsui/stack,bsui/separator,bsui/aspect-ratio,bsui/badge,bsui/avatar,bsui/progress,bsui/meter,bsui/skeleton,bsui/spinner,bsui/kbdbsui/form,bsui/field,bsui/field-group,bsui/file-upload,bsui/color-picker,bsui/rating
Molti sono blocchi composti. Un blocco bsui/tabs gestisce lo stato interattivo, mentre i blocchi figlio come bsui/tabs-list, bsui/tabs-trigger e bsui/tabs-panel ne descrivono la struttura.
<block name="bsui/tabs" defaultValue="features">
<block name="bsui/tabs-list">
<block name="bsui/tabs-trigger" value="features" title="Features"></block>
<block name="bsui/tabs-trigger" value="pricing" title="Pricing"></block>
</block>
<block name="bsui/tabs-panel" value="features">
<p>Features content.</p>
</block>
<block name="bsui/tabs-panel" value="pricing">
<p>Pricing content.</p>
</block>
</block>
Così il markup resta leggibile, mentre lo stato e il comportamento sono gestiti dall’API Interactivity.
Esempi di app
Lo spazio dei nomi app/* contiene esempi realizzati con gli stessi componenti UI.
Non sono un framework a parte, ma implementazioni di riferimento per interfacce Blockstudio più ampie: blocchi composti, UI annidati, stato Interactivity API e punti in cui i componenti UI si integrano con RPC o con funzionalità basate su database.
<block name="app/kitchen-sink"></block>
<block name="app/chat">
<block name="app/chat-sidebar"></block>
<block name="app/chat-header"></block>
<block name="app/chat-messages"></block>
<block name="app/chat-input"></block>
</block>
La libreria UI include anche la propria documentazione e un catalogo interattivo dei componenti. Il comportamento dei componenti non è solo una raccolta di template: fa parte del contratto del framework e resta coerente man mano che la libreria cresce.
Creazione e modifica
Diverse novità rendono i blocchi più facili da creare e modificare.
Editor ampliato
Modificare blocchi complessi nella barra laterale dell’ispettore può diventare presto scomodo, soprattutto per i ripetitori, i campi di codice, il testo formattato e i gruppi annidati.
Blockstudio 7.3 aggiunge all’ispettore dei blocchi un’azione per aprire l’editor ampliato. Si apre un pannello più largo dal lato destro dell’editor, che mostra gli stessi campi Blockstudio.
L’aspetto importante è che si tratta sempre dello stesso sistema di campi. Il rendering dei campi non viene duplicato, non viene introdotto un secondo percorso di persistenza e le modifiche apportate nell’editor ampliato aggiornano il blocco selezionato, proprio come quelle fatte nella normale barra laterale.
Usatelo quando la barra laterale è comoda per consultare i campi, ma troppo stretta per inserirvi i dati.
Selettori di risorse con ambito
Blockstudio supportava già %selector% per i campi di codice. Nella versione 7.3, le risorse CSS e SCSS dei blocchi possono usare lo stesso schema di creazione.
In un file CSS, %selector% si espande nella classe con ambito del blocco:
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Questo permette di applicare stili all’effettivo elemento contenitore:
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
<h1 class="hero__title">Hero</h1>
</section>
I selettori normali in *.scoped.css continuano a selezionare gli elementi discendenti. %selector% è l’hook esplicito per l’elemento radice del blocco.
Dipendenze dei plugin
Ora i blocchi possono dichiarare dipendenze da plugin WordPress all’interno della chiave blockstudio di block.json.
La forma semplice verifica che tutti gli slug dei plugin elencati siano attivi:
{
"blockstudio": {
"pluginDependencies": ["woocommerce"]
}
}
La forma a oggetto aggiunge vincoli di versione:
{
"blockstudio": {
"pluginDependencies": {
"woocommerce": {
"version": ">6"
}
}
}
}
Gli identificatori sono gli slug dei plugin WordPress, in linea con il sistema delle dipendenze dei plugin di base di WordPress. Blockstudio associa gli slug ai plugin attivi e salta la registrazione se un plugin richiesto manca, è inattivo o ha una versione inferiore a quella richiesta.
Il vincolo di versione usa lo stesso modello di confronto di PHP version_compare(). Una versione semplice come "6" viene interpretata come >=6.
È utile per i blocchi che hanno senso solo quando è disponibile un plugin: schede prodotto WooCommerce, integrazioni per moduli, integrazioni SEO, componenti per gli abbonamenti, widget per le prenotazioni o UI di amministrazione legati a un plugin di terze parti.
Criteri dell’editor
Il file blockstudio.json sta diventando più utile anche come file di criteri dell’editor a livello di progetto.
La versione 7.3 aggiunge un livello di criteri blockEditor basato su PHP per le impostazioni WordPress già esposte tramite hook lato server. Potete così definire il comportamento globale dell’inseritore, dei pattern e dei media senza aggiungere codice specifico al tema.
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"blockEditor": {
"blocks": {
"allow": ["core/*", "my-theme/*"],
"deny": ["core/embed", "core/freeform"],
"directory": false,
"categories": {
"rename": {
"text": "Writing",
"design": "Layout"
},
"order": ["my-theme", "text", "media"]
}
},
"patterns": {
"core": false,
"remote": false,
"categories": {
"deny": ["gallery"],
"order": ["featured", "buttons"]
}
},
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"]
}
}
}
}
La prima versione si limita volutamente agli aspetti supportati da PHP: blocchi consentiti e vietati, caricamento della directory dei blocchi, etichette e ordinamento delle categorie dell’inseritore, origini e categorie dei pattern, Openverse, opzioni delle dimensioni delle immagini, visibilità dei widget legacy e rimozione degli stili dei blocchi registrati tramite PHP.
Non cerca di riscrivere impostazioni predefinite arbitrarie dei blocchi di base. Impostazioni come core/columns.isStackedOnMobile fanno parte del flusso di registrazione JavaScript dell’editor dei blocchi e quindi richiedono un API separato e più esplicito, anziché essere inserite a forza in un file JSON.
Alias dei tag dei blocchi
Ai tag dei blocchi è stato aggiunto un filtro per gli alias:
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
$aliases['theme-button'] = 'bsui/button';
return $aliases;
});
Questo permette a un progetto di definire tag più comodi da usare durante la creazione, che internamente vengono comunque associati al nome canonico del blocco.
<bs:theme-button label="Continue" />
È particolarmente utile quando si compongono template ricchi di UI: i nomi canonici dei blocchi sono corretti, ma non sempre sono i più comodi da usare in fase di creazione.
Strumenti e affidabilità
Sono stati compiuti progressi nell’analisi statica, nell’affidabilità e negli strumenti per le prestazioni.
Analisi statica e documentazione generata
L’estensione PHPStan ora supporta percorsi di scansione espliciti per librerie di blocchi esterne. Un progetto può così convalidare i tag <bs:*> e <block> rispetto a blocchi che si trovano al di fuori del plugin o del tema corrente, mantenendo tali percorsi accessibili solo al registro durante l’analisi.
Sono stati ampliati anche i controlli degli schemi per i metadati delle pagine e pluginDependencies, così è più facile individuare una configurazione non valida in fase di rilascio prima che raggiunga WordPress.
La generazione della documentazione ora include riferimenti ai filtri per le impostazioni e agli hook PHP. Diventa ancora più utile man mano che blockstudio.json si trasforma in un vero file di criteri del progetto, anziché restare solo un insieme di opzioni sparse.
Affidabilità delle pagine e dell’editor
La versione 7.3 include anche una serie di correzioni per le pagine basate su file, il rendering dell’editor e la modalità di ripristino.
L’analisi delle pagine basata su file ora gestisce mappature personalizzate dei contenitori che tengono conto degli attributi durante l’analisi di HTML. Anche i tag di pagina bs: risolvono correttamente gli spazi dei nomi dei blocchi con trattini, così nomi come custom-theme/card non confondono più l’analizzatore.
I tag generici dei contenitori non core ora serializzano innerContent validi se non forniscono markup wrapper. In questo modo, i contenuti delle pagine sincronizzate sono più prevedibili e la serializzazione dei blocchi WordPress resta valida.
L’editor ha ricevuto una serie di correzioni relative all’anteprima e al precaricamento:
- Tailwind editor CSS ora include candidati di classe dai template di pagina basati su file.
- I precaricamenti dell’editor mantengono le classi wrapper di RichText per i blocchi ripetuti dello stesso tipo.
- I precaricamenti dell’editor corrispondono ai blocchi i cui valori predefiniti dei campi vengono espansi da Gutenberg ma omessi dal markup del blocco salvato.
- Gli attributi predefiniti registrati ed espansi da Gutenberg vengono ignorati prima di confrontare le chiavi della cache di rendering.
- Le anteprime di rendering dell’editor e dell’inseritore mantengono ora voci di cache separate, anche quando condividono un client id.
bs_get_group()ora funziona correttamente con gruppi di campi personalizzati riutilizzati, inclusi quelli il cui id corrisponde al nome del campo personalizzato, ed estrae solo i prefissi esatti del gruppo.- I campi link con
withCreateSuggestionora configurano correttamente il flusso di creazione di LinkControl WordPress e creano pagine in bozza tramite REST API. - I template di blocco PHP ora vengono eseguiti una volta per rendering, senza eseguire un include preliminare poi scartato.
Anche la modalità di ripristino è stata migliorata. Ora neutralizza le regole di larghezza dei blocchi e di margine verticale dell’editor Gutenberg per i tipi di contenuto configurati, rimuove gli stili di contenuto e ripristino dell’iframe WordPress dove necessario e rende più pulite le sovrapposizioni di passaggio del mouse e selezione di Blockstudio.
Sono stati ampliati anche i test di regressione per i pattern complessi di InnerBlocks, includendo i blocchi Blockstudio annidati, così il percorso di rendering dell’editor viene verificato nei casi di inserimento dei pattern più difficili da controllare manualmente.
Strumenti per le prestazioni
Le sonde anonime locali blockstudio-perf=1 ora possono emettere intestazioni Server-Timing senza iniettare il pannello di debug.
Le misurazioni dei tempi coprono anche più fasi del ciclo di build: rilevamento, elaborazione delle risorse, registrazione e override. In questo modo è più facile capire dove viene impiegato il tempo, senza attivare una UI di profilazione visibile.
Perché questa release è importante
Il tema principale della versione 7.3 è la composizione.
I componenti UI facilitano la composizione delle interfacce applicative. Expanded Editor semplifica la modifica dei blocchi più grandi. Le dipendenze dei plugin consentono ai blocchi di descrivere il contesto del plugin di cui hanno bisogno. Le policy dell’editor trasferiscono le regole del progetto per l’editor dei blocchi in blockstudio.json. Gli alias dei tag dei blocchi semplificano la creazione dei template. Le correzioni all’analizzatore, a PHPStan e all’editor rendono queste composizioni più affidabili quando passano attraverso WordPress.
Blockstudio continua a basarsi su file. I blocchi sono ancora cartelle. I template continuano a svolgere il loro compito. Ma ora il framework aggiunge a queste fondamenta un livello di UI più solido.