Zum Inhalt springen

Element-Erkennung

Bei der Arbeit mit KI-Coding-Assistenten musst du ihnen oft mitteilen, welche Template-Datei ein bestimmtes Seitenelement rendert. Die Element-Erkennung bietet eine Auswahl im Fadenkreuzstil, die mit einer einzigen Geste den ausführlichen Elementkontext in deine Zwischenablage kopiert.

Aktivierung

Die Element-Erkennung wird über einen Abfrageparameter aktiviert. Hänge ?blockstudio-devtools an eine beliebige Frontend-URL an, um sie einzuschalten:

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

Ohne den Abfrageparameter werden weder Skripte noch Datenattribute geladen.

Einstellungen

Aktiviere die Element-Erkennung in der blockstudio.json deines Themes:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Eigenschaft Typ Standardwert Beschreibung
enabled boolean false Aktiviert die Element-Erkennung.

Die Einstellung ist auch als Filter verfügbar:

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

Verwendung

  1. Rufe mit ?blockstudio-devtools eine beliebige Frontend-Seite auf und melde dich als Benutzer mit der Berechtigung edit_posts an.
  2. Halte Cmd+C (Mac) oder Ctrl+C (Windows) 100ms lang gedrückt, um die Erkennung zu aktivieren.
  3. Eine Fadenkreuz-Auswahl wird eingeblendet; ein Canvas-Overlay hebt beim Überfahren mit dem Mauszeiger Blockstudio-Blöcke hervor.
  4. Zwei Beschriftungen erscheinen: eine zeigt den Dateipfad des Block-Templates, die andere den Tagnamen des HTML-Elements.
  5. Klicke auf ein Element, um seinen Kontext in die Zwischenablage zu kopieren.
  6. Füge das Ergebnis in dein KI-Coding-Tool ein.

Drücke Escape oder erneut Cmd+C, um die Erkennung zu deaktivieren, ohne etwas zu kopieren. Wenn du Cmd+C vor Ablauf von 100ms loslässt, bleibt das normale Kopierverhalten erhalten.

Zwischenablageformat

Wenn du auf ein Element klickst, wird eine ausführliche Kontextzeichenfolge für KI-Coding-Assistenten kopiert:

Code
@<div>

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

Sie enthält den Tagnamen des Elements, eine HTML-Vorschau mit Attributen und Inhalt sowie den Pfad der Template-Datei.

Interna

Blockstudio fügt jedem Block-Wrapper-Element, das im Frontend useBlockProps verwendet, ein Attribut data-blockstudio-path hinzu. Dieses Attribut enthält den absoluten Pfad zur Template-Datei, die den Block rendert.

Ein schlankes Vanilla-TypeScript-Modul (ohne Abhängigkeiten von React oder WordPress) wird für angemeldete Redakteure im Frontend eingebunden. Mithilfe von document.elementsFromPoint() erkennt es sowohl das konkrete HTML-Element unter dem Mauszeiger als auch den übergeordneten Blockstudio-Block und hebt beide separat hervor.

Sicherheit

Das Attribut data-blockstudio-path und das Erkennungsskript werden nur ausgegeben, wenn alle Bedingungen erfüllt sind:

  • Der Abfrageparameter ?blockstudio-devtools ist vorhanden.
  • Die Einstellung dev.grab.enabled ist true.
  • Der aktuelle Benutzer verfügt über die Berechtigung edit_posts.

Öffentliche Besucher sehen weder Dateipfade noch das Erkennungsskript.