Elementu atlasītājs
Strādājot ar MI kodēšanas asistentiem, bieži ir jānorāda, kurš veidnes fails attēlo konkrētu lapas elementu. Elementu atlasītājs piedāvā elementu atlasi ar tēmēkļa kursoru, kas ar vienu darbību kopē starpliktuvē detalizētu elementa kontekstu.
Aktivizēšana
Elementu atlasītājs ir pieejams, izmantojot vaicājuma parametru. Pievienojiet ?blockstudio-devtools jebkuram priekšgala URL, lai to iespējotu:
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools
Ja vaicājuma parametra nav, netiek ielādēts neviens skripts vai datu atribūts.
Iestatījumi
Iespējojiet elementu atlasītāju savas tēmas blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Rekvizīts | Tips | Noklusējums | Apraksts |
|---|---|---|---|
enabled |
boolean |
false |
Iespējot elementu atlasītāju. |
Šis iestatījums ir pieejams arī kā filtrs:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Lietošana
- Apmeklējiet jebkuru priekšgala lapu ar
?blockstudio-devtools, esot pieteicies kā lietotājs ar iespējuedit_posts. - Turiet nospiestu Cmd+C (Mac) vai Ctrl+C (Windows) 100ms, lai aktivizētu atlasītāju.
- Tiek aktivizēts tēmēkļa atlasītājs ar canvas pārklājumu, kas, pārvietojot kursoru, izceļ Blockstudio blokus.
- Tiek parādītas divas etiķetes: viena rāda bloka veidnes faila ceļu, otra — HTML elementa taga nosaukumu.
- Noklikšķiniet uz elementa, lai kopētu tā kontekstu starpliktuvē.
- Ielīmējiet rezultātu savā MI kodēšanas rīkā.
Nospiediet Escape vai vēlreiz Cmd+C, lai deaktivizētu atlasītāju, neko nekopējot. Ja atlaižat Cmd+C pirms 100ms, parastā kopēšanas darbība tiek saglabāta.
Starpliktuves formāts
Noklikšķinot uz elementa, tiek kopēta detalizēta konteksta virkne, kas paredzēta MI kodēšanas asistentiem:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Tajā ir elementa taga nosaukums, HTML priekšskatījums ar atribūtiem un saturu, kā arī veidnes faila ceļš.
Iekšējā darbība
Blockstudio pievieno atribūtu data-blockstudio-path katram bloka aptverošajam elementam, kurā priekšskatā tiek izmantots useBlockProps. Šis atribūts satur absolūto ceļu uz veidnes failu, kas attēlo bloku.
Priekšskatā reģistrētiem redaktoriem tiek pievienots viegls vaniļas TypeScript modulis (bez React un WordPress atkarībām). Tas izmanto document.elementsFromPoint(), lai noteiktu gan konkrēto HTML elementu zem kursora, gan tā vecākelementa Blockstudio bloku, katram iezīmējot atsevišķu apgabalu.
Drošība
Atribūts data-blockstudio-path un satveršanas skripts tiek attēloti tikai tad, ja ir izpildīti visi nosacījumi:
- Ir norādīts vaicājuma parametrs
?blockstudio-devtools. - Iestatījums
dev.grab.enabledirtrue. - Pašreizējam lietotājam ir iespēja
edit_posts.
Publiskie apmeklētāji nekad neredz failu ceļus vai satveršanas skriptu.