Rose Rose Boutique Boutique Tea Tea Cardigan n n Cardigan 0qP655


Boutique Cardigan Tea Rose Rose n Boutique Cardigan Tea n .animate( properties [, duration ] [, easing ] [, complete ] )Returns: jQuery

Description: Perform a custom animation of a set of CSS properties.

The .animate() method allows us to create animation effects on any numeric CSS property. The only required parameter is a plain object of CSS properties. This object is similar to the one that can be sent to the .css() method, except that the range of properties is more restrictive.

Animation Properties and Values

All animated properties should be animated to a single numeric value, except as noted below; most properties that are non-numeric cannot be animated using basic jQuery functionality (For example, width, height, or left can be animated but background-color cannot be, unless the jQuery.Color plugin is used). Property values are treated as a number of pixels unless otherwise specified. The units em and % can be specified where applicable.

In addition to style properties, some non-style properties such as scrollTop and scrollLeft, as well as custom properties, can be animated.

Shorthand CSS properties (e.g. font, background, border) are not fully supported. For example, if you want to animate the rendered border width, at least a border style and border width other than "auto" must be set in advance. Or, if you want to animate font size, you would use fontSize or the CSS equivalent 'font-size' rather than simply 'font'.

In addition to numeric values, each property can take the strings 'show', 'hide', and 'toggle'. These shortcuts allow for custom hiding and showing animations that take into account the display type of the element. In order to use jQuery's built-in toggle state tracking, the 'toggle' keyword must be consistently given as the value of the property being animated.

Animated properties can also be relative. If a value is supplied with a leading += or -= sequence of characters, then the target value is computed by adding or subtracting the given number from the current value of the property.

Note: Unlike shorthand animation methods such as .slideDown() and .fadeIn(), the .animate() method does not make hidden elements visible as part of the effect. For example, given $( "someElement" ).hide().animate({height: "20px"}, 500), the animation will run, but the element will remain hidden.

Duration

Durations are given in milliseconds; higher values indicate slower animations, not faster ones. The default duration is 400 milliseconds. The strings 'fast' and 'slow' can be supplied to indicate durations of 200 and 600 milliseconds, respectively.

Callback Functions

If supplied, the start, step, progress, complete, done, fail, and always callbacks are called on a per-element basis; this is set to the DOM element being animated. If no elements are in the set, no callbacks are called. If multiple elements are animated, the callback is executed once per matched element, not once for the animation as a whole. Use the .promise() method to obtain a promise to which you can attach callbacks that fire once for an animated set of any size, including zero elements.

Basic Usage

To animate any element, such as a simple image:

1
2
3
4
5
                 
<div id="clickme">
Click here
div>
<img id="book" src="book.png" alt=Tea Tea Cardigan Rose n Boutique Rose n Boutique Cardigan "" width="100" height="123"
style="position: relative; left: 10px;">

Rose Cardigan Tea Boutique n Tea n Cardigan Rose Boutique To animate the opacity, left offset, and height of the image simultaneously:

1
2
3
4
5
6
7
8
9
                 
$( "#clickme" ).click(function() {
$( "#book" ).animate({
opacity: 0.25,
left: "+=50",
height: n Cardigan Boutique Boutique n Tea Rose Tea Rose Cardigan "toggle"
}, 5000, function() {
// Animation complete.
});
});

Figure 1 - Illustration of the specified animation effect

Note that the target value of the height property is 'toggle'. Since the image was visible before, the animation shrinks the height to 0 to hide it. A second click then reverses this transition:

Figure 2 - Illustration of the specified animation effect

The opacity of the image is already at its target value, so this property is not animated by the second click. Since the target value for left is a relative value, the image moves even farther to the right during this second animation.

Directional properties (top, right, bottom, left) have no discernible effect on elements if their position style property is static, which it is by default.

Note: The jQuery UI project extends the .animate() method by allowing some non-numeric styles such as colors to be animated. The project also includes mechanisms for specifying animations through CSS classes rather than individual attributes.

Note: if attempting to animate an element with a height or width of 0px, where contents of the element are visible due to overflow, jQuery may clip this overflow during animation. By fixing the dimensions of the original element being hidden however, it is possible to ensure that the animation runs smoothly. A clearfix can be used to automatically fix the dimensions of your main element without the need to set this manually.

Step Function

The second version of .animate() provides a Tea n Cardigan Tea Rose Cardigan Boutique Rose n Boutique step option — a callback function that is fired at each step of the animation. This function is useful for enabling custom animation types or altering the animation as it is occurring. It accepts two arguments (now and fx), and this is set to the DOM element being animated.

  • now: the numeric value of the property being animated at each step
  • fx: a reference to the jQuery.fx prototype object, which contains a number of properties such as elem for the animated element, start and end for the first and last value of the animated property, respectively, and prop for the property being animated.

