注意,从 v0.2.1 开始,初始化方法变成了 $.init()
, $.config.autoInit = false;
,也就是默认不会调用 $.init
方法。现在需要自己手动调用 $.init
,他会调用 $.initPage 方法初始化页面组件,并且触发一个 pageInit
事件,所以请确保在所有的 pageInit
事件绑定之后再调用 $.init()
方法。
请不要修改 $.init
方法,这个方法是MSUI提供好的,调用它就会初始化页面。
如果设置了 $.config.autoInit = true;
,那么在 document.onload的时候就会执行 $.init
方法,从而触发 pageInit
事件,如果在这之后监听了 pageInit 事件是无法被执行的。强烈建议不要设置为true,而是在绑定完所有的 pageInit
事件之后,再调用 $.init
方法
关于如何初始化,可以参考demos中的写法
我们提供了一些全局配置,可以在初始化之前通过这些配置改变一些默认行为。
在引入JS之前通过一个 $.config
变量来改变默认配置:
从 v0.2.1 版本开始, autoInit
默认为 false
参数名 | 默认值 | 说明 |
---|---|---|
autoInit | false | 在 document.onload 之后自动调用 $.init 方法。如果你的页面内容是异步加载的,应该关闭这个配置,并且在加载完成之后手动调用 $.init |
router | true | 默认启用MSUI内置的Router功能。如果想关闭此功能,在页面加载MSUI之前配置$.config.router = false 即可。 |
showPageLoadingIndicator | true | 在加载新页面过程中显示一个加载指示器。 |
swipePanel | "left" | 是否可以通过左右滑动打开侧栏,一次只能指定一个方向。 |
swipePanelOnlyClose | true | 只允许滑动关闭侧栏,不允许滑动打开。 |