jQuery UI API - .switchClass()

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, añade y elimina la Class especificada para cada elemento del conjunto de elementos coincidentes.

Devuelve:jQuery

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

Parámetros Tipo Descripción Valor predeterminado
removeClassName String Uno o más nombres de class que se eliminarán del atributo class de cada elemento coincidente, separados por espacios.
addClassName String Uno o más nombres de class que se agregarán 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 se ejecutará la animación. 400
easing String Una cadena que indica laeasingfunción a utilizar. swing
complete Function() Una función que se llamará cuando la animación se complete.

.switchClass( removeClassName, addClassName [, options ] )

Parámetros Tipo Descripción
removeClassName String Uno o más nombres de class que se eliminarán del atributo class de cada elemento coincidente, separados por espacios.
addClassName String Uno o más nombres de class que se agregarán 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 se ejecutará la animación.
  • easing(Valor predeterminado:swing)
    Tipo: String
    Descripción: una cadena que indica laeasingfunción a utilizar.
  • complete
    Tipo: Function()
    Descripción: una función que se llamará cuando la animación se complete.
  • children(Valor predeterminado:false)
    Tipo: Boolean
    Descripción: especifica si la animación se aplica a todos los descendientes de los elementos coincidentes. Esta función debe usarse con precaución, ya que determinar si un elemento es descendiente de los elementos animados es muy costoso y crece linealmente con el número de descendientes.
  • queue(Valor predeterminado:true)
    Tipo: Boolean o String
    Descripción: un valor booleano que indica si se coloca la animación en la cola de efectos. Si es false, la animación comenzará inmediatamente.A partir de jQuery 1.7, la opción queue también acepta una cadena, en cuyo caso la animación se agrega a la cola representada por la cadena.

.switchClass()El método le permite añadir una Class mientras elimina una Class durante la transición de la animación.

Similar a las transiciones CSS nativas, las animaciones de class de jQuery UI proporcionan una transición suave de un estado a otro, asegurando que todos los detalles de los cambios de estilo se realicen a través de CSS, sin necesidad de usar JavaScript. Todos los métodos de animación de class, incluidos.switchClass(), 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 imágenes de fondo. Cualquier estilo que no pueda animarse cambiará al final de la animación.

Este plugin extiende el método .switchClass() integrado de jQuery. Si jQuery UI no está cargado, llamar al.switchClass()método no fallará directamente, porque el método existe en jQuery. Pero no ocurrirá el comportamiento esperado.

Ejemplo

Agregar la class 'blue' a los elementos coincidentes y eliminar la class 'big' de los elementos coincidentes.

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

Otras extensiones