Инструмент за избор на елемент
Когато работите с AI асистенти за програмиране, често трябва да им посочите кой файл с шаблон визуализира даден елемент на страницата. Инструментът за избор на елемент предлага селектор с мерник, който с едно действие копира подробен контекст за елемента в клипборда.
Активиране
Инструментът за избор на елемент се активира чрез параметър на заявката. Добавете ?blockstudio-devtools към всеки фронтенд URL, за да го включите:
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools
Без параметъра на заявката не се зареждат скрипт или атрибути на данните.
Настройки
Включете инструмента за избор на елемент във файла blockstudio.json на темата си:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Свойство | Тип | По подразбиране | Описание |
|---|---|---|---|
enabled |
boolean |
false |
Включва инструмента за избор на елемент. |
Настройката е налична и като филтър:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Употреба
- Отворете която и да е страница във фронтенда с
?blockstudio-devtools, като сте влезли като потребител с правотоedit_posts. - Задръжте Cmd+C (Mac) или Ctrl+C (Windows) за 100ms, за да активирате инструмента.
- Активира се селектор с мерник и наслагване на платното, което подчертава блоковете Blockstudio при посочване.
- Показват се два етикета: единият указва пътя към файла с шаблона на блока, а другият — името на етикета на елемента HTML.
- Щракнете върху елемент, за да копирате контекста му в клипборда.
- Поставете резултата в инструмента си за програмиране с AI.
Натиснете Escape или Cmd+C отново, за да деактивирате режима, без да копирате. Ако пуснете Cmd+C преди 100ms, стандартното копиране се запазва.
Формат на клипборда
При щракване върху елемент се копира низ с подробен контекст, предназначен за AI асистенти за програмиране:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Той включва името на тага на елемента, предварителен преглед на HTML с атрибути и съдържание, както и пътя до файла с шаблона.
Вътрешна реализация
Blockstudio добавя атрибут data-blockstudio-path към обвиващия елемент на всеки блок, който използва useBlockProps във фронтенда. Този атрибут съдържа абсолютния път до файла с шаблона, който визуализира блока.
На фронтенда за вписаните редактори се зарежда лек модул на vanilla TypeScript (без зависимости от React или WordPress). Той използва document.elementsFromPoint(), за да открива както конкретния елемент HTML под курсора, така и родителския му блок Blockstudio, и очертава всеки от тях отделно.
Сигурност
Атрибутът data-blockstudio-path и скриптът за маркиране се изобразяват само когато са изпълнени всички условия:
- Налице е параметърът на заявката
?blockstudio-devtools. - Настройката
dev.grab.enabledеtrue. - Текущият потребител има правото
edit_posts.
Посетителите на сайта никога не виждат пътищата до файловете или скрипта за маркиране.