API jQuery UI - .switchClass()

Catégorie

Effets | Cœur des effets | Redéfinitions de méthodes

Utilisation

Description :Lorsque le style d'animation change, ajoutez et supprimez la classe spécifiée pour chaque élément de l'ensemble d'éléments correspondants.

Retourne :jQuery

.switchClass( removeClassName, addClassName [, duration ] [, easing ] [, complete ] )

Paramètre Type Description Valeur par défaut
removeClassName String Un ou plusieurs noms de classes à supprimer de l'attribut class de chaque élément correspondant, séparés par des espaces.
addClassName String Un ou plusieurs noms de classe à ajouter à l'attribut class de chaque élément correspondant, séparés par des espaces.
duration Nombre ou chaîne de caractères Une chaîne ou un nombre spécifiant la durée de l'animation. 400
easing String Une chaîne indiquant la fonctioneasing. swing
complete Function() Une fonction à appeler une fois l'animation terminée.

.switchClass( removeClassName, addClassName [, options ] )

Paramètre Type Description
removeClassName String Un ou plusieurs noms de classes à supprimer de l'attribut class de chaque élément correspondant, séparés par des espaces.
addClassName String Un ou plusieurs noms de classe à ajouter à l'attribut class de chaque élément correspondant, séparés par des espaces.
options Object Tous les paramètres d'animation. Toutes les propriétés sont facultatives.
  • duration(par défaut :400)
    Type : Number ou String
    Description : Une chaîne ou un nombre spécifiant la durée de l'animation.
  • easing(par défaut :swing)
    Type : String
    Description : Une chaîne indiquant quelle fonctioneasing.
  • complete
    Type : Function()
    Description : Fonction à appeler une fois l'animation terminée.
  • children(par défaut :false)
    Type : Boolean
    Description : indique si l'animation doit être appliquée à tous les descendants des éléments correspondants. Cette fonctionnalité doit être utilisée avec prudence, car déterminer si un élément est un descendant de l'animation est coûteux et croît linéairement avec le nombre de descendants.
  • queue(par défaut :true)
    Type : Boolean ou String
    Description : Une valeur booléenne indiquant s'il faut placer l'animation dans la file d'attente des effets. Si false, l'animation commence immédiatement.À partir de jQuery 1.7, l'option queue accepte également une chaîne, auquel cas l'animation est ajoutée à la file d'attente représentée par cette chaîne.

.switchClass()La méthode vous permet d'ajouter une classe tout en supprimant une classe pendant la transition d'animation.

Semblables aux transitions CSS natives, les animations de classe de jQuery UI offrent une transition fluide d'un état à un autre, tout en garantissant que tous les détails de changement de style sont gérés via CSS sans avoir besoin de JavaScript. Toutes les méthodes d'animation de classe, y compris.switchClass(), permettent de personnaliser la durée de l'animation et les fonctions d'easing, et fournissent également une fonction de rappel lorsque l'animation est terminée.

Les styles ne peuvent pas tous être animés. Par exemple, animer des images d'arrière-plan. Tout style qui ne peut pas être animé changera lorsque l'animation se termine.

Ce plugin étend la méthode intégrée .switchClass() de jQuery. Si jQuery UI n'est pas chargé, l'appel de.switchClass()la méthode n'échouera pas directement, car la méthode existe dans jQuery. Cependant, le comportement attendu ne se produira pas.

Exemple

Ajoutez la classe "blue" aux éléments correspondants et supprimez la classe "big" des éléments correspondants.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>.switchClass() 演示</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
  <style>
  div {
    width: 100px;
    height: 100px;
    background-color: #ccc;
  }
  .big {
    width: 200px;
    height: 200px;
  }
  .blue {
    background-color: #00f;
  }
  </style>
  <script src="//code.jquery.com/jquery-1.10.2.js"></script>
  <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
 
<div class="big"></div>
 
<script>
$( "div" ).click(function() {
  $( this ).switchClass( "big", "blue", 1000, "easeInOutQuad" );
});
</script>
 
</body>
</html>

Autres extensions