wp_enqueue_scripts
Позволяет добавить скрипты и стили на фронт-энде в очередь на подключение.
Через этот хук принято подключать файлы стилей и скриптов. Смотрите:
Это событие срабатывает в момент хука 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 2311
do_action( 'wp_enqueue_scripts' );
Где используется хук в WordPress
wp-includes/block-supports/block-style-variations.php 255
add_action( 'wp_enqueue_scripts', 'wp_enqueue_block_style_variation_styles', 1 );
wp-includes/block-supports/duotone.php 50
add_action( 'wp_enqueue_scripts', array( 'WP_Duotone', 'output_block_styles' ), 9 );
wp-includes/block-supports/duotone.php 51
add_action( 'wp_enqueue_scripts', array( 'WP_Duotone', 'output_global_styles' ), 11 );
wp-includes/class-wp-customize-nav-menus.php 1345
add_action( 'wp_enqueue_scripts', array( $this, 'customize_preview_enqueue_deps' ) );
wp-includes/class-wp-customize-widgets.php 1215
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 373
add_action( 'wp_enqueue_scripts', 'wp_enqueue_emoji_styles' );
wp-includes/default-filters.php 596
add_action( 'wp_enqueue_scripts', 'wp_localize_jquery_ui_datepicker', 1000 );
wp-includes/default-filters.php 597
add_action( 'wp_enqueue_scripts', 'wp_common_block_scripts_and_styles' );
wp-includes/default-filters.php 598
add_action( 'wp_enqueue_scripts', 'wp_enqueue_classic_theme_styles' );
wp-includes/default-filters.php 630
add_action( 'wp_enqueue_scripts', 'wp_enqueue_global_styles' );
wp-includes/default-filters.php 634
add_action( 'wp_enqueue_scripts', 'wp_enqueue_stored_styles' );
wp-includes/default-filters.php 689
add_action( 'wp_enqueue_scripts', 'wp_enqueue_admin_bar_bump_styles' );
wp-includes/default-filters.php 690
add_action( 'wp_enqueue_scripts', 'wp_enqueue_admin_bar_header_styles' );
wp-includes/default-filters.php 751
add_action( 'wp_enqueue_scripts', 'wp_enqueue_block_template_skip_link' );
wp-includes/deprecated.php 5887
add_action( 'wp_enqueue_scripts', $fn_generate_and_enqueue_styles );
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' ) );