.toggleClass()

Add or remove one or more classes from each element in the set of matched elements, depending on either the class's presence or the value of the switch argument, while animating all style changes.

Similar to native CSS transitions, jQuery UI's class animations provide a smooth transition from one state to another while allowing you to keep all the details about which styles to change in CSS and out of your JavaScript. All class animation methods, including .toggleClass(), support custom durations and easings, as well as provide a callback for when the animation completes.

Not all styles can be animated. For example, there is no way to animate a background image. Any styles that cannot be animated will be changed at the end of the animation.

This plugin extends jQuery's built-in .toggleClass() method. If jQuery UI is not loaded, calling the .toggleClass() method may not fail directly, as the method still exists. However, the expected behavior will not occur.

className

One or more class names (space separated) to be toggled for each element in the matched set.

switch

A boolean value to determine whether the class should be added or removed.

duration (default: 400)

A string or number determining how long the animation will run.

easing (default: swing)

A string indicating which easing function to use for the transition.

complete

A function to call once the animation is complete, called once per matched element.

className

One or more class names (space separated) to be toggled for each element in the matched set.

switch

A boolean value to determine whether the class should be added or removed.

options

All animation settings. All properties are optional.

duration (default: 400)

A string or number determining how long the animation will run.

easing (default: swing)

A string indicating which easing function to use for the transition.

complete

A function to call once the animation is complete, called once per matched element.

children (default: false)

Whether the animation should additionally be applied to all descendants of the matched elements. This feature should be used with caution as the cost of determining which descendants to animate can be very expensive, and grows linearly with the number of descendants.

queue (default: true)

A Boolean indicating whether to place the animation in the effects queue. If false, the animation will begin immediately. As of jQuery 1.7, the queue option can also accept a string, in which case the animation is added to the queue represented by that string.

Examples:

Toggles the class "big-blue" for the matched elements.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>toggleClass demo</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.11.4/themes/smoothness/jquery-ui.css">
  <style>
  div {
    width: 100px;
    height: 100px;
    background-color: #ccc;
  }
  .big-blue {
    width: 200px;
    height: 200px;
    background-color: #00f;
  }
  </style>
  <script src="//code.jquery.com/jquery-1.10.2.js"></script>
  <script src="//code.jquery.com/ui/1.11.4/jquery-ui.js"></script>
</head>
<body>
 
<div></div>
 
<script>
$( "div" ).click(function() {
  $( this ).toggleClass( "big-blue", 1000, "easeOutSine" );
});
</script>
 
</body>
</html>
doc_jQuery
2016-03-28 14:48:00
Comments
Leave a Comment

Please login to continue.