jQuery UI API - виджет Spinner
Категория
Использование
Описание:Улучшает текстовое поле для ввода числовых значений с помощью кнопок вверх/вниз и обработки клавиш со стрелками.
Добавлено в версии:1.9
Spinner, или виджет числового счетчика, — это идеальный виджет для обработки всех типов числового ввода. Он позволяет пользователю вводить значение напрямую или изменять существующее значение с помощью прокрутки с клавиатуры, мыши или колесика прокрутки. В сочетании с Globalize вы можете даже прокручивать валюты и даты в различных локалях.
Spinner использует две кнопки, накладываемые на поле ввода текста, для увеличения и уменьшения текущего значения. Spinner добавляет события keydown, чтобы то же увеличение и уменьшение можно было выполнять с клавиатуры. Spinner делегируетGlobalizeформатирование и разбор чисел.
Взаимодействие с клавиатурой
- UP: Увеличивает значение на один шаг.
- DOWN: Уменьшает значение на один шаг.
- PAGE UP: Увеличивает значение на одну страницу.
- PAGE DOWN: Уменьшает значение на одну страницу.
Фокус остаётся в текстовом поле после нажатия кнопок прокрутки мышью.
Пока счетчик не находится в режиме только для чтения (<input readonly>), пользователи могут вводить значения, которые могут быть недопустимыми (меньше минимума, больше максимума, несоответствие шагу, нечисловой ввод). При увеличении или уменьшении, программно или с помощью кнопок счетчика, значение принудительно приводится к допустимому значению (дополнительную информацию см. вstepUp()иstepDown()описании.
Темы оформления
Виджет Spinner используетjQuery UI CSS frameworkдля определения стилей внешнего вида и поведения. Если вам нужно использовать стили, специфичные для Spinner, можно использовать следующие имена CSS-классов:
ui-spinner: внешний контейнер счетчика.ui-spinner-input: элемент<input>на котором создан виджет Spinner.ui-spinner-button: элементы управления в виде кнопок, используемые для увеличения или уменьшения значения счетчика. Кнопка вверх также будет иметьui-spinner-upкласс, а кнопка вниз также будет иметьui-spinner-downкласс.
Зависимости
- Ядро UI
- Фабрика виджетов
- Виджет Button
- Globalize(внешняя, необязательная; при использовании с
cultureиnumberFormatопция)
Дополнительные примечания
- Для работы этого виджета требуется некоторый функциональный CSS, иначе он не будет работать. Если вы создаете собственную тему, пожалуйста, используйте в качестве отправной точки CSS-файл, специфичный для виджета.
- Этот виджет программно управляет значением элемента, поэтому нативное
changeсобытие не срабатывает при изменении значения элемента. - Создание спиннера на
<input type="number">не поддерживается, потому что это вызовет конфликты с нативным интерфейсом спиннера.
Примеры
Базовый числовой спиннер.
<!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>Другие расширения