Element Grabber
Wanneer je met AI-codeerassistenten werkt, moet je vaak aangeven welk templatebestand een specifiek element op de pagina weergeeft. De element grabber biedt een elementkiezer in de vorm van een vizier, die met één gebaar uitgebreide elementcontext naar je klembord kopieert.
Activering
De element grabber is beveiligd met een queryparameter. Voeg ?blockstudio-devtools toe aan een frontend-URL om deze in te schakelen:
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools
Zonder de queryparameter worden er geen script of data-attributen geladen.
Instellingen
Schakel de element grabber in blockstudio.json van je thema in:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Eigenschap | Type | Standaard | Beschrijving |
|---|---|---|---|
enabled |
boolean |
false |
Schakel de element grabber in. |
De instelling is ook beschikbaar als filter:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Gebruik
- Ga naar een willekeurige frontendpagina met
?blockstudio-devtoolsterwijl je bent aangemeld als gebruiker met de mogelijkheidedit_posts. - Houd Cmd+C (Mac) of Ctrl+C (Windows) 100 ms ingedrukt om de grabber te activeren.
- Er verschijnt een vizierkiezer met een canvas-overlay die Blockstudio-blokken markeert wanneer je erover beweegt.
- Er verschijnen twee labels: één met het pad naar het blocktemplatebestand en één met de tagnaam van het element HTML.
- Klik op een element om de context ervan naar je klembord te kopiëren.
- Plak het resultaat in je AI-codeertool.
Druk nogmaals op Escape of Cmd+C om de functie uit te schakelen zonder te kopiëren. Als je Cmd+C minder dan 100 ms ingedrukt houdt, blijft het normale kopieergedrag behouden.
Klembordindeling
Als je op een element klikt, wordt een uitgebreide contextstring gekopieerd die is bedoeld voor AI-codeerassistenten:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Deze bevat de tagnaam van het element, een HTML-preview met attributen en inhoud, en het pad naar het templatebestand.
Interne werking
Blockstudio voegt een attribuut data-blockstudio-path toe aan elk block-wrapperelement dat useBlockProps op de frontend gebruikt. Dit attribuut bevat het absolute pad naar het templatebestand dat het block rendert.
Op de frontend wordt voor ingelogde editors een lichtgewicht vanilla TypeScript-module geladen (zonder afhankelijkheden van React of WordPress). Deze gebruikt document.elementsFromPoint() om zowel het specifieke HTML-element onder de cursor als het bovenliggende block Blockstudio te detecteren en beide afzonderlijk te markeren.
Beveiliging
Het attribuut data-blockstudio-path en het grabberscript worden alleen weergegeven als aan alle voorwaarden is voldaan:
- De queryparameter
?blockstudio-devtoolsis aanwezig. - De instelling
dev.grab.enabledistrue. - De huidige gebruiker beschikt over de capability
edit_posts.
Bezoekers zien nooit bestandspaden of het grabberscript.