初始化SUI - SUI 移动开发UI库

返回介绍

初始化SUI

发布于 2017-06-10 字数2187 浏览 972 评论 0

注意,必须执行初始化方法: $.init()

他会调用 $.initPage 方法初始化页面组件,并且触发一个 pageInit 事件,所以请确保在所有的 pageInit 事件绑定之后再调用 $.init() 方法。

如果设置了 $.config.autoInit = true;,那么在 document.onload的时候就会执行 $.init方法,从而触发 pageInit事件,如果在这之后监听了 pageInit 事件是无法被执行的。

强烈建议不要设置为true,而是在绑定完所有的 pageInit 事件之后,再调用 $.init方法,关于如何初始化,可以参考demos中的写法

全局配置

我们提供了一些全局配置,可以在初始化之前通过这些配置改变一些默认行为。 在引入JS之前通过一个 $.config 变量来改变默认配置:

<script>
  //打开自动初始化页面的功能
  //建议不要打开自动初始化,而是自己调用 $.init 方法完成初始化
  $.config = {
    autoInit: true
  }
</script>
<script src='sm.min.js'></script>

所有配置项如下:

参数名 默认值 说明
autoInit false document.onload 之后自动调用 $.init 方法。如果你的页面内容是异步加载的,应该关闭这个配置,并且在加载完成之后手动调用 $.init
router true 默认启用MSUI内置的Router功能。如果想关闭此功能,在页面加载MSUI之前配置$.config.router = false 即可。
routerFilter null 当前点击链接是否使用路由功能的自定义过滤器。这是一个函数,实参是当前点击的链接的 Zepto 对象(即 $(‘the-link’)),返回 false 表示不使用路由功能,返回 true 表示进入路由功能后续处理。
showPageLoadingIndicator true 在加载新页面过程中显示一个加载指示器。
swipePanel “left” 是否可以通过左右滑动打开侧栏,一次只能指定一个方向。
swipePanelOnlyClose true 只允许滑动关闭侧栏,不允许滑动打开。

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!