Treci la conținut

Selector de elemente

Când lucrați cu asistenți AI pentru programare, trebuie adesea să le indicați ce fișier de șablon redă un anumit element de pe pagină. Selectorul de elemente oferă un instrument de selectare în formă de reticul care copiază în clipboard, printr-un singur gest, contextul detaliat al elementului.

Activare

Selectorul de elemente este activat printr-un parametru de interogare. Adăugați ?blockstudio-devtools la orice URL din interfața publică pentru a-l activa:

Cod
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools

Fără parametrul de interogare, nu se încarcă niciun script sau atribut de date.

Setări

Activați selectorul de elemente în fișierul blockstudio.json al temei:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Proprietate Tip Implicit Descriere
enabled boolean false Activați selectorul de elemente.

Setarea este disponibilă și ca filtru:

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

Utilizare

  1. Accesați orice pagină din interfața publică cu ?blockstudio-devtools, autentificat ca utilizator cu capacitatea edit_posts.
  2. Țineți apăsat Cmd+C (Mac) sau Ctrl+C (Windows) timp de 100ms pentru a activa selectorul.
  3. Se activează un selector în formă de reticul, cu o suprapunere canvas care evidențiază blocurile Blockstudio pe măsură ce treceți cursorul peste ele.
  4. Apar două etichete: una indică calea fișierului de șablon al blocului, iar cealaltă indică numele etichetei elementului HTML.
  5. Faceți clic pe un element pentru a-i copia contextul în clipboard.
  6. Lipiți rezultatul în instrumentul AI de programare.

Apăsați Escape sau din nou Cmd+C pentru a dezactiva selectorul fără să copiați. Dacă eliberați Cmd+C înainte de 100ms, comportamentul obișnuit de copiere este păstrat.

Formatul clipboardului

Dacă faceți clic pe un element, în clipboard este copiat un șir cu context detaliat, conceput pentru asistenții AI de programare:

Cod
@<div>

<div class="my-block">
  Hello world
</div>
  in theme-name/blockstudio/blocks/my-block/index.php

Acesta include numele etichetei elementului, o previzualizare HTML cu atribute și conținut, precum și calea fișierului de șablon.

Detalii interne

Blockstudio adaugă un atribut data-blockstudio-path fiecărui element wrapper de bloc care folosește useBlockProps pe frontend. Acest atribut conține calea absolută către fișierul șablon care redă blocul.

Un modul TypeScript vanilla, ușor (fără dependențe de React și fără WordPress), este încărcat în frontend pentru editorii autentificați. Folosește document.elementsFromPoint() pentru a detecta atât elementul HTML specific aflat sub cursor, cât și blocul Blockstudio părinte, evidențiindu-le separat.

Securitate

Atributul data-blockstudio-path și scriptul grabber sunt generate numai dacă sunt îndeplinite toate condițiile:

  • Parametrul de interogare ?blockstudio-devtools este prezent.
  • Setarea dev.grab.enabled este true.
  • Utilizatorul curent are capabilitatea edit_posts.

Vizitatorii publici nu văd niciodată căile fișierelor sau scriptul grabber.