bui.input Class
Constructor
bui.input
-
option
Parameters:
-
optionObject[description]
-
idString[事件的父级]
-
[uid]String optional1.6.6新增，实例的自定义唯一名字，用于命令式调用
-
[target]String optional目标是input
-
[onChange]Function optional1.5.6新增 改变以后触发,无需修改event的参数
-
[event]String optional类型，默认“input” || "change"
-
[iconClass]String optional1.5.6改为支持多图标样式名,默认:".icon-remove", 多个格式应该为: ".newfont.newfont-remove"
-
[showIcon]Boolean optional是否显示图标,会影响到callback回调, 默认: true(显示图标)|false(隐藏图标)
-
[showLength]Boolean optional是否显示长度,结合maxLength参数, 默认: false(隐藏长度)|true(显示长度)
-
[maxLength]Number optional输入的长度, 0不限制 ,默认:0
-
[onInput]Function optional输入的回调
-
[onBlur]Function optional离开的回调, 必须返回 true 的时候, value方法才能拿到值. 如果 return fasle, 则value 方法拿不到值,用于校验
-
[onFocus]Function optional聚焦的回调
-
[onBeforeInit]Function optional1.5.1新增 初始化前触发
-
[onInited]Function optional1.5.1新增 初始化以后触发
-
[callback]Function optional点击图标的回调
-
Example:
html:
<div class="bui-input password-input">
<input id="password" type="password" placeholder="密码">
</div>
js:
var uiInput = bui.input({
id: ".password-input",
callback: function (e) {
// 点击删除按钮清空
$("#password").val('');
$(e.target).hide();
}
})
Methods
empty
()
清空值, 在一组目标下，在 callback 里面，调用 this.empty(e), 会只单独清除一个
Example:
uiInput.epmty();
init
-
[option]
初始化方法,用于重新初始化结构,事件只初始化一次
Parameters:
-
[option]Object optional参数控件本身
option
-
[key] -
[value]
获取设置参数
Parameters:
-
[key]String | object optional不传则获取所有参数, 类型为string,没有第2个参数则获取某个参数
-
[value]String | number | boolean | function optional设置参数的时候要传,设置多个参数不用传,获取参数的时候也不用传
Example:
//获取所有参数
var option = uiInput.option();
//获取某个参数
var id = uiInput.option( "id" );
reset
()
重置
Example:
uiInput.reset();
toggleType
()
切换text跟password, 用于密码的展示
Example:
uiInput.toggleType();
value
()
获取并设置值, 只能单个操作
Example:
var val = uiInput.value();
values
-
[vals]
批量获取设置值
Parameters:
-
[vals]Array optional设置值
Example:
// 取值
var vals = uiInput.values();
// 设置值
对应的html:
<div class="bui-input"><input id="user" type="text" name="username"></div>
uiInput.values([{
id:"user", // id 或者 name 进行区分，name也是唯一值
name:"username",
value:"easybui"
}]);
widget
-
[name]
获取依赖的控件
Parameters:
-
[name]String optional依赖控件名
Example:
//获取依赖控件
var uiInputWidget = uiInput.widget();
Events
off
为控件取消绑定事件
Event Payload:
-
[type]String optional事件类型: "click"(搜索时触发) | "focus"(移除关键字时触发) | "input"(每次输入时触发)
-
[callback]Function optional绑定的事件, this 为当前点击的菜单
Example:
uiInput.off("input");
on
为控件绑定事件
Event Payload:
-
[type]String optional事件类型: "click"(搜索时触发) | "focus"(移除关键字时触发) | "input"(每次输入时触发)
-
[callback]Function optional绑定的事件, this 为当前点击的菜单
Example:
uiInput.on("input",function () {
// 点击的菜单
console.log(this);
});