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:
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:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Vlastnosť | Typ | Predvolené | Popis |
|---|---|---|---|
enabled |
boolean |
false |
Zapnutie nástroja na výber prvkov. |
Nastavenie je dostupné aj ako filter:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Použitie
- Prihláste sa a otvorte ľubovoľnú stránku frontendu s
?blockstudio-devtools; používateľ musí mať oprávnenieedit_posts. - Podržte Cmd+C (Mac) alebo Ctrl+C (Windows) na 100 ms, čím aktivujete nástroj.
- Aktivuje sa výberový kurzor v tvare zameriavacieho kríža s prekrytím plátna, ktoré pri pohybe kurzora zvýrazňuje bloky Blockstudio.
- Zobrazia sa dva štítky: jeden s cestou k súboru šablóny bloku a druhý s názvom značky prvku HTML.
- Kliknutím na prvok skopírujete jeho kontext do schránky.
- 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:
@<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.enabledmá hodnotutrue. - 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.