jQueryUI如何自定义组件实现代码 |
本文标签:jQueryUI,自定义组件 如何开始使用 首先用$.widget()方法开始定义你的组件,它只接收三个参数:第一个是组件名称,第二个是可选的基类组件(默认的基类是$.Widget),第三个是组件的原型 。 组件名称必须包含命名空间,要注意的是,官方组件的命名空间是以‘ui开头的,比如:‘ui.tabs 。我在下面的用‘我的拼音(‘wo) 。 复制代码 代码如下: $.widget("yourNamespace.yourWidgetName",[yourBaseWidget],yourWidgetPrototype) $.Widget基类含有一个重要的属性‘options,它用来定义公有参数,组件初始化时外部调用的参数会覆盖内部定义的参数;以及三个重要的私有的方法‘_create、‘_init、‘,前两个相当于构造函数的作用,按顺序执行,_create()方法执行之后会触发create事件 。 _trigger()方法会将参数中的指定函数标准化为W3C事件,并且触发这个自定义事件 。 另外还有三个公有方法‘enable,‘disable,‘destroy,分别表示启用、禁用和销毁组件 。 这里很有意思的,是私有方法和公有方法的实现 。jQuerUI Widget暴露的方法都是不以‘_开头的: 复制代码 代码如下: // prevent calls to internal methods if ( isMethodCall && options.charAt( 0 ) === "_" ) { return returnValue; } 实际上,jQueryUI Widget还是保留了原始的API,比如这样使用: 复制代码 代码如下: var $div = $(.demo:first); var api = $div.data(divZoom); // console.dir(api); api.zoomIn(); // 对比 $div.divZoom(zoomIn); 一个实现完全私有变量的小技巧: 复制代码 代码如下: (function($) { var privateVar = ; $.widget("wo.divZoom",{}); })(jQuery) 所有代码 复制代码 代码如下: /* * @by ambar * @create 2010-10-20 * @update 2010-10-25 */ (function($) { var html = <div class="icon-zoom">\ <span title="zoom in" class="zoom-in">zoom in</span>\ <span title="zoom out" class="zoom-out">zoom out</span>\ </div>; $.widget("wo.divZoom",{ _init : function() { var self = this, opt = self.options, tgt = opt.target, $el = self.element ; // 初始一次 if($(div.icon-zoom,$el).length) return; $el.append(html); self.target = ( tgt == ? $el : $el.find(tgt) ); // 检测初始值 var level = self.target.attr(opt.dataPrefix); self.target.attr(opt.dataPrefix,level || opt.level[0]); self.btnZoomIn = $el.find(span.zoom-in).click( $.proxy(self.zoomIn,self) ); self.btnZoomOut = $el.find(span.zoom-out).click( $.proxy(self.zoomOut,self) ); }, destroy : function(){ this.element.find(div.icon-zoom).remove(); }, options : { level : [120,160,200], target : , speed : normal, dataPrefix : data-zoom-level, zooming : null, select : null, show : null }, currentLevel : function(){ var self = this, opt = self.options, lvl = Number(self.target.attr(opt.dataPrefix)); return $.inArray(lvl,opt.level); }, zoomIn : function() { this.zoom(this.currentLevel() + 1); }, zoomOut : function() { this.zoom(this.currentLevel() - 1); }, zoom : function(i){ var self = this, opt = self.options,lvls = opt.level,$tgt = self.target; if( i<=-1 || i>=lvls.length ) return; var value = lvls[i], originalValue = lvls[self.currentLevel()], style = { width:value, height:value }; var data = { target : $tgt, css : style, originalCss : {width:originalValue,height:originalValue} }; var goon = self._trigger(start,null,data); if(!goon) return; $tgt.animate(style, { duration : opt.speed, step : function(val) { var css = { width:val, height:val }; self._trigger(zooming,null,$.extend({},data,{css:css})); }, complete : function(){ $tgt.attr(opt.dataPrefix,value); self._trigger(stop,null,data); } }); } }); })(jQuery) 在页面上调用 复制代码 代码如下: <script src="js/jquery-1.4.4.min.js"></script> <script src="js/jquery.ui.widget.js"></script> <!-- 自定义的 --> <script src="js/jquery.ui.wo.divZoom.js"></script> <script type="text/javascript"> $(function() { $(div.demo).divZoom({ target : >a, level : [80,120,160,200], zooming : function(e,ui){ // console.log(e,ui.css); }, start : function(e,ui){ console.log(开始,this,e.type,ui); }, stop : function(e,ui) { console.log(结束,ui.css); } }); }); </script> 示例代码: 复制代码 代码如下: <!DOCTYPE HTML> <html lang="en-US"> <head> <meta charset="UTF-8"> <title>jQueryUI</title> <style type="text/css"> #receptacle{width:800px;height:500px;background:#cde;position:relative;} #receptacle .demo{width:80px;height:80px;position:absolute;} .demo .cont{width:80px;height:80px;display:block;background:#07a;} .demo-a{top:30px;left:122px;} .demo-b{top:100px;left:400px;} .icon-zoom { position:absolute; width:63px; height:20px; overflow:hidden; background:url(http://files.jb51.net/file_images/photoshop/201011/icon-zoom.png) no-repeat; cursor:pointer; } .icon-zoom span { width:20px; display:block; text-indent:-999em; float:left; } </style> <!--<script src="js/jquery.ui.core.js"></script> <script src="jquery-1.4.4.min.js"></script> <script src="jquery.ui.widget.js"></script> <!-- 自定义的 --> <script src="jquery.ui.wo.divZoom.js"></script> <script type="text/javascript"> $(function() { $(div.demo).divZoom({ target : >a, level : [80,120,160,200], zooming : function(e,ui){ // console.log(e,ui.css); }, start : function(e,ui){ console.log(开始,this,e.type,ui); }, stop : function(e,ui) { console.log(结束,ui.css); } }); }); </script> </head> <body> <p> <a href="http://www.cnblogs.com/ambar/archive/2010/11/12/how-to-user-jquery-ui-widget.html">原文</a> </p> <div id="receptacle"> <div class="demo demo-a"> <a class="cont" href="#a">a</a> </div> <div class="demo demo-b"> <a class="cont" href="#b">b</a> </div> </div> </body> </html> |