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

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

以下的默认配置可以通过$.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 [data-mynamespace-role=page], .ui-mobile [data-mynamespace-role=dialog], .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属性即可，如下：