Pereiti prie turinio

Elementų parinkiklis

Dirbant su AI programavimo asistentais dažnai reikia nurodyti, kuris šablono failas atvaizduoja konkretų puslapio elementą. Elementų parinkiklis leidžia kryželio formos žymikliu pasirinkti elementą ir vienu veiksmu nukopijuoti išsamų jo kontekstą į iškarpinę.

Suaktyvinimas

Elementų parinkiklis įjungiamas naudojant užklausos parametrą. Norėdami jį įjungti, prie bet kurio svetainės sąsajos URL pridėkite ?blockstudio-devtools:

Kodas
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools

Jei užklausos parametro nėra, neįkeliami jokie scenarijai ar duomenų atributai.

Nustatymai

Įjunkite elementų parinkiklį savo temoje esančiame blockstudio.json:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Ypatybė Tipas Numatytoji reikšmė Aprašymas
enabled boolean false Įjungti elementų parinkiklį.

Nustatymą taip pat galima pakeisti naudojant filtrą:

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

Naudojimas

  1. Prisijungę kaip naudotojas, turintis edit_posts galimybę, atidarykite bet kurį svetainės puslapį su ?blockstudio-devtools.
  2. Laikykite nuspaudę Cmd+C (Mac) arba Ctrl+C (Windows) 100ms, kad įjungtumėte parinkiklį.
  3. Įjungiamas kryželio formos žymiklis ir drobės perdanga, kuri užvedus žymiklį paryškina Blockstudio blokus.
  4. Rodomos dvi etiketės: viena nurodo bloko šablono failo kelią, kita – HTML elemento žymos pavadinimą.
  5. Spustelėkite elementą, kad nukopijuotumėte jo kontekstą į iškarpinę.
  6. Įklijuokite rezultatą į AI programavimo įrankį.

Paspauskite Escape arba dar kartą Cmd+C, kad išjungtumėte parinkiklį nieko nenukopijavę. Atleidus Cmd+C anksčiau nei po 100ms, įprasta kopijavimo veiksena išsaugoma.

Iškarpinės formatas

Spustelėjus elementą, nukopijuojama išsami konteksto eilutė, skirta AI programavimo asistentams:

Kodas
@<div>

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

Joje pateikiamas elemento žymos pavadinimas, HTML peržiūra su atributais ir turiniu bei šablono failo kelias.

Vidinė veikimo struktūra

Blockstudio prideda atributą data-blockstudio-path prie kiekvieno bloko apvalkalo elemento, kuris sąsajoje naudoja useBlockProps. Šiame atribute pateikiamas absoliutus šablono failo, kuriame atvaizduojamas blokas, kelias.

Prisijungusiems redaktoriams sąsajoje įkeliama lengva paprasto TypeScript kalbos modulio versija (be React ir WordPress priklausomybių). Jis naudoja document.elementsFromPoint(), kad aptiktų ir konkretų po žymekliu esantį elementą HTML, ir jo pirminį bloką Blockstudio, kiekvieną paryškindamas atskirai.

Sauga

Atributas data-blockstudio-path ir žymeklio scenarijus atvaizduojami tik tada, kai tenkinamos visos sąlygos:

  • Yra užklausos parametras ?blockstudio-devtools.
  • Nustatymas dev.grab.enabled yra true.
  • Dabartinis naudotojas turi galimybę edit_posts.

Vieši lankytojai niekada nemato failų kelių ar žymeklio scenarijaus.