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.
<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:
<div class="my-class wp-block-your-block-name alignright">
</div>
Fontos tudnivalók
Hivatkozások a szerkesztőben
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.
<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.
<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.
<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:
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.