jQuery UI API - .addClass()

Kategorie

Effekte | Effekt-Kern | Methodenüberschreibungen

Nutzung

Beschreibung:Während Stiländerungen animiert werden, wird die angegebene Klasse zu jedem Element in der Menge der übereinstimmenden Elemente hinzugefügt.

Gibt zurück:jQuery

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

Parameters Type Beschreibung Standardwert
className String Ein oder mehrere Klassennamen, die zum class-Attribut jedes übereinstimmenden Elements hinzugefügt werden sollen; mehrere Klassennamen werden durch Leerzeichen getrennt.
duration Number oder String Ein String oder eine Zahl, die angibt, wie lange die Animation läuft. 400
easing String Ein String, der die ... zu verwendendeeasingFunktion angibt. swing
complete Function() Eine Funktion, die aufgerufen wird, sobald die Animation abgeschlossen ist.

.addClass( className [, options ] )

Parameters Type Beschreibung
className String Ein oder mehrere Klassennamen, die zum class-Attribut jedes übereinstimmenden Elements hinzugefügt werden sollen; mehrere Klassennamen werden durch Leerzeichen getrennt.
options Objekt Alle Animationseinstellungen. Alle Eigenschaften sind optional.
  • duration(Standardwert:400)
    Typ: Number oder String
    Beschreibung: Ein String oder eine Zahl, die angibt, wie lange die Animation läuft.
  • easing(Standardwert:swing)
    Typ: String
    Beschreibung: Ein String, der die ... zu verwendendeeasingFunktion angibt.
  • complete
    Typ: Function()
    Beschreibung: Eine Funktion, die aufgerufen wird, sobald die Animation abgeschlossen ist.
  • children(Standardwert:false)
    Typ: Boolean
    Beschreibung: Gibt an, ob die Animation auf alle Nachfahren der übereinstimmenden Elemente angewendet werden soll. Diese Funktion sollte mit Vorsicht verwendet werden, da die Bestimmung, ob Elemente Nachfahren des animierten Elements sind, sehr kostspielig ist und linear mit der Anzahl der Nachfahren wächst.
  • queue(Standardwert: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 Zeichenfolge; in diesem Fall wird die Animation der durch die Zeichenfolge repräsentierten Warteschlange hinzugefügt.

Ähnlich wie native CSS-Übergänge bieten die Klassenanimationen von jQuery UI einen fließenden Übergang von einem Zustand in einen anderen und stellen dabei sicher, dass alle Details der Stiländerungen von CSS behandelt werden, ohne dass JavaScript erforderlich ist. Alle Klassenanimationsmethoden, einschließlich.addClass(), ermöglichen eine benutzerdefinierte Animationsdauer und eineEasing-Funktion und bieten außerdem einen Callback, wenn die Animation abgeschlossen ist.

Nicht alle Stile können animiert werden. Zum Beispiel das Animieren von Hintergrundbildern. Jeder Stil, der nicht animiert werden kann, ändert sich am Ende der Animation.

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

Beispiele

Füge die Klasse "big-blue" zu den ausgewählten Elementen hinzu.

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

Andere Erweiterungen