基础篇13. 什么是模板文件,twig debug介绍

我来讲解一下什么是模板文件。

但是在继续之前,先说一下,这个local.services.yml文件中的第8行,开启了auto reload服务。但是其实你并不需要这一条语句,因为我们可以在官网文档中找到关于这个参数的说明,文档中说,如果你开启了twig debug功能,那么这个auto reload服务就同时被开启了,因此,在这里你并不需要单独声明这个服务。你可以在文档中找到官方说明的链接

现在,让我们来讲解一下什么是模板文件。

在Drupal8中模板文件指的是.html.twig文件,用于为Drupal网站的页面提供HTML标签。他们位于主题文件夹的templates文件夹中。这个主题可能是核心自带的主题,也可能是你自己创建的主题。

如果你根据Drupal的模板命名规则在自己的主题中创建某个模板文件,Drupal的主题系统会自动使用你的模板来替换默认的模板文件。通过这种方式你就可以修改页面上的HTML标签。这个方式在Drupal中有一个专门的术语叫作覆写。关于覆写我们以后还会专门讲。

我们在新建模板文件的时候通常都需要借助twig debug模式,所以,这里对这个模式做一个简介。在浏览器的元素检查区域,我们可以看到twig debug模式为页面生成的绿色的注释代码。

Drupal在渲染页面的时候,将一个页面划分成不同的层,就像剥洋葱那样一层一层的渲染,所以,如果你打开了twig debug模式以后,页面上每一层模板都会被套在一个这样的注释中。

我们在这里可以看到这个模板的开始,在页面的底部,你还能找到这个模板的结束位置。

首先声明注释代码的出处是:twig debug服务以及所使用的Theme Hook:html。关于这个theme hook,以后会讲,现在可以不管。接下来是模板建议。给出了几个在这一层可以使用的模板名称。其中,前面有x的是目前页面渲染是使用的模板名称,另外两个带有星号的是可选的模板名称。接下来,是告诉你被启用的模板所在的位置,并且声明这是这个模板的开始。

如果你把代码拉到下面,你还会找到另一个声明,声明这个模板的结束位置。

如果你展开代码,你会看到除了最外层的html.html.twig模板之外,还会嵌套一层又一层的其他模板。这和我们之前所说的Drupal渲染页面的方式是相对应的。
 

本书共83小节:

评论 (写第一个评论)