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
是否必须填写:否