Описание enqueue_block_assets
— Action
Хук enqueue_block_assets позволяет подключать стили и скрипты для блоков редактора Gutenberg. Он срабатывает при загрузке страницы редактирования поста или страницы, когда в редакторе присутствуют блоки, и позволяет добавлять необходимые ресурсы для кастомных блоков
Примеры использования
Пример подключения CSS-файла для кастомного блока:
add_action('enqueue_block_assets', function() {
wp_enqueue_style('my-custom-block-style', get_template_directory_uri() . '/css/custom-block.css');
});
В этом примере мы загружаем стили для кастомного блока из папки темы
Пример подключения JS-файла для кастомного блока:
add_action('enqueue_block_assets', function() {
wp_enqueue_script('my-custom-block-script', get_template_directory_uri() . '/js/custom-block.js', array('wp-blocks', 'wp-element'), true);
});
Здесь мы загружаем скрипт для кастомного блока с зависимостями от wp-blocks и wp-element
Пример подключения стилей только для определенного блока:
add_action('enqueue_block_assets', function() {
if (has_block('my-plugin/my-custom-block')) {
wp_enqueue_style('my-custom-block-style', get_template_directory_uri() . '/css/custom-block.css');
}
});
Мы проверяем, используется ли определенный блок, и только тогда подключаем стили
— Лучшие практики
– Использование
Используйте этот хук для подключения стилей и скриптов, нужных для кастомных блоков в редакторе Gutenberg
– Производительность
Избегайте подключения слишком большого количества стилей и скриптов, чтобы не замедлять загрузку редактора
– Предупреждения
Осторожно с зависимостями, убедитесь, что все необходимые библиотеки загружаются корректно
Альтернативы
Тип: action
Этот хук позволяет подключать ресурсы только для блоков в редакторе, а не на фронтэнде
Используйте его, если вам нужны скрипты или стили только в редакторе, а не на сайте