Preskoči na vsebino

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:

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

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Lastnost Vrsta Privzeto Opis
enabled boolean false Omogoči izbirnik elementov.

Nastavitev je na voljo tudi kot filter:

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

Uporaba

  1. Obiščite poljubno stran z ?blockstudio-devtools, medtem ko ste prijavljeni kot uporabnik z zmožnostjo edit_posts.
  2. Za aktivacijo izbirnika pridržite Cmd+C (Mac) ali Ctrl+C (Windows) za 100ms.
  3. Aktivira se izbirnik v obliki merka s prekrivanjem platna, ki med premikanjem kazalca označuje bloke Blockstudio.
  4. Prikažeta se dve oznaki: ena prikazuje pot do datoteke predloge bloka, druga pa ime oznake elementa HTML.
  5. Kliknite element, da kopirate njegov kontekst v odložišče.
  6. 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:

Koda
@<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.enabled je true.
  • Trenutni uporabnik ima zmožnost edit_posts.

Javni obiskovalci nikoli ne vidijo poti do datotek ali skripta za zajem.