wp_enqueue_scripts
Срабатывает в момент подключения в очередь на вывод файлов стилей и скриптов.
На этот хук принято вешать функции, которые подключают стили и скрипты темы. Т.е. через этот хук принято подключать файлы стилей и скриптов: смотрите wp_enqueue_script() и wp_enqueue_style().
Это событие срабатывает в момент хука wp_head с приоритетом 1, т.е. так:
add_action( 'wp_head', 'wp_enqueue_scripts', 1 );
Список скриптов WP из коробки смотрите по этой ссылке.
Использование
add_action( 'wp_enqueue_scripts', 'wp_kama_enqueue_scripts_action' );
/**
* Function for `wp_enqueue_scripts` action-hook.
*
* @return void
*/
function wp_kama_enqueue_scripts_action(){
// action...
}
Примеры
#1 Подключение стилей и скриптов темы
Для темы/плагина правильно подключать стили и скрипты через хук wp_enqueue_scripts:
// правильный способ подключить стили и скрипты темы
add_action( 'wp_enqueue_scripts', 'theme_add_scripts' );
function theme_add_scripts() {
// подключаем файл стилей темы
wp_enqueue_style( 'style-name', get_stylesheet_uri() );
// подключаем js файл темы
wp_enqueue_script( 'script-name', get_template_directory_uri() .'/js/example.js', array(), '1.0', true );
}
Список изменений
| С версии 2.8.0 | Введена. |
Где вызывается хук
wp_enqueue_scripts
wp-includes/script-loader.php 2180
do_action( 'wp_enqueue_scripts' );
Где используется хук в WordPress
wp-includes/class-wp-customize-nav-menus.php 1323
add_action( 'wp_enqueue_scripts', array( $this, 'customize_preview_enqueue_deps' ) );
wp-includes/class-wp-customize-widgets.php 1171
add_action( 'wp_enqueue_scripts', array( $this, 'customize_preview_enqueue' ) );
wp-includes/customize/class-wp-customize-selective-refresh.php 148
add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_preview_scripts' ) );
wp-includes/default-filters.php 558
add_action( 'wp_enqueue_scripts', 'wp_localize_jquery_ui_datepicker', 1000 );
wp-includes/default-filters.php 559
add_action( 'wp_enqueue_scripts', 'wp_common_block_scripts_and_styles' );
wp-includes/default-filters.php 560
add_action( 'wp_enqueue_scripts', 'wp_enqueue_classic_theme_styles' );
wp-includes/default-filters.php 577
add_action( 'wp_enqueue_scripts', 'wp_enqueue_global_styles' );
wp-includes/default-filters.php 581
add_action( 'wp_enqueue_scripts', 'wp_enqueue_stored_styles' );
wp-includes/script-loader.php 3656
add_action( 'wp_enqueue_scripts', $fn_generate_and_enqueue_styles );
wp-includes/widgets/class-wp-widget-media.php 115
add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_preview_scripts' ) );
wp-includes/widgets/class-wp-widget-text.php 62
add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_preview_scripts' ) );