Elemkijelölő
AI-alapú kódolási asszisztensekkel végzett munka során gyakran meg kell mondania nekik, melyik sablonfájl jelenít meg egy adott elemet az oldalon. Az elemkijelölő célkereszt stílusú elemválasztót biztosít, amely egyetlen művelettel az elem részletes környezetét másolja a vágólapra.
Aktiválás
Az elemkijelölő használatát egy lekérdezési paraméter szabályozza. Az engedélyezéséhez fűzze hozzá a ?blockstudio-devtools paramétert bármely webhelyfelületi URL címhez:
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools
A lekérdezési paraméter nélkül sem szkript, sem adatattribútumok nem töltődnek be.
Beállítások
Engedélyezze az elemkijelölőt a témája blockstudio.json fájljában:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Tulajdonság | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
enabled |
boolean |
false |
Az elemkijelölő engedélyezése. |
A beállítás szűrőként is elérhető:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Használat
- Jelentkezzen be egy olyan felhasználóként, aki rendelkezik az
edit_postsjogosultsággal, majd nyissa meg bármelyik webhelyfelületi oldalt a?blockstudio-devtoolsparaméterrel. - Tartsa lenyomva a Cmd+C (Mac) vagy a Ctrl+C (Windows) billentyűkombinációt 100 ms-ig a kijelölő aktiválásához.
- Megjelenik a célkereszt, amely vászonréteggel jelöli ki az Blockstudio blokkokat, ahogy föléjük viszi a mutatót.
- Két címke jelenik meg: az egyik a blokk sablonfájljának útvonalát mutatja, a másik az HTML elem címkéjét.
- Kattintson egy elemre a környezet vágólapra másolásához.
- Illessze be az eredményt az AI-alapú kódolási eszközébe.
Nyomja meg ismét az Escape vagy a Cmd+C billentyűt a másolás nélküli deaktiváláshoz. Ha 100ms előtt felengedi a Cmd+C billentyűkombinációt, a másolás a megszokott módon működik.
Vágólapformátum
Egy elemre kattintva az AI-kódolási asszisztensek számára kialakított, kontextust tartalmazó szöveg kerül a vágólapra:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Ez tartalmazza az elem címkéjének nevét, egy HTML előnézetet attribútumokkal és tartalommal, valamint a sablonfájl elérési útját.
Belső működés
A Blockstudio minden olyan blokkon futó burkolóelemhez hozzáad egy data-blockstudio-path attribútumot, amely az előtérben a useBlockProps elemet használja. Ez az attribútum a blokkot megjelenítő sablonfájl abszolút elérési útját tartalmazza.
A bejelentkezett szerkesztők számára egy könnyű, natív TypeScript modult tölt be az előtérben (nincs React, és nem függ a WordPress elemtől). A document.elementsFromPoint() segítségével érzékeli a kurzor alatti konkrét HTML elemet és annak szülő Blockstudio blokkját is, és külön kiemelést rajzol mindkettőhöz.
Biztonság
A data-blockstudio-path attribútum és a kijelölőszkript csak akkor jelenik meg, ha minden feltétel teljesül:
- Jelen van a
?blockstudio-devtoolslekérdezési paraméter. - A
dev.grab.enabledbeállítás értéketrue. - Az aktuális felhasználó rendelkezik a
edit_postsjogosultsággal.
A nyilvános látogatók soha nem látják a fájlok elérési útját vagy a kijelölőszkriptet.