Перейти до вмісту

Інструмент вибору елементів

Працюючи з помічниками кодування на основі ШІ, часто потрібно вказати, який файл шаблону відображає певний елемент сторінки. Інструмент вибору елементів дає змогу вибрати елемент прицілом і одним жестом скопіювати докладний контекст елемента в буфер обміну.

Активація

Інструмент вибору елементів доступний лише за наявності параметра запиту. Додайте ?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. Вставте результат у свій інструмент кодування на основі ШІ.

Натисніть Escape або ще раз Cmd+C, щоб вимкнути інструмент без копіювання. Якщо відпустити Cmd+C раніше ніж через 100мс, звичайне копіювання працюватиме як завжди.

Формат буфера обміну

Після клацання елемента в буфер обміну копіюється докладний рядок контексту, призначений для помічників кодування на основі ШІ:

Код
@<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 і скрипт grabber відображаються, лише коли виконано всі умови:

  • Наявний параметр запиту ?blockstudio-devtools.
  • Параметр dev.grab.enabled має значення true.
  • Поточний користувач має дозвіл edit_posts.

Відвідувачі сайту не бачать шляхів до файлів і скрипту grabber.