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ć:
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:
{
"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:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Użycie
- Odwiedź dowolną stronę frontendową z
?blockstudio-devtools, będąc zalogowanym jako użytkownik z uprawnieniemedit_posts. - Przytrzymaj Cmd+C (Mac) lub Ctrl+C (Windows) przez 100ms, aby aktywować selektor.
- Aktywuje się selektor w kształcie celownika z nakładką canvas, która podczas najeżdżania podświetla bloki Blockstudio.
- Pojawią się dwie etykiety: jedna pokaże ścieżkę pliku szablonu bloku, a druga nazwę tagu elementu HTML.
- Kliknij element, aby skopiować jego kontekst do schowka.
- 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:
@<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-devtoolsjest obecny. - Ustawienie
dev.grab.enabledma 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.