jQuery Mobile中jQuery.mobile.changePage方法使用详解

时间:2021-10-30 19:00:50

jQuery.mobile.changePage方法用的还是很多的。作为一个老手,有必要对jQuery mobile中实用方法做一些总结。系列文章请看jQuery Mobile专栏。jquery.mobile.changepage是过时的jQuery Mobile 1.4.0及将被删除在1.5.0。使用pagecontainer部件的change()法代替。
注意该方法是在内部使用的页面加载和转换作为一个结果,点击一个链接或提交表单时。跳转外部页面全部没有效果,必须是内部的DIV页面才有效果。
jQuery.mobile.changePage( to [, options ] )参数解释说明:
to:字符串类型或Object类型,将要跳转到的目的页面。
options:可选参数,Object类型。其对象内的属性解释如下:
allowSamePageTransition:布尔类型,默认为false。默认情况下,changepage()忽略请求改变当前的活动页面。设置为true,允许请求执行。注意的一些页面转换到另一个页面(changepage请求的页和页是不同的),他们可能不会如预期的动画。
changeHash:布尔类型,默认为true。设置为true时地址栏中的Hash更新会创建一个新的浏览器历史记录的影响。设置为false,传入的页面在浏览器历史替换当前页面,用户导航无法通过浏览器的“后退”按钮回到上一个页面。
data:Object类型或字符串类型,默认为 undefined。跳转页面发送ajax请求的参数。
dataUrl:字符串类型,默认为 undefined。完成页面转换时要更新浏览器地址的URL地址。如不特别指定,则使用页面page元素的data-url属性值。
pageContainer:(jQuery选择器,默认:$.mobile.pageContainer)指定应该包含页面的容器。
reloadPage:布尔类型,默认false。强制刷新页面, 即使当页面容器中的dom元素已经准备好时,也强制刷新。只在changePage()的to参数是一个可用地址的时候。
reverse:布尔类型,默认false。设定页面转场动画的方向,设置为true时将导致反方向的转场。
role:字符串类型,默认为 undefined。显示页面的时候使用data-role值。默认情况下此参数为认:undefined,取决于元素的@data-role属性。
showLoadMsg:布尔类型,默认true。设定加载外部页面时是否显示loading信息。
transition:字符串类型,默认为 $.mobile.defaultPageTransition。过渡到其他页面时呈现。
type:字符串类型,默认为get。只有到to的参数被指定时使用。
使用例子如下:添加changehash:假以避免iframe引起的问题。

    1. $.mobile.changePage( "../resources/us.html", {
    2. transition: "slideup",
    3. changeHash: false
    4. });
    5. $.mobile.changePage( "../resources/results.php", {
    6. type: "post",
    7. data: $( "form#search" ).serialize(),
    8. changeHash: false
    9. });
    10. $.mobile.changePage( "../resources/confirm.html", {
    11. transition: "pop",
    12. reverse: false,
    13. changeHash: false
    14. });
    15. //以slideup效果 跳转到 "about us" 页面
    16. $.mobile.changePage("about/us.html", "slideup");
    17. //以pop效果 跳转到 "confirm" 页面 并且在url hash里不记录其历史
    18. $.mobile.changePage("../alerts/confirm.html", "pop", false, false);
    19. //跳转到 "search results" 页面,提交id为 "search"的表单数据
    20. $.mobile.changePage({url:"searchresults.php" , type:"get" , data: $("form#search").serialize() });
    21. //将页面url,类型,数据定义为变量来传递。
    22. $.mobile.changePage({ url: formresults.php, type: 'get', data:$('form#myform').serialize () });
    23. //使用changepage来加载第三个页面
    24. $.mobile.changePage([$.mobile.activePage.data ('ui.prevPage'), anotherPreviousPage], 'pop');