组件调用方式1(传统参数传入方式): 示例 调用方法
ymPrompt.alert('http://www.qq.com',null,null,'确认要提交吗?',handler)
ymPrompt.succeedInfo($('txt').innerHTML,400,260,null,handler2)
ymPrompt.errorInfo('操作失败!',null,null,null,handler)
ymPrompt.confirmInfo('信息确认框功能测试',null,null,null,handler)
ymPrompt.win('<div class=\'myContent\'>普通弹出窗口</div>',300,200,'普通弹窗测试')
ymPrompt.win('http://www.163.com',500,300,'网易官方网站',handler,null,null,{id:'a'})
组件调用方式2(JSON方式):示例 源码
ymPrompt.alert({message:'http://www.qq.com',slideShowHide:false,title:'确认要提交吗?',handler:handler})
ymPrompt.succeedInfo({message:$('txt').innerHTML,width:400,height:260,handler:handler2})
ymPrompt.errorInfo({message:'操作失败!',handler:handler})
ymPrompt.confirmInfo({message:'信息确认框功能测试',handler:handler})
ymPrompt.win({message:'普通弹出窗口',width:300,height:200,msgCls:'myContent',title:'普通弹窗测试'})
ymPrompt.win({message:'http://www.163.com',width:500,height:300,title:' 网易官方网站',handler:handler,maxBtn:true,minBtn:true,iframe:true})
其他使用方式演示: 示例 源码
ymPrompt.alert()
ymPrompt.alert('消息内容')
ymPrompt.alert({title:'我的标题',message:'我的内容'})
ymPrompt.win({title:'iframe 模式',fixPosition:true,maxBtn:true,minBtn:true,iframe: {id:'myId',name:'myName',src:'http://www.baidu.com'}})
ymPrompt.alert({title:'fixPosition使用演示',message:'我不会随滚动条一起滚动',fixPosition:false})
ymPrompt.alert({title:'dragOut使用演示',message:'我可以拖出到窗口可见区域以外',dragOut:true})
ymPrompt.alert({title:'autoClose使用演示',message:'程序控制关闭',autoClose:false,handler:autoClose})
ymPrompt.win({message:'<br><center>无标题栏</center>',handler:noTitlebar,btn:[['关闭我']],titleBar:false})
ymPrompt.win({message:'<br><center>无关闭按钮</center>',btn: ['OK'],closeBtn:false})
ymPrompt.alert({message:'不显示遮罩',title:'不显示遮罩',showMask:false})
ymPrompt.alert({message:'右下角弹出',title:'右下角弹出',winPos:'rb'})
ymPrompt.alert({message:'自定义弹出位置',title:'右下角弹出',winPos:[200,1000]})
ymPrompt.win({message:'自定义按钮',title:'自定义按钮测试',handler:testHd,btn:[['是','yes'],['否','no'],['取消','cancel']]})
ymPrompt.alert({message:'拖动窗体时的透明度为0.5',title:'自定义按钮测试',winAlpha:0.5})
ymPrompt.alert({message:'显示窗体阴影',title:'显示阴影',showShadow:true})
ymPrompt.alert({message:'窗体淡入淡出',title:'淡入淡出',useSlide:true,handler:slideHd})
ymPrompt.alert({message:'自定义淡入淡出',title:'淡入淡出',useSlide:true,slideCfg:{increment:0.1,interval:100},handler:slideHd})
ymPrompt.alert({message:'显示最大化最小化按钮',title:'最大化最小化',minBtn:true,maxBtn:true})
ymPrompt.win({message:'自定义内容样式',title:'自定义内容样式',msgCls:'customCls'})
ymPrompt.alert({message:'允许在消息框中使用右键',title:'允许右键',allowRightMenu:true})
ymPrompt.alert({message:'允许选择消息框中内容',title:'允许选择',allowSelect:true})
',title:'请输入您的名字',height:150,handler:getInput,autoClose:false})" type=button value=模仿系统Confirm> ymPrompt.confirmInfo({icoCls:'',msgCls:'confirm',message:' 请输入您的姓名:<br><input type='text' id='myInput' onfocus='this.select()' />',title:'请输入您的名字',height:150,handler:getInput,autoClose:false})" />
组件方式及属性调用演示: 示例 源码
ymPrompt.win('<div class=fmt>版本号:'+ymPrompt.version+'<br>发布日期:'+ymPrompt.pubDate+'<br>组件当前配置信息:'+json2str(ymPrompt.cfg)+'</div>',250,500)
ymPrompt.win({message:'iframe.html',width:500,height:300,title:'getPage测试',handler:handlerIframe,autoClose:false,iframe:true})
ymPrompt.alert({message:'一秒钟后我的大小改为[400,300]',height:200,width:250});
setTimeout(function(){ymPrompt.resizeWin(400,300)},1000);
ymPrompt.alert({message:'两秒钟后自动点击确定按钮',handler:handler});
setTimeout(function(){ymPrompt.doHandler('ok')},1000);
ymPrompt.alert({message:'点击确定显示按钮的内容',autoClose:false,btn:[['是','yes'],['否','no']],handler:getButtons})
ymPrompt.alert({message:'悬浮右下角,模拟qq',fixPosition:true,winPos:'rb',showMask:false})
ymPrompt.alert({message:' 窗口状态控制',width:400,autoClose:false,btn:[['最大化','max'],['最小化','min'],['正常态 ','normal'],['关闭','close']],handler:stateHd})
en();ymPrompt.alert({message:'英文化成功'})
cn();ymPrompt.alert({message:'中文化成功'})
调用方法及参数说明
1. 在页面中引入ymPrompt.js。如:<script type="text/javascript" src="ymPrompt.js"></script>
2. 在页面中引入对应的皮肤文件的CSS,如:<link rel="stylesheet" type="text/css" href="skin/qq/ymPrompt.css" />
3. 自定义组件的默认配置信息(此步骤可选,该方法可以在任意时间调用)
页面的js中通过ymPrompt.setDefaultCfg(cfg)方法修改组件部分或全部的默认属性。
如:ymPrompt.setDefaultCfg({maskAlpha:0.2,maskAlphaColor:'#00f'})
组件的默认配置(对于没有设定的项将采用该配置项的默认值):
{
message: '内容', //消息框按钮
width: 300, //宽
height: 185, //高
title: '标题', //消息框标题
handler: function() {}, //回调事件
maskAlphaColor: '#000', //遮罩透明色
maskAlpha: 0.1, //遮罩透明度
iframe: false, //iframe模式
icoCls: '', //图标的样式
btn: null, //按钮配置
autoClose: true, //点击关闭、确定等按钮后自动关闭
fixPosition: true, //随滚动条滚动
dragOut: false, //不允许拖出窗体范围
titleBar: true, //显示标题栏
showMask: true, //显示遮罩
winPos: 'c', //在页面中间显示
winAlpha:0.8, //拖动窗体时窗体的透明度
closeBtn:true, //是否显示关闭按钮
showShadow:false, //不显示阴影,只对IE有效
useSlide:false, //不使用淡入淡出
slideCfg:{increment:0.3,interval:50}, //淡入淡出配置
//按钮文本,可通过自定义这些属性实现本地化
closeTxt: '关闭',
okTxt:' 确 定 ',
cancelTxt:' 取 消 ',
msgCls:'ym-content' //消息内容的样式
minBtn:false, //不显示最小化按钮
minTxt:'最小化',
maxBtn:false, //不显示最大化按钮
maxTxt:'最大化'
allowSelect:false, //是否允许选择消息框内容,默认不允许
allowRightMenu:false //是否允许在消息框使用右键,默认不允许
}
4. 根据您的需要调用相应的消息函数(两种参数传入方式):
* ymPrompt.alert(参数) //消息提示类型
* ymPrompt.succeedInfo(参数) //成功信息类型
* ymPrompt.errorInfo(参数) //错误信息类型
* ymPrompt.confirmInfo(参数) //询问消息类型
* ymPrompt.win(参数) //自定义窗口类型
参数传入方式包含两种:
* 第一种即传统的参数传入,按照顺序传入相应的参数值即可(一定要按照顺序),对于不需要设定的值请传入null。如ymPrompt.alert('内容',null,null,'标题')
参数顺序上面的默认配置中参数顺序一致
* (推荐)第二种即JSON的传入方式,需要指定字段名,没有顺序,根据需要设定相关属性。如ymPrompt.alert({title:'标题',message:'内容'})
五个方法的参数意义完全相同(所有参数均为可选,不传入则使用默认参数值),具体含义如下:
* message:消息组件要显示的内容,默认为“内容”。
* width:消息框的宽度,默认为300。
* height:消息框的高度,默认为185。
* title:消息组件标题,默认为“标题”
* handler:回调函数。当确定/取消/关闭按钮被点击时会触发该函数并传入点击的按钮标识。如ok代表确定,cancel代表取消,close代表关闭
* maskAlphaColor:遮罩的颜色,默认为黑色。
* maskAlpha:遮罩的透明度,默认为0.1。
* fixPosition:设定是否弹出框随滚动条一起浮动,保持在屏幕的固定位置,默认为true
* dragOut:设定是否允许拖出屏幕范围,默认为false。
* autoClose:设定用户点击窗口中按钮后自动关闭窗口,默认为true(设定为false后程序中可以通过调用close方法关闭)。
* titleBar:是否显示标题栏,默认显示。注意,如果没有标题栏需要自己在程序中控制关闭。
* showMask:是否显示遮罩层,默认为true
* winPos:弹出窗口的位置,支持8种内置位置(c,l,t,r,b,lt,rt,lb,rb)及自定义窗口坐标,默认为c。
各参数意义:c:页面中间,l:页面左侧,t:页面顶部,r:页面右侧,b:页面顶部,lt:左上角,rt:右上角,lb:左下角,rb:右下角
* winAlpha:弹出窗体拖动时的透明度,默认为0.8
//以下三个参数主要用于win方法(当然你也可以通过设定这些覆盖前面四个消息类型的默认属性)。
* iframe:是否使用iframe方法加载内容,该属性如果为true或者object,组件则尝试将message内容作为url进行加载(如果属性值为一个object,则将object的内容添加为iframe的属性,如iframe: {id:'myId',name:'myName',src:'http://www.baidu.com'}则iframe的id为myId,name 为myName,src为http://www.baidu.com)。默认为false 。
* icoCls:图标类型。传入的内容为className,具体写法可以参考ymprompt.css中对图标的定义方式。默认为空。
* btn:按钮定义。传入的是数组形式。每个按钮的格式为['按钮文本','按钮标识'],
如[['确定','ok'],['取消','cancel'],['关闭','close']]等。
注意单个按钮应该是这样的:[['确定','ok']]
* closeBtn:是否显示关闭按钮,默认为true(显示)。
* showShadow:是否启用弹出框阴影效果(IE Only),默认为false
* useSlide:f是否启用弹出框的渐显渐隐效果,默认为false
* slideCfg:渐变效果的配置信息,参数格式为object,属性包括incerment:透明度每次增加的值,interval:变化的速度。例如:{incerment:0.3,interval:50}。该参数仅在useSlide为true时有效
//以下参数可用于对组件语言本地化,如用于英文等系统中
* okTxt:确定按钮的文本描述,默认为“确定”
* cancelTxt:取消按钮的文本描述,默认为“取消”
* closeTxt:关闭按钮的文本描述(鼠标放在关闭按钮上时显示),默认为“关闭”
* minTxt:最小化按钮的文本描述,默认为“最小化”
* maxTxt:最大化按钮的文本描述,默认为“最大化”
* minBtn:是否显示最小化按钮,默认为false
* maxBtn:是否显示最大化按钮,默认为false
* allowSelect:是否允许选择消息框内容,默认为false
* allowRightMenu:是否允许在消息框中使用右键,默认为false
5. 操作接口:
属性:
version:当前版本号如:alert(ymPrompt.version)
pubDate:当前版本的发布日期如:alert(ymPrompt.pubDate);
cfg:组件的当前的默认配置
方法:
setDefaultCfg(cfg):设定组件的默认属性,设定后的所有弹出均默认采用cfg中的设置。
如:ymPrompt.setDefaultCfg({maskAlpha:0.2,maskAlphaColor:'#00f'}); //设定遮罩层颜色为蓝色,透明度0.2
getPage():在iframe窗口模式下,获取到iframe的dom对象。
如:alert(ymPrompt.getPage().contentWindow.document.body.outerHTML); //获取iframe页面的html内容
resizeWin(w,h):通过程序动态修改窗口的大小。参数:w:宽度,h:高度
如:ymPrompt.resizeWin(400,300); //修改弹出框宽度为400px,高度为300px
doHandler(sign,autoClose):模拟触发某个按钮的点击事件。参数sign:传给回调函数的标识,autoClose:是否自动关闭窗口(默认采用全局配置)
如:ymPrompt.doHandler('ok',false); //触发确定按钮的点击事件,并且执行完回调函数后不关闭窗口
getButtons():获取当前弹出窗口的所有按钮对象,返回结果是一个对象集合(数组)。
如:var btnID=ymPrompt.getButtons()[0].id; //获取第一个按钮的id
close():关闭当前弹出的窗口 如:ymPrompt.close()
max():最大化弹出窗口。
min():最小化弹出窗口
normal():窗口普通弹出状态
6. 其他说明:如果觉得“对象.方法”的调用方式比较麻烦,可以采用如下方式简化调用:
在调用之前设定var Alert=ymPrompt.alert。之后就可以使用Alert()的方式进行调用
分享到:
相关推荐
在"ymPrompt消息提示组件_4.0简要说明"文档中,开发者可以找到关于4.0版本的详细信息,包括新特性、改进以及使用方法。这个文档通常会包含组件的安装步骤、配置选项、API接口说明等内容,帮助开发者快速上手并充分...
在本文中,我们将深入探讨ymPrompt4.0的核心特性和使用方法,以及如何通过实例应用来提升网页交互体验。 一、核心功能与特点 1. **弹出模态窗口**:ymPrompt4.0的主要功能是创建弹出模态窗口,这种窗口可以在用户...
"demo.html", "frameset.html", 和 "iframe.html"是示例文件,展示了ymPrompt组件的使用方法。通过这些例子,我们可以看到如何在实际项目中引入ymPrompt,并配置参数来创建不同的消息提示效果。 "readme.txt"通常...
"ymPrompt-4.0-B" 是一个专用于创建HTML弹出窗口的工具或库,其版本号为4.0,标识B可能代表该版本的一个...对于具体的使用方法、示例代码和可能的高级功能,建议参考ymPrompt的官方文档或源代码,以获取更准确的信息。
在压缩包中,"ymPrompt 用于js中跳出对话框"这一文件很可能是ymPrompt插件的主文件,包含了ymPrompt的核心功能和示例代码。在使用时,需要将其正确引入到你的HTML页面,并按照文档说明进行配置,就可以在你的web应用...
3. **创建提示**:使用`ymprompt.alert()`, `ymprompt.confirm()`, `ymprompt.prompt()`等方法,根据需求创建不同类型的消息提示。 4. **自定义样式和行为**:可以修改CSS样式文件以改变对话框的外观,或者监听...
这可能是一些额外的插件、预设样式或者特定场景下的使用示例,旨在展示ymPrompt的更多可能性。通过研究这个文件,开发者可以学习如何充分利用ymPrompt库,添加更多高级功能,如动画效果、自定义模板等。 ymPrompt库...
同时,ymPrompt 具有良好的兼容性,能够在主流的浏览器环境下稳定运行,包括Chrome、Firefox、Safari、Edge以及IE9及以上版本。 在实际应用中,ymPrompt 可以广泛应用于各种类型的Web项目,无论是企业级应用、电子...
通过熟练掌握其特性和使用方法,开发者可以构建出更加贴近用户需求的界面,提高产品的质量和用户满意度。在开发过程中,不断更新和优化消息提示组件,保持与最新技术的同步,是保证应用竞争力的关键。
7. **响应式布局**:考虑到移动设备的使用,ymPrompt4可能已经实现了响应式设计,确保在不同分辨率和设备上都能正常显示。 8. **兼容性**:由于基于jQuery,ymPrompt4可能对主流浏览器(如Chrome、Firefox、Safari...
`readme.txt`文件通常包含关于ymPrompt的基本信息、安装指南、使用方法等,是了解这个库的重要文档。而`changelog.txt`则记录了ymPrompt的更新历史,可以帮助开发者追踪其版本变化和新功能添加。 最后,`skin`目录...
ymPrompt是一款在Web开发中常用于创建弹出对话框的JavaScript库。它提供了一种方便的方式来展示信息、获取...通过分析和学习这个示例,你将能更全面地掌握ymPrompt的用法,从而在自己的项目中灵活运用弹出窗口功能。
开发者可以通过调用ymPrompt对象的相应方法来控制弹出窗口的行为。 `ymPrompt_source.js`则是源代码文件,对于想要了解ymPrompt4.0内部工作原理或进行二次开发的开发者来说,这是一个宝贵的资源。通过阅读源代码,...
"ymPrompt消息提示组件3.0版DEMO演示"是一个专注于提供用户交互体验优化的工具,主要用于在网页应用中展示各种类型的消息提示。这个组件的最新版本为3.0,由开发者wazhpi(八零後-㊣平)创建。ymPrompt组件设计精巧...
"ymPrompt"是一款功能强大的网页窗口控件,尤其在JavaScript编程中被广泛使用。它能够为开发者提供便捷的弹窗功能,不仅可以实现普通的信息提示,还可以覆盖整个页面,包括由多个iframe组成的复杂页面结构。这样的...
在实际使用ymPrompt时,开发者可以通过简单的JavaScript API调用来创建和控制消息提示,如`ymPrompt.info()`、`ymPrompt.warning()`等,同时可能支持参数配置,如延迟关闭时间、是否允许用户手动关闭等。 综上所述...
1、在页面中引入ymPrompt.js。如:<script type="text/javascript" src="ymPrompt.js"></script> 2、在页面中引入对应的皮肤文件的CSS,如:<link rel="stylesheet" type="text/css" href="skin/qq/ymPrompt.css" ...
`readme.txt`通常会介绍如何引入库文件,如何调用API,以及一些基本的使用示例,帮助开发者快速上手。`changelog.txt`则列出了每个版本的更新内容,对于跟踪程序的改进和修复问题很有帮助。 ymPrompt-4.0的弹出窗口...