jQuery UI API - .removeClass()

Kategorie

Effekte | Effekt-Kern | Methodenüberschreibungen

Nutzung

Beschreibung:Während Stiländerungen animiert werden, entfernt sie die angegebene Klasse aus jedem Element in der Menge der übereinstimmenden Elemente.

Gibt zurück:jQuery

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

Parameters Type Beschreibung Standard
className String Ein oder mehrere Klassennamen, die aus dem class-Attribut jedes übereinstimmenden Elements entfernt werden sollen, getrennt durch Leerzeichen.
duration Number oder String Ein String oder eine Zahl, die angibt, wie lange die Animation ausgeführt wird. 400
easing String Ein String, der dieEasing-Funktion angibt, die verwendet werden soll. swing
complete Function() Eine Funktion, die aufgerufen wird, sobald die Animation abgeschlossen ist.

.removeClass( className [, options ] )

Parameters Type Beschreibung
className String Ein oder mehrere Klassennamen, die aus dem class-Attribut jedes übereinstimmenden Elements entfernt werden sollen, getrennt durch Leerzeichen.
options Objekt Alle Animationsoptionen. Alle Eigenschaften sind optional.
  • duration(Standard:400)
    Typ: Number oder String
    Beschreibung: Eine Zeichenkette oder eine Zahl, die angibt, wie lange die Animation läuft.
  • easing(Standard:swing)
    Typ: String
    Beschreibung: Ein String, der die zu verwendendeeasing-Funktion angibt.
  • 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, wobei die Animation in diesem Fall der durch die Zeichenkette dargestellten Warteschlange hinzugefügt wird.

Ä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.removeClass()benutzerdefinierte Animationsdauern undEasing-Funktionen ermöglichen und außerdem einen Callback bereitstellen, wenn die Animation abgeschlossen ist.

Nicht alle Stile können animiert werden. Zum Beispiel das Animieren eines Hintergrundbilds. Jeder Stil, der nicht animiert werden kann, wird am Ende der Animation geändert.

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

Beispiele

Entfernt die Klasse "big-blue" aus den übereinstimmenden Elementen.

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

Andere Erweiterungen