admin 发表于 2013-8-8 19:16:48

如何修改Jquery Mobile 设置默认选项

以下的默认配置可以通过$.mobile对象重新配置

自定义命名空间

ns (字符, 默认: ""):

      在jQuery Mobile中,甚至可以自定义象HTML5中的data-attribute等系列属性,比如data-role等。这通过自定义命名空间即可实现。比 如可以实现自定义一个名字,变成data-自定义名-role这样的形式。按照“data-属性”格式安排的命名空间,例如:data-role,可以设 置为任何东西,默认为空字符串。如果你包含一个面包屑的话用起来会比较明晰,比如 mynamespace-",会映射到 data-mynamespace-foo="...".

这可以通过$.mobile对象中增加ns属性来指定,如下代码:
  $(document).bind("mobileinit", function() {
  $.mobile.ns = "my-custom-ns";
  });通过上面的代码,建立了一个data-my-customer-ns-role的属性,而不是传统jQuery Mobile中指定的data-role。通过设置自定义的命名空间,可以方便开发者在CSS选择器中进行指定,同时如果要自定义mobile小插件的主 题,则也必须使用自定义命名空间,以示区别。



注意:如果你使用了data-命名空间,你需要在主题的css中手动的更新/覆盖一个选择器。按照以下格式把命名空间并并入到命名空间中。
    .ui-mobile , .ui-mobile , .ui-page { ...


页面初始化

autoInitializePage(布尔值,默认: true)当DOM加载完成时,JQM框架会自动调用$.mobile.initializePage方法。如果设为False,页面page则不会自动初始化,在视觉上就会是隐藏的,直到 $.mobile.initializePage 方法被手动调用。

jQuery Mobile提供了一个叫autoInitializePage的属性,这个属性表示页面是否应该初始化,其默认值为true。然而,如果是继承扩展 了$.mobile对象,开发者则可以将该值设置为false,并且在稍晚的时候对页面初始化进行设置。下面的代码中,演示了当其他脚本在运行时,如何暂 时延迟页面的初始化。如果有大量的客户端脚本运行,则一个很好的建议方法是延迟页面的初始化,直到DOM完成加载客户端脚本。<!DOCTYPE HTML>
<html>
<head>
<title>Understanding the jQuery Mobile API</title>
<script type="text/java script" src="jquery.js"></script>
<script type="text/java script">
    $(document).bind("mobileinit", function() {
      $.mobile.autoInitializePage = false;
    });
</script>
<script type="text/java script" src="jquery.mobile.js"></script>
</head>      
<body>
<div data-role="page">
    <div data-role="content">
      <ul data-role="listview" id="my-list"></ul>
    </div>
</div>
<script type="text/java script">
    $('#my-list').html('<li><a href="page-2.html">Link to another page</a></li>');
    $.mobile.autoInitializePage = true;
</script>
</body>
</html>自定义子页的URL键

subPageUrlKey (字符串,默认: "ui-page")

当在jQuery Mobile中引用子页时,默认使用的是ui-page做为KEY标识。开发者可以通过$.mobile对象的subPageUrlKey去重新设置,比 如如果定义了subPageUrlKey为my-page,则默认的子页引用将从web-page.html&ui-page=value改为 web-page.html&my-page=value,这样做的一个好处是开发者可让url更友善更容易维护。

url参数用来指向组件产生的子页面(比如生成的嵌套的列表)。会被转义为example.html&ui-page=subpageIdentifier。Jquery Mobile会把 &ui-page=之前的部分用来向子页面的url地址发出ajax请求。


设置历史记录

nonHistorySelectors (字符串, 默认: "dialog")

对于带有 data-rel 属性的a标签链接,或 data-role 属性的页面,如果选择器与之匹配,则他们不会在历史记录中被追踪 (即它们不会在location.hash中被更新也不会被浏览器历史所标记).


设置当前激活页面的样式

activePageClass (字符串, 默认: "ui-page-active"):给当前页面(包括转场中的) 分配class。

当使用了jQuery Mobile后,默认当前激活页面中的ui-page元素都会使用框架默认的样式中定义的ui-page-active,如果要对其进行修改,可以设置$.mobile对象中的activePageClass属性,比如:$(document).bind("mobileinit", function(){
  $.mobile.activePageClass="ui-page-custom";
});其中ui-page-custome则为用户自定义的样式。


设置当前激活页面的按钮

activeBtnClass (字符串, 默认: "ui-page-active"):给活动状态的按钮分配class值,该class值必须在css框架中存。设置ajax

ajaxEnabled (布尔值, 默认: true):Jquery Mobile 会自动通过ajax处理链接点击以及表单提交。如果无法处理,url hash 监听将会被禁用,url也会像常规那样发出HTTP 请求.


ajaxLinksEnabled (布尔值, 默认: true):可行时,Jquery Mobile 就会自动通过ajax处理链接的点击。


ajaxFormsEnabled (布尔值, 默认: true):可行时,Jquery Mobile 就会自动通过ajax处理表单的提交。

设置哈希值

hashListeningEnabled (布尔值, 默认: true)

Jquery Mobile 会自动监听与处理 location.hash的改变。禁用它会防止Jquery Mobile处理 location.hash的改变。使你可以自己处理他们,或者在文档中用完整的链接地址指到一个特定的id值上。


设置默认的转场效果

defaultTransition (字符串, 默认: 'slide'):设定使用AJAX进行页面转场的默认的转场效果。设为"none"的话则默认没有转场的动画。

默认的jQuery Mobile的页面和对话框的效果都是通过ajax实现的。默认的页面切换效果是幻灯片切换,默认的对话框出现的效果是弹出。如果需要改变这些效果的话 ,同样是如下代码所示,设置$.mobile对象的defaultPageTransition和defaultDialogTransition属性就 可以了。 $(document).bind("mobileinit", function() {
  $.mobile.defaultPageTransition = "fade";
  $.mobile.defaultDialogTransition = "fade";
 });
jQuery Mobile提供了6种效果供用户选择,分别是:slide, slideup, slidedown, pop, fade, 和flip,用户可以按照上面的方法进行设置。


设置加载时默认信息

loadingMessage (字符串, 默认: "loading"):设置页面加载时显示的文本. 如果设置为false,将不会显示任何文字。

加载信息会在加载页面时显示给用户看,要更改这个设置,只需要修改$.mobile对象的loadingMessage属性即可,如下:  $(document).bind("mobileinit", function() {
  $.mobile.loadingMessage = "Please wait";
  });设置加载时错误信息

pageLoadErrorMessage (字符串, 默认: "Error Loading Page"):通过ajax加载页面失败时出现的文本信息。$(document).bind("mobileinit", function() {
  $.mobile.pageLoadErrorMessage = 'Sorry, something went wrong. Please try again.';
});设置页面的最小的卷动距离

minScrollBack (字符串,默认:'150'):返回一个页面的最小的卷动距离。

gradeA (返回一个布尔值, 默认: 返回$.support.mediaquery的值):浏览器必须符合所有支持的条件才会返回 true.


phonegap100 发表于 2013-9-27 17:21:21

沙发!沙发!

phonegap100 发表于 2013-10-1 15:19:42

路过,支持一下啦

小雪 发表于 2013-10-4 03:49:02

好好 学习了 确实不错

uqobk8216 发表于 2013-10-5 17:53:19

我是来刷分的,嘿嘿顺便学习一下

admin 发表于 2013-10-7 08:55:20

我是来刷分的,嘿嘿顺便学习一下

phonegap100 发表于 2013-10-9 01:32:21

学习了,不错,讲的太有道理了
页: [1]
查看完整版本: 如何修改Jquery Mobile 设置默认选项