初始化SUI

优质

小牛编辑

125浏览

2023-12-01

注意，必须执行初始化方法: $.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	只允许滑动关闭侧栏，不允许滑动打开。