Перейти к содержимому

Поиск элемента

При работе с AI-ассистентами для написания кода часто нужно указать, какой файл шаблона отображает конкретный элемент страницы. Инструмент поиска элемента позволяет выбирать элементы прицельным курсором и одним движением копировать в буфер обмена подробный контекст элемента.

Активация

Доступ к средству захвата элементов открывается с помощью параметра запроса. Добавьте ?blockstudio-devtools к любому URL во фронтенде, чтобы включить его:

Код
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools

Без параметра запроса скрипт и атрибуты данных не загружаются.

Настройки

Включите инструмент поиска элемента в файле blockstudio.json темы:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Свойство Тип По умолчанию Описание
enabled boolean false Включить инструмент поиска элемента.

Эта настройка также доступна в виде фильтра:

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

Использование

  1. Откройте любую страницу внешней части сайта с параметром ?blockstudio-devtools, войдя в систему как пользователь с правом edit_posts.
  2. Удерживайте Cmd+C (Mac) или Ctrl+C (Windows) в течение 100мс, чтобы активировать инструмент.
  3. Появится прицельный курсор с наложением canvas, подсвечивающим блоки Blockstudio при наведении.
  4. Появятся две подписи: одна с путем к файлу шаблона блока, другая с именем тега элемента HTML.
  5. Нажмите на элемент, чтобы скопировать его контекст в буфер обмена.
  6. Вставьте результат в инструмент для написания кода с помощью 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.

Публичные посетители никогда не видят пути к файлам и скрипт захвата.