Siirry sisältöön

Elementin tunnistin

Kun työskentelet tekoälyavusteisten koodausavustajien kanssa, sinun on usein kerrottava niille, mikä mallitiedosto hahmontaa tietyn sivun elementin. Elementin tunnistin tarjoaa tähtäinristin kaltaisen valitsimen, joka kopioi monipuoliset elementtitiedot leikepöydälle yhdellä eleellä.

Aktivointi

Elementin tunnistin on käytettävissä kyselyparametrin avulla. Lisää ?blockstudio-devtools mihin tahansa käyttöliittymän URL-osoitteeseen ottaaksesi sen käyttöön:

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

Ilman kyselyparametria komentosarjaa tai data-attribuutteja ei ladata.

Asetukset

Ota elementin tunnistin käyttöön teemasi blockstudio.json-tiedostossa:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Ominaisuus Tyyppi Oletus Kuvaus
enabled boolean false Ota elementin tunnistin käyttöön.

Asetus on saatavilla myös suodattimena:

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

Käyttö

  1. Siirry mille tahansa käyttöliittymän sivulle osoitteella ?blockstudio-devtools ja kirjaudu sisään käyttäjänä, jolla on edit_posts-oikeus.
  2. Aktivoi tunnistin pitämällä Cmd+C-näppäimiä (Mac) tai Ctrl+C (Windows) painettuina 100 millisekunnin ajan.
  3. Tähtäinristin valitsin aktivoituu, ja piirtoalueen peite korostaa Blockstudio-lohkoja, kun viet osoittimen niiden päälle.
  4. Näkyviin tulee kaksi tunnistetta: toinen näyttää lohkon mallitiedoston polun ja toinen HTML-elementin tunnistenimen.
  5. Kopioi elementin tiedot leikepöydälle napsauttamalla sitä.
  6. Liitä tulos käyttämääsi tekoälyavusteiseen koodaustyökaluun.

Poistu kopioimatta painamalla Escape tai Cmd+C uudelleen. Jos vapautat Cmd+C ennen 100ms, tavallinen kopiointitoiminto säilyy.

Leikepöydän muoto

Elementin napsauttaminen kopioi monipuolisen kontekstimerkkijonon, joka on tarkoitettu tekoälyavustajille:

Koodi
@<div>

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

Se sisältää elementin tunnisteen nimen, HTML-esikatselun määritteineen ja sisältöineen sekä mallitiedoston polun.

Sisäinen toteutus

Blockstudio lisää data-blockstudio-path-määritteen jokaiseen lohkon kääreelementtiin, joka käyttää useBlockProps-toimintoa käyttöliittymässä. Määrite sisältää lohkon renderöivän mallitiedoston absoluuttisen polun.

Kevyt vanillana toteutettu TypeScript-moduuli (ei React- eikä WordPress-riippuvuuksia) lisätään käyttöliittymään kirjautuneille muokkaajille. Se käyttää document.elementsFromPoint()-toimintoa tunnistaakseen sekä osoittimen alla olevan tietyn HTML-elementin että sen sisältävän Blockstudio-lohkon ja korostaa ne erikseen.

Tietoturva

data-blockstudio-path-määrite ja tunnistusskripti renderöidään vain, kun kaikki ehdot täyttyvät:

  • ?blockstudio-devtools-kyselyparametri on mukana.
  • dev.grab.enabled-asetus on true.
  • Nykyisellä käyttäjällä on edit_posts-kyky.

Julkiset kävijät eivät koskaan näe tiedostopolkuja tai tunnistusskriptiä.