Pāriet uz saturu

useBlockProps

Pēc noklusējuma Gutenberg ir jāizveido ietvars ap blokiem, lai padarītu tos interaktīvus redaktorā. Tas var radīt problēmas ar dažiem bloku veidiem, piemēram, konteineriem vai kolonnām, jo marķējums redaktorā un priekšgalā atšķirsies. Āķis useBlockProps ļauj bloka veidnes elementu atzīmēt kā saknes elementu, tādējādi nodrošinot vienādu marķējumu redaktorā un priekšgalā.

Lietošana

Vienkārši pievienojiet atribūtu useBlockProps bloka saknes elementam.

PHP
<div useBlockProps class="my-class">
  <!--
  This element will be rendered
  as the root element of your block
  in Gutenberg.
  -->
</div>

Blockstudio automātiski apvienos klases un atribūtus no redaktora (piemēram, līdzinājuma klases) ar tiem, kas definēti bloku veidnēs. Šim nolūkam iekšēji tiek izmantots get_block_wrapper_attributes.

Filtrs blockstudio/blocks/components/use_block_props/render tiek lietots ietvaram gan priekšgala, gan redaktora renderēšanas ceļā. Tāpēc motīva vai katra gadījuma integrācijas pievienotās klases parādās gan redaktora kanvā, gan saglabātajā priekšgala marķējumā.

Izvade:

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

Apsvērumi

Blockstudio novērš saišu navigāciju bloku redaktorā, tostarp target="_blank", klikšķus ar modifikatoriem, klikšķus ar vidējo pogu un aktivizēšanu ar tastatūru. Klikšķu notikumi joprojām sasniedz Gutenberg, tāpēc parasti klikšķi atlasa bloku. RichText joprojām ir rediģējams. Tas darbojas gan ar useBlockProps, gan bez tās, tostarp, ja enkurs ir bloka saknes elements.

Saites saskarnē un pārlūkprogrammas konteksta izvēlnes komandas paliek nemainīgas. Veidnēs nav jānoņem saites vai jāveido atzars pēc $isEditor.

Saknes elements

Tā kā bloka veidnē var būt tikai viens saknes elements, izmantojot useBlockProps, bloka veidnei jābūt vienam saknes elementam. Piemēram, tālāk redzamais nedarbosies, un Gutenberg izveidos ietvaru ap veidni.

PHP
<div useBlockProps>
  First root element.
</div>
<span>
  Second root element.
</span>

Līdzīgi useBlockProps katrā bloka veidnē var izmantot tikai vienreiz.

@ zīme

Blockstudio pārvērš bloka veidni derīgā React kodā Gutenberg, izmantojot html-react-parser. Tāpēc rakstzīmi @ nevar izmantot HTML atribūta nosaukumā.

Tādas bibliotēkas kā Alpine.js izmanto rakstzīmes @, lai definētu direktīvas HTML elementos.

PHP
<button useBlockProps @click="console.log('hi')">
  Click me
</button>

Komponentā Gutenberg šis atribūts @click tiks noņemts no elementa. (Protams, priekšgalā tas joprojām darbosies.)

Lai apietu šo problēmu, varat izmantot alternatīvo sintaksi, ko nodrošina Alpine.js.

PHP
<button useBlockProps x-on:click="console.log('hi')">
  Click me
</button>

Iepriekš minētais darbosies komponentā Gutenberg un priekšgalā.

Kanvas pamatdaļas klases

Kad assets.reset.enabled ir aktīvs, Blockstudio arī kopē sanitizētās klases, ko atgriež WordPress filtra body_class, uz bloka redaktora kanvu. Tādējādi motīva selektori, piemēram, .brand-a .site-card, darbojas abās vietās.

Filtrējiet gala klašu sarakstu, ja redaktoram nepieciešama šaurāka kopa:

PHP
add_filter('blockstudio/editor/canvas/body_class', function(array $classes) {
  return array_values(array_diff($classes, ['logged-in']));
});

Šis filtrs kontrolē tikai tās klases, kas tiek kopētas uz redaktora kanvu. Tas nemaina priekšgala pamatdaļas klases.