Vai al contenuto

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:

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

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Proprietà Tipo Predefinito Descrizione
enabled boolean false Abilita il selettore di elementi.

L’impostazione è disponibile anche come filtro:

PHP
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');

Utilizzo

  1. Visita qualsiasi pagina del frontend con ?blockstudio-devtools mentre hai effettuato l’accesso come utente con la capability edit_posts.
  2. Tieni premuto Cmd+C (Mac) o Ctrl+C (Windows) per 100ms per attivare il selettore.
  3. Si attiva un selettore a mirino con una sovrapposizione canvas che evidenzia i blocchi Blockstudio al passaggio del cursore.
  4. Compaiono due etichette: una mostra il percorso del file template del blocco e l’altra il nome del tag dell’elemento HTML.
  5. Fai clic su un elemento per copiare le relative informazioni negli appunti.
  6. 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:

Codice
@<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.