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
- UI 核心
- Widget-Factory
- Button Widget
- Globalize(extern, optional; bei Verwendung mit dem
cultureundnumberFormatOption)
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 native
changeEreignis 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