Lewati ke konten

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:

Kode
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:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Properti Jenis Default Deskripsi
enabled boolean false Aktifkan pengambil elemen.

Pengaturan ini juga tersedia sebagai filter:

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

Penggunaan

  1. Buka halaman frontend mana pun dengan ?blockstudio-devtools saat masuk sebagai pengguna yang memiliki kemampuan edit_posts.
  2. Tahan Cmd+C (Mac) atau Ctrl+C (Windows) selama 100ms untuk mengaktifkan pengambil.
  3. Pemilih bidik aktif dengan overlay kanvas yang menyorot blok Blockstudio saat Anda mengarahkan kursor.
  4. Dua label muncul: satu menampilkan jalur file templat blok dan satu lagi menampilkan nama tag elemen HTML.
  5. Klik elemen untuk menyalin konteksnya ke clipboard.
  6. 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:

Kode
@<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-devtools tersedia.
  • Pengaturan dev.grab.enabled bernilai true.
  • Pengguna saat ini memiliki kapabilitas edit_posts.

Pengunjung publik tidak pernah melihat jalur file atau skrip grabber.