Framework7(05: Page,路由,页面刷新)

1.路由器 JS API

Framework7 中的路由器使用非常灵活,他可以有多种方式来处理Page:

  • Ajax Pages,从一个指定的URL 加载页面,通常是另外一个页面的文件地址(默认行为)。
  • 通过JS API 创建和加载 动态页面
  • 如果你的页面已经写在DOM中了,那么你可以直接使用 内联页面 ,而不用再去加载。
  • 可以加载使用 Template7 编写的模板
  • 可以在你的应用中混合使用所有上面的这些方法。

视图是应用中的一个独立部分,她有自己的设置、页面切换和浏览历史路由器也是初始化之后的视图(View)中的一部分,所以你使用路由器之前必须要记得先初始化视图(使用myApp.addView()方法)

2.视图中页面切换相关方法:

在视图中主要有两个路由器方法:

  • mainView.router.load(options) - 把一个页面加载到当前视图
  • mainView.router.back(options) - 这个方法会触发一个反向的动画并回到上一个页面,也就是浏览历史上的回退

上面这些方法都接受一个options对象作为参数,这个参数有很多属性。urlcontentcontext 等等。

3.视图中页面切换的快捷方式

  • 加载新页面的方法:
    mainView.router.loadPage(url)- 加载指定的页面到视图中。其实和你在页面中点击一个链接是一样的效果。
    url - 需要加载的页面的URL
    mainView.router.loadContent(content)- 把动态生成的内容当做一个页面加载.
    content - string or HTMLElement or [jQuery/Zepto/DOM7 collection] or [array of HTMLElement] - 需要加载的内容

4.重新加载当前页面的方法:

  • mainView.router.reloadPage(url) - 重新加载指定的页面到视图的当前页面。同时也会修改视图的浏览历史,把最后一条记录替换成指定的URL
    url - 需要加载页面的URL
  • mainView.router.reloadContent(content)- 重新加载指定的内容到视图的当前页面。同时也会修改视图的浏览历史,把最后一条记录替换成指定的URL
    content - string or HTMLElement or [jQuery/Zepto/DOM7 collection] or [array of HTMLElement]- 需要加载的内容

5.重新加载上一个页面的方法(如果视图的DOM中有两个页面):

  • mainView.router.reloadPreviousPage(url)- r重新加载指定的页面到视图的上一个页面。同时也会修改视图的浏览历史,把最后一条记录替换成指定的URL

  • mainView.router.reloadPreviousContent(content) - 重新加载指定的内容到视图的上一个页面。同时也会修改视图的浏览历史,把最后一条记录替换成指定的URL

6.刷新页面的方法:

  • mainView.router.refreshPage() - 刷新视图的当前页面。和你调用.reloadPage
    方法并且传入当前页面的URL是一样的效果
  • mainView.router.refreshPreviousPage() - 刷新视图的上一个页面。和你调用.reloadPreviousPage
    方法并且传入上一个页面的URL是一样的效果

7.Ajax页面
默认情况下 Framework7 会使用 Ajax 加载所有的页面,除了带有 external class的链接(<a href="somepage.html" class="external">)和没有正确 href 值的链接(比如是空的或者是 #)。

初始化 时候传递不同的 ajaxLinks 参数可以改变这个行为。

所以我们如果需要创建一个链接指向 about.html,我们只需要按照平时一样写 <a>标签就可以:
<a href="about.html">Go to About page</a>

当我们点击这个链接的时候,Framework7会通过Ajax获取 about.html,解析它的内容,然后把它插入到DOM中,并且做一个动画切换到这个新页面。

  1. Page 内部的结构

因为Framework7有一个非常聪明的解析器,所以在内部页面中我们不需要完整的HTML结构(head,body,views,pages等)。比如 about.html的内容:

<!-- That is all we have in about.html file -->
<div class="page" data-page="about">
     ... About page content goes here
</div>

重点是,Framework7解析器会尝试在ajax加载的页面中寻找 <div class="page">,所以我们不需要完整的HTML结构。当然这不是强制的,你可以写出完整的页面结构。

9.多个Page的结构

两个view应该和主页中的view有相同的class。这样Framework7就知道应该哪一个page应该放在哪一个view中。

10.动态导航栏的文件结构

nav回退,

<div class="page" data-page="about">     
    <!-- Just add additional "back" class to link --> 
    <a href="index.html" class="back"> 
        Go back to home page 
    </a>
</div>

关于后退链接几个需要注意的地方:

  • 如果在浏览历史中有页面,Framework7会忽略掉 href 属性中的值。
  • 如果在浏览历史中没有页面(比如你在首页点了后退),Framework7会加载href属性指定的url。你无法改变上述行为。

对后退链接来说, href 属性不是必须得,但是为了向下兼容,最好还是写上。

11.滑动后退(iOS only)

如果你启用了 "swipeBackPage" 应用参数,那么你可以通过从左向右滑动来后退到上一个页面。但是有时候你会想在某些页面中禁用这个行为,这种情况下你只需要加一个 no-swipeback class 即可。

<div class="page no-swipeback">
     ...
</div> 

12.取消/增加页面切换动画

有时候你在加载页面或者后退的时候需要立刻执行,不想要一个切换的动画效果,可以通过增加一个 "no-animation" class 在链接上即可。

div class="page" data-page="about"> 
    <!-- Add additional "no-anmation" class to link to disable animated page transition --> 
   <a href="about.html" class="no-animation"> 
        Load About page immediately 
   </a>
   <!-- The same rule for back link --> 
   <a href="index.html" class="back no-animation"> 
        Go back immediately 
   </a>
</div>

如果我们已经全局禁用了动画,但是在某些链接上希望启用这些动画,那么我们可以给链接加上 "with-animation" class。

13.通过 data 标签配置更多选项

有时候我们希望在某些链接上有更多的配置,我们可以使用作为data-属性来配置所有在 视图链接方法中的参数。
<a href="about.html" data-reload="true" data-ignore-cache="true">Refresh page</a>

14.用javascript加载page,和回退page

15.结论

Framework7 中,页面之间的链接路由都是很简单的,你只需要记住:

  • 你需要使用普通的 <a>标签,她有一个href属性指向你需要加载的页面。
  • 通过ajax加载的页面不需要有完整的HTML结构。只需要有 <div class="page"> (和 <div class="navbar"> 如果你需要动态的滚动条)
  • 如果你在同一个文件中有多个Page,把他们用 <div class="view"> 包裹起来,并且给每一个View设置好正确的class
  • 只需给一个链接加上 back class (<a href="index.html" class="back">),她就会自动变成一个后退链接。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,014评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,796评论 3 386
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,484评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,830评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,946评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,114评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,182评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,927评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,369评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,678评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,832评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,533评论 4 335
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,166评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,885评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,128评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,659评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,738评论 2 351

推荐阅读更多精彩内容