6.7. Werken met regio’s en blokken in Drupal

Om een nieuwe regio toe te voegen waarmee je blokken kunt weergeven, moet je het volgende doen:

• Voeg informatie over de regio toe aan het bestand theme.info.yml
• Bewerk het bestand page.html.twig en voeg daar de weergave van de nieuwe regio toe

Regio’s toevoegen aan het bestand drupalbook.info.yml

Alle regio’s worden gedefinieerd onder de sleutel regions:

# Regions
regions:
  header: 'Header'
  content: 'Content'
  footer: 'Footer'

De machinenaam van een regio mag letters, cijfers en underscores bevatten — net als in PHP-variabelen. De leesbare naam kan tussen aanhalingstekens staan (aanbevolen, vooral bij spaties), maar dat is niet verplicht. De leesbare naam wordt weergegeven in het beheerpaneel van Drupal, terwijl de machinenaam wordt gebruikt in het page.html.twig-sjabloon.

Regio’s weergeven in page.html.twig

Alle regio’s zijn beschikbaar in de variabele page. Om een specifieke regio weer te geven, toon je een deel van deze variabele. Gebruik hiervoor de machinenaam van de regio. Bijvoorbeeld, als we de regio header hebben gedefinieerd:

header: 'Header'

Dan kunnen we deze in de template als volgt weergeven:

{{ page.header }}

Je kunt elke regio die je in theme.info.yml hebt gedefinieerd, op eender welke plaats in page.html.twig weergeven.

Standaardregio’s in Drupal

Je kunt altijd de officiële documentatie raadplegen: page.html.twig

page.header: toont de kop van de site.
page.primary_menu: toont het hoofdmenu van de site.
page.secondary_menu: toont een aanvullend menu.
page.highlighted: toont informatie boven de content.
page.help: toont helpinformatie.
page.content: verplichte regio voor het tonen van de hoofdinhoud van de site.
page.sidebar_first: eerste zijbalk.
page.sidebar_second: tweede zijbalk.
page.footer: voettekst van de site.
page.breadcrumb: broodkruimelnavigatie van de site.

Je kunt de standaardregio’s van Drupal gebruiken of je eigen regio’s toevoegen. Het belangrijkste is dat de naam van de regio overeenkomt met de locatie waar je deze in page.html.twig wilt weergeven.