Přejít k obsahu

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:

Kód
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:

JSON
{
  "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:

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

Použití

  1. Přihlaste se jako uživatel s oprávněním edit_posts a přejděte na libovolnou stránku webu s parametrem ?blockstudio-devtools.
  2. Podržte Ctrl+C (Windows) po dobu 100 ms a aktivujte nástroj.
  3. 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.
  4. Zobrazí se dva štítky: jeden s cestou k souboru šablony bloku a druhý s názvem značky prvku HTML.
  5. Kliknutím na prvek zkopírujete jeho kontext do schránky.
  6. 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í:

Kód
@<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.enabled je true.
  • 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.