Preskoči na vsebino

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.

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

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

Premisleki

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.

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

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

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

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