jQuery метод .fadeTo()

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

jQuery метод .fadeTo() позволяет изменить уровень прозрачности у выбранных элементов.

jQuery синтаксис:

Синтаксис 1.0:

JavaScript
$( selector ).fadeTo( duration, opacity, complete )

duration - Number, или String

opacity - Number (0 - 1)

complete - Function

Синтаксис 1.4.3:

JavaScript
$( selector ).fadeTo( duration, opacity, easing, complete )

duration - Number, или String

opacity - Number (0 - 1)

easing - String

complete - Function

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

1.0 (синтаксис обновлен в версии 1.4.3)

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

Параметр Описание
duration Строковое или числовое значение, которое определяет, как долго анимация будет продолжаться. Значение по умолчанию 400 (в миллисекундах). Строковые ключевые слова 'fast' и 'slow' соответствуют 200 и 600 миллисекундам соответственно (высокие значения указывают на медленную анимацию, а более низкие на быструю).
opacity Числовое значение между 0 и 1, обозначающее прозрачность для элемента (1 - элемент непрозрачный, 0.5 - среднее значение, 0 - элемент полностью прозрачный).
easing Ключевое слово (строка), которое опряеделяет кривую скорости для анимации (используется математическая функция - кубическая кривая Безье). Без использования внешних плагинов имеет только два значения - linear (эффект анимации с одинаковой скоростью от начала до конца) и swing (эффект анимации имеет медленный старт и медленное окончание, но скорость увеличивается в середине анимации). Значение по умолчанию swing.
complete Функция, которая будет выполнена после завершения анимации, она вызывается один раз для каждого соответствующего элемента. Внутри функции, переменная this ссылается на DOM элемент к которому применяется анимация.

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

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

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

index.html
HTML
<button class="fadeto">Метод .fadeTo()</button>
<hr />
<div></div>
<div></div>
<div style="display: none"></div>
main.js
JavaScript
$(document).ready(function () {
    $('.fadeto').click(function () {
        $('div').fadeTo(1000, 0.5, 'linear')
    })
})
style.css
CSS
div {
    display: inline-block;
    width: 75px;
    height: 150px;
    margin-right: 20px;
    background-color: green;
}

В этом примере с использованием jQuery метода .fadeTo() мы при нажатии на кнопку линейно изменяем прозрачность элементов <div> до 0,5 за одну секунду (1000 миллисекунд). Обратите внимание, что скрытый элемент отображается, этого можно избежать используя свойство visibility со значением hidden, либо применяя селекторы не затрагивающие необходимые элементы.

Рассмотрим следующий пример в котором зададим методу fadeTo() callback функцию:

Пример использования jQuery метода .fadeTo() (с callback функцией)

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

index.html
HTML
<button class="fadeto">Метод .fadeTo()</button>
<hr />
<div></div>
<div></div>
<div></div>
main.js
JavaScript
$(document).ready(function () {
    $('.fadeto').click(function () {
        // задаем функцию при нажатиии на элемент с классом toggle
        var num = 0 // переменная (для вставки номера элемента)
        $('div').fadeTo(500, 0.4, 'linear', function () {
            // линейно изменяем прозрачность элементов до 0,4 за пол секунды и вызываем функцию
            num++ // увеличиваем переменную на 1 (инкремент)
            $(this).text(num) // добавляем значение переменной элементу к которому применяется анимация
        })
    })
})
style.css
CSS
div {
    display: inline-block;
    width: 75px;
    height: 150px;
    margin-right: 20px;
    background-color: red;
}

В этом примере с использованием jQuery метода .fadeTo() мы при нажатии на кнопку линейно изменяем прозрачность элементов <div> до 0,4 за пол секунды (500 миллисекунд). Кроме того, по завершению анимации, мы вызываем функцию, которая добавляет каждому элементу значение переменной. Обратите внимание, что внутри функции, переменная this ссылается на DOM элемент к которому применяется анимация, что позволяет нам поочередно добавить каждому элементу <div> в виде текстового содержимого значение переменной, увеличенное на один.