.fadeToggle()S2C Home « Effects « .fadeToggle()

Fading elements in and out.

Description

The .fadeToggle() method is used to animate the opacity of the matched set to hide or show it.

Syntax

Signature Description
.fadeToggle( [duration] [, easing] [, callback] )Animate the opacity of the matched set to hide or show it, optionally providing a duration and/or an easing and/or a callback function.

Parameters

Parameter Description Type
durationA string or number determining the time the animation will run for.
default: 400
  • Durations are given in milliseconds and the higher the value, the slower the animation.
  • The string 'slow' can be used which equates to 600 milliseconds.
  • The string 'fast' can be used which equates to 200 milliseconds.
String or
Number
easingSpecify the speed at which the animation progresses at different points within the animation.
default: swing
  • The string 'swing' which is the default and causes the animation to animate faster at the beginning/end and slower in the middle.
  • The string 'linear' which causes the animation to progress at a constant pace.
String
callbackA function that fires once the animation is complete.
  • The callback is fired in the context of the current element in the set being animated, so the keyword this refers to that element.
  • The callback is fired once for each element in the matched set and can be used to string different animations together in sequence.
Function

Return

A jQuery object.

.fadeToggle( [duration] [,easing] [,callback] ) ExamplesTop

Animate the opacity of the matched set to hide or show it, optionally providing a duration and/or an easing and/or a callback function.

  • When used in its basic form with no parameters or incorrect parameters the .fadeToggle() method defaults to fading in the element(s) with a duration of 400 milliseconds which is the default.

In the example below when the first button is pressed we fade in or out the first image and it defaults to a fade in time of 400 milliseconds.

When the second button is pressed we use 'swing' easing to animate the picture as we fade it in or out.

When the third button is pressed we use a callback to alert when the image is faded in or out.

When the fourth button is pressed we use a duration, easing and a callback to fade in or out the last 3 images to their specified values.

a picture of curry a picture of pie a picture of pie a picture of pie a picture of pie a picture of pie



$(function(){
  $('#btn9').on('click', function() {
    $('#curry3').fadeToggle();
  });
  $('#btn10').on('click', function() {
    $('#pie7').fadeToggle('swing');
  });
  $('#btn11').on('click', function() {
    $('#pie8').fadeToggle(function() {
      alert('Animation finished.');
    });
  });
  $('#btn12').on('click', function() {
    $('.pie9').first().fadeToggle('slow', 'swing', function() {
      // using 'callee' so we don't have to name the function
      $(this).next().fadeToggle(1200, arguments.callee);
    });
  });
});

Press the buttons below to action the above code: