useBlockProps
Pagal numatytuosius nustatymus Gutenberg turi sukurti apvalkalą aplink blokus, kad jie būtų interaktyvūs redaktoriuje. Tai gali kelti problemų su kai kurių tipų blokais, pavyzdžiui, konteineriais ar stulpeliais, nes žymėjimas redaktoriuje ir viešojoje svetainės dalyje skirsis. Naudodami kabliuką useBlockProps galite pažymėti bloko šablono elementą kaip šakninį elementą ir taip užtikrinti vienodą žymėjimą redaktoriuje ir viešojoje svetainės dalyje.
Naudojimas
Tiesiog pridėkite atributą useBlockProps prie bloko šakninio elemento.
<div useBlockProps class="my-class">
<!--
This element will be rendered
as the root element of your block
in Gutenberg.
-->
</div>
Blockstudio automatiškai sujungs redaktoriaus klases ir atributus (pvz., lygiavimo klases) su tuo, kas apibrėžta bloko šablonuose. Tam viduje naudojamas get_block_wrapper_attributes.
Filtras blockstudio/blocks/components/use_block_props/render taikomas apvalkalui tiek viešosios svetainės dalies, tiek redaktoriaus atvaizdavimo keliuose. Todėl temos arba konkretaus egzemplioriaus integracijos pridėtos klasės rodomos ir redaktoriaus drobėje, ir išsaugotame viešosios svetainės dalies žymėjime.
Išvestis:
<div class="my-class wp-block-your-block-name alignright">
</div>
Svarstymai
Nuorodos rengyklėje
Blockstudio blokuoja nuorodų atvėrimą blokų rengyklėje, įskaitant
target="_blank", paspaudimus su modifikavimo klavišais, vidurinio pelės mygtuko paspaudimus ir aktyvinimą klaviatūra.
Paspaudimų įvykiai vis tiek pasiekia Gutenberg, todėl įprastai spustelėjus pasirenkamas blokas.
RichText turinį galima redaguoti. Tai taikoma nepriklausomai nuo to, ar yra useBlockProps,
įskaitant atvejį, kai bloko šakninis elementas yra nuoroda.
Nuorodos svetainės sąsajoje ir naršyklės kontekstinio meniu komandos nekeičiamos. Nereikia šalinti nuorodų iš šablonų ar tikrinti $isEditor.
Šakninis elementas
Kadangi bloko šablone gali būti tik vienas šakninis elementas, naudojant useBlockProps bloko šablone turi būti vienas šakninis elementas. Pavyzdžiui, toliau pateiktas variantas neveiks, o Gutenberg aplink šabloną sukurs apvalkalą.
<div useBlockProps>
First root element.
</div>
<span>
Second root element.
</span>
Panašiai useBlockProps galima naudoti tik vieną kartą kiekviename bloko šablone.
Ženklas @
Blockstudio paverčia bloko šabloną galiojančiu React kodu Gutenberg, naudodamas html-react-parser. Dėl to simbolio @ negalima naudoti HTML atributo pavadinime.
Tokios bibliotekos kaip Alpine.js naudoja simbolį @ direktyvoms HTML elementuose apibrėžti.
<button useBlockProps @click="console.log('hi')">
Click me
</button>
Gutenberg viduje šis atributas @click bus pašalintas iš elemento. (Žinoma, viešojoje svetainės dalyje jis vis tiek veiks.)
Norėdami išspręsti šią problemą, galite naudoti alternatyvią sintaksę, kurią teikia Alpine.js.
<button useBlockProps x-on:click="console.log('hi')">
Click me
</button>
Tai veiks ir Gutenberg viduje, ir viešojoje svetainės dalyje.
Drobės elementų body klasės
Kai aktyvus assets.reset.enabled, Blockstudio taip pat nukopijuoja į blokų redaktoriaus drobę sanitizuotas klases, kurias grąžina WordPress filtras body_class. Taip užtikrinama, kad temos selektoriai, tokie kaip .brand-a .site-card, veiktų abiejose vietose.
Filtruokite galutinį klasių sąrašą, kai redaktoriui reikia siauresnio rinkinio:
add_filter('blockstudio/editor/canvas/body_class', function(array $classes) {
return array_values(array_diff($classes, ['logged-in']));
});
Šis filtras valdo tik į blokų redaktoriaus drobę kopijuojamas klases. Jis nekeičia viešosios svetainės dalies body klasių.