Razširitve
Razširitve omogočajo razširitev katerega koli registriranega bloka v vaši namestitvi WordPress s preprosto konfiguracijo .json na osnovi API, podobno konfiguraciji block.json. To vključuje jedrne bloke, bloke tretjih oseb in bloke, ustvarjene z orodjem Blockstudio.
Vse vrste polj lahko dodate kateremu koli bloku, podatki pa se shranijo v njegove atribute. Za razširitve je na voljo celoten nabor funkcij atributov, kot so filtriranje, onemogočanje, pogojna logika in določanje možnosti.
Vrste razširitev
Razširjene vrednosti lahko uporabite na različne načine:
- class: Bloku dodajte razred z vrednostjo atributa
- style: Bloku dodajte vgrajene sloge z vrednostjo atributa
- attributes: Vrednost katerega koli atributa nastavite neposredno na bloku
- data attributes: Vrednosti razširitve uporabite za nastavitev določenih podatkovnih atributov
Nastavitev
Predstavljajte si naslednji primer: vsakemu jedrnemu bloku želite dodati polje select za razred po meri. Vse, kar morate storiti, je, da to datoteko .json dodate kamor koli v mapo bloka; samodejno bo registrirana kot razširitev.
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"priority": 10,
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customColor",
"type": "select",
"label": "Custom color",
"options": [
{
"value": "#f00",
"label": "Red"
},
{
"value": "#00f",
"label": "Blue"
}
],
"set": [
{
"attribute": "style",
"value": "color: {attributes.customColor}"
}
]
}
]
}
}
S tem boste vsakemu jedrnemu bloku dodali polje customColor, s katerim boste lahko nastavili barvo besedila bloka.
Ime datoteke
Ker ni predloge za izris, razširitev ne potrebuje ustrezne datoteke index, zato ji tudi ni treba biti poimenovana block.json. Tako lahko vse razširitve priročno shranite v eno mapo. Več datotek lahko razširja iste bloke, na primer dve datoteki z "name": "core/*"; vsaka registrira svoja polja.
Shema
Blockstudio zagotavlja shemo po meri JSON za konfiguracije razširitev:
Ime
Lastnost name konfiguracijskega objekta določa, katere bloke je treba razširiti. Glede na vaše potrebe so na voljo tri možnosti:
- blockName: Ime enega bloka, e.g.
core/paragraph - [blockNameA, blockNameB]: Polje imen blokov, e.g.
["core/paragraph", "core/heading"] - core/*: Nadomestni znak za razširitev vseh blokov določene vrste
Vsako ime, ki se konča z zvezdico, je nadomestni znak za predpono, ne le core/*. Spodnja razširitev velja za vsak blok, katerega ime se začne z my-plugin/, vključno z bloki, ustvarjenimi z Blockstudio:
{
"name": "my-plugin/*",
"blockstudio": {
"extend": true,
"attributes": []
}
}
Izključevanje blokov
Uporabite vrhnje polje exclude, da preskočite bloke, ki bi sicer ustrezali name:
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"exclude": ["core/button", "core/image"],
"blockstudio": {
"extend": true,
"attributes": []
}
}
Pri izključitvah se uporabljata enako ujemanje natančnega imena in ujemanje predpone z zaključno oznako * kot pri name. Imajo prednost pred posameznimi imeni, seznami imen in nadomestnimi znaki. Izključeni blok ne prejme polj razširitve v urejevalniku, atributov za čelni del ali sredstev. Druge ustrezne razširitve ostanejo nespremenjene. Izpustite exclude ali uporabite prazno polje, da ohranite obstoječe delovanje.
Ključ Blockstudio
Tako kot pri uporabi block.json za bloke po meri mora biti v konfiguracijskem objektu prisotna lastnost blockstudio, pri čemer mora biti extend nastavljeno na true.
Položaj
Razširitve so privzeto prikazane na svojem zavihku v pregledovalniku blokov. Če jih želite premakniti drugam, lahko uporabite lastnost group:
- settings: privzeti položaj
- styles: zavihek s slogi
- advanced: zavihek z naprednimi možnostmi
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"group": "styles",
"attributes": []
}
}
Prednostna naloga
Z lastnostjo priority lahko določite vrstni red prikaza razširitev. Razširitve z višjo prednostno nalogo bodo prikazane pozneje. Nastavite jo na najvišji ravni datoteke, kot v primeru nastavitve, ali znotraj extend:
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": { "priority": 10 },
"attributes": []
}
}
Če sta nastavljeni obe vrednosti, ima prednost blockstudio.extend.priority.
Atributi
Več informacij o delovanju atributov najdete v razdelku o atributih.
Edino, kar morate vedeti o atributih v razširitvah, je lastnost set. Uporablja se za dodelitev vrednosti atributa eni od vrst razširitev.
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customColor",
"type": "select",
"label": "Heading color",
"options": [
{
"value": "#f00",
"label": "Red"
},
{
"value": "#00f",
"label": "Blue"
}
],
"set": [
{
"attribute": "style",
"value": "color: {attributes.customColor}"
}
]
}
]
}
}
Pridobivanje vrednosti
Za pridobivanje vrednosti atributa se uporablja zapis s piko znotraj zavitih oklepajev.
Gnezdene vrednosti je mogoče pridobiti tudi, kadar atributi ne vrnejo ene same vrednosti, na primer pri nastavitvi oblike vrnjene vrednosti na both za vrste polj z možnostmi.
{
"attributes": [
{
"id": "customColor",
"type": "select",
"label": "Heading color",
"options": [
{
"value": "#f00",
"label": "Red"
},
{
"value": "#00f",
"label": "Blue"
}
],
"returnFormat": "both",
"set": [
{
"attribute": "style",
"value": "color: {attributes.customColor.value}"
},
{
"attribute": "data-color",
"value": "{attributes.customColor.label}"
}
]
}
]
}
Zgornji primer bo atribut style nastavil na color: #f00 ali color: #00f, atribut data-color pa na Red ali Blue, odvisno od vrednosti.
Za zdaj je v definicijah set mogoče uporabiti samo vrednosti trenutnega atributa. Možnost uporabe vrednosti drugih atributov bo morda dodana v prihodnosti.
Polja
Pri uporabi polj bo lastnost set uporabljena za vsak element v polju.
Vsak element doda svoj razred ali deklaracijo sloga. Vsak drug atribut vsebuje eno samo vrednost, zato jo vsak element prepiše in obvelja zadnji element. Nastavite join na true, da namesto tega zapišete rezultate vseh elementov, ločene s presledki in brez praznih ali podvojenih vrednosti, tako da izbirnik, kot je [data-langs~="en"], ustreza vsem izbranim elementom. join ne vpliva na class in style ali na polja, ki vrnejo eno samo vrednost.
{
"id": "langs",
"type": "checkbox",
"label": "Languages",
"options": [
{
"value": "en",
"label": "English"
},
{
"value": "de",
"label": "German"
}
],
"set": [
{
"attribute": "data-langs",
"value": "{attributes.langs}",
"join": true
}
]
}
Če izberete obe možnosti, se izriše data-langs="en de". Brez join se izriše data-langs="de".
Polje attributes
Pri uporabi polja attributes lastnosti set ni treba nastaviti, saj polje samodejno preslika vrednosti v ime in vrednost atributa.
Pregled polj razširitve
bs_block_extension_fields('core/paragraph') vrne definicije polj vseh razširitev, ki ustrezajo bloku. Za vrnjeno vrednost in njeno povezavo z bs_block_fields() glejte Pregled blokov.