Pāriet uz saturu

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:

Kods
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:

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:

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

Lietošana

  1. Apmeklējiet jebkuru priekšgala lapu ar ?blockstudio-devtools, esot pieteicies kā lietotājs ar iespēju edit_posts.
  2. Turiet nospiestu Cmd+C (Mac) vai Ctrl+C (Windows) 100ms, lai aktivizētu atlasītāju.
  3. Tiek aktivizēts tēmēkļa atlasītājs ar canvas pārklājumu, kas, pārvietojot kursoru, izceļ Blockstudio blokus.
  4. Tiek parādītas divas etiķetes: viena rāda bloka veidnes faila ceļu, otra — HTML elementa taga nosaukumu.
  5. Noklikšķiniet uz elementa, lai kopētu tā kontekstu starpliktuvē.
  6. 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:

Kods
@<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.enabled ir true.
  • Pašreizējam lietotājam ir iespēja edit_posts.

Publiskie apmeklētāji nekad neredz failu ceļus vai satveršanas skriptu.