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:
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:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Eigenschaft | Typ | Standardwert | Beschreibung |
|---|---|---|---|
enabled |
boolean |
false |
Aktiviert die Element-Erkennung. |
Die Einstellung ist auch als Filter verfügbar:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Verwendung
- Rufe mit
?blockstudio-devtoolseine beliebige Frontend-Seite auf und melde dich als Benutzer mit der Berechtigungedit_postsan. - Halte Cmd+C (Mac) oder Ctrl+C (Windows) 100ms lang gedrückt, um die Erkennung zu aktivieren.
- Eine Fadenkreuz-Auswahl wird eingeblendet; ein Canvas-Overlay hebt beim Überfahren mit dem Mauszeiger Blockstudio-Blöcke hervor.
- Zwei Beschriftungen erscheinen: eine zeigt den Dateipfad des Block-Templates, die andere den Tagnamen des HTML-Elements.
- Klicke auf ein Element, um seinen Kontext in die Zwischenablage zu kopieren.
- 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:
@<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-devtoolsist vorhanden. - Die Einstellung
dev.grab.enabledisttrue. - Der aktuelle Benutzer verfügt über die Berechtigung
edit_posts.
Öffentliche Besucher sehen weder Dateipfade noch das Erkennungsskript.