当前浏览:首页 / WordPress钩子 / get_header

do_action( 'get_header', string|null $name, array $args )

在加载页首模板文件之前激发

headermore...


参数

$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开始引入

使用示例

  • 示例1

    下面的示例将有条件地为不同的页首加载不同的样式。这只是如何使用钩子的一个示例,并将使用二级模板文件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' );
    }