Ugrás a tartalomhoz

useBlockProps

Alapértelmezés szerint a Gutenberg burkolóelemet hoz létre a blokkok körül, hogy azok interaktívak legyenek a szerkesztőben. Ez gondot okozhat bizonyos blokktípusoknál, például tárolóknál vagy oszlopoknál, mivel a szerkesztő és az előtér jelölése eltérő lesz. A useBlockProps hook lehetővé teszi, hogy a blokk sablonjának egyik elemét gyökérelemként jelöld meg, így azonos jelölést hoz létre a szerkesztőben és az előtérben.

Használat

Egyszerűen add hozzá a useBlockProps attribútumot a blokkod gyökéreleméhez.

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

A Blockstudio automatikusan egyesíti a szerkesztő osztályait és attribútumait (például igazítási osztályokat) a blokk sablonjában megadottakkal. Ehhez a háttérben a get_block_wrapper_attributes függvényt használja.

A blockstudio/blocks/components/use_block_props/render szűrő az előtérben és a szerkesztőben történő megjelenítés során is alkalmazódik a burkolóelemre. Ezért a téma vagy az adott példány integrációja által hozzáadott osztályok a szerkesztővásznon és a mentett előtéri jelölésben is megjelennek.

Kimenet:

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

Fontos tudnivalók

A Blockstudio megakadályozza a hivatkozások megnyitását a blokkszerkesztőben, beleértve a target="_blank" billentyűkombinációkat, a módosítóbillentyűvel vagy középső gombbal végzett kattintásokat, valamint a billentyűzetes aktiválást. A kattintási események továbbra is eljutnak a Gutenberg elemhez, így a szokásos kattintások kijelölik a blokkot. A RichText továbbra is szerkeszthető. Ez a useBlockProps megléte nélkül és annak használatakor is érvényes, akkor is, ha a horgony a blokk gyökéreleme.

A webhely látogatói számára megjelenő hivatkozások és a böngésző helyi menüjének parancsai változatlanok. Nem kell eltávolítania a hivatkozásokat a sablonokból, és nem kell a $isEditor megléte alapján elágaztatnia a kódot.

Gyökérelem

Mivel egy blokk sablonjának csak egy gyökéreleme lehet, a useBlockProps használatakor a blokksablonnak egyetlen gyökérelemmel kell rendelkeznie. Az alábbi példa például nem fog működni, és a Gutenberg burkolóelemet hoz létre a sablon körül.

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

A useBlockProps hasonlóképpen csak egyszer használható blokksablononként.

@ jel

A Blockstudio a blokksablont érvényes React kóddá alakítja a Gutenberg belsejében a html-react-parser segítségével. Ennek korlátja, hogy a @ karakter nem használható HTML attribútumnévben.

Az olyan könyvtárak, mint a Alpine.js, a @ karaktereket használják direktívák megadására a HTML elemeken.

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

A Gutenberg belsejében ez a @click attribútum eltávolításra kerül az elemből. (Az előtérben természetesen továbbra is működik.)

A probléma megoldására használhatod a Alpine.js által biztosított alternatív szintaxist.

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

A fenti megoldás a Gutenberg belsejében és az előtérben is működik.

A vászon törzsének osztályai

Ha a assets.reset.enabled aktív, a Blockstudio a WordPress body_class szűrője által visszaadott, megtisztított osztályokat is átmásolja a blokkszerkesztő vásznára. Így a téma választói, például a .brand-a .site-card, mindkét helyen működnek.

Ha a szerkesztőben szűkebb osztálykészletre van szükség, szűrd a végső osztálylistát:

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

Ez a szűrő csak a szerkesztővászonra másolt osztályokat szabályozza. Az előtér törzselemeinek osztályait nem módosítja.