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:
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:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Proprietate | Tip | Implicit | Descriere |
|---|---|---|---|
enabled |
boolean |
false |
Activați selectorul de elemente. |
Setarea este disponibilă și ca filtru:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Utilizare
- Accesați orice pagină din interfața publică cu
?blockstudio-devtools, autentificat ca utilizator cu capacitateaedit_posts. - Țineți apăsat Cmd+C (Mac) sau Ctrl+C (Windows) timp de 100ms pentru a activa selectorul.
- 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.
- Apar două etichete: una indică calea fișierului de șablon al blocului, iar cealaltă indică numele etichetei elementului HTML.
- Faceți clic pe un element pentru a-i copia contextul în clipboard.
- 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:
@<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-devtoolseste prezent. - Setarea
dev.grab.enabledestetrue. - Utilizatorul curent are capabilitatea
edit_posts.
Vizitatorii publici nu văd niciodată căile fișierelor sau scriptul grabber.