8.7. Работа с регионами и блоками в Drupal 8.
Для того чтобы у вас появился новый регион, через который вы сможете выводить блоки, вам нужно:
- Добавить данные о регионе в файл theme.info.yml
- Отредактировать page.html.twig, добавив в него вывод нового региона
Добавляем данные о регионе в файл drupalbook.info.yml
Все регионы объединены ключем regions:
# Regions
regions:
header: 'Header'
content: 'Content'
footer: 'Footer'
Машинное имя региона должно состоять из букв и чисел, можно использовать нижнее подчеркивание, в принципе все как в переменных PHP. Читаемое имя можно указывать в ковычках или без если нет пробелов, но лучше всеже кавычки ставить всегда. Читаемое имя региона отображается в админке, а машинное имя используется в шаблоне page.html.twig.
Добавляем вывод региона в page.html.twig
Весь вывод регионов находится в переменной page. Для того чтобы вывести нужный регион, нужно вывести часть переменной page. Используйте машинное имя региона для вывода, например у нас регион header:
header: 'Header'
Поэтому мы используем машинное имя header:
{{ page.header }}
Вы можете выводить любой регион из вашего theme.info.yml файла в любом месте шаблона page.html.twig.
Стандартные региона Drupal 8
Вы можете всегда обращаться к официальной документации: page.html.twig
page.header: для вывода вашей шапки сайта.
page.primary_menu: для вывода главного меню сайта.
page.secondary_menu: для вывода дополнительного меню.
page.highlighted: для вывода информации над контентом.
page.help: для вывода справки.
page.content: обязательный регион для вывода контента сайта.
page.sidebar_first: первый сайдбар.
page.sidebar_second: второй сайдбар.
page.footer: подвал сайта.
page.breadcrumb: хлебные крошки сайта.
Вы можете использовать стандартные регионы друпала, можете добавлять свои, главное следите чтобы название региона соответствовало его нахождению в page.html.twig.