Поиск элемента
При работе с 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) в течение 100мс, чтобы активировать инструмент.
- Появится прицельный курсор с наложением canvas, подсвечивающим блоки Blockstudio при наведении.
- Появятся две подписи: одна с путем к файлу шаблона блока, другая с именем тега элемента HTML.
- Нажмите на элемент, чтобы скопировать его контекст в буфер обмена.
- Вставьте результат в инструмент для написания кода с помощью AI.
Нажмите Escape или еще раз Cmd+C, чтобы отключить инструмент, не копируя данные. Если отпустить Cmd+C раньше чем через 100мс, обычное копирование будет работать как прежде.
Формат буфера обмена
При нажатии на элемент в буфер обмена копируется подробная строка контекста, предназначенная для AI-ассистентов по написанию кода:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Она включает имя тега элемента, предварительный просмотр HTML с атрибутами и содержимым, а также путь к файлу шаблона.
Внутреннее устройство
Blockstudio добавляет атрибут data-blockstudio-path каждому элементу-обёртке блока, в котором на фронтенде используется useBlockProps. Этот атрибут содержит абсолютный путь к файлу шаблона, который отображает блок.
На фронтенде для вошедших в систему редакторов подключается лёгкий модуль на чистом TypeScript без зависимостей от React и WordPress. Он использует document.elementsFromPoint(), чтобы обнаружить элемент HTML под курсором и его родительский блок Blockstudio, выделяя каждый из них отдельно.
Безопасность
Атрибут data-blockstudio-path и скрипт захвата отображаются, только если выполнены все условия:
- Указан параметр запроса
?blockstudio-devtools. - Настройка
dev.grab.enabledимеет значениеtrue. - У текущего пользователя есть право
edit_posts.
Публичные посетители никогда не видят пути к файлам и скрипт захвата.