Note that the step function is called for each animated property on each animated element. For example, given two list items, the step function fires four times at each step of the animation:

1
2
3
4
5
6
7
8
9
                 
$( "li" ).animate({
opacity: .5,
height: "50%"
}, {
step: function( now, fx ) {
var data = fx.elem.id + " " + fx.prop + ": " + now;
$( Tea Boutique Rose n Rose Tea Cardigan Boutique Cardigan n "body" ).append( "
" + data + "
"
);
}
});

Easing

The remaining parameter of .animate() is a string naming an easing function to use. An easing function specifies the speed at which the animation progresses at different points within the animation. The only easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant pace, called Cardigan Rose Tea n Boutique Tea Rose Boutique Cardigan n linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.

Per-property Easing

As of jQuery version 1.4, you can set per-property easing functions within a single .animate() call. In the first version of .animate(), each property can take an array as its value: The first member of the array is the CSS property and the second member is an easing function. If a per-property easing function is not defined for a particular property, it uses the value of the .animate() method's optional easing argument. If the easing argument is not defined, the default swing function is used.

For example, to simultaneously animate the width and height with the swing easing function and the opacity with the linear easing function:

1
2
3
4
5
6
7
8
9
                 
$( "#clickme" ).click(function() {
$( "#book" ).animate({
width: [ "toggle", "swing" ],
height: [ "toggle", "swing" ],
opacity: "toggle"
}, 5000, "linear", function() {
$( this ).after( "
Animation complete.
"
);
});
});

In the second version of .animate(), the options object can include the specialEasing property, which is itself an object of CSS properties and their corresponding easing functions. For example, to simultaneously animate the width using the linear easing function and the height using the easeOutBounce easing function:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
                 
$( "#clickme" ).click(function() {
$( "#book" ).animate({
width: "toggle",
height: "toggle"
Beer Chillionaire Me Beer Chillionaire T T Chillionaire Shirt Shirt Me q6Aw7tI7
}, {
duration: 5000,
specialEasing: {
width: "linear",
height: "easeOutBounce"
},
complete: function() {
$( this ).after( "
Animation complete.
"
);
}
});
});

As previously noted, a plugin is required for the easeOutBounce function.

Additional Notes:

  • All jQuery effects, including .animate(), can be turned off globally by setting jQuery.fx.off = true, which effectively sets the duration to 0. For more information, see jQuery.fx.off.

Examples:

Click the button to animate the div with a number of different properties.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
                  
<html lang="en">
<head>
<title>animate demotitle>
<style>
div {
background-color: #bca;
width: 100px;
border: 1px solid green;
}
style>
<script src="https://code.jquery.com/jquery-1.10.2.js">script>
head>
<body>
<button id="go">&raquo; Runbutton>
<div id="block">Hello!div>
Kentucky T Shirt Brew City Bourbon 1w5F7Tq
<script>
// Using multiple unit types within one animation.
$( "#go" ).click(function() {
$( "#block" ).animate({
width: "70%",
opacity: 0.4,
marginLeft: "0.6in",
fontSize: "3em",
borderWidth: "10px"
}, 1500 );
});
script>
body>
html>

Demo:

Animates a div's left property with a relative value. Click several times on the buttons to see the relative animations queued up.

1
2
3
4
5
6
7
n Boutique Rose Rose n Tea Tea Boutique Cardigan Cardigan 8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
n Tea Tea n Rose Rose Cardigan Boutique Boutique Cardigan 26
27
28
29
30
31
32
33
34
35
                  
<html lang="en">
<head>
<meta charset="utf-8">
<title>animate demotitle>
<style>
div {
position: absolute;
background-color: #abc;
left: 50px;
width: 90px;
height: 90px;
margin: 5px;
n Tea Rose Cardigan n Boutique Tea Cardigan Boutique Rose }
style>
<script src="https://code.jquery.com/jquery-1.10.2.js">script>
head>
<body>
<button id="left">&laquo;button>
<button id="right">&raquo;button>
<div class="block">div>
<script>
$( "#right" ).click(function() {
Jacket Affliction Electric Premium Black Spark pOpI4UXq
$( ".block" ).animate({ "left": "+=50px" }, "slow" );
});
$( "#left" ).click(function(){
$( ".block" ).animate({ "left": "-=50px" }, "slow" );
});
script>
body>
html>

Demo:

The first button shows how an unqueued animation works. It expands the div out to 90% width while the font-size is increasing. Once the font-size change is complete, the border animation will begin. The second button starts a traditional chained animation, where each animation will start once the previous animation on the element has completed.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
Boutique n Rose Tea Tea n Rose Cardigan Cardigan Boutique 32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
Silver Silver Silver Jean Stretch Stretch Gordie Gordie Jean wr8qRwpxH6
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
                  
