jQuery UI API - Spinner-Widget

Kategorie

小部件

Nutzung

Beschreibung:Erweitert die Texteingabe für die Eingabe numerischer Werte, mit Auf-/Ab-Schaltflächen und Pfeiltastenbehandlung.

添加版本:1.9

Spinner, oder Zahlen-Stepper-Widget, ist das perfekte Widget für die Verarbeitung aller Arten numerischer Eingaben. Es ermöglicht dem Benutzer, einen Wert direkt einzugeben oder einen vorhandenen Wert durch Hoch-/Runterzählen mit Tastatur, Maus oder Mausrad zu ändern. In Kombination mit Globalize können Sie sogar Währungen und Datumsangaben in verschiedenen Gebietsschemata hoch-/runterzählen.

Spinner verwendet zwei Schaltflächen, um die Texteingabe mit einer Erhöhung und Verringerung des aktuellen Werts zu überlagern. Spinner fügt keydown-Ereignisse hinzu, sodass dieselbe Erhöhung und Verringerung mit der Tastatur durchgeführt werden kann. Spinner delegiert anGlobalizedie Zahlenformatierung und das Parsen.

Tastaturinteraktion

  • UP: Erhöht den Wert um einen Schritt.
  • DOWN: Verringert den Wert um einen Schritt.
  • PAGE UP: Erhöht den Wert um eine Seite.
  • PAGE DOWN: Verringert den Wert um eine Seite.

Der Fokus bleibt im Textfeld, nachdem die Spin-Schaltflächen mit der Maus angeklickt wurden.

Solange der Spinner nicht readonly ist (<input readonly>), können Benutzer Werte eingeben, die ungültig sein können (kleiner als das Minimum, größer als das Maximum, Schritt-Abweichung, nicht numerische Eingabe). Beim Inkrementieren oder Dekrementieren, ob programmgesteuert oder über die Spinner-Schaltflächen, wird der Wert auf einen gültigen Wert erzwungen (weitere Informationen finden Sie in derstepUp()undstepDown()Beschreibung.

主题

Das Spinner-Widget verwendet dasjQuery UI CSS framework, um seine Look-and-Feel-Stile zu definieren. Wenn Sie Spinner-spezifische Stile verwenden müssen, können Sie die folgenden CSS-Klassennamen verwenden:

  • ui-spinner: Der äußere Container des Spinners.
    • ui-spinner-input: das Element<input>, auf dem das Spinner-Widget instanziiert wird.
    • ui-spinner-button: Die Button-Steuerelemente, die zum Inkrementieren oder Dekrementieren des Spinner-Werts verwendet werden. Die Aufwärts-Schaltfläche hat außerdem eineui-spinner-upKlasse, und die Abwärts-Schaltfläche hat außerdem eineui-spinner-down -Klasse.

Abhängigkeiten

Zusätzliche Hinweise

  • Dieses Widget benötigt etwas funktionales CSS, andernfalls funktioniert es nicht. Wenn Sie ein benutzerdefiniertes Theme erstellen, verwenden Sie bitte die widget-spezifische CSS-Datei als Ausgangspunkt.
  • Dieses Widget manipuliert den Wert des Elements programmatisch, sodass das nativechangeEreignis nicht ausgelöst wird, wenn sich der Wert des Elements ändert.
  • Das Erstellen eines Spinners auf<input type="number">wird nicht unterstützt, da es zu Konflikten mit der nativen Spinner-UI führt.

Beispiele

Ein einfacher numerischer Spinner.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>旋转器部件(Spinner Widget)演示</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
  <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>
 
<input id="spinner">
 
<script>
$( "#spinner" ).spinner();
</script>
 
</body>
</html>

Andere Erweiterungen