参数
- $name
-
(string|null) 要使用的特定页首文件的名称。默认页首为Null。
- $args
-
(array) 传递给页首模板的其他参数。
说明
get_header
是一个从get_header()
函数一开始调用就运行的钩子。如果传入特定页首文件的名称,如get_header( 'new' )
,那么do_action
将传入该名称作为钩子的参数,如果你愿意,这允许你将add_action
调用限制在特定的模板上。添加到这个钩子的动作应该被添加到你的 functions.php 文件中。
注意:这个钩子最适合用来设置和执行在页面加载之后才会回显到浏览器的代码。在显示任何标记之前,将显示您回显的任何内容。
源码
更新日志
版本 | 描述 |
---|---|
5.5.0 | 添加了$args 参数 |
2.8.0 | 添加了$name 参数 |
2.1.0 | 开始引入 |
使用示例
下面的示例将有条件地为不同的页首加载不同的样式。这只是如何使用钩子的一个示例,并将使用二级模板文件
header-new.php
function wpdocs_themeslug_header_hook( $name ) { if ( 'new' == $name ) { add_action( 'wp_enqueue_scripts', 'wpdocs_themeslug_header_style' ); } } add_action( 'get_header', 'wpdocs_themeslug_header_hook' ); function wpdocs_themeslug_header_style() { wp_enqueue_style( 'wpdocs-header-new-style', get_template_directory_uri() . '/css/header-new.css' ); }