Ugrás a tartalomhoz

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:

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

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

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

Használat

  1. Jelentkezzen be egy olyan felhasználóként, aki rendelkezik az edit_posts jogosultsággal, majd nyissa meg bármelyik webhelyfelületi oldalt a ?blockstudio-devtools paraméterrel.
  2. 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.
  3. Megjelenik a célkereszt, amely vászonréteggel jelöli ki az Blockstudio blokkokat, ahogy föléjük viszi a mutatót.
  4. 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.
  5. Kattintson egy elemre a környezet vágólapra másolásához.
  6. 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:

Kód
@<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-devtools lekérdezési paraméter.
  • A dev.grab.enabled beállítás értéke true.
  • Az aktuális felhasználó rendelkezik a edit_posts jogosultsá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.