useBlockProps
Privzeto mora Gutenberg ustvariti ovoj okoli blokov, da postanejo interaktivni v urejevalniku. To lahko povzroči težave pri nekaterih vrstah blokov, na primer vsebnikih ali stolpcih, saj se označevanje v urejevalniku razlikuje od označevanja na spletnem mestu. S kljuko useBlockProps lahko označite element v predlogi bloka kot korenski element in tako zagotovite enako označevanje v urejevalniku in na spletnem mestu.
Uporaba
Preprosto dodajte atribut useBlockProps korenskemu elementu bloka.
<div useBlockProps class="my-class">
<!--
This element will be rendered
as the root element of your block
in Gutenberg.
-->
</div>
Blockstudio bo samodejno združil razrede in atribute iz urejevalnika (na primer razrede poravnave) z vsem, kar je določeno v predlogah blokov. V ozadju se za to uporablja get_block_wrapper_attributes.
Filter blockstudio/blocks/components/use_block_props/render se uporabi za ovoj pri izrisu na spletnem mestu in v urejevalniku.
Zato se razredi, ki jih doda tema ali integracija posameznega primerka,
prikažejo tako na platnu urejevalnika kot v shranjenem označevanju na spletnem mestu.
Izhod:
<div class="my-class wp-block-your-block-name alignright">
</div>
Premisleki
Povezave v urejevalniku
Blockstudio prepreči krmarjenje po povezavah v urejevalniku blokov, vključno z
target="_blank", kliki s pritisnjeno modifikacijsko tipko, kliki s srednjim gumbom in aktivacijo s tipkovnico.
Dogodki klika še vedno dosežejo Gutenberg, zato običajni kliki izberejo blok.
RichText je še vedno mogoče urejati. To velja z useBlockProps ali brez njega,
tudi kadar je sidro uporabljeno kot korenski element bloka.
Povezave na sprednjem delu spletnega mesta in ukazi brskalnika v kontekstnem meniju ostanejo nespremenjeni. Povezav vam ni treba odstraniti iz predlog ali uporabiti vejitev glede na $isEditor.
Korenski element
Ker je v predlogi bloka lahko samo en korenski element, mora imeti predloga bloka pri uporabi useBlockProps en sam korenski element. Naslednji primer na primer ne bo deloval, zato bo Gutenberg okoli predloge ustvaril ovoj.
<div useBlockProps>
First root element.
</div>
<span>
Second root element.
</span>
Podobno lahko useBlockProps v posamezni predlogi bloka uporabite samo enkrat.
Znak @
Blockstudio pretvori predlogo bloka v veljavno kodo React znotraj Gutenberg z uporabo razčlenjevalnika html-react-parser. To prinaša omejitev: znaka @ ni mogoče uporabiti v imenu atributa HTML.
Knjižnice, kot je Alpine.js, uporabljajo znake @ za določanje direktiv na elementih HTML.
<button useBlockProps @click="console.log('hi')">
Click me
</button>
Znotraj Gutenberg bo ta atribut @click odstranjen iz elementa. (Seveda bo še vedno deloval na spletnem mestu.)
To težavo lahko odpravite z uporabo nadomestne sintakse, ki jo ponuja Alpine.js.
<button useBlockProps x-on:click="console.log('hi')">
Click me
</button>
Zgornje bo delovalo znotraj Gutenberg in na spletnem mestu.
Razredi telesa platna
Ko je assets.reset.enabled aktiven, Blockstudio na platno urejevalnika kopira tudi prečiščene
razrede, ki jih vrne filter body_class komponente WordPress.
Tako izbirniki teme, kot je .brand-a .site-card, delujejo na obeh mestih.
Končni seznam razredov filtrirajte, ko urejevalnik potrebuje ožji nabor:
add_filter('blockstudio/editor/canvas/body_class', function(array $classes) {
return array_values(array_diff($classes, ['logged-in']));
});
Ta filter nadzira samo razrede, kopirane na platno urejevalnika. Ne spremeni razredov body na spletnem mestu.