Izbirnik elementov
Pri delu s pomočniki za kodiranje z UI jim morate pogosto povedati, katera datoteka predloge izriše določen element na strani. Izbirnik elementov ponuja izbirnik v obliki merka, ki z eno potezo kopira bogat kontekst elementa v odložišče.
Aktivacija
Izbirnik elementov je omejen s parametrom poizvedbe. Če ga želite omogočiti, poljubnemu URL-ju strani dodajte ?blockstudio-devtoolsURL:
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools
Brez parametra poizvedbe se ne naloži noben skript ali podatkovni atribut.
Nastavitve
Omogočite izbirnik elementov v datoteki blockstudio.json svoje teme:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Lastnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
enabled |
boolean |
false |
Omogoči izbirnik elementov. |
Nastavitev je na voljo tudi kot filter:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Uporaba
- Obiščite poljubno stran z
?blockstudio-devtools, medtem ko ste prijavljeni kot uporabnik z zmožnostjoedit_posts. - Za aktivacijo izbirnika pridržite Cmd+C (Mac) ali Ctrl+C (Windows) za 100ms.
- Aktivira se izbirnik v obliki merka s prekrivanjem platna, ki med premikanjem kazalca označuje bloke Blockstudio.
- Prikažeta se dve oznaki: ena prikazuje pot do datoteke predloge bloka, druga pa ime oznake elementa HTML.
- Kliknite element, da kopirate njegov kontekst v odložišče.
- Rezultat prilepite v orodje za kodiranje z UI.
Pritisnite Escape ali znova Cmd+C, da izbirnik izklopite brez kopiranja. Če Cmd+C spustite pred potekom 100ms, se ohrani običajno kopiranje.
Oblika odložišča
S klikom elementa se v odložišče kopira bogat kontekstni niz, namenjen pomočnikom za kodiranje z UI:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Vključuje ime oznake elementa, predogled HTML z atributi in vsebino ter pot do datoteke predloge.
Notranje delovanje
Blockstudio vsakemu elementu ovoja bloka, ki na sprednjem delu spletnega mesta uporablja useBlockProps, doda atribut data-blockstudio-path. Ta atribut vsebuje absolutno pot do datoteke predloge, ki izriše blok.
Lahkoten modul TypeScript brez odvisnosti od React in WordPress se doda na sprednji del spletnega mesta za prijavljene urednike. Z uporabo document.elementsFromPoint() zazna tako določen element HTML pod kazalcem kot njegov nadrejeni blok Blockstudio ter vsakega posebej označi.
Varnost
Atribut data-blockstudio-path in skript za zajem se izrišeta samo, če so izpolnjeni vsi pogoji:
- Prisoten je parameter poizvedbe
?blockstudio-devtools. - Nastavitev
dev.grab.enabledjetrue. - Trenutni uporabnik ima zmožnost
edit_posts.
Javni obiskovalci nikoli ne vidijo poti do datotek ali skripta za zajem.