İçeriğe geç

useBlockProps

Varsayılan olarak Gutenberg, düzenleyicide blokların etkileşimli olmasını sağlamak için etraflarına bir sarmalayıcı eklemelidir. Kapsayıcılar veya sütunlar gibi bazı blok türlerinde bu sorun yaratabilir; çünkü düzenleyici ile ön uç arasındaki işaretleme farklı olur. useBlockProps kancası, blok şablonundaki bir öğeyi kök öğe olarak işaretlemeyi ve böylece düzenleyici ile ön uçta aynı işaretlemeyi oluşturmayı sağlar.

Kullanım

useBlockProps özniteliğini bloğunuzun kök öğesine eklemeniz yeterlidir.

PHP
<div useBlockProps class="my-class">
  <!--
  This element will be rendered
  as the root element of your block
  in Gutenberg.
  -->
</div>

Blockstudio, düzenleyicideki sınıfları ve öznitelikleri (hizalama sınıfları vb.) blok şablonlarında tanımlananlarla otomatik olarak birleştirir. Bunun için arka planda get_block_wrapper_attributes kullanılır.

blockstudio/blocks/components/use_block_props/render filtresi, hem ön uç hem de düzenleyici çizim yollarındaki sarmalayıcıya uygulanır. Bu nedenle tema veya örnek bazlı bir entegrasyon tarafından eklenen sınıflar hem düzenleyici tuvalinde hem de kaydedilmiş ön uç işaretlemesinde görünür.

Çıktı:

HTML
<div class="my-class wp-block-your-block-name alignright">
</div>

Dikkat Edilecekler

Blockstudio, target="_blank", değiştirici tuşla tıklama, orta tuşla tıklama ve klavyeyle etkinleştirme dahil olmak üzere blok düzenleyicide bağlantı gezinmesini engeller. Tıklama olayları yine de Gutenberg öğesine ulaşır; bu nedenle normal tıklamalar bloğu seçer. RichText düzenlenebilir olmaya devam eder. Bu, useBlockProps olsun ya da olmasın geçerlidir; blokun kök öğesi olarak kullanılan bir bağlantı da buna dahildir.

Ön yüz bağlantıları ve tarayıcının bağlam menüsü komutları değişmez. Şablonlardan bağlantıları kaldırmanız veya $isEditor koşuluna göre dallanma yapmanız gerekmez.

Kök Öğe

Bir blok şablonunda yalnızca bir kök öğe bulunabileceğinden, useBlockProps kullanılırken blok şablonunun tek bir kök öğesi olmalıdır. Örneğin, aşağıdaki yapı çalışmaz ve Gutenberg şablonun etrafına bir sarmalayıcı ekler.

PHP
<div useBlockProps>
  First root element.
</div>
<span>
  Second root element.
</span>

Benzer şekilde, useBlockProps her blok şablonunda yalnızca bir kez kullanılabilir.

@ İşareti

Blockstudio, html-react-parser kullanarak blok şablonunu Gutenberg içinde geçerli React koduna dönüştürür. Bunun sınırlaması, @ karakterinin bir HTML öznitelik adında kullanılamamasıdır.

Alpine.js gibi kitaplıklar, HTML öğelerinde yönergeler tanımlamak için @ karakterlerini kullanır.

PHP
<button useBlockProps @click="console.log('hi')">
  Click me
</button>

Gutenberg içinde bu @click özniteliği öğeden çıkarılır. (Elbette ön uçta çalışmaya devam eder.)

Bu sorunu çözmek için Alpine.js tarafından sunulan alternatif söz dizimini kullanabilirsiniz.

PHP
<button useBlockProps x-on:click="console.log('hi')">
  Click me
</button>

Yukarıdaki yapı Gutenberg içinde ve ön uçta çalışır.

Tuval Gövde Sınıfları

assets.reset.enabled etkin olduğunda, Blockstudio ayrıca WordPress tarafından body_class filtresinden döndürülen temizlenmiş sınıfları blok düzenleyici tuvaline kopyalar. Böylece .brand-a .site-card gibi tema seçicileri her iki yerde de çalışır.

Düzenleyici daha sınırlı bir sınıf kümesine ihtiyaç duyduğunda son sınıf listesini filtreleyin:

PHP
add_filter('blockstudio/editor/canvas/body_class', function(array $classes) {
  return array_values(array_diff($classes, ['logged-in']));
});

Bu filtre yalnızca düzenleyici tuvaline kopyalanan sınıfları denetler. Ön uç gövde sınıflarını değiştirmez.