useBlockProps
Vaikimisi peab Gutenberg looma plokkide ümber ümbrise, et muuta need redaktoris interaktiivseks. See võib olla probleemne mõne plokitüübi, näiteks konteinerite või veergude puhul, sest märgendus erineb redaktoris ja esiküljel. Konks useBlockProps võimaldab määrata plokimallis elemendi juurelemendiks, tagades nii redaktori ja esikülje märgenduse kooskõla.
Kasutamine
Lisage lihtsalt atribuut useBlockProps ploki juurelemendile.
<div useBlockProps class="my-class">
<!--
This element will be rendered
as the root element of your block
in Gutenberg.
-->
</div>
Blockstudio ühendab automaatselt redaktori klassid ja atribuudid (nt joondusklassid) plokimallis määratutega. Selleks kasutatakse taustal funktsiooni get_block_wrapper_attributes.
Filtrit blockstudio/blocks/components/use_block_props/render rakendatakse ümbrisele nii esikülje kui ka redaktori renderdamisel. Seega kuvatakse teema või üksiku eksemplari integratsiooni lisatud klassid nii redaktori lõuendil kui ka salvestatud esikülje märgenduses.
Väljund:
<div class="my-class wp-block-your-block-name alignright">
</div>
Kaalutlused
Lingid redaktoris
Blockstudio takistab plokiredaktoris linkidel navigeerimist, sealhulgas
target="_blank", muuteklahviga klõpsamisel, keskmise hiirenupuga klõpsamisel ja klaviatuuriga aktiveerimisel.
Klõpsusündmused jõuavad endiselt Gutenberg-ni, nii et tavaline klõps valib ploki.
RichText jääb redigeeritavaks. See kehtib nii koos useBlockProps-ga kui ka ilma selleta,
sealhulgas juhul, kui ankur on ploki juurelement.
Esilehe lingid ja brauseri kontekstimenüü käsud jäävad muutmata. Teil pole vaja mallidest linke eemaldada ega tingimuslikult $isEditor järgi käituda.
Juur element
Kuna plokimallis saab olla ainult üks juurelement, peab mallil olema useBlockProps kasutamisel üksainus juurelement. Näiteks järgmine variant ei tööta ja Gutenberg loob malli ümber ümbrise.
<div useBlockProps>
First root element.
</div>
<span>
Second root element.
</span>
useBlockPropsi saab samamoodi plokimallis kasutada ainult üks kord.
@-märk
Blockstudio teisendab plokimalli kehtivaks React koodiks objektis Gutenberg, kasutades html-react-parser. Selle piiranguna ei saa märki @ kasutada atribuudi HTML nimes.
Sellised teegid nagu Alpine.js kasutavad märke @ direktiivide määratlemiseks HTML elementidel.
<button useBlockProps @click="console.log('hi')">
Click me
</button>
Gutenberg puhul eemaldatakse see @click atribuut elemendilt. (Esiküljel töötab see muidugi endiselt.)
Selle probleemi lahendamiseks võite kasutada alternatiivset süntaksit, mida pakub Alpine.js.
<button useBlockProps x-on:click="console.log('hi')">
Click me
</button>
Ülaltoodu töötab nii Gutenberg sees kui ka esiküljel.
Lõuendi body-klassid
Kui assets.reset.enabled on aktiivne, kopeerib Blockstudio plokiredaktori lõuendile ka sanitiseeritud klassid, mille tagastab WordPress filter body_class. Nii töötavad teemavalijad, näiteks .brand-a .site-card, mõlemas kohas.
Filtreerige lõplikku klasside loendit, kui redaktor vajab kitsamat valikut:
add_filter('blockstudio/editor/canvas/body_class', function(array $classes) {
return array_values(array_diff($classes, ['logged-in']));
});
See filter juhib ainult plokiredaktori lõuendile kopeeritavaid klasse. See ei muuda esikülje body-klasse.