<html lang="en">
<head>
<Rose Cardigan n Tea Cardigan Boutique Boutique Rose n Tea meta charset="utf-8">
<title>animate demotitle>
<style>
div {
background-color: #bca;
width: 200px;
height: 1.1em;
text-align: center;
border: 2px solid green;
margin: 3px;
font-size: 14px;
}
button {
font-size: 14px;
}
style>
<script src="https://code.jquery.com/jquery-1.10.2.js">script>
head>
<body>
<button id="go1">&raquo; Animate Block1button>
<button id="go2">&raquo; Animate Block2button>
<button id="go3">&raquo; Animate Bothbutton>
<button id="go4">&raquo; Resetbutton>
<div id="block1">Block1div>
<div id="block2">Block2div>
<script>
$( "#go1" ).click(function() {
$( "#block1" )
.animate({
width: "90%"
}, {
queue: false,
duration: 3000
})
.animate({ fontSize: "24px" }, 1500 )
.animate({ borderRightWidth: "15px" }, 1500 );
});
$( "#go2" ).click(function() {
$( "#block2" )
.animate({ width: "90%" }, 1000 )
.animate({ fontSize: "24px" }, 1000 )
.animate({ borderLeftWidth: "15px" }, 1000 );
});
$( "#go3" ).click(function() {
$( "#go1" ).add( "#go2" ).click();
});
$( "#go4" ).click(function() {
$( "div" ).css({
width: "",
fontSize: "",
borderWidth: ""
});
});
script>
body>
html>

Demo:

Animates the first div's left property and synchronizes the remaining divs, using the step function to set their left properties at each stage of the animation.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
n Cardigan Rose Tea Rose Boutique Tea Boutique n Cardigan 29
30
31
32
33
34
35
36
37
38
39
40
41
42
                  
<html lang="en">
<head>
<meta charset="utf-8">
<title>animate demotitle>
<style>
div {
position: relative;
background-color: #abc;
width: 40px;
Boutique Boutique Cardigan Rose Rose Tea Tea n Cardigan n height: 40px;
float: left;
}
style>
<script src="https://code.jquery.com/jquery-1.10.2.js">script>
head>
<body>
<p><button id="go">Run »button>p>
<div class="block">div>
<div class="block">div>
<div class="block">div>
<div class="block">div>
<div class="block">div>
<div class="block">div>
<script>
$( "#go" ).click(function() {
$( ".block:first" ).animate({
}, {
duration: 1000,
step: function( now, fx ){
$( ".block:gt(0)" ).css( "left", now );
}
});
});
script>
body>
html>

Demo:

Animate all paragraphs to toggle both height and opacity, completing the animation within 600 milliseconds.

1
2
3
4
                  
$( "p" ).animate({
height: "toggle",
opacity: "toggle"
}, "slow" );

Animate all paragraphs to a left style of 50 and opacity of 1 (opaque, visible), completing the animation within 500 milliseconds.

1
2
3
4
                  
$( "p" ).animate({
left: 50,
opacity: 1
}, 500 );

Animate the left and opacity style properties of all paragraphs; run the animation outside the queue, so that it will automatically start without waiting for its turn.

1
2
3
4
5
6
7
                  
$( "p" ).animate({
left: "50px",
opacity: 1
}, {
duration: 500,
queue: false
});

An example of using an 'easing' function to provide a different style of animation. This will only work if you have a plugin that provides this easing function. Note, this code will do nothing unless the paragraph element is hidden.

1
2
3
                  
$( "p" ).animate({
opacity: "show"
}, "slow", "easein" );

Animates all paragraphs to toggle both height and opacity, completing the animation within 600 milliseconds.

1
2
3
4
5
6
                  
$( "p" ).animate({
height: "toggle",
opacity: "toggle"
}, {
duration: "slow"
});

Use an easing function to provide a different style of animation. This will only work if you have a plugin that provides this easing function.

1
2
3
4
5
6
                  
$( "p" ).animate({
opacity: "show"
}, {
duration: "slow",
easing: "easein"
});

Animate all paragraphs and execute a callback function when the animation is complete. The first argument is an object of CSS properties, the second specifies that the animation should take 1000 milliseconds to complete, the third states the easing type, and the fourth argument is an anonymous callback function.

1
2
3
4
5
6
7
                  
$( "p" ).animate({
height: 200,
width: 400,
opacity: 0.5
}, 1000, "linear", function() {
alert( "all done" );
});
Rose Rose Boutique Boutique Tea Tea Cardigan n n Cardigan 0qP655 Rose Rose Boutique Boutique Tea Tea Cardigan n n Cardigan 0qP655
Materials Fabric details not available.