前端UI库SUI Mobile 不可不知的坑

背景介绍:

所在公司由于技术团队小,开发任务紧,领导把移动端的项目外包了。外包团队的工程师使用阿里前端团队出品的SUI Mobile的前端UI库来开发,所以,我也就理所当然地去学习官方文档(http://m.sui.taobao.org/)。

这个UI库,其实是山寨Framework7的。优点是足够地轻量级、且提供中文文档。缺点是由于核心开发人员已经离开阿里,本项目已经将近一年没有更新、无人维护了,基本没有形成社区。该作者离职后把SUIMobile项目改了名,叫做Light7(http://www.light7.cn/),修复了部分bug。觉得SUI Mobile不错的,可以考虑使用Light7.

第一个坑:必须显式地调用$.init()方法。

官方文档里(http://m.sui.taobao.org/components/)有这么一句话:

如果没有这样显式地调用初始化方法的话,JavaScript脚本很有可能会不执行。当我拿到外包团队提交的代码的时候,我是崩溃的。因为有许多莫名其妙的bug。最后试着加了这段代码之后,发现JavaScript才正常地调用了。

第二个坑:建议全局禁用自带的路由$.config = {router: false}。

官方文档(http://m.sui.taobao.org/components/#router)上介绍说:

`Router默认开启,会自动拦截所有链接的Touch行为,如果希望一个链接走浏览器原生跳转而不使用router,可以在链接上增加class="external"或者自定义属性,如xxx。如果需要禁用路由功能,那么可以在 zepto 之后, msui 之前使用$.config = {router: false}来禁用.`

我遇到的情况是这样的:首页有个轮播,第一次进来首页可以正常播放。当用户从首页进到其他页面之后,通过顶部的返回按钮或者浏览器的后退键回到首页时,轮播是卡住的。调试代码后,发现返回后,js脚本是不执行的。试着全局禁用了路由之后,轮播可以自动播放了,js脚本都能正常执行了。


第三个坑:只支持Zepto.js 不支持jQuery。

众所周知,Zepto.js虽然比jQuery轻量,但基于jQuery的插件众多,可以为我们节省不少重复造轮子的精力。同时,jQuery效率更高,开发者也更熟悉jQuery的方法。然而SUI Mobile只支持Zepto.js,这就尴尬了。SUI Mobile在GitHub上有这个issue(https://github.com/sdc-alibaba/SUI-Mobile/issues/143)。

我们这个项目的外包团队也许是因为这个原因同时使用了Zepto.js 和jQuery两个类库。由于两个类库都是用“$”,会导致了莫名其妙的bug。所以,如果你也遇到这种情况,不得不使用两个库的时候,那么使用Zepto来替换这个UI库里提供的js方法中的“$”,来解决命名冲突。

当然,如果可以,建议使用Light7来代替SUI Mobile。因为Light7是支持jQuery的。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,636评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,890评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,680评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,766评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,665评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,045评论 1 276
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,515评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,182评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,334评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,274评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,319评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,002评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,599评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,675评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,917评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,309评论 2 345
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,885评论 2 341

推荐阅读更多精彩内容