Magento2 布局文件中Block的参数详细介绍说明

2107人浏览 2020-09-29

Magento2 布局文件中Block的参数详细介绍说明:

在布局文件中,经常遇到block标签,比如default.xml中

<block class="Magento\Framework\View\Element\Messages" name="messages" as="messages" template="Magento_Theme::messages.phtml"/>

下面说下block各个参数的含义:

 

“classs”:

   说明:指定这个block所使用的Block类文件

   参数:例如:Vendor\Module\Block\Class  默认为:Magento\Framework\View\Element\Template。

   是否必须填写:否

 

 “display”:

   说明:指定这个block是否允许输出视图。

   参数:true / false

   是否必须填写:否

 

“name”:

   说明:可用于寻址分配了该属性的块的名称。每个生成的页面的名称必须唯一。如果未指定,系统会分配自动名称。

   参数:命名规则0-9,AZ,az,下划线(_),句点(。),破折号(-)。应该以字母开头。区分大小写。

   是否必须填写:否

 

“before”:

   说明:在某元素之前加载,用于将块放置在同一父元素下的元素之前。在值中指定元素名称或别名。使用破折号(-)将块定位在其嵌套级别的所有其他元素之前。

   参数:具体block的name或者“-”

   是否必须填写:否

 

“after”:

   说明:在某元素之后加载,用于将块放置在同一父元素下的元素之后。在值中指定元素名称或别名。使用破折号(-)将块定位在其嵌套级别的所有其他元素之后。

   参数:具体block的name或者“-”

   是否必须填写:否

 

“template”:

   说明:此block对应的模板视图文件。如果省略该属性,则该块将不呈现任何输出。

   参数:如:Vendor_Module::path/to/template.phtml

   是否必须填写:否

 

“as”:

   说明:name的别名。

   参数:命名规则0-9,AZ,az,下划线(_),句点(。),破折号(-)。应该以字母开头。区分大小写。

   是否必须填写:否

 

“cacheable”:

   说明:定义块元素是否可缓存。这可用于开发目的并使页面的所需元素动态化。

   参数:true /false 默认为true

   是否必须填写:否

 

“ifconfig”:

   说明:使块的可见性取决于系统配置字段。

   参数:XPath到系统配置字段。例如contact/contact/enabled

   是否必须填写:否

 

推荐文章

Magento2 忘记密码重置修改后台登录密码
2020-09-18
win10系统安装Magento 2报错解决方案
2020-09-14
搜索文章