Pengambil Elemen
Saat bekerja dengan asisten pengodean AI, Anda sering perlu memberi tahu mereka file templat mana yang merender elemen tertentu di halaman. Pengambil elemen menyediakan pemilih elemen bergaya bidik yang menyalin konteks elemen lengkap ke clipboard Anda dengan satu gerakan.
Aktivasi
Pengambil elemen dikendalikan oleh parameter kueri. Tambahkan ?blockstudio-devtools ke URL frontend mana pun untuk mengaktifkannya:
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools
Tanpa parameter kueri, tidak ada skrip atau atribut data yang dimuat.
Pengaturan
Aktifkan pengambil elemen di blockstudio.json tema Anda:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Properti | Jenis | Default | Deskripsi |
|---|---|---|---|
enabled |
boolean |
false |
Aktifkan pengambil elemen. |
Pengaturan ini juga tersedia sebagai filter:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Penggunaan
- Buka halaman frontend mana pun dengan
?blockstudio-devtoolssaat masuk sebagai pengguna yang memiliki kemampuanedit_posts. - Tahan Cmd+C (Mac) atau Ctrl+C (Windows) selama 100ms untuk mengaktifkan pengambil.
- Pemilih bidik aktif dengan overlay kanvas yang menyorot blok Blockstudio saat Anda mengarahkan kursor.
- Dua label muncul: satu menampilkan jalur file templat blok dan satu lagi menampilkan nama tag elemen HTML.
- Klik elemen untuk menyalin konteksnya ke clipboard.
- Tempelkan hasilnya ke alat pengodean AI Anda.
Tekan Escape atau Cmd+C lagi untuk menonaktifkan tanpa menyalin. Jika Anda melepas Cmd+C sebelum 100ms, perilaku salin biasa tetap berlaku.
Format Clipboard
Mengklik elemen akan menyalin string konteks lengkap yang dirancang untuk asisten pengodean AI:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Ini mencakup nama tag elemen, pratinjau HTML beserta atribut dan kontennya, serta jalur file templat.
Internal
Blockstudio menambahkan atribut data-blockstudio-path ke setiap elemen pembungkus blok yang menggunakan useBlockProps di frontend. Atribut ini berisi jalur absolut ke file templat yang merender blok.
Modul TypeScript vanilla yang ringan (tanpa dependensi React atau WordPress) dimuat di frontend untuk editor yang sudah masuk. Modul ini menggunakan document.elementsFromPoint() untuk mendeteksi elemen HTML tertentu di bawah kursor serta blok induk Blockstudio-nya, lalu menampilkan sorotan terpisah untuk masing-masing.
Keamanan
Atribut data-blockstudio-path dan skrip grabber hanya dirender jika semua kondisi berikut terpenuhi:
- Parameter kueri
?blockstudio-devtoolstersedia. - Pengaturan
dev.grab.enabledbernilaitrue. - Pengguna saat ini memiliki kapabilitas
edit_posts.
Pengunjung publik tidak pernah melihat jalur file atau skrip grabber.