Gå til indhold

Tilsidesættelser

Blockstudio giver mulighed for at tilsidesætte blokke på et meget detaljeret niveau. Det kan være nyttigt for delte blokbiblioteker, når du vil ændre en bloks adfærd uden at skulle oprette en helt ny blok.

block.json

Kom i gang ved at angive navnet på den blok, du vil tilsidesætte, som nøglen name og sætte nøglen override til true.

JSON
{
  "name": "blockstudio/my-block",
  "title": "My overridden block title",
  "blockstudio": {
    "override": true
  }
}

Når egenskaben override er sat til true, flettes dataene fra den nye block.json med dataene fra den oprindelige blok. Det betyder, at du kan tilsidesætte enhver egenskab i den oprindelige blok.

Attributter

Attributter kan enten tilsidesættes med id eller tilføjes. Lad os f.eks. forestille os, at vi vil tilsidesætte en bloks attribut width og tilføje en ny attribut height.

JSON
{
  "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"
      }
    ]
  }
}

Når der findes en attribut med samme id, flettes dataene med den oprindelige attribut. Attributter, der ikke findes, føjes til blokken.

Advarsel

Når du tilsidesætter attributter, skal du angive type for den oprindelige attribut, selvom den forbliver den samme.

Komplekse strukturer

Når du tilsidesætter attributter med komplekse strukturer (gentagelsesfelter, grupper, faner osv.), skal du angive hele attributstrukturen frem til det element, der skal tilsidesættes.

JSON
{
  "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"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

Ressourcer

Aktivfiler erstattes, når filnavnet stemmer overens. Hvis der f.eks. findes en style.css-fil i den oprindelige blok, erstattes den af filen style.css i den tilsidesættende blok. Filer med navne, der ikke stemmer overens med den oprindelige blok, føjes til blokken.

Gengivelsesskabelon

Gengivelsesskabeloner kan tilsidesættes ved at angive en ny skabelonfil: enten index.php, index.twig eller index.blade.php.

Twig-blokke

Twig-skabeloner kan tilsidesættes på et mere detaljeret niveau ved hjælp af blokfunktionen i Twig.

Lad os forestille os følgende gengivelsesskabelon for en fiktiv billedblok:

Twig
<h1>Images:</h1>
{% for image in a.images %}
  <div class="content">
    {% block image %}
      <img src="{{ image.url }}" class="image" />
    {% endblock %}
  </div>
{% endfor %}

I stedet for at erstatte hele skabelonen kan vi bruge funktionen extends i Twig til at tilsidesætte bestemte dele af skabelonen, mens resten bevares.

Twig
{% extends 'index.twig' %}

{% block image %}
  <figure>
    <img src="{{ image.url }}" class="image" />
    <figcaption>{{ image.caption }}</figcaption>
  </figure>
{% endblock %}