Описание customize_preview_{$this->type}
— Action
Хук customize_preview_{$this->type} позволяет изменять данные при предварительном просмотре настроек кастомайзера. Он срабатывает, когда пользователь просматривает изменения в реальном времени в кастомайзере и позволяет динамически обновлять различные элементы страницы на основе выбранных опций.
Примеры использования
Пример изменения заголовка при предварительном просмотре:
add_action('customize_preview_{$this->type}', function($wp_customize) {
// Изменяем заголовок сайта
$wp_customize->get_setting('blogname')->set_value('Новый заголовок');
});
В этом примере мы меняем заголовок сайта на ‘Новый заголовок’ при предварительном просмотре.
Пример изменения цвета фона при предварительном просмотре:
add_action('customize_preview_{$this->type}', function($wp_customize) {
$wp_customize->get_setting('background_color')->set_value('#ff0000');
});
Здесь мы меняем цвет фона на красный при предварительном просмотре.
Пример добавления JavaScript для обновления элементов на странице:
add_action('customize_preview_{$this->type}', function($wp_customize) {
wp_enqueue_script('customize-preview-script', get_template_directory_uri() . '/js/customize-preview.js', array('customize-preview'), null, true);
});
В этом примере мы подключаем JavaScript, который будет обрабатывать изменения в кастомайзере.
— Лучшие практики
– Использование
Используйте этот хук, когда вам нужно динамически обновлять элементы на странице при изменении настроек кастомайзера.
– Производительность
Следите за производительностью, так как слишком много изменений может замедлить работу кастомайзера.
– Предупреждения
Будьте внимательны с частыми обновлениями, чтобы избежать проблем с интерфейсом пользователя.
Альтернативы
Тип: action
Этот хук срабатывает при сохранении изменений в кастомайзере и позволяет выполнять дополнительные действия после сохранения.
Используйте его, если нужно выполнить действия после того, как настройки были сохранены.