Liigu sisu juurde

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.

PHP
<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:

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

Kaalutlused

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.

PHP
<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.

PHP
<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.

PHP
<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:

PHP
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.