API jQuery UI - .addClass()

Catégorie

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

Utilisation

Description :Lors de l'animation des changements de style, ajoute la classe spécifiée à chaque élément de l'ensemble des éléments correspondants.

Retourne :jQuery

.addClass( className [, duration ] [, easing ] [, complete ] )

Parameters Type Description Valeur par défaut
className String Un ou plusieurs noms de classe à ajouter à l'attribut class de chaque élément correspondant ; plusieurs noms de classe sont 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 d'exécution de l'animation. 400
easing String Une chaîne indiquant la ... à utiliser.easingfonction. swing
complete Function() Une fonction à appeler une fois l'animation terminée.

.addClass( className [, options ] )

Parameters Type Description
className String Un ou plusieurs noms de classe à ajouter à l'attribut class de chaque élément correspondant ; plusieurs noms de classe sont séparés par des espaces.
options Object Tous les paramètres d'animation. Toutes les propriétés sont facultatives.
  • duration(Valeur par défaut :400)
    Type : Number ou String
    Description : Une chaîne ou un nombre spécifiant la durée d'exécution de l'animation.
  • easing(Valeur par défaut :swing)
    Type : String
    Description : Une chaîne indiquant la ... à utiliser.easingfonction.
  • complete
    Type : Function()
    Description : Fonction à appeler une fois l'animation terminée.
  • children(Valeur 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 des éléments sont des descendants de l'élément animé est très coûteux et croît linéairement avec le nombre de descendants.
  • queue(Valeur par défaut :true)
    Type : Boolean ou String
    Description : Valeur booléenne indiquant s'il faut placer l'animation dans la file d'attente des effets. Si false, l'animation commencera immédiatement.À partir de jQuery 1.7, l'option queue accepte également une chaîne de caractères, auquel cas l'animation est ajoutée à la file d'attente représentée par la chaîne.

Semblables aux transitions CSS natives, les animations de classe de jQuery UI assurent une transition fluide d'un état à un autre, tout en veillant à ce que tous les détails de modification de style soient gérés par CSS, sans avoir besoin de JavaScript. Toutes les méthodes d'animation de classe, y compris.addClass(), permettent de personnaliser la durée d'animation et la fonction d'easing, et fournissent également une fonction de rappel lorsque l'animation se termine.

Tous les styles ne peuvent pas être animés. Par exemple, l'animation d'images d'arrière-plan. Tout style qui ne peut pas être animé changera à la fin de l'animation.

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

Exemples

Ajoutez la classe "big-blue" aux éléments correspondants.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>.addClass() 演示</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-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.10.4/jquery-ui.js"></script>
</head>
<body>
 
<div></div>
 
<script>
$( "div" ).click(function() {
  $( this ).addClass( "big-blue", 1000, "easeOutBounce" );
});
</script>
 
</body>
</html>

Autres extensions