Lohkoattribuutit
$attributes– tai $a-muuttujilla pääset käsiksi vain blockstudio-ominaisuuteen rekisteröityihin tietoihin. Voit käyttää tavallisia WordPress-lohkon tietoja, kuten kohdistusta tai typografiaa, $block– tai $b-muuttujilla.
Renderöinti
PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>
Twig
<h1>The block is aligned: {{ block.align }}</h1>
<h1>The block is aligned: {{ b.align }}</h1>
Oletusarvojen asettaminen
Varatut kenttätunnukset
WordPress-omistamia attribuutteja ei saa määrittää Blockstudio-kentiksi samalla ylätason tunnuksella. Varattuja ovat anchor, className, style, lock ja metadata, samoin kuin Blockstudio-sisäiset attribuutit blockstudio, __BLOCKSTUDIO_KEY ja blockEditingMode.
Käytössä olevat WordPress-laajennukset varaavat myös omien attribuuttiensa nimet tarpeen mukaan: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow ja ariaLabel. Myös jonkin näistä attribuuteista natiivi määrittely varaa kyseisen nimen. Näin estetään esimerkiksi ytimen merkkijonon align korvaaminen valintakentän asetusoliolla.
Ristiriitaiset kentät ohitetaan rekisteröinnissä ja niistä kirjataan lokimerkintä kohteeseen blockstudio/error/logged (sekä virheenjäljityslokiin WordPress, jos se on käytössä). Merkinnässä mainitaan lohko ja kenttä. Niiden editorisäätimiä, tallennuskäsittelijöitä ja renderöintimäärityksiä ei rekisteröidä. Nimeä kenttä uudelleen tunnukseksi headingAlign tai sijoita se nimettyyn ryhmään, kuten presentation, jolloin tulokseksi tulee presentation_align. Toistinkentät sijaitsevat rivinsä sisällä eivätkä aiheuta ylätason tunnusristiriitoja. Tavallinen align-kenttä on kelvollinen, kun tasaustuki on poistettu käytöstä eikä natiivia align-attribuuttia ole.
Kun päivität olemassa olevaa lohkoa, jossa on ristiriita, nimeä sen kenttä uudelleen ja siirrä kaikki tallennetut kenttäarvot uuteen tunnukseen. Blockstudio ei nimeä tallennettua sisältöä uudelleen eikä poista WordPress-tukea hiljaisesti.
Natiivien attribuuttien oletusarvot
Aseta oletusarvo WordPress-ominaisuuksille, kuten align, lisäämällä default-avain attributes-avaimen sisään:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/block",
"title": "Native Block",
"icon": "star-filled",
"description": "Native Block.",
"supports": {
"align": ["left", "center", "right"]
},
"attributes": {
"align": {
"type": "string",
"default": "center"
}
},
"blockstudio": true
}
Käytettävissä olevat lohkotiedot
$block / $b-muuttuja sisältää:
| Ominaisuus | Kuvaus |
|---|---|
name |
Lohkon nimi (e.g., my-theme/my-block) |
title |
Lohkon otsikko |
dir |
Lohkon hakemistopolku |
url |
Lohkon hakemiston URL |
align |
Kohdistusarvo (jos supports.align on käytössä) |
className |
Mukautettu CSS-luokka (jos supports.customClassName on käytössä) |
anchor |
HTML-ankkuri/tunnus (jos supports.anchor on käytössä) |
WordPress-tuet
Ota WordPress-lohko-ominaisuudet käyttöön supports-ominaisuuden kautta:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Katso WordPress-lohkojen tukien dokumentaatiosta kaikki käytettävissä olevat vaihtoehdot.