jQuery UI （17）旋转器部件（Spinner Widget）

通过向上/向下按钮和箭头键处理，为输入数值增强文本输入功能。

一、实例

普通的数字选择器。

 

代码

 <input id="spinner">
 
<script>
$( "#spinner" ).spinner();
</script>

查看演示

旋转器（Spinner），或数步进控件（number stepper widget），是用于处理各种数字输入的完美控件。它允许用户直接输入一个值，或通过键盘、鼠标、滚轮旋转改变一个已有的值。当与全球化（Globalize）结合时，您甚至可以旋转显示不同地区的货币和日期。

旋转器（Spinner）使用两个按钮将文本输入覆盖为当前值的递增值和递减值。旋转器增加了按键事件，以便可以用键盘完成相同的递增和递减。旋转器代表 全球化（Globalize）的数字格式和解析。

二、键盘交互

  • UP：对值增加一步。
  • DOWN：对值减少一步。
  • PAGE UP：对值增加一页。
  • PAGE DOWN：对值减少一页。

用鼠标点击旋转按钮后，焦点仍停留在文本域中。

当旋转器不是只读（）时，用户可以输入值，这可能会产生无效的值（小于最小值，大于最大值，增减错配，非数字输入）。当增减时，不管通过编程方式还是旋转按钮方式，值都会被强制为一个有效值（如需了解详情，请查看 stepUp() 和 stepDown() 的描述。

三、主题化

旋转器部件（Spinner Widget）使用 jQuery UI CSS 框架 来定义它的外观和感观的样式。如果需要使用旋转器指定的样式，则可以使用下面的 CSS class 名称：

  • ui-spinner：旋转器的外层容器。
    • ui-spinner-input：旋转器部件（Spinner Widget）实例化的 元素。
    • ui-spinner-button：用于递增或递减旋转器值的按钮控件。向上按钮会另外带有一个 ui-spinner-up class，向下按钮会另外带有一个 ui-spinner-down class。

四、快速导航

1、Options

  • culture：设置culture选项 用于解析和格式化值。 如果为null，在Globalize下当前设置的culture将被使用， 可供的culture，请查看Globalize 文档。 只有当numberFormat选项设置了，才会有关联。 需要引用Globalize。
  • disabled：如果设置为 true，则禁用该 spinner（微调组件）。
  • icons：标题要使用的图标，与 jQuery UI CSS 框架提供的图标（Icons） 匹配。设置为 false 则不显示图标。
  • incremental：当按住spinner（微调组件）按钮不放时，控制的步数。
  • max：允许的最大值。 如果元素的max属性存在，该选项未明确设置，那么该元素的max属性就被用作该选项的值。 如果为null，表示没有上限。
  • min：允许的最小值。 如果元素的min属性存在，该选项未明确设置，那么该元素的min属性就被用作该选项的值。 如果为null，表示没有下限。
  • numberFormat：通过Globalize格式化数字， 如果有效的话。 最常见的用于"n"用作十进制数 和"C"用作货币值。 也看到了culture选择。
  • page：当通过pageUp/pageDown的方法进行分页时，采取的步数。
  • step：通过按钮或stepUp()/stepDown()方法微调时，采取的步数。 如果元素的step属性存在，并且该选项未明确设置，那么元素的step属性值将作为该选项的值使用。

2、Methods

3、Extension Points

  • _buttonHtml()：这个方法返回的HTML用于spinner（微调组件）的递增和递减按钮。 每个按钮都必须给定一个ui-spinner-button的类名 用于相关联的事件工作。
  • _uiSpinnerHtml()：这个方法返回的HTML用于包裹 spinner（微调组件）元素。

4、Events

  • change( event, ui )：当spinner微调器的值改变并且输入元素（input）失去焦点时，该事件触发。
  • create( event, ui )：当spinner微调器创建的时候，该时间触发。
  • spin( event, ui )：在递增/递减的时候，该事件触发（用 当前值和ui.value比较来 确定的微调的方向）。可以取消，以防止被更新值。
  • start( event, ui )：微调开始之前，触发该事件。可以取消，以防止微调。
  • stop( event, ui )：微调结束后，触发该事件。

 

posted on 2020-03-16 14:06  springsnow  阅读(299)  评论(0)  编辑  收藏  举报

导航