Show:

bui.loading Class

Module: UI

进度条

有appendTo的时候是在id下的操作,没有的是在body下的,可以控制是否显示文本,或者自动关闭,甚至你还可以自定义你的进度条模板

预览地址: demo

方法说明:

show: 显示加载,如果存在则显示,如果不存在则创建
hide: 隐藏加载,如果存在则隐藏,不存在则没有操作
pause: 暂停滚动
text: 修改文本
showRing: 显示圈圈
hideRing: 隐藏圈圈
start: 显示加载,重新创建
stop: 移除加载
option: 获取设置参数
widget: 获取依赖控件
控件预览

Constructor

bui.loading

(
  • [option]
)

Parameters:

  • [option] Object optional
    • [uid] String optional

      1.6.6新增,实例的自定义唯一名字,用于命令式调用

    • [appendTo] String optional

      appendTo是进度条生成的位置ID,默认在body标签下

    • [opacity] Number optional

      遮罩透明度,默认为0 ,值为 0-1 之间,如 0.1

    • [className] Number optional

      1.7.6新增 自定义进度条样式,如:"loading-router"

    • [width] Number optional

      宽度

    • [height] Number optional

      高度

    • [text] String optional

      加载的文本

    • [autoTrigger] Boolean optional

      是否自动触发 默认 true | false

    • [onlyText] Boolean optional

      是否只显示文本

    • [autoClose] Boolean optional

      默认true | false 是否点击自动关闭

    • [display] String optional

      inline

    • [timeout] String optional

      since1.3.0 是否开启定时关闭 默认0,大于零则开启定时关闭

    • [zIndex] String optional

      since1.3.0 默认""的时候为130

    • [onBeforeInit] Function optional

      1.5.1新增 初始化前触发

    • [onInited] Function optional

      1.5.1新增 初始化以后触发

    • callback Function

      回调

Example:

 // 效果1:
                                           var uiLoading = bui.loading();
                                           //开启进度条
                                           //uiLoading.show();
                                           //关闭进度条
                                           //uiLoading.hide();
                                    
                                           // 效果2:
                                           var uiLoading = bui.loading({
                                               appendTo:"#loading",
                                               display: "block",
                                               width: 30,
                                               height: 30,
                                               opacity: 0,
                                               callback: function (argument) {
                                                   console.log("clickloading")
                                               }
                                           });
                                    

Methods

destroy

(
  • [bool]
)

Defined in src/scripts/ui/bui.loading.js:561

Available since 1.4.2

[销毁控件]

Parameters:

  • [bool] Boolean optional

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

Example:

       //销毁
                                                       uiLoading.destroy();
                                                

el

() chainable

Defined in src/scripts/ui/bui.loading.js:335

Available since 1.8.0

获取操作的元素

Example:

       var uiLoading = bui.loading();
                                                           uiLoading.el();
                                                

hide

() chainable

隐藏loading

Example:

       var uiLoading = bui.loading();
                                                           uiLoading.hide();
                                                

hideRing

() chainable

隐藏圈圈

Example:

       var uiLoading = bui.loading();
                                                           uiLoading.hideRing();
                                                

init

(
  • [option]
)
chainable

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

Parameters:

  • [option] Object optional

    参数控件本身

isLoading

() chainable

Defined in src/scripts/ui/bui.loading.js:396

Available since 1.5.1

是否正在展示

Example:

       var uiLoading = bui.loading();
                                                           uiLoading.isLoading();
                                                

option

(
  • [key]
  • [value]
)
chainable

获取设置参数

Parameters:

  • [key] String | object optional

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

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

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

Example:

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

pause

() chainable

Defined in src/scripts/ui/bui.loading.js:442

Available since 1.3.0

暂停loading

Example:

       var uiLoading = bui.loading();
                                                           uiLoading.pause();
                                                

show

() chainable

显示loading

Example:

       var uiLoading = bui.loading();
                                                           uiLoading.show();
                                                

showRing

() chainable

显示圈圈

Example:

           uiLoading.showRing();
                                                

start

() chainable

显示loading , 参数参考loading的初始化, 每次都重新创建

Example:

       var uiLoading = bui.loading();
                                                           uiLoading.start();
                                                

stop

() chainable

关闭并移除loading

Example:

       var uiLoading = bui.loading();
                                                           uiLoading.stop();
                                                

text

() chainable

修改文本

Example:

       var uiLoading = bui.loading();
                                                           uiLoading.text("正在加载");
                                                

widget

(
  • [name]
)

获取依赖的控件

Parameters:

  • [name] String optional

    依赖控件名 mask

Example:

       //获取依赖控件
                                                       var uiLoadingWidget = uiLoading.widget();
                                                

Events

off

Defined in src/scripts/ui/bui.loading.js:658

Available since 1.3.0

为控件取消绑定事件

Event Payload:

  • [type] String optional

    事件类型: "show" | "hide" | "pause" (暂停转圈)| "start" (开始转圈) | "remove" (删除时)

  • [callback] Function optional

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

Example:

       uiLoading.off("show");
                                                

on

Defined in src/scripts/ui/bui.loading.js:638

Available since 1.3.0

为控件绑定事件

Event Payload:

  • [type] String optional

    事件类型: "show" | "hide" | "pause" (暂停转圈)| "start" (开始转圈) | "remove" (删除时)

  • [callback] Function optional

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

Example:

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