JQUERY MOBILE 1.0 BETA 3 中文基础——配置项

配置项

在这个版本中JQM的默认配置项更加的完善了,作为里程碑的版本,配置项中的属性使项目开发更加的灵活可控。

ns:(字符) 默认:””

自定义属性命名空间,防止和其他的命名空间冲突。将[data-属性]的命名空间变更为[data-‘自定义字符’属性]。

例如:

程序代码 程序代码
$(document).bind("mobileinit", function(){ $.extend($.mobile , { ns: ‘eddy-‘ }); });

注:声明后需要使用新的命名空间来定义属性,如:data-eddy-role

autoInitializePage:(布尔)默认:true

在DOM加载完成后是否立即调用$.mobile.initializePage对页面进行自动渲染。如果设置为false,页面将不会被立即渲染,并且保持隐藏状态。直到手动声明$.mobile.initializePage页面才会开始渲染,这样可以方便开发者控制异步操作完成后才开始渲染页面,避免动态元素渲染失败的问题。

程序代码 程序代码
$(document).bind("mobileinit", function(){ $.extend($.mobile , { autoInitializePage: false }); });


subPageUrlKey:(字符)默认:” ui-page”

用于设置引用子页面时哈希表中的标识,Url参数用来引用有JQM生成的子页面,例如example.html&ui-page=subpageldentifir。在&ui-page=前的部分被JQM框架用来向子页面所在的Url发送一个Ajax请求。

例如:

程序代码 程序代码
$(document).bind("mobileinit", function(){ $.extend($.mobile , { subPageUrlKey: ‘ui-eddypage’ }); });

注:’&ui-page=’将被转换为’&ui-eddypage=’

activePageClass:(字符)默认:” ui-page-active”

处于活动状态的页面的Class名称,用于自定义活动状态的页面的样式引用。在自定义这个样式到时候必须要在样式中声明以下属性:

“display:block !important; overflow:visible !important;”。

注:不熟悉JQM的CSS框架的朋友经常会遇到自定义的样式不起作用的情况,这一般是由于自定义的样式和原有CSS框架的继承关系不同引起的,可以在不起作用的样式后面加上!important来提高自定义样式的优先级。

activeBtnClass:(字符)默认:” ui-btn-active”

按钮在处于活动状态时的样式,包括按钮形态的元素被点击、激活时的显示效果。用于自定义样式风格。

ajaxEnabled:(布尔)默认:true

在点击链接和提交按钮时,是否使用Ajax方式加载界面和提交数据,如果设置为false,链接和提交方式将会使用html原生的跳转和提交方式。

hashListeningEnabled:(布尔)默认:true

设置JQM是否自动监听和处理location.hash的变化,如果设置为false,你将可以使用手动的方式来处理hash的变化,或者简单的使用链接地址进行跳转,在一个文件中则使用ID标记的方式来切换页面。

defaultPageTransition:(字符)默认:” slide”

设置默认的页面切换效果,如果设置为”none”,页面切换将没有效果。

可选的效果:
参数

备注

slide

左右滑入

slideup

由下向上滑入

slidedown

由上向下滑入

pop

由中心展开

fade

渐显

flip

翻转

注:由于浏览器的支持程度问题,有些效果在某些浏览器中不支持

touchOverflowEnabled:(布尔)默认:false

是否使用设备的原生区域滚动特性,除了iOS5之外大部分的设备还不支持原生的区域滚动特性。

defaultDialogTransition:(字符)默认:”pop”

设置Ajax对话框的弹出效果,如果设置为”none”,则没有过渡效果。可选的效果与defaultPageTransition属性相同

minScrollBack:(字符)默认:150

当滚动超出所设置的高度时才会触发滚动位置记忆功能,当滚动高度没有超过所设置的高度时,当后退到该页面滚动条会到达顶部。以此设置来减小位置记忆的数据量。

loadingMessage:(字符)默认:” loading”

设置在页面加载时出现的提示框中的文本,如果设置为false,将不显示提示框。

pageLoadErrorMessage:(字符)默认:” Error Loading Page”

设置在Ajax加载失败后出现的提示框中的文字内容。

gradeA:(函数返回一个布尔值)默认:$.support.mediaquery

用于判断浏览器是否属于A级浏览器。布尔类型,默认$.support.mediaquery用于返回这个布尔值。

文章来自: 本站原创
引用通告: 查看所有引用 | 我要引用此文章
Tags: jQuery Mobile 1.0 BETA 3 中文基础 配置项
相关日志:
评论: 0 | 引用: 0 | 查看次数: 5110
发表评论
昵 称:
密 码: 游客发言不需要密码.
内 容:
验证码: 验证码
选 项:
虽然发表评论不用注册,但是为了保护您的发言权,建议您注册帐号.
字数限制 300 字 | UBB代码 关闭 | [img]标签 关闭