jQuery UI API - .switchClass()

Kategorie

Effekte | Effekt-Kern | Methodenüberschreibungen

Nutzung

Beschreibung:Wenn sich der Animationsstil ändert, fügen Sie die angegebene Klasse für jedes Element in der Menge übereinstimmender Elemente hinzu und entfernen Sie sie.

Gibt zurück:jQuery

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

Parameter Type Beschreibung Standardwert
removeClassName String Ein oder mehrere Klassennamen, die aus dem class-Attribut jedes übereinstimmenden Elements entfernt werden sollen, getrennt durch Leerzeichen.
addClassName String Ein oder mehrere Klassennamen, die dem Klassenattribut jedes übereinstimmenden Elements hinzugefügt werden, durch Leerzeichen getrennt.
duration Number oder String Eine Zeichenkette oder Zahl, die angibt, wie lange die Animation dauern soll. 400
easing String Eine Zeichenkette, die dieeasing-Funktion angibt. swing
complete Function() Eine Funktion, die aufgerufen wird, sobald die Animation abgeschlossen ist.

.switchClass( removeClassName, addClassName [, options ] )

Parameter Type Beschreibung
removeClassName String Ein oder mehrere Klassennamen, die aus dem class-Attribut jedes übereinstimmenden Elements entfernt werden sollen, getrennt durch Leerzeichen.
addClassName String Ein oder mehrere Klassennamen, die dem Klassenattribut jedes übereinstimmenden Elements hinzugefügt werden, durch Leerzeichen getrennt.
options Objekt Alle Animationseinstellungen. Alle Eigenschaften sind optional.
  • duration(Standard:400)
    Typ: Number oder String
    Beschreibung: Eine Zeichenkette oder Zahl, die angibt, wie lange die Animation dauern soll.
  • easing(Standard:swing)
    Typ: String
    Beschreibung: Eine Zeichenkette, die angibt, welcheeasing-Funktion.
  • complete
    Typ: Function()
    Beschreibung: Eine Funktion, die aufgerufen wird, sobald die Animation abgeschlossen ist.
  • children(Standard:false)
    Typ: Boolean
    Beschreibung: Legt fest, ob die Animation auf alle Nachfahren der übereinstimmenden Elemente angewendet werden soll. Diese Funktion sollte mit Vorsicht verwendet werden, da die Bestimmung, ob ein Element ein Nachfahre der Animation ist, aufwendig ist und linear mit der Anzahl der Nachfahren wächst.
  • queue(Standard:true)
    Typ: Boolean oder String
    Beschreibung: Ein boolescher Wert, der angibt, ob die Animation in die Effekt-Warteschlange gestellt werden soll. Wenn false, beginnt die Animation sofort.Seit jQuery 1.7akzeptiert die Option queue auch eine Zeichenkette; in diesem Fall wird die Animation der durch diese Zeichenkette repräsentierten Warteschlange hinzugefügt.

.switchClass()Die Methode ermöglicht es Ihnen, während des Animationsübergangs eine Klasse hinzuzufügen und gleichzeitig eine Klasse zu entfernen.

Ähnlich wie native CSS-Übergänge bieten die Klassenanimationen von jQuery UI einen sanften Übergang von einem Zustand in einen anderen, während sichergestellt wird, dass alle Details der Stiländerungen über CSS abgewickelt werden, ohne dass JavaScript erforderlich ist. Alle Klassenanimationsmethoden, einschließlich.switchClass(), ermöglichen benutzerdefinierte Animationsdauer undEasing-Funktionen und bieten außerdem einen Callback, wenn die Animation abgeschlossen ist.

Nicht alle Stile lassen sich animieren. Zum Beispiel das Animieren von Hintergrundbildern. Jeder Stil, der nicht animiert werden kann, ändert sich, wenn die Animation endet.

Dieses Plugin erweitert die in jQuery integrierte Methode .switchClass(). Wenn jQuery UI nicht geladen ist, wird der Aufruf.switchClass()der Methode nicht direkt fehlschlagen, da die Methode in jQuery existiert. Das erwartete Verhalten wird jedoch nicht eintreten.

Beispiel

Fügen Sie den übereinstimmenden Elementen die Klasse "blue" hinzu und entfernen Sie die Klasse "big" von den übereinstimmenden Elementen.

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

Andere Erweiterungen