jQuery UI API - .toggleClass()
Categoría
Efectos (Effects) | Núcleo de efectos (Effects Core) | Sobrecarga de métodos (Method Overrides)
Uso
Descripción:Cuando el estilo de la animación cambia, según si la Class existe y el valor del parámetro switch, agrega o elimina una o más Classes para cada elemento del conjunto de elementos coincidentes.
Devuelve:jQuery
| Parámetros | Tipo | Descripción | Valor predeterminado |
|---|---|---|---|
| ClassName | String | Uno o más nombres de class para alternar en cada elemento del conjunto de elementos coincidentes; varios nombres de class se separan por espacios. | |
| switch | Boolean | Un valor booleano que especifica si la class debe agregarse o eliminarse. | |
| 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() | Función que se llamará cuando se complete la animación. |
| Parámetros | Tipo | Descripción |
|---|---|---|
| ClassName | String | Uno o más nombres de class para alternar en cada elemento del conjunto de elementos coincidentes; varios nombres de class se separan por espacios. |
| switch | Boolean | Un valor booleano que especifica si la class debe agregarse o eliminarse. |
| options | Object | Todas las opciones de animación. Todas las propiedades son opcionales.
|
Al igual que las transiciones CSS nativas, las animaciones de class de jQuery UI proporcionan una transición suave de un estado a otro, al tiempo que garantizan que todos los detalles de los cambios de estilo se realicen mediante CSS y no requieran JavaScript. Todos los métodos de animación de class, incluido.toggleClass(), permiten personalizar la duración de la animación yeasingfunción, y también proporcionan un callback cuando la animación se completa.
No todos los estilos pueden animarse. Por ejemplo, animar una imagen de fondo. Cualquier estilo que no pueda animarse cambiará al final de la animación.
Este complemento extiende el método incorporado de jQuery.toggleClass(). Si jQuery UI no está cargado, llamar al.toggleClass()método no fallará directamente, porque ese método existe en jQuery. Pero no ocurrirá el comportamiento esperado.
Ejemplo
Alterna la class "big-blue" en los elementos coincidentes.
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>.toggleClass() 演示</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 ).toggleClass( "big-blue", 1000, "easeOutSine" );
});
</script>
</body>
</html>
Otras extensiones