Przejdź do treści

Selektor elementów

Podczas pracy z asystentami programowania AI często trzeba wskazać, który plik szablonu renderuje konkretny element strony. Selektor elementów działa jak celownik i jednym gestem kopiuje do schowka rozbudowane informacje o elemencie.

Aktywacja

Selektor elementów jest aktywowany za pomocą parametru zapytania. Dodaj ?blockstudio-devtools do dowolnego adresu frontendowego URL, aby go włączyć:

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

Bez parametru zapytania nie są ładowane żadne skrypty ani atrybuty danych.

Ustawienia

Włącz selektor elementów w pliku blockstudio.json motywu:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Właściwość Typ Domyślnie Opis
enabled boolean false Włącza selektor elementów.

Ustawienie jest również dostępne jako filtr:

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

Użycie

  1. Odwiedź dowolną stronę frontendową z ?blockstudio-devtools, będąc zalogowanym jako użytkownik z uprawnieniem edit_posts.
  2. Przytrzymaj Cmd+C (Mac) lub Ctrl+C (Windows) przez 100ms, aby aktywować selektor.
  3. Aktywuje się selektor w kształcie celownika z nakładką canvas, która podczas najeżdżania podświetla bloki Blockstudio.
  4. Pojawią się dwie etykiety: jedna pokaże ścieżkę pliku szablonu bloku, a druga nazwę tagu elementu HTML.
  5. Kliknij element, aby skopiować jego kontekst do schowka.
  6. Wklej wynik do narzędzia AI do programowania.

Naciśnij Escape lub ponownie Cmd+C, aby wyłączyć selektor bez kopiowania. Jeśli zwolnisz Cmd+C przed upływem 100ms, zwykłe kopiowanie nadal będzie działać.

Format schowka

Kliknięcie elementu kopiuje rozbudowany ciąg kontekstu przeznaczony dla asystentów programowania AI:

Kod
@<div>

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

Zawiera on nazwę tagu elementu, podgląd HTML z atrybutami i treścią oraz ścieżkę pliku szablonu.

Szczegóły działania

Blockstudio dodaje atrybut data-blockstudio-path do każdego elementu opakowującego blok, który używa useBlockProps na frontendzie. Atrybut ten zawiera bezwzględną ścieżkę do pliku szablonu renderującego blok.

Lekki moduł vanilla TypeScript (bez zależności React i WordPress) jest dołączany na frontendzie dla zalogowanych edytorów. Używa document.elementsFromPoint() do wykrywania zarówno konkretnego elementu HTML pod kursorem, jak i jego nadrzędnego bloku Blockstudio, wyświetlając osobne podświetlenia dla każdego z nich.

Bezpieczeństwo

Atrybut data-blockstudio-path i skrypt grabbera są renderowane tylko po spełnieniu wszystkich warunków:

  • Parametr zapytania ?blockstudio-devtools jest obecny.
  • Ustawienie dev.grab.enabled ma wartość true.
  • Bieżący użytkownik ma uprawnienie edit_posts.

Odwiedzający bez uprawnień nigdy nie widzą ścieżek do plików ani skryptu grabbera.