Към съдържанието

Инструмент за избор на елемент

Когато работите с 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) за 100ms, за да активирате инструмента.
  3. Активира се селектор с мерник и наслагване на платното, което подчертава блоковете Blockstudio при посочване.
  4. Показват се два етикета: единият указва пътя към файла с шаблона на блока, а другият — името на етикета на елемента HTML.
  5. Щракнете върху елемент, за да копирате контекста му в клипборда.
  6. Поставете резултата в инструмента си за програмиране с 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.

Посетителите на сайта никога не виждат пътищата до файловете или скрипта за маркиране.