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 класс.

Зависимости

Дополнительные примечания

  • Для работы этого виджета требуется некоторый функциональный 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>

Другие расширения