阻塞

简介

当整个页面或页面局部（通过ajax）更新时，需要阻塞用户的操作；根据用户指定的区域提供
1、遮罩层
2、缺省的和可自定义的动画图片
3、动画下方的文字可随时自定义
4、通过jquery插件方式显示和去除上述功能

使用方法

2.1 方法&事件使用 EAS7.5+

//对id为activity_pane的div区域加阻塞层
waf.block.show({
  target:waf('#activity_pane'),//如果要阻塞body，此属性可不指定
  text:showBlockTempStr
});

//去掉id为activity_pane的div区域的阻塞层
waf.block.hide(waf('#activity_pane'));//如果阻塞的是body，则不需参数

属性说明

target Integer 缺省值: waf(‘body’) 不可以在运行期改变 EAS7.5+

被遮罩的区域。
如：target:waf(‘#divID’)
如果阻塞的是body，则不用设置此属性

text String 缺省值: null EAS7.5+

动画图片下方的显示的文字内容。
    如：text:’加载中，请稍候…‘
    阻塞层显示后，如下修改显示的文字:waf.block.text(waf(‘#divID’),’50%’)
    如果阻塞的是body，则waf.block.text(‘50%’)即可。

addClass String 缺省值: null 不可以在运行期改变 EAS7.5+

设置图片和文字层的样式。
如：addClass：’loading-indicator-bars’
样式定义如下：.loading-indicator-bars{background-image:url(‘images/loading-bars.gif’);width:150px;}

方法说明

show 参数: (json) 返回值类型: (none) EAS7.5+

给指定区域增加阻塞层效果.
如：waf.block.show({ target:waf(‘#divID’), text:’loading’})
如果要阻塞body，则waf.block.show({ text:’loading’})

hide 参数: (jquery对象) 返回值类型: (none) EAS7.5+

去除指定区域的阻塞层，参数为被阻塞区域的对象
如：waf.block.hide(waf(‘#divID’))
如果阻塞区域为body，则waf.block.hide()

getIndicateDiv 参数: (none) 返回值类型: (jquery对象) EAS7.5+

获得阻塞层中图片和文字层所在的div对象,以便于对其进行个性化控制
如：varindicatDiv=waf.block.getIndicateDiv(‘#divID’)
如果阻塞区域为body，则var indicatDiv = waf.block.getIndicateDiv()

事件说明

afterShow 参数:(callback_options) 返回值类型: (none) EAS7.5+

阻塞显示后执行的js函数.
参数说明：
- callback_options中包括：overlay，indicator和element的jquery对象.
返回值说明：无

样例集合

阻塞示例: