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 2265
do_action( 'wp_enqueue_scripts' );
Где используется хук в WordPress
wp-includes/block-supports/duotone.php 49
add_action( 'wp_enqueue_scripts', array( 'WP_Duotone', 'output_block_styles' ), 9 );
wp-includes/block-supports/duotone.php 50
add_action( 'wp_enqueue_scripts', array( 'WP_Duotone', 'output_global_styles' ), 11 );
wp-includes/class-wp-customize-nav-menus.php 1348
add_action( 'wp_enqueue_scripts', array( $this, 'customize_preview_enqueue_deps' ) );
wp-includes/class-wp-customize-widgets.php 1191
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 361
add_action( 'wp_enqueue_scripts', 'wp_enqueue_emoji_styles' );
wp-includes/default-filters.php 567
add_action( 'wp_enqueue_scripts', 'wp_localize_jquery_ui_datepicker', 1000 );
wp-includes/default-filters.php 568
add_action( 'wp_enqueue_scripts', 'wp_common_block_scripts_and_styles' );
wp-includes/default-filters.php 569
add_action( 'wp_enqueue_scripts', 'wp_enqueue_classic_theme_styles' );
wp-includes/default-filters.php 599
add_action( 'wp_enqueue_scripts', 'wp_enqueue_global_styles' );
wp-includes/default-filters.php 603
add_action( 'wp_enqueue_scripts', 'wp_enqueue_global_styles_custom_css' );
wp-includes/default-filters.php 606
add_action( 'wp_enqueue_scripts', 'wp_enqueue_stored_styles' );
wp-includes/default-filters.php 659
add_action( 'wp_enqueue_scripts', 'wp_enqueue_admin_bar_bump_styles' );
wp-includes/default-filters.php 660
add_action( 'wp_enqueue_scripts', 'wp_enqueue_admin_bar_header_styles' );
wp-includes/default-filters.php 720
add_action( 'wp_enqueue_scripts', 'wp_enqueue_block_template_skip_link' );
wp-includes/deprecated.php 5886
add_action( 'wp_enqueue_scripts', $fn_generate_and_enqueue_styles );
wp-includes/interactivity-api/class-wp-interactivity-api.php 209
add_action( 'wp_enqueue_scripts', array( $this, 'register_script_modules' ) );
wp-includes/widgets/class-wp-widget-media.php 117
add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_preview_scripts' ) );
wp-includes/widgets/class-wp-widget-text.php 60
add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_preview_scripts' ) );