Інструмент вибору елементів
Працюючи з помічниками кодування на основі ШІ, часто потрібно вказати, який файл шаблону відображає певний елемент сторінки. Інструмент вибору елементів дає змогу вибрати елемент прицілом і одним жестом скопіювати докладний контекст елемента в буфер обміну.
Активація
Інструмент вибору елементів доступний лише за наявності параметра запиту. Додайте ?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.
- Клацніть елемент, щоб скопіювати його контекст у буфер обміну.
- Вставте результат у свій інструмент кодування на основі ШІ.
Натисніть 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.