jQuery UI API - .addClass()

Categoría

Efectos (Effects) | Núcleo de efectos (Effects Core) | Reemplazos de métodos (Method Overrides)

Uso

Descripción:Cuando cambia el estilo de animación, agrega la clase especificada a cada elemento dentro del conjunto de elementos coincidentes.

Devuelve:jQuery

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

Parámetros Tipo Descripción Valor predeterminado
className String Uno o más nombres de clase para agregar al atributo class de cada elemento coincidente, separados por espacios.
duration Number o String Una cadena o un número que especifica cuánto tiempo durará la animación. 400
easing String Una cadena que indica laeasingfunción. swing
complete Function() La función que se invocará cuando la animación haya finalizado.

.addClass( className [, options ] )

Parámetros Tipo Descripción
className String Uno o más nombres de clase para agregar al atributo class de cada elemento coincidente, separados por espacios.
options Object Todas las configuraciones de animación. Todas las propiedades son opcionales.
  • duration(Valor predeterminado:400)
    Tipo: Number o String
    Descripción: una cadena o un número que especifica cuánto tiempo durará la animación.
  • easing(Valor predeterminado:swing)
    Tipo: String
    Descripción: una cadena que indica laeasingfunción.
  • complete
    Tipo: Function()
    Descripción: la función que se llamará cuando la animación haya finalizado.
  • children(Valor predeterminado:false)
    Tipo: Boolean
    Descripción: especifica si la animación se aplica a todos los descendientes de los elementos coincidentes. Esta característica debe usarse con precaución, ya que determinar si un elemento es descendiente de un elemento animado es costoso y aumenta linealmente con la cantidad de descendientes.
  • queue(Valor predeterminado:true)
    Tipo: Boolean o String
    Descripción: un valor booleano que indica si la animación se coloca en la cola de efectos. Si es false, la animación comenzará inmediatamente.Desde jQuery 1.7, la opción queue también acepta una cadena; en ese caso, la animación se agrega a la cola representada por la cadena.

Al igual que las transiciones CSS nativas, las animaciones de clase de jQuery UI proporcionan una transición suave de un estado a otro, garantizando que todos los detalles de los cambios de estilo se realicen mediante CSS, sin necesidad de usar JavaScript. Todos los métodos de animación de clase, incluido.addClass(), permiten personalizar la duración de la animación y laeasingfunción, y también se proporciona una devolución de llamada cuando la animación se completa.

No todos los estilos se pueden animar. Por ejemplo, animar imágenes de fondo. Cualquier estilo que no se pueda animar cambiará al final de la animación.

Este complemento extiende el.addClass()método. Si jQuery UI no está cargado, invocar.addClass()el método no fallará directamente, porque este método existe en jQuery. Sin embargo, no ocurrirá el comportamiento esperado.

Ejemplo

Agrega la clase 'big-blue' a los elementos coincidentes.

<!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>

Otras extensiones