Preskočiť na obsah

Nástroj na výber prvkov

Pri práci s AI asistentmi na programovanie často potrebujete určiť, ktorý súbor šablóny vykresľuje konkrétny prvok na stránke. Nástroj na výber prvkov zobrazí výberový kurzor v tvare zameriavacieho kríža a jediným gestom skopíruje podrobné informácie o prvku do schránky.

Aktivácia

Nástroj na výber prvkov je dostupný cez parameter dopytu. Ak ho chcete zapnúť, pridajte ?blockstudio-devtools k ľubovoľnej adrese URL frontendu URL:

Kód
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools

Bez parametra dopytu sa nenačíta žiadny skript ani atribúty údajov.

Nastavenia

Zapnite nástroj na výber prvkov v súbore blockstudio.json svojej témy:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Vlastnosť Typ Predvolené Popis
enabled boolean false Zapnutie nástroja na výber prvkov.

Nastavenie je dostupné aj ako filter:

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

Použitie

  1. Prihláste sa a otvorte ľubovoľnú stránku frontendu s ?blockstudio-devtools; používateľ musí mať oprávnenie edit_posts.
  2. Podržte Cmd+C (Mac) alebo Ctrl+C (Windows) na 100 ms, čím aktivujete nástroj.
  3. Aktivuje sa výberový kurzor v tvare zameriavacieho kríža s prekrytím plátna, ktoré pri pohybe kurzora zvýrazňuje bloky Blockstudio.
  4. Zobrazia sa dva štítky: jeden s cestou k súboru šablóny bloku a druhý s názvom značky prvku HTML.
  5. Kliknutím na prvok skopírujete jeho kontext do schránky.
  6. Vložte výsledok do svojho nástroja AI na programovanie.

Znova stlačte Escape alebo Cmd+C, ak chcete deaktivovať funkciu bez kopírovania. Ak kláves Cmd+C uvoľníte pred uplynutím 100ms, zachová sa bežné správanie kopírovania.

Formát schránky

Kliknutím na prvok skopírujete reťazec s kontextom, ktorý je určený pre AI asistentov na programovanie:

Kód
@<div>

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

Obsahuje názov značky prvku, náhľad HTML s atribútmi a obsahom a cestu k súboru šablóny.

Interné fungovanie

Blockstudio pridáva atribút data-blockstudio-path ku každému obaľovaciemu prvku bloku, ktorý na frontende používa useBlockProps. Tento atribút obsahuje absolútnu cestu k súboru šablóny, ktorý vykresľuje blok.

Na frontende sa pre prihlásených editorov načíta ľahký modul TypeScript vo vanilkovom React (bez závislostí od WordPress). Pomocou document.elementsFromPoint() rozpozná konkrétny prvok HTML pod kurzorom aj jeho nadradený blok Blockstudio a pre každý vykreslí samostatné zvýraznenie.

Zabezpečenie

Atribút data-blockstudio-path a skript na získavanie údajov sa vykreslia len vtedy, keď sú splnené všetky podmienky:

  • Je prítomný parameter dopytu ?blockstudio-devtools.
  • Nastavenie dev.grab.enabled má hodnotu true.
  • Aktuálny používateľ má oprávnenie edit_posts.

Verejní návštevníci nikdy neuvidia cesty k súborom ani skript na získavanie údajov.