Описание customize_preview_init
— Action
Хук customize_preview_init позволяет выполнять действия, когда пользователь открывает предварительный просмотр настроек кастомайзера в WordPress. Он срабатывает при инициализации предварительного просмотра и предоставляет возможность добавить дополнительные скрипты или стили, а также настроить параметры для динамического обновления.
Примеры использования
Пример добавления кастомного JavaScript для предварительного просмотра:
add_action('customize_preview_init', function() {
wp_enqueue_script('customizer-preview-script', get_template_directory_uri() . '/js/customizer-preview.js', array('jquery'), null, true);
});
В этом примере мы добавляем кастомный JavaScript-файл для работы с предварительным просмотром настроек кастомайзера.
Пример добавления кастомного CSS для предварительного просмотра:
add_action('customize_preview_init', function() {
wp_enqueue_style('customizer-preview-style', get_template_directory_uri() . '/css/customizer-preview.css');
});
Здесь мы добавляем кастомный CSS-файл для стилизации предварительного просмотра кастомайзера.
Пример передачи параметров в скрипт предварительного просмотра:
add_action('customize_preview_init', function() {
wp_enqueue_script('customizer-preview-script', get_template_directory_uri() . '/js/customizer-preview.js', array('jquery'), null, true);
wp_localize_script('customizer-preview-script', 'customizerData', array('exampleVar' => 'value'));
});
В этом примере мы передаем переменные из PHP в JavaScript, чтобы использовать их в кастомном скрипте.
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо добавлять кастомные скрипты или стили для предварительного просмотра настроек кастомайзера
– Производительность
Следите за тем, чтобы добавляемые ресурсы не замедляли загрузку страницы кастомайзера
– Предупреждения
Убедитесь, что добавляемые скрипты и стили корректно работают в контексте кастомайзера и не вызывают конфликтов
Альтернативы
Тип: action
Этот хук позволяет регистрировать секции и контроллеры для кастомайзера, но не используется для предварительного просмотра
Используйте его для настройки самого кастомайзера и добавления новых элементов управления
