组件功能介绍:
1、调用方式简单,直接使用ymPrompt.alert()的方式调用,传入相应的参数即可。
2、兼容IE6.0+、FF1.5+、Opear9+(在Opear下显示有一个小缺陷),兼容HTML4/XHTML1.0页面渲染模式。
3、完全的CSS皮肤定制功能,所有外观包括显示图标/关闭按钮等都可以通过css设置。目前提供了五种皮肤,Vista、QQ、dmm-green、ExtBlue和BlackColl。有兴趣可以修改样式表文件定义新的皮肤。
4、提供四种消息类型。分别为消息提示、成功信息、错误信息、询问信息。
5、弹出消息框时屏蔽页面其它元素的操作,自动隐藏页面select及iframe下select(无限级select隐藏),并遮罩iframe等元素。
6、页面select控件状态还原时保持原状态,即如果原来select就是隐藏的,则消息框弹出并关闭后该select仍保持隐藏状态,而只显示原本显示的select。
7、消息组件弹出时屏蔽除Tab和回车外的几乎所有键盘操作(包括F5),“消息确认框”支持“tab键/左右方向键”切换确定/取消焦点。
8、可以页面加载的任意时间调用,如页面初始化时调用,页面加载完成后调用。
9、支持通过JSON和传统的参数传入方式。如ymprompt.alert('消息内容',300,200,'消息标题',handler)和ymprompt.alert({message:'消息内容',width:300,height:200,title:'消息标题',handler:handler}),这两种写法是等价的。
10、只需要一个回调函数,可捕获确定、取消及关键按钮的点击事件。函数改变了1.0版需要对确定和取消按钮分别写回调函数及不支持关闭事件的缺陷,
11、完全的封装,对外只暴露一个ymPrompt变量,有效防止与使用者程序变量的冲突。
12、程序(js)与样式(css)的完全分离,取消了1.0中自动加载css的功能,用户可根据需要加载对应css样式表单,降低了对样式配置的复杂度。
ymPrompt2.0下载地址:
http://www.ajaxbbs.net/attachment.php?fid=27
演示地址:http://www.ajaxbbs.net/test/ymPrompt2.0/demo.html
调用方法及参数说明:
1、在页面中引入ymPrompt.js。如:<script type="text/javascript" src="ymPrompt.js"></script>
2、在页面中引入对应的皮肤文件的CSS,如:<link rel="stylesheet" type="text/css" href="skin/default/ymPrompt.css" />
3、根据您的需要调用相应的消息函数:
ymPrompt.alert(message,width,height,title,handler,maskAlphaColor,maskAlpha) //消息提示类型
ymPrompt.succeedInfo(....) //成功信息类型
ymPrompt.errorInfo(...) //错误信息类型
ymPrompt.confirmInfo(....) //询问消息类型
四个方法的参数个数及意义完全相同:
message:消息组件要显示的内容,默认为“内容”。
width:消息框的宽度,默认为300。
height:消息框的高度,默认为185。
title:消息组件标题,默认为“标题”
handler:回调函数。当确定/取消/关闭按钮被点击时会触发该函数并传入点击的按钮标识。如ok代表确定,cancel代表取消,close代表关闭
maskAlphaColor:遮罩的颜色,默认为黑色。
maskAlpha:遮罩的透明度,默认为0.1。
参数传入方式包含两种:
第一种即传统的参数传入,按照顺序传入相应的参数值即可,对于不需要设定的值请传入null。如ymPrompt.alert('内容',null,null,'标题')
第二种即JSON的传入方式,需要指定字段名。如ymPrompt({title:'标题',message:'内容'})
4、其他说明:如果觉得“对象.方法”的调用方式比较麻烦,可以采用如下方式简化调用:
在调用之前设定var Alert=ymPrompt.alert。之后就可以使用Alert()的方式进行调用。