Метод disable

Метод disable используется для временного отключения отображения тултипов на выбранных элементах. После вызова этого метода тултипы не будут появляться при наведении, клике или фокусе, пока не будет вызван метод enable. Это полезно в ситуациях, когда необходимо временно блокировать интерактивность всплывающих подсказок, не удаляя их полностью из DOM и не уничтожая экземпляр Tooltipster.

Синтаксис

$(selector).tooltipster('disable');

Параметры:

  • selector — CSS-селектор или jQuery-объект, к которому привязан тултип.
  • Метод не принимает дополнительных аргументов.

Основные свойства и поведение

  • После вызова disable события отображения тултипа блокируются, но конфигурация остаётся сохранённой.
  • Тултип не уничтожается: его можно снова активировать вызовом enable.
  • Метод применим к одному или нескольким элементам одновременно через jQuery-селектор.

Пример использования

// Инициализация тултипа
$('#button1').tooltipster({
    content: 'Нажмите, чтобы сохранить изменения',
    theme: 'tooltipster-light',
    trigger: 'hover'
});

// Временное отключение тултипа
$('#button1').tooltipster('disable');

// Позже можно снова включить
$('#button1').tooltipster('enable');

В этом примере тултип будет полностью деактивирован до вызова enable. Это позволяет, например, блокировать подсказки во время выполнения асинхронной операции, чтобы пользователь не видел устаревшую информацию.

Отключение нескольких тултипов

Метод disable можно применять к группе элементов сразу:

$('.info-tooltip').tooltipster('disable');

Здесь все элементы с классом info-tooltip будут временно заблокированы.

Поведение при разных триггерах

  • Hover: при наведении мыши тултип не появляется.
  • Click: клик по элементу не вызывает отображение тултипа.
  • Focus: элемент не будет показывать тултип при получении фокуса.

Метод действует независимо от настроек триггера и сохраняет их для последующего включения.

Сочетание с другими методами

disable часто используется совместно с методами:

  • enable — возвращает тултип в активное состояние.
  • destroy — удаляет тултип полностью. В отличие от disable, после destroy восстановить тултип невозможно без повторной инициализации.
  • content — изменение содержимого после disable сохраняется и отобразится при повторном включении.

Пример:

$('#button2').tooltipster('disable')
             .tooltipster('content', 'Обновлённый текст')
             .tooltipster('enable');

В этом случае содержимое изменяется в момент, когда тултип отключён, и новое содержимое отобразится после включения.

Практические советы

  • Использовать disable вместо destroy, если требуется временная блокировка, а не полное удаление тултипа.
  • Хорошо подходит для форм с динамически меняющимся состоянием элементов, где не всегда нужно показывать подсказки.
  • Можно применять к динамически добавляемым элементам, если инициализация тултипа уже выполнена.

Отличия от destroy

Метод Действие Можно восстановить?
disable Блокирует показ тултипа Да (enable)
destroy Полностью удаляет тултип с элемента Нет

Метод disable является ключевым инструментом управления поведением тултипов, позволяя гибко контролировать их отображение без потери настроек и структуры DOM.

Оглавление