Hoppa till innehåll

Elementväljare

När du arbetar med AI-kodningsassistenter behöver du ofta tala om för dem vilken mallfil som renderar ett visst element på sidan. Elementväljaren ger dig en hårkorsliknande väljare som med en enda gest kopierar detaljerad elementkontext till urklipp.

Aktivering

Elementväljaren aktiveras med en frågeparameter. Lägg till ?blockstudio-devtools i valfri frontend-URL för att aktivera den:

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

Utan frågeparametern läses inget skript eller några dataattribut in.

Inställningar

Aktivera elementväljaren i temats blockstudio.json:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Egenskap Typ Standardvärde Beskrivning
enabled boolean false Aktivera elementväljaren.

Inställningen finns även som ett filter:

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

Användning

  1. Besök valfri frontend-sida med ?blockstudio-devtools medan du är inloggad som en användare med behörigheten edit_posts.
  2. Håll ned Cmd+C (Mac) eller Ctrl+C (Windows) i 100ms för att aktivera väljaren.
  3. En hårkorsväljare aktiveras med en canvas-överlappning som markerar Blockstudio-block när du håller pekaren över dem.
  4. Två etiketter visas: en med sökvägen till blockets mallfil och en med HTML-elementets taggnamn HTML.
  5. Klicka på ett element för att kopiera dess kontext till urklipp.
  6. Klistra in resultatet i ditt AI-kodningsverktyg.

Tryck på Escape eller Cmd+C igen för att avaktivera utan att kopiera. Om du släpper Cmd+C innan 100ms har gått bevaras det vanliga kopieringsbeteendet.

Urklippsformat

När du klickar på ett element kopieras en detaljerad kontextsträng som är avsedd för AI-kodningsassistenter:

Kod
@<div>

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

Den innehåller elementets taggnamn, en förhandsvisning av HTML med attribut och innehåll samt mallfilens sökväg.

Interna detaljer

Blockstudio lägger till ett data-blockstudio-path-attribut på varje blockomslags-element som använder useBlockProps i frontend. Attributet innehåller den absoluta sökvägen till mallfilen som renderar blocket.

En lättviktig vanilla-TypeScript-modul (utan beroenden av React eller WordPress) köas på frontend för inloggade redaktörer. Den använder document.elementsFromPoint() för att identifiera både det specifika HTML-elementet under markören och dess överordnade Blockstudio-block, och ritar separata markeringar för vart och ett.

Säkerhet

Attributet data-blockstudio-path och grabberskriptet renderas bara när alla villkor är uppfyllda:

  • Frågeparametern ?blockstudio-devtools finns.
  • Inställningen dev.grab.enabled är true.
  • Den aktuella användaren har behörigheten edit_posts.

Offentliga besökare ser aldrig filsökvägar eller grabberskriptet.