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:
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:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Ypatybė | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
enabled |
boolean |
false |
Įjungti elementų parinkiklį. |
Nustatymą taip pat galima pakeisti naudojant filtrą:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Naudojimas
- Prisijungę kaip naudotojas, turintis
edit_postsgalimybę, atidarykite bet kurį svetainės puslapį su?blockstudio-devtools. - Laikykite nuspaudę Cmd+C (Mac) arba Ctrl+C (Windows) 100ms, kad įjungtumėte parinkiklį.
- Įjungiamas kryželio formos žymiklis ir drobės perdanga, kuri užvedus žymiklį paryškina Blockstudio blokus.
- Rodomos dvi etiketės: viena nurodo bloko šablono failo kelią, kita – HTML elemento žymos pavadinimą.
- Spustelėkite elementą, kad nukopijuotumėte jo kontekstą į iškarpinę.
- Į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:
@<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.enabledyratrue. - Dabartinis naudotojas turi galimybę
edit_posts.
Vieši lankytojai niekada nemato failų kelių ar žymeklio scenarijaus.