jQuery свойство $.fx.off

Определение и применение

jQuery свойство глобального объекта $.fx.off позволяет глобально отключить все анимации.

jQuery синтаксис:

Синтаксис 1.3:

JavaScript
$.fx.off =  value

value - Boolean

Добавлен в версии jQuery

1.3

Значения параметров

Параметр Описание
value Логическое значение, которое определяет следует ли проигрывать анимацию в обычном режиме, или отключить все анимации глобально. Значение по умолчанию false (анимация проигрывается в обычном режиме).

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

Пример использования jQuery метода .animate() (относительные значения)

Нажмите ▶, затем выполните действие из пояснения. Измените JavaScript и запустите пример ещё раз. В редакторе используется jQuery 4.0.0.

index.html
HTML
<button class="left">Left</button>
<button class="right">Right</button>
<button class="off">$.fx.off</button><span></span>
<div>Animate me</div>
main.js
JavaScript
$(document).ready(function () {
    var initialPosition = $('div').offset().left
    $('.left').click(function () {
        $('div').animate({ left: 0 })
    })

    $('.right').click(function () {
        var currentPosition = $('div').offset().left
        if (currentPosition == initialPosition) {
            $('div').removeAttr('style').animate({ right: 0 })
        }
    })
    $('.off').click(function () {
        $.fx.off = !$.fx.off
        $.fx.off
            ? $('span').css('color', 'red').html(' Animation disabled')
            : $('span').css('color', 'green').html(' Animation enabled')
    })
})
style.css
CSS
body {
    position: relative;
}
div {
    width: 80px;
    height: 80px;
    border: 1px solid violet;
    margin-top: 50px;
    position: absolute;
}

В этом примере при загрузке документа мы с использованием jQuery метода .offset() получаем позицию элемента от левого края документа в пикселях и записываем это значение в переменную, это нам пригодиться далее для корректного воспроизведения анимации.

Кроме того, мы разместили в документе три кнопки (элементы <button>), для каждой назначили обработчик события "click" (клик левой кнопкой мыши):

  • При нажатии на элемент с классом left вызываем функцию, которая с помощью метода .animate() анимирует смещение элемента влево относительно документа.
  • При нажатии на элемент с классом right вызываем функцию, которая получает позицию элемента от левого края документа в пикселях и если это значение совпадает с первоначальным (полученным при загрузке), то с помощью метода .animate() анимирует смещение элемента вправо относительно документа. Эта проверка необходима для того, чтобы избежать возможности вызвать анимацию, когда элемент уже находиться у правого края документа. Кроме того, мы с помощью метода .removeAttr() удаляем у элемента глобальный атрибут style, это необходимо, чтобы убрать значение, установленное для CSS свойства left и воспроизвести анимацию неоднократно, иначе после нажатия на элемент с классом left смещение элемента вправо не произойдет.
  • При нажатии на элемент с классом off вызываем функцию, которая устанавливает противоположное значение свойству глобального объекта $.fx.off (если true, то false и наоборот). Кроме того, используя тернарный оператор в зависимости от текущего значения устанавливаем с помощью jQuery метода .css() цвет текста и с помощью jQuery метода .html() вставляем текстовое содержимое.