Ohitukset
Blockstudio mahdollistaa lohkojen toiminnan ohittamisen hyvin tarkasti rajatulla tasolla. Tästä voi olla hyötyä jaetuissa lohkokirjastoissa, kun haluat muuttaa lohkon toimintaa luomatta uutta lohkoa alusta asti.
block.json
Aloita asettamalla ohitettavan lohkon nimi avaimeksi name ja asettamalla avaimen override arvoksi true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Kun ominaisuuden override arvoksi asetetaan true, uuden block.json-arvon tiedot yhdistetään alkuperäisen lohkon tietoihin. Näin voit ohittaa minkä tahansa alkuperäisen lohkon ominaisuuden.
Attribuutit
Attribuutteja voi ohittaa ominaisuudella id tai lisätä erikseen. Kuvitellaan esimerkiksi, että haluamme ohittaa lohkon attribuutin width ja lisätä uuden attribuutin height.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true,
"attributes": [
{
"id": "width",
"type": "number",
"default": 280,
"label": "Override width"
},
{
"id": "height",
"type": "number",
"default": 280,
"label": "New height"
}
]
}
}
Kun löytyy attribuutti, jolla on sama id, sen tiedot yhdistetään alkuperäiseen attribuuttiin. Lohkoon lisätään attribuutit, joita ei löydy alkuperäisestä.
Varoitus
Attribuutteja ohittaessasi sinun on annettava alkuperäisen attribuutin
type, vaikka se pysyisi samana.
Monimutkaiset rakenteet
Kun ohitat attribuutteja, joiden rakenne on monimutkainen (toistimet, ryhmät, välilehdet jne.), sinun on annettava attribuutin koko rakenne siihen asti, jossa ohitettava kohde sijaitsee.
{
"name": "blockstudio/my-block",
"blockstudio": {
"override": true,
"attributes": [
{
"id": "tabs",
"type": "tabs",
"tabs": [
{
"id": "tab1",
"attributes": [
{
"key": "group1",
"type": "group",
"title": "Group",
"attributes": [
{
"id": "text",
"type": "text",
"label": "Override text"
}
]
}
]
},
{
"id": "tab2",
"title": "Override tab",
"attributes": [
{
"id": "group",
"type": "group",
"title": "Group ID",
"attributes": [
{
"id": "text",
"type": "text",
"label": "Override text"
}
]
}
]
}
]
}
]
}
}
Aineistot
Resurssitiedosto korvataan, kun tiedostonimet täsmäävät. Jos alkuperäisessä lohkossa on esimerkiksi tiedosto style.css, sen korvaa ohituslohkossa oleva tiedosto style.css. Tiedostot, joiden nimet eivät vastaa alkuperäisen lohkon tiedostonimiä, lisätään lohkoon.
Renderöintimalli
Renderöintimallit voi ohittaa antamalla uuden mallitiedoston, joka voi olla index.php, index.twig tai index.blade.php.
Twig-lohkot
Twig-mallit voidaan ohittaa tarkemmin käyttämällä Twig-ohjelman lohko-ominaisuutta.
Kuvitellaan seuraava kuvitteellisen kuvallohkon renderöintimalli:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
Koko mallin korvaamisen sijaan voimme käyttää ominaisuuden Twig extends avulla mallin tiettyjen osien ohittamiseen ja jättää loput ennalleen.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}