Gå til indhold

Elementvælger

Når du arbejder med AI-kodeassistenter, skal du ofte fortælle dem, hvilken skabelonfil der gengiver et bestemt element på siden. Elementvælgeren viser en trådkorsformet markør, som med én bevægelse kopierer omfattende elementkontekst til udklipsholderen.

Aktivering

Elementvælgeren kræver en forespørgselsparameter. Føj ?blockstudio-devtools til en vilkårlig frontend-URL for at aktivere den:

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

Uden forespørgselsparameteren indlæses hverken scripts eller dataattributter.

Indstillinger

Aktivér elementvælgeren i dit temas blockstudio.json:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Egenskab Type Standard Beskrivelse
enabled boolean false Aktivér elementvælgeren.

Indstillingen findes også som et filter:

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

Brug

  1. Besøg en vilkårlig frontendside med ?blockstudio-devtools, mens du er logget ind som en bruger med rettigheden edit_posts.
  2. Hold Cmd+C (Mac) eller Ctrl+C (Windows) nede i 100 ms for at aktivere vælgeren.
  3. En trådkorsformet markør aktiveres med et canvas-overlay, der fremhæver Blockstudio-blokke, når du holder markøren over dem.
  4. Der vises to etiketter: én med blokkens skabelonfilsti og én med tagnavnet på elementet HTML.
  5. Klik på et element for at kopiere dets kontekst til udklipsholderen.
  6. Indsæt resultatet i dit AI-kodeværktøj.

Tryk på Escape eller Cmd+C igen for at deaktivere uden at kopiere. Hvis du slipper Cmd+C før 100ms, bevares den normale kopieringsfunktion.

Udklipsholderformat

Når du klikker på et element, kopieres en kontekststreng med formateret tekst, der er beregnet til AI-kodeassistenter:

Kode
@<div>

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

Den indeholder elementets tagnavn, en HTML forhåndsvisning med attributter og indhold samt stien til skabelonfilen.

Interne detaljer

Blockstudio tilføjer attributten data-blockstudio-path til hvert blokomsluttende element, der bruger useBlockProps på frontend. Attributten indeholder den absolutte sti til skabelonfilen, der gengiver blokken.

Et let vanilla TypeScript-modul (uden React og uden afhængigheder af WordPress) indlæses på frontend for indloggede redaktører. Det bruger document.elementsFromPoint() til at registrere både det specifikke HTML-element under markøren og dets overordnede Blockstudio-blok og tegner separate fremhævninger for hver.

Sikkerhed

Attributten data-blockstudio-path og grabber-scriptet gengives kun, når alle betingelser er opfyldt:

  • Forespørgselsparameteren ?blockstudio-devtools er til stede.
  • Indstillingen dev.grab.enabled er true.
  • Den aktuelle bruger har funktionen edit_posts.

Offentlige besøgende kan aldrig se filstier eller grabber-scriptet.