BUI

其它版本:

API for BUI 1.5.1

Show:

bui.number Class

数字增减条

支持静态初始化,常用于购物车

预览地址: demo

方法说明:

prev: 执行减少操作
next: 执行增加操作
value: 不传参则获取,传参则设置
disabled: 禁止输入修改
option: 获取设置参数
widget: 获取依赖控件
控件预览

Constructor

bui.number

(
  • option
)

Parameters:

  • option Object
    • [id] String optional

      [控件id, 不传则全部初始化,可以通过查找input的值设置.]

    • [min] Number optional

      [最小值, 属性的 data-min 会优先]

    • [max] Number optional

      [最大值, 属性的 data-max 会优先, 默认:100 ]

    • [step] Number optional

      [一次增加多少]

    • [value] String optional

      [初始值]

    • [name] String optional

      [某一组的名称]

    • [disabled] Boolean optional

      [ 是否可以输入修改 false | true ]

    • [render] Boolean optional

      [ 是否动态填充, true | false ]

    • [onInput] Function optional

      [ 1.4.3新增 输入数值的时候的实时校验处理 ]

    • [onChange] Function optional

      [ 1.5新增 改变的时候触发,初始值的时候不触发 ]

    • [onBeforeInit] Function optional

      [ 1.5.1新增 初始化前触发 ]

    • [onInited] Function optional

      [ 1.5.1新增 初始化以后触发 ]

    • [callback] Function optional

      [ 点击按钮的回调 ]

Example:

html:

       <div id="number" class="bui-number"></div>

js:

       // 初始化
       var uiNumber = bui.number({
                       id:'#number'
           });
           //获取值
           uiNumber.value(); 

Item Index

Events

Methods

destroy

(
  • [bool]
)

[销毁控件]

Parameters:

  • [bool] Boolean optional

    [ 默认: false 销毁部分 | true 销毁全部 ]

Example:

       //销毁
       uiNumber.destroy();

disabled

(
  • [bool]
)
chainable

禁止输入

Parameters:

  • [bool] Boolean optional

    [禁止输入 true | false]

Example:

       //获取值
       uiNumber.disabled();

init

(
  • [option]
)
chainable

初始化方法,用于重新初始化结构,事件只初始化一次

Parameters:

  • [option] Object optional

    [参数控件本身]

next

() chainable

增加值

Example:

       //增加
       uiNumber.next();

option

(
  • [key]
  • [value]
)
chainable

获取设置参数

Parameters:

  • [key] String | object optional

    [ 不传则获取所有参数, 类型为string,没有第2个参数则获取某个参数 ]

  • [value] String | number | boolean | function optional

    [ 设置参数的时候要传,设置多个参数不用传,获取参数的时候也不用传 ]

Example:

       //获取所有参数
        //获取所有参数
       var option = uiNumber.option();

       //获取某个参数
       var id = uiNumber.option( "id" );

       //修改一个参数
       uiNumber.option( "min",10 );

       //修改多个参数
       uiNumber.option( {"min":10} );

prev

() chainable

减少值

Example:

       //减少
       uiNumber.prev();

value

(
  • [num]
)
chainable

设置或者获取值

Parameters:

  • [num] String optional

    [设置值]

Example:

       //设置值
       uiNumber.value("110");

       //获取值
       uiNumber.value();

values

(
  • [num]
)
Array chainable

获取设置多个值

Parameters:

  • [num] String optional

    [设置值]

Returns:

Array:

[ 返回 [{id:"",value:""}] ]

Example:

       uiNumber.values();

widget

(
  • [name]
)

获取依赖的控件

Parameters:

  • [name] String optional

    [ 依赖控件名 ]

Example:

       //获取依赖控件
       var uiNumberWidget = uiNumber.widget();

Events

off

为控件取消绑定事件

Event Payload:

  • [type] String optional

    [ 事件类型: "prev" | "next" | "change" 符合条件时触发改变 ]

  • [callback] Function optional

    [ 绑定的事件, this 为当前点击的菜单 ]

Example:

       uiNumber.off("change");

on

为控件绑定事件

Event Payload:

  • [type] String optional

    [ 事件类型: "prev" | "next" | "change" 符合条件时触发改变 ]

  • [callback] Function optional

    [ 绑定的事件, this 为当前点击的菜单 ]

Example:

       uiNumber.on("change",function () {
           // 点击的菜单
           console.log(this);
       });