Liigu sisu juurde

Elemendi valija

AI-koodimisabilistega töötades tuleb sageli neile öelda, milline mallifail lehe kindlat elementi renderdab. Elemendi valija lisab sihiku kujulise elemendivaliku, mis kopeerib liigutusega lõikelauale elemendi üksikasjaliku konteksti.

Aktiveerimine

Elemendi valija on saadaval päringuparameetri kaudu. Selle lubamiseks lisage mis tahes avaliku URL-i lõppu ?blockstudio-devtools:

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

Kui päringuparameetrit pole, ei laadita ühtegi skripti ega andmeatribuuti.

Seaded

Lubage elemendi valija oma teema failis blockstudio.json:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Atribuut Tüüp Vaikimisi Kirjeldus
enabled boolean false Lubab elemendi valija.

Seade on saadaval ka filtrina:

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

Kasutamine

  1. Avage avaliku veebisaidi mis tahes leht aadressiga ?blockstudio-devtools, olles sisse logitud kasutajana, kellel on võimekus edit_posts.
  2. Valija aktiveerimiseks hoidke 100 ms all klahve Cmd+C (Macis) või Ctrl+C (Windows).
  3. Aktiveerub sihikujuline valija koos lõuendikihiga, mis tõstab kursori liikumisel esile plokid Blockstudio.
  4. Kuvatakse kaks silti: üks näitab ploki mallifaili teed ja teine elemendi HTML märgendi nime.
  5. Elemendi konteksti lõikelauale kopeerimiseks klõpsake sellel.
  6. Kleepige tulemus oma AI-koodimistööriista.

Vajutage uuesti Escape või Cmd+C, et see kopeerimata välja lülitada. Kui vabastate klahvikombinatsiooni Cmd+C enne 100ms möödumist, säilib tavaline kopeerimiskäitumine.

Lõikelaua vorming

Elemendil klõpsates kopeeritakse rikkaliku kontekstiga string, mis on mõeldud AI-kodeerimisassistentidele:

Kood
@<div>

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

See sisaldab elemendi silti, atribuutide ja sisuga HTML eelvaadet ning mallifaili teed.

Sisemine toimimine

Blockstudio lisab igale ploki ümbriselemendile atribuudi data-blockstudio-path, mis kasutab eesliideses useBlockProps. See atribuut sisaldab plokki renderdava mallifaili absoluutset teed.

Sisseloginud toimetajate jaoks lisatakse eesliidesesse kerge vanilla TypeScript moodul (ilma sõltuvusteta React ja WordPress). See kasutab document.elementsFromPoint(), et tuvastada nii kursori all olev konkreetne HTML element kui ka selle ülemplokk Blockstudio, tõstes kumbagi eraldi esile.

Turvalisus

Atribuut data-blockstudio-path ja haaramisskript renderdatakse ainult siis, kui kõik tingimused on täidetud:

  • Päringuparameeter ?blockstudio-devtools on olemas.
  • Seadistus dev.grab.enabled on true.
  • Praegusel kasutajal on võimekus edit_posts.

Avalikud külastajad ei näe kunagi failiteid ega haaramisskripti.