Selettore di elementi
Quando lavori con assistenti di programmazione basati sull’IA, spesso devi indicare loro quale file template esegue il rendering di un elemento specifico della pagina. Il selettore di elementi offre un selettore a mirino che copia negli appunti, con un solo gesto, informazioni dettagliate sull’elemento.
Attivazione
Il selettore di elementi si attiva tramite un parametro di query. Aggiungi ?blockstudio-devtools a qualsiasi URL del frontend per abilitarlo:
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools
Senza il parametro di query, non vengono caricati script né attributi di dati.
Impostazioni
Abilita il selettore di elementi nel file blockstudio.json del tema:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Proprietà | Tipo | Predefinito | Descrizione |
|---|---|---|---|
enabled |
boolean |
false |
Abilita il selettore di elementi. |
L’impostazione è disponibile anche come filtro:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Utilizzo
- Visita qualsiasi pagina del frontend con
?blockstudio-devtoolsmentre hai effettuato l’accesso come utente con la capabilityedit_posts. - Tieni premuto Cmd+C (Mac) o Ctrl+C (Windows) per 100ms per attivare il selettore.
- Si attiva un selettore a mirino con una sovrapposizione canvas che evidenzia i blocchi Blockstudio al passaggio del cursore.
- Compaiono due etichette: una mostra il percorso del file template del blocco e l’altra il nome del tag dell’elemento HTML.
- Fai clic su un elemento per copiare le relative informazioni negli appunti.
- Incolla il risultato nel tuo strumento di programmazione basato sull’IA.
Premi di nuovo Escape o Cmd+C per disattivare senza copiare. Se rilasci Cmd+C prima di 100ms, il normale comportamento di copia viene mantenuto.
Formato degli appunti
Facendo clic su un elemento si copia una stringa di contesto dettagliata, pensata per gli assistenti di programmazione basati sull’IA:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Include il nome del tag dell’elemento, un’anteprima HTML con attributi e contenuti e il percorso del file template.
Dettagli interni
Blockstudio aggiunge un attributo data-blockstudio-path a ogni elemento wrapper del blocco che usa useBlockProps nel frontend. Questo attributo contiene il percorso assoluto del file template che esegue il rendering del blocco.
Un modulo TypeScript vanilla leggero (senza dipendenze React né WordPress) viene caricato nel frontend per gli editor che hanno effettuato l’accesso. Usa document.elementsFromPoint() per rilevare sia l’elemento HTML specifico sotto il cursore sia il relativo blocco Blockstudio padre, evidenziandoli separatamente.
Sicurezza
L’attributo data-blockstudio-path e lo script grabber vengono renderizzati solo se sono soddisfatte tutte le condizioni:
- È presente il parametro di query
?blockstudio-devtools. - L’impostazione
dev.grab.enabledètrue. - L’utente corrente dispone della funzionalità
edit_posts.
I visitatori pubblici non vedono mai i percorsi dei file né lo script grabber.