6.7. Arbeiten mit Regionen und Blöcken in Drupal
Damit Sie eine neue Region haben, über die Sie Blöcke anzeigen können, müssen Sie:
- Region-Informationen zur Datei theme.info.yml hinzufügen
- Die Datei page.html.twig bearbeiten und die Ausgabe der neuen Region hinzufügen
Region-Daten zur Datei drupalbook.info.yml hinzufügen
Alle Regionen sind durch den Schlüssel regions vereint:
# Regionen
regions:
header: 'Header'
content: 'Inhalt'
footer: 'Footer'
Der maschinenlesbare Name der Region sollte aus Buchstaben und Zahlen bestehen, Sie können Unterstriche verwenden, genauso wie bei PHP-Variablen. Der lesbare Name kann in Anführungszeichen stehen oder ohne, wenn keine Leerzeichen enthalten sind, aber es ist besser, immer Anführungszeichen zu verwenden. Der lesbare Name der Region wird im Admin-Panel angezeigt, der maschinenlesbare Name wird in der page.html.twig Vorlage verwendet.
Region-Ausgabe zu page.html.twig hinzufügen
Alle Regionenausgaben sind in der Variable page enthalten. Um die gewünschte Region anzuzeigen, müssen Sie den entsprechenden Teil der page-Variable ausgeben. Verwenden Sie den maschinenlesbaren Namen der Region, zum Beispiel haben wir die Region header:
header: 'Header'
Also verwenden wir den maschinenlesbaren Namen header:
{{ page.header }}
Sie können jede Region aus Ihrer theme.info.yml Datei beliebig in der page.html.twig Vorlage ausgeben.
Standard-Drupal-Regionen
Sie können jederzeit auf die offizielle Dokumentation verweisen: page.html.twig
page.header: zeigt die Kopfzeile der Seite an.
page.primary_menu: zeigt das Hauptmenü der Seite an.
page.secondary_menu: zeigt ein zusätzliches Menü an.
page.highlighted: zeigt Informationen über dem Inhalt an.
page.help: zeigt Hilfetexte an.
page.content: erforderliche Region für die Anzeige des Seiteninhalts.
page.sidebar_first: erste Seitenleiste.
page.sidebar_second: zweite Seitenleiste.
page.footer: Fußzeile der Seite.
page.breadcrumb: Breadcrumb-Navigation der Seite.
Sie können die Standard-Regionen von Drupal verwenden oder eigene hinzufügen. Wichtig ist, dass der Name der Region mit dem Ort in page.html.twig übereinstimmt.