BUI

其它版本:

API for BUI 1.6.x

Show:

bui.mask Class

Module: UI

Mask遮罩控件

预览地址: demo

方法说明:

remove: 移除遮罩
show: 显示遮罩,如果不存在则创建再显示
hide: 隐藏遮罩,如果不存在则不操作
option: 获取设置参数
widget: 获取依赖控件
控件预览

Constructor

bui.mask

(
  • [option]
)

Parameters:

  • [option] Object optional
    • [id] [ 遮罩的id, 用于跟其它控件绑定, 默认可以不传] String optional
    • [appendTo] [ 遮罩生成的位置,默认在body标签下] String optional
    • [className] [ 1.5.6新增, 自定义样式名,用于区分多个遮罩的样式处理] String optional
    • [opacity] [ 透明度,小数点] Number optional
    • [autoTrigger] [ 是否自动触发 默认 true | false] Boolean optional
    • [background] [ 背景颜色] String optional
    • [onBeforeInit] [ 1.5.1新增 初始化前触发] Function optional
    • [onInited] [ 1.5.1新增 初始化以后触发] Function optional
    • [callback] [ 回调] Function optional

Example:

方法1:

       // 遮罩初始化
                                       var uiMask = bui.mask();
                                
                                           // 调用 show 方法
                                           uiMask.show();
                                

Item Index

Events

Methods

destroy

(
  • [bool] [ 默认: false 销毁部分 | true 销毁全部]
)

Defined in src/scripts/ui/bui.mask.js:347

Available since 1.4.2

[销毁控件]

Parameters:

  • [bool] [ 默认: false 销毁部分 | true 销毁全部] Boolean optional

Example:

       //销毁
                                                   uiMask.destroy();
                                            

hide

()

隐藏遮罩

Example:

       var uiMask = bui.mask();
                                                       uiMask.hide();
                                            

init

(
  • [option] [参数控件本身]
)
chainable

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

Parameters:

  • [option] [参数控件本身] Object optional

isShow

()

Defined in src/scripts/ui/bui.mask.js:332

Available since 1.3.0

遮罩是否显示

Example:

       var uiMask = bui.mask(),
                                                       isShow = uiMask.isShow();
                                            

option

(
  • [key] [ 不传则获取所有参数, 类型为string,没有第2个参数则获取某个参数]
  • [value] [ 设置参数的时候要传,设置多个参数不用传,获取参数的时候也不用传]
)
chainable

获取设置参数

Parameters:

  • [key] [ 不传则获取所有参数, 类型为string,没有第2个参数则获取某个参数] String | object optional
  • [value] [ 设置参数的时候要传,设置多个参数不用传,获取参数的时候也不用传] String | number | boolean | function optional

Example:

       //获取所有参数
                                                    //获取所有参数
                                                   var option = uiMask.option();
                                            
                                                   //获取某个参数
                                                   var id = uiMask.option( "appendTo" );
                                            
                                                   //修改一个参数
                                                   uiMask.option( "opacity",0.5 );
                                            
                                                   //修改多个参数
                                                   uiMask.option( {"opacity":0.5} );
                                            

remove

() chainable

遮罩移除方法

Example:

       var uiMask = bui.mask();
                                                       uiMask.remove();
                                            

show

()

显示遮罩

Example:

       var uiMask = bui.mask();
                                                       uiMask.show();
                                            

widget

(
  • [name] [ 依赖控件名]
)

获取依赖的控件

Parameters:

  • [name] [ 依赖控件名] String optional

Example:

       //获取依赖控件
                                                   var uiMaskWidget = uiMask.widget();
                                            

Events

off

Defined in src/scripts/ui/bui.mask.js:434

Available since 1.3.0

为控件取消绑定事件

Event Payload:

  • [type] [ 事件类型: "show" | "hide"] String optional
  • [callback] [ 绑定的事件, this 为当前点击的菜单] Function optional

Example:

       uiMask.off("show");
                                            

on

Defined in src/scripts/ui/bui.mask.js:414

Available since 1.3.0

为控件绑定事件

Event Payload:

  • [type] [ 事件类型: "show" | "hide"] String optional
  • [callback] [ 绑定的事件, this 为当前点击的菜单] Function optional

Example:

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