İçeriğe geç

Öğe Yakalayıcı

AI kodlama asistanlarıyla çalışırken, sayfadaki belirli bir öğeyi hangi şablon dosyasının görüntülediğini onlara söylemeniz sık sık gerekir. Öğe yakalayıcı, tek bir hareketle zengin öğe bağlamını panoya kopyalayan, artı işareti biçiminde bir öğe seçici sunar.

Etkinleştirme

Etkinleştirmek için herhangi bir ön yüz URL adresine ?blockstudio-devtools ekleyin. Öğe yakalayıcı bir sorgu parametresine bağlıdır:

Kod
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools

Sorgu parametresi olmadan hiçbir betik veya veri özniteliği yüklenmez.

Ayarlar

Temanızın blockstudio.json dosyasında öğe yakalayıcıyı etkinleştirin:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Özellik Tür Varsayılan Açıklama
enabled boolean false Öğe yakalayıcıyı etkinleştirir.

Ayar filtre olarak da kullanılabilir:

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

Kullanım

  1. edit_posts yeteneğine sahip bir kullanıcı olarak oturum açın ve ?blockstudio-devtools ile herhangi bir ön yüz sayfasını ziyaret edin.
  2. Yakalayıcıyı etkinleştirmek için Cmd+C (Mac) veya Ctrl+C (Windows) tuşlarını 100ms boyunca basılı tutun.
  3. Fareyle üzerine geldiğinizde Blockstudio bloklarını vurgulayan bir tuval katmanıyla birlikte artı işareti seçicisi etkinleşir.
  4. İki etiket görünür: biri bloğun şablon dosyası yolunu, diğeri ise HTML öğe etiketinin adını gösterir.
  5. Bağlamını panoya kopyalamak için bir öğeye tıklayın.
  6. Sonucu AI kodlama aracınıza yapıştırın.

Kopyalama yapmadan devre dışı bırakmak için Escape veya Cmd+C tuşlarına yeniden basın. 100ms dolmadan Cmd+C tuşlarını bırakırsanız normal kopyalama davranışı korunur.

Pano Biçimi

Bir öğeye tıklandığında, AI kodlama asistanları için tasarlanmış zengin bir bağlam dizgesi kopyalanır:

Kod
@<div>

<div class="my-block">
  Hello world
</div>
  in theme-name/blockstudio/blocks/my-block/index.php

Bu; öğe etiketinin adını, öznitelikleri ve içeriğiyle birlikte HTML önizlemesini ve şablon dosyasının yolunu içerir.

İç Yapı

Blockstudio, ön yüzde useBlockProps kullanan her blok sarmalayıcı öğesine data-blockstudio-path özniteliği ekler. Bu öznitelik, bloğu oluşturan şablon dosyasının mutlak yolunu içerir.

Giriş yapmış editörler için ön yüzde hafif bir vanilla TypeScript modülü yüklenir (React yok, WordPress bağımlılıkları yok). Hem imlecin altındaki belirli HTML öğesini hem de üst öğesi olan Blockstudio bloğunu algılamak için document.elementsFromPoint() kullanır ve her biri için ayrı vurgular çizer.

Güvenlik

data-blockstudio-path özniteliği ve yakalama betiği yalnızca tüm koşullar karşılandığında oluşturulur:

  • ?blockstudio-devtools sorgu parametresi mevcut.
  • dev.grab.enabled ayarı true.
  • Mevcut kullanıcının edit_posts yeteneği var.

Genel ziyaretçiler dosya yollarını veya yakalama betiğini hiçbir zaman görmez.