Ga naar de inhoud

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:

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

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Eigenschap Type Standaard Beschrijving
enabled boolean false Schakel de element grabber in.

De instelling is ook beschikbaar als filter:

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

Gebruik

  1. Ga naar een willekeurige frontendpagina met ?blockstudio-devtools terwijl je bent aangemeld als gebruiker met de mogelijkheid edit_posts.
  2. Houd Cmd+C (Mac) of Ctrl+C (Windows) 100 ms ingedrukt om de grabber te activeren.
  3. Er verschijnt een vizierkiezer met een canvas-overlay die Blockstudio-blokken markeert wanneer je erover beweegt.
  4. Er verschijnen twee labels: één met het pad naar het blocktemplatebestand en één met de tagnaam van het element HTML.
  5. Klik op een element om de context ervan naar je klembord te kopiëren.
  6. 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:

Code
@<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-devtools is aanwezig.
  • De instelling dev.grab.enabled is true.
  • De huidige gebruiker beschikt over de capability edit_posts.

Bezoekers zien nooit bestandspaden of het grabberscript.