Nástroj pro výběr prvků
Při práci s asistenty AI pro programování jim často potřebujete sdělit, který soubor šablony vykresluje konkrétní prvek stránky. Nástroj pro výběr prvků zobrazí zaměřovací kříž a jediným gestem zkopíruje do schránky podrobné informace o prvku.
Aktivace
Nástroj pro výběr prvků se aktivuje pomocí parametru dotazu. Chcete-li jej zapnout, přidejte ?blockstudio-devtools k libovolné adrese URL:
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools
Bez parametru dotazu se nenačte žádný skript ani datové atributy.
Nastavení
Povolte nástroj pro výběr prvků v souboru blockstudio.json své šablony:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Vlastnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
enabled |
boolean |
false |
Povolí nástroj pro výběr prvků. |
Nastavení je dostupné také jako filtr:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Použití
- Přihlaste se jako uživatel s oprávněním
edit_postsa přejděte na libovolnou stránku webu s parametrem?blockstudio-devtools. - Podržte Ctrl+C (Windows) po dobu 100 ms a aktivujte nástroj.
- Aktivuje se výběr se zaměřovacím křížem a překryvnou vrstvou plátna, která při najetí zvýrazní bloky Blockstudio.
- Zobrazí se dva štítky: jeden s cestou k souboru šablony bloku a druhý s názvem značky prvku HTML.
- Kliknutím na prvek zkopírujete jeho kontext do schránky.
- Vložte výsledek do svého nástroje AI pro programování.
Dalším stisknutím Escape nebo Cmd+C deaktivujete funkci bez kopírování. Pokud klávesu Cmd+C uvolníte před uplynutím 100ms, zachová se běžné chování kopírování.
Formát schránky
Kliknutím na prvek zkopírujete řetězec s kontextem určený pro AI asistenty při programování:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Obsahuje název značky elementu, náhled HTML s atributy a obsahem a cestu k souboru šablony.
Interní fungování
Blockstudio přidává atribut data-blockstudio-path každému obalovému elementu bloku, který na frontendu používá useBlockProps. Tento atribut obsahuje absolutní cestu k souboru šablony, který blok vykresluje.
Na frontendu se přihlášeným editorům načítá odlehčený modul TypeScript ve vanilla JavaScriptu (bez React a bez závislostí na WordPress). Pomocí document.elementsFromPoint() rozpozná konkrétní prvek HTML pod kurzorem i jeho nadřazený blok Blockstudio a pro každý vykreslí samostatné zvýraznění.
Zabezpečení
Atribut data-blockstudio-path a skript grabberu se vykreslí pouze tehdy, jsou-li splněny všechny podmínky:
- Je přítomen parametr dotazu
?blockstudio-devtools. - Nastavení
dev.grab.enabledjetrue. - Aktuální uživatel má oprávnění
edit_posts.
Veřejní návštěvníci nikdy neuvidí cesty k souborům ani skript grabberu.