如何编写grunt 插件

也许现有的grunt plugin无法满足你的需求,那就只能自己写一个plugin。

准备工作:

一、 当然首先是查一下plugin的API文档及模板。grunt的API比较少,但是已经包含了大部分的基础功能了。如常用的文件读取,log输出等。

相关前期文档可以查看:

http://www.gruntjs.net/docs/creating-plugins/ 
http://www.gruntjs.net/api/grunt.file/

二、 创建项目环境。

看完文档之后,接下来就得开始编写项目了,还好grunt已经为我们准备了标准的plugin模板,我们通过git命令下载回来后直接修改。然后就可以进入插件开发。

项目创建流程如下:

vIfyie

1、通过 npm install -g grunt-init 命令安装 grunt-init 。 
2、通过 git clone git://github.com/gruntjs/grunt-init-gruntplugin.git ~/.grunt-init/gruntplugin 命令安装grunt插件模版。 
3、在一个空的目录中执行 grunt-init gruntplugin 。 
执行这一步时,会出现如下问答式的内容。根据自己需要填写好就会创建出相应的项目所需文件。 
当然,如果你还不清楚这些怎么填写,也可以随便写一下,日后也可以直接修改配置文件。 

4、执行 npm install 命令以准备开发环境。

好了,现在可以开始grunt plugin的书写了。

140531151439

以下是我新建的一个插件目录结构。 

在task文件夹里编写你需要的任务,其中常用的一个函数接口是 grunt.files

以下是我刚写是timestamp 插件,看代码也许比文字更容易理解,呵呵。插件的项目地址: https://github.com/baofen14787/grunt-timestamp-file

/*
 * grunt-timestamp-file
 * https://github.com/baofen14787/grunt-timestamp-file
 *
 * Copyright (c) 2014 hugo
 * Licensed under the MIT license.
 */
var crypto = require('crypto');

'use strict';

module.exports = function (grunt) {

	// Please see the Grunt documentation for more information regarding task
	// creation: http://gruntjs.com/creating-tasks

	grunt.registerMultiTask('timestamp_file', 'grunt create timestamp file in project', function () {

		// Merge task-specific and/or target-specific options with these defaults.
		//默认参数
		var options = this.options({
			punctuation	 :   '.',
			separator	   :   '\n ',
			urlRoot		 :   '',						  //生成的页面片地址URL根目录地址
			timestampType   :   'md5',  //md5 || time
			timestampFormat :   'yymmddhMMss'
		});

		function ttType(filepath){
			var timeString,
				sourcedata;
			if(options.timestampType == 'md5'){
				sourcedata = grunt.file.read(filepath);
				timeString = md5(sourcedata, options.timestampType).substring(0,10);  //MD5太长 截短一点
			}else{
				timeString = grunt.template.today(options.timestampFormat)
			}
			return timeString;
		}

		function md5(content, encoding) {
			return crypto.createHash('md5').update(content, encoding).digest('hex');
		}

		/**
		 * 创建script标签
		 * @param filepath
		 * @param attr
		 * @returns {string}
		 */
		function createScript(filepath,attr){
			var version = ttType(filepath),
				url = options.urlRoot + filepath;

			var str = '<script src="'+ url + '?v='+ version +'" ';
			if(typeof attr === 'object'){
				for(var i in attr){
					str += i + '="' + attr[i] + '" ';
				}
			}
			str += '></script>';
			return str;
		}

		function createStyle(filepath,attr){
			var version = ttType(filepath),
				url = options.urlRoot + filepath;
			var str = '<link rel="stylesheet" type="text/css" media="screen" href='+ url + '?v='+ version +'" ';
			if(typeof attr === 'object'){
				for(var i in attr){
					str += i + '="' + attr[i] + '" ';
				}
			}
			str += '/>';
			return str;
		}

		function createTimesTamp(filepath,attr){
			//判定文件类型
			var fileTyle = filepath.split('.'),
				tag;
			attr = attr || options.attr;
			fileTyle = fileTyle[fileTyle.length -1];

			switch (fileTyle){
				case 'js':
					tag = createScript(filepath,attr);
					break
				case 'css':
					tag = createStyle(filepath,attr);
			}
			return tag;
		}

		console.info('filepath:', this.files)
		//开始读取文件
		this.files.forEach(function (f) {

			// Concat specified files.
			var src = f.src.filter(function (filepath) {
				//如果文件不存在 则 提示警告
				if (!grunt.file.exists(filepath)) {
					grunt.log.warn('Source file "' + filepath + '" not found.');
					return false;
				} else {
					return true;
				}
			}).map(function (filepath) {
					// Read file source.
					return createTimesTamp(filepath);
				}).join(grunt.util.normalizelf(options.separator));

			// Handle options.
			src += options.punctuation;

			// Write the destination file.
			grunt.file.write(f.dest, src);

			// Print a success message.
			grunt.log.writeln('File "' + f.dest + '" created.');
		});
	});



};

三、最后,插件编写完后就开始发布了。

官网的发布写的比较简单,直接就是 npm pulish .但实际上直接运行这个命令很可能报错。

正确的发布顺序是:

# 初始化 package.json
C:\GitHub\grunt-timestamp-file> npm init
 
# 验证你在 npmjs.org 上的账号
C:\GitHub\grunt-timestamp-file> npm adduser
 
# 发布
C:\GitHub\grunt-timestamp-file> npm publish .

上面三部是初次发布插件的步骤。当然,在发布前需要你先去npmjs.org上注册一个账号。

如果你以后修改了代码,然后想要同步到 npm 上的话请修改 package.json 中的 version 然后再次 publish

最后,如果你报错 
no_perms Private mode enable, only admin can publish this module

那么可能是你用了国内的镜像地址了,只需要重新把地址注册回npmjs即可。npm config set registry http://registry.npmjs.org

backbone1.1.2源码阅读

backbone是比较轻量的mvc框架,去掉注释整个源码不到1000行。框架源码还是比较好理解的,没什么太有技巧性的写法,读起来比较轻松。顺便把代码注释也写上了,目前只是粗略读了下,晚点再做深入分析,取其精华。

阅读地址传送门: https://github.com/baofen14787/backbone/blob/master/backbone.js

jquery ui widget 源码分析

jquery ui 的所有组件都是基于一个简单,可重用的widget。

这个widget是jquery ui的核心部分,实用它能实现一致的API,创建有状态的插件,而无需关心插件的内部转换。$.widget( name, base, prototype )

widget一共有2或3个参数。base为可选。

这里之所以把base放在第二个参数里,主要是因为这样写代码更直观一些。(因为后面的prototype 是个代码非常长的大对象)。

name: 第一个参数是一个包含一个命名空间和组件名称的字符串,通过”.”来分割。 
命名空间必须有,它指向widget prototype存储的全局jQuery对象。 
如果命名空间没有,widget factory将会为你生成。widget name是插件函数和原型的真实名称, 
比如: jQuery.widget( “demo.multi”, {…} ) 将会生成 jQuery.demo , jQuery.demo.multi , and jQuery.demo.multi.prototype .

base: 第二个参数(可选)是 widget prototype继承于什么对象。 
例如jQuery UI有一个“mouse”的插件,它可以作为其他的插件提供的基础。 
为了实现这个所有的基于mouse的插件比如draggable, 
droppable可以这么做: jQuery.widget( "ui.draggable", $.ui.mouse, {...} ); 
如果没有这个参数,widget默认继承自“base widget” jQuery.Widget(注意jQuery.widget 和 jQuery.Widget不同) 。

prototype: 最后一个参数是一个对象文字,它会转化为所有widget实例的prototype。widget factory会生成属性链,连接到她继承的widget的prototype。一直到最基本的 jQuery.Widget。

一旦你调用 jQuery.widget ,它会在 jQuery prototype ( jQuery.fn ) 上生成一个新的可用方法对应于widget的名字,比如我们这个例子jQuery.fn.multi。 .fn方法是包含Dom元素的jquery对象和你生成的 widget prototyp实例的接口,为每一个jQuery对象生成一个新的widget的实例。

/*!
 * jQuery UI Widget @VERSION
 * http://jqueryui.com
 *
 * Copyright 2014 jQuery Foundation and other contributors
 * Released under the MIT license.
 * http://jquery.org/license
 *
 * http://api.jqueryui.com/jQuery.widget/
 */

//这里判定是否支持amd or cmd 模式
(function( factory ) {
	if ( typeof define === "function" && define.amd ) {

		// AMD. Register as an anonymous module.
		define( [ "jquery" ], factory );
	} else {

		// Browser globals
		factory( jQuery );
	}
}(function( $ ) {

var widget_uuid = 0,        //插件的实例化数量
	widget_slice = Array.prototype.slice;   //数组的slice方法,这里的作用是将参赛arguments 转为真正的数组

//清除插件的数据及缓存
$.cleanData = (function( orig ) {
	return function( elems ) {
		for ( var i = 0, elem; (elem = elems[i]) != null; i++ ) {
			try {
	    // 重写cleanData方法,调用后触发每个元素的remove事件
				$( elem ).triggerHandler( "remove" );
			// http://bugs.jquery.com/ticket/8235
			} catch( e ) {}
		}
		orig( elems );
	};
})( $.cleanData );

    /**
     * widget工厂方法,用于创建插件
     * @param name 包含命名空间的插件名称,格式 xx.xxx
     * @param base 需要继承的ui组件
     * @param prototype 插件的实际代码
     * @returns {Function}
     */
$.widget = function( name, base, prototype ) {
	var fullName, //插件全称
        existingConstructor, //原有的构造函数
        constructor,	//当前构造函数
        basePrototype,          //父类的Prototype
		// proxiedPrototype allows the provided prototype to remain unmodified
		// so that it can be used as a mixin for multiple widgets (#8876)
		proxiedPrototype = {},      //可调用父类方法_spuer的prototype对象,扩展于prototype
		namespace = name.split( "." )[ 0 ];

	name = name.split( "." )[ 1 ];
	fullName = namespace + "-" + name;
    //如果只有2个参数  base默认为Widget类,组件默认会继承base类的所有方法
	if ( !prototype ) {
		prototype = base;
		base = $.Widget;
	}

//    console.log(base, $.Widget)

	// create selector for plugin
    //创建一个自定义的伪类选择器
    //如 $(':ui-menu') 则表示选择定义了ui-menu插件的元素
	$.expr[ ":" ][ fullName.toLowerCase() ] = function( elem ) {
		return !!$.data( elem, fullName );
	};

    // 判定命名空间对象是否存在,没有的话 则创建一个空对象
	$[ namespace ] = $[ namespace ] || {};
    //这里存一份旧版的插件,如果这个插件已经被使用或者定义了
	existingConstructor = $[ namespace ][ name ];
    //这个是插件实例化的主要部分
    //constructor存储了插件的实例,同时也创建了基于命名空间的对象
    //如$.ui.menu
	constructor = $[ namespace ][ name ] = function( options, element ) {
		// allow instantiation without "new" keyword
        //允许直接调用命名空间上的方法来创建组件
        //比如:$.ui.menu({},'#id') 这种方式创建的话,默认没有new 实例化。因为_createWidget是prototype上的方法,需要new关键字来实例化
        //通过 调用 $.ui.menu 来实例化插件
		if ( !this._createWidget ) {
	console.info(this)
			return new constructor( options, element );
		}

		// allow instantiation without initializing for simple inheritance
		// must use "new" keyword (the code above always passes args)
        //如果存在参数,则说明是正常调用插件
        //_createWidget是创建插件的核心方法
		if ( arguments.length ) {
			this._createWidget( options, element );
		}
	};
	// extend with the existing constructor to carry over any static properties
    //合并对象,将旧插件实例,及版本号、prototype合并到constructor
	$.extend( constructor, existingConstructor, {

		version: prototype.version,
		// copy the object used to create the prototype in case we need to
		// redefine the widget later
        //创建一个新的插件对象
        //将插件实例暴露给外部,可用户修改及覆盖
		_proto: $.extend( {}, prototype ),
		// track widgets that inherit from this widget in case this widget is
		// redefined after a widget inherits from it
		_childConstructors: []
	});

    //实例化父类 获取父类的  prototype
	basePrototype = new base();
	// we need to make the options hash a property directly on the new instance
	// otherwise we'll modify the options hash on the prototype that we're
	// inheriting from
    //这里深复制一份options
	basePrototype.options = $.widget.extend( {}, basePrototype.options );
    //在传入的ui原型中有方法调用this._super 和this.__superApply会调用到base上(最基类上)的方法
	$.each( prototype, function( prop, value ) {
        //如果val不是function 则直接给对象赋值字符串
		if ( !$.isFunction( value ) ) {
			proxiedPrototype[ prop ] = value;
			return;
		}
        //如果val是function
		proxiedPrototype[ prop ] = (function() {
	//两种调用父类函数的方法
			var _super = function() {
	        //将当期实例调用父类的方法
					return base.prototype[ prop ].apply( this, arguments );
				},
				_superApply = function( args ) {
					return base.prototype[ prop ].apply( this, args );
				};
			return function() {
				var __super = this._super,
					__superApply = this._superApply,
					returnValue;
//	    console.log(prop, value,this,this._super,'===')
//	    debugger;
	    //在这里调用父类的函数
				this._super = _super;
				this._superApply = _superApply;

				returnValue = value.apply( this, arguments );

				this._super = __super;
				this._superApply = __superApply;
//	    console.log(this,value,returnValue,prop,'===')
				return returnValue;
			};
		})();
	});
//    console.info(proxiedPrototype)
//    debugger;
    //这里是实例化获取的内容
	constructor.prototype = $.widget.extend( basePrototype, {
		// TODO: remove support for widgetEventPrefix
		// always use the name + a colon as the prefix, e.g., draggable:start
		// don't prefix for widgets that aren't DOM-based
		widgetEventPrefix: existingConstructor ? (basePrototype.widgetEventPrefix || name) : name
	}, proxiedPrototype, {
        //重新把constructor指向 constructor 变量
		constructor: constructor,
		namespace: namespace,
		widgetName: name,
		widgetFullName: fullName
	});

	// If this widget is being redefined then we need to find all widgets that
	// are inheriting from it and redefine all of them so that they inherit from
	// the new version of this widget. We're essentially trying to replace one
	// level in the prototype chain.
    //这里判定插件是否被使用了。一般来说,都不会被使用的。
    //因为插件的开发者都是我们自己,呵呵
	if ( existingConstructor ) {
		$.each( existingConstructor._childConstructors, function( i, child ) {
			var childPrototype = child.prototype;

			// redefine the child widget using the same prototype that was
			// originally used, but inherit from the new version of the base
			$.widget( childPrototype.namespace + "." + childPrototype.widgetName, constructor, child._proto );
		});
		// remove the list of existing child constructors from the old constructor
		// so the old child constructors can be garbage collected
		delete existingConstructor._childConstructors;
	} else {
        //父类添加当前插件的实例 主要用于作用域链查找 不至于断层
		base._childConstructors.push( constructor );
	}

    //将此方法挂在jQuery对象上
	$.widget.bridge( name, constructor );

	return constructor;
};

//扩展jq的extend方法,实际上类似$.extend(true,..) 深复制
$.widget.extend = function( target ) {
	var input = widget_slice.call( arguments, 1 ),
		inputIndex = 0,
		inputLength = input.length,
		key,
		value;
	for ( ; inputIndex < inputLength; inputIndex++ ) {
		for ( key in input[ inputIndex ] ) {
			value = input[ inputIndex ][ key ];
			if ( input[ inputIndex ].hasOwnProperty( key ) && value !== undefined ) {
				// Clone objects
				if ( $.isPlainObject( value ) ) {
					target[ key ] = $.isPlainObject( target[ key ] ) ?
						$.widget.extend( {}, target[ key ], value ) :
						// Don't extend strings, arrays, etc. with objects
						$.widget.extend( {}, value );
				// Copy everything else by reference
				} else {
					target[ key ] = value;
				}
			}
		}
	}
	return target;
};

//bridge 是设计模式的一种,这里将对象转为插件调用
$.widget.bridge = function( name, object ) {
	var fullName = object.prototype.widgetFullName || name;
    //这里就是插件了
    //这部分的实现主要做了几个工作,也是制作一个优雅的插件的主要代码
    //1、初次实例化时将插件对象缓存在dom上,后续则可直接调用,避免在相同元素下widget的多实例化。简单的说,就是一个单例方法。
    //2、合并用户提供的默认设置选项options
    //3、可以通过调用插件时传递字符串来调用插件内的方法。如:$('#id').menu('hide') 实际就是实例插件并调用hide()方法。
    //4、同时限制外部调用“_”下划线的私有方法
	$.fn[ name ] = function( options ) {
		var isMethodCall = typeof options === "string",
			args = widget_slice.call( arguments, 1 ),
			returnValue = this;

		// allow multiple hashes to be passed on init.
        //可以简单认为是$.extend(true,options,args[0],...),args可以是一个参数或是数组
		options = !isMethodCall && args.length ?
			$.widget.extend.apply( null, [ options ].concat(args) ) :
			options;
        //这里对字符串和对象分别作处理
		if ( isMethodCall ) {
			this.each(function() {
				var methodValue,
					instance = $.data( this, fullName );
	    //如果传递的是instance则将this返回。
				if ( options === "instance" ) {
					returnValue = instance;
					return false;
				}
				if ( !instance ) {
					return $.error( "cannot call methods on " + name + " prior to initialization; " +
						"attempted to call method '" + options + "'" );
				}
	    //这里对私有方法的调用做了限制,直接调用会抛出异常事件
				if ( !$.isFunction( instance[options] ) || options.charAt( 0 ) === "_" ) {
					return $.error( "no such method '" + options + "' for " + name + " widget instance" );
				}
	    //这里是如果传递的是字符串,则调用字符串方法,并传递对应的参数.
	    //比如插件有个方法hide(a,b); 有2个参数:a,b
	    //则调用时$('#id').menu('hide',1,2);//1和2 分别就是参数a和b了。
				methodValue = instance[ options ].apply( instance, args );
				if ( methodValue !== instance && methodValue !== undefined ) {
					returnValue = methodValue && methodValue.jquery ?
						returnValue.pushStack( methodValue.get() ) :
						methodValue;
					return false;
				}
			});
		} else {
			this.each(function() {
				var instance = $.data( this, fullName );

				if ( instance ) {
					instance.option( options || {} );
	        //这里每次都调用init方法
					if ( instance._init ) {
						instance._init();
					}
				} else {
	        //缓存插件实例
					$.data( this, fullName, new object( options, this ) );
				}
			});
		}

		return returnValue;
	};
};

    //这里是真正的widget基类
$.Widget = function( /* options, element */ ) {};
$.Widget._childConstructors = [];

$.Widget.prototype = {
	widgetName: "widget",
    //用来决定事件的名称和插件提供的callbacks的关联。
    // 比如dialog有一个close的callback,当close的callback被执行的时候,一个dialogclose的事件被触发。
    // 事件的名称和事件的prefix+callback的名称。widgetEventPrefix 默认就是控件的名称,但是如果事件需要不同的名称也可以被重写。
    // 比如一个用户开始拖拽一个元素,我们不想使用draggablestart作为事件的名称,我们想使用dragstart,所以我们可以重写事件的prefix。
    // 如果callback的名称和事件的prefix相同,事件的名称将不会是prefix。
    // 它阻止像dragdrag一样的事件名称。
	widgetEventPrefix: "",
	defaultElement: "<div>",
    //属性会在创建模块时被覆盖
	options: {
		disabled: false,

		// callbacks
		create: null
	},
	_createWidget: function( options, element ) {
		element = $( element || this.defaultElement || this )[ 0 ];
		this.element = $( element );
		this.uuid = widget_uuid++;
		this.eventNamespace = "." + this.widgetName + this.uuid;
		this.options = $.widget.extend( {},
			this.options,
			this._getCreateOptions(),
			options );

		this.bindings = $();
		this.hoverable = $();
		this.focusable = $();

		if ( element !== this ) {
//	debugger
			$.data( element, this.widgetFullName, this );
			this._on( true, this.element, {
				remove: function( event ) {
					if ( event.target === element ) {
						this.destroy();
					}
				}
			});
			this.document = $( element.style ?
				// element within the document
				element.ownerDocument :
				// element is window or document
				element.document || element );
			this.window = $( this.document[0].defaultView || this.document[0].parentWindow );
		}

		this._create();
        //创建插件时,有个create的回调
		this._trigger( "create", null, this._getCreateEventData() );
		this._init();
	},
	_getCreateOptions: $.noop,
	_getCreateEventData: $.noop,
	_create: $.noop,
	_init: $.noop,
    //销毁模块:去除绑定事件、去除数据、去除样式、属性
	destroy: function() {
		this._destroy();
		// we can probably remove the unbind calls in 2.0
		// all event bindings should go through this._on()
		this.element
			.unbind( this.eventNamespace )
			.removeData( this.widgetFullName )
			// support: jquery <1.6.3
			// http://bugs.jquery.com/ticket/9413
			.removeData( $.camelCase( this.widgetFullName ) );
		this.widget()
			.unbind( this.eventNamespace )
			.removeAttr( "aria-disabled" )
			.removeClass(
				this.widgetFullName + "-disabled " +
				"ui-state-disabled" );

		// clean up events and states
		this.bindings.unbind( this.eventNamespace );
		this.hoverable.removeClass( "ui-state-hover" );
		this.focusable.removeClass( "ui-state-focus" );
	},
	_destroy: $.noop,

	widget: function() {
		return this.element;
	},
    //设置选项函数
	option: function( key, value ) {
		var options = key,
			parts,
			curOption,
			i;

		if ( arguments.length === 0 ) {
			// don't return a reference to the internal hash
	//返回一个新的对象,不是内部数据的引用
			return $.widget.extend( {}, this.options );
		}

		if ( typeof key === "string" ) {
			// handle nested keys, e.g., "foo.bar" => { foo: { bar: ___ } }
			options = {};
			parts = key.split( "." );
			key = parts.shift();
			if ( parts.length ) {
				curOption = options[ key ] = $.widget.extend( {}, this.options[ key ] );
				for ( i = 0; i < parts.length - 1; i++ ) {
					curOption[ parts[ i ] ] = curOption[ parts[ i ] ] || {};
					curOption = curOption[ parts[ i ] ];
				}
				key = parts.pop();
				if ( arguments.length === 1 ) {
					return curOption[ key ] === undefined ? null : curOption[ key ];
				}
				curOption[ key ] = value;
			} else {
				if ( arguments.length === 1 ) {
					return this.options[ key ] === undefined ? null : this.options[ key ];
				}
				options[ key ] = value;
			}
		}

		this._setOptions( options );

		return this;
	},
	_setOptions: function( options ) {
		var key;

		for ( key in options ) {
			this._setOption( key, options[ key ] );
		}

		return this;
	},
	_setOption: function( key, value ) {
		this.options[ key ] = value;

		if ( key === "disabled" ) {
			this.widget()
				.toggleClass( this.widgetFullName + "-disabled", !!value );

			// If the widget is becoming disabled, then nothing is interactive
			if ( value ) {
				this.hoverable.removeClass( "ui-state-hover" );
				this.focusable.removeClass( "ui-state-focus" );
			}
		}

		return this;
	},

	enable: function() {
		return this._setOptions({ disabled: false });
	},
	disable: function() {
		return this._setOptions({ disabled: true });
	},

	_on: function( suppressDisabledCheck, element, handlers ) {
		var delegateElement,
			instance = this;

		// no suppressDisabledCheck flag, shuffle arguments
		if ( typeof suppressDisabledCheck !== "boolean" ) {
			handlers = element;
			element = suppressDisabledCheck;
			suppressDisabledCheck = false;
		}

		// no element argument, shuffle and use this.element
		if ( !handlers ) {
			handlers = element;
			element = this.element;
			delegateElement = this.widget();
		} else {
			// accept selectors, DOM elements
			element = delegateElement = $( element );
			this.bindings = this.bindings.add( element );
		}

		$.each( handlers, function( event, handler ) {
			function handlerProxy() {
				// allow widgets to customize the disabled handling
				// - disabled as an array instead of boolean
				// - disabled class as method for disabling individual parts
				if ( !suppressDisabledCheck &&
						( instance.options.disabled === true ||
							$( this ).hasClass( "ui-state-disabled" ) ) ) {
					return;
				}
				return ( typeof handler === "string" ? instance[ handler ] : handler )
					.apply( instance, arguments );
			}

			// copy the guid so direct unbinding works
			if ( typeof handler !== "string" ) {
				handlerProxy.guid = handler.guid =
					handler.guid || handlerProxy.guid || $.guid++;
			}

			var match = event.match( /^([\w:-]*)\s*(.*)$/ ),
				eventName = match[1] + instance.eventNamespace,
				selector = match[2];
			if ( selector ) {
				delegateElement.delegate( selector, eventName, handlerProxy );
			} else {
				element.bind( eventName, handlerProxy );
			}
		});
	},

	_off: function( element, eventName ) {
		eventName = (eventName || "").split( " " ).join( this.eventNamespace + " " ) + this.eventNamespace;
		element.unbind( eventName ).undelegate( eventName );
	},

	_delay: function( handler, delay ) {
		function handlerProxy() {
			return ( typeof handler === "string" ? instance[ handler ] : handler )
				.apply( instance, arguments );
		}
		var instance = this;
		return setTimeout( handlerProxy, delay || 0 );
	},

	_hoverable: function( element ) {
		this.hoverable = this.hoverable.add( element );
		this._on( element, {
			mouseenter: function( event ) {
				$( event.currentTarget ).addClass( "ui-state-hover" );
			},
			mouseleave: function( event ) {
				$( event.currentTarget ).removeClass( "ui-state-hover" );
			}
		});
	},

	_focusable: function( element ) {
		this.focusable = this.focusable.add( element );
		this._on( element, {
			focusin: function( event ) {
				$( event.currentTarget ).addClass( "ui-state-focus" );
			},
			focusout: function( event ) {
				$( event.currentTarget ).removeClass( "ui-state-focus" );
			}
		});
	},

	_trigger: function( type, event, data ) {
		var prop, orig,
			callback = this.options[ type ];

		data = data || {};
		event = $.Event( event );
		event.type = ( type === this.widgetEventPrefix ?
			type :
			this.widgetEventPrefix + type ).toLowerCase();
		// the original event may come from any element
		// so we need to reset the target on the new event
		event.target = this.element[ 0 ];

		// copy original event properties over to the new event
		orig = event.originalEvent;
		if ( orig ) {
			for ( prop in orig ) {
				if ( !( prop in event ) ) {
					event[ prop ] = orig[ prop ];
				}
			}
		}

		this.element.trigger( event, data );
		return !( $.isFunction( callback ) &&
			callback.apply( this.element[0], [ event ].concat( data ) ) === false ||
			event.isDefaultPrevented() );
	}
};

$.each( { show: "fadeIn", hide: "fadeOut" }, function( method, defaultEffect ) {
	$.Widget.prototype[ "_" + method ] = function( element, options, callback ) {
		if ( typeof options === "string" ) {
			options = { effect: options };
		}
		var hasOptions,
			effectName = !options ?
				method :
				options === true || typeof options === "number" ?
					defaultEffect :
					options.effect || defaultEffect;
		options = options || {};
		if ( typeof options === "number" ) {
			options = { duration: options };
		}
		hasOptions = !$.isEmptyObject( options );
		options.complete = callback;
		if ( options.delay ) {
			element.delay( options.delay );
		}
		if ( hasOptions && $.effects && $.effects.effect[ effectName ] ) {
			element[ method ]( options );
		} else if ( effectName !== method && element[ effectName ] ) {
			element[ effectName ]( options.duration, options.easing, callback );
		} else {
			element.queue(function( next ) {
				$( this )[ method ]();
				if ( callback ) {
					callback.call( element[ 0 ] );
				}
				next();
			});
		}
	};
});

return $.widget;

}));

根据ua检测ie浏览器版本

function IEMode(){
  var ua = navigator.userAgent.toLowerCase();
  var re_trident = /\btrident\/([0-9.]+)/;
  var re_msie = /\b(?:msie |ie |trident\/[0-9].*rv[ :])([0-9.]+)/;
  var version;

  if(!re_msie.test(ua)){return false;}

  var m = re_trident.exec(ua);
  if(m){
    version = m[1].split(".");
    version[0] = parseInt(version[0], 10) + 4;
    version = version.join(".");
  }else{
    m = re_msie.exec(ua);
    version = m[1];
  }
  return parseFloat(version);
}


var ie = IEMode();
if(ie && ie < 8){
  // 你的浏览器太老了。
}

var isIE6 = navigator.userAgent.indexOf("MSIE 6.0") !== -1;
var isIE7 = IEMode() == 7;
var isIE8 = navigator.userAgent.indexOf("Trident 4.0") !== -1;
var isIE9 = navigator.userAgent.indexOf("Trident 5.0") !== -1;
var isIE10 = navigator.userAgent.indexOf("Trident 6.0") !== -1;
var isIE11 = navigator.userAgent.indexOf("Trident 7.0") !== -1;

IEMode的作用是避免将IE内核的浏览器识别为IE,如搜狗浏览器、360浏览器等双核浏览器。

如果只需要简单的做下判断,可以用如下代码:

// 单个浏览器识别:
var isIE6 = navigator.userAgent.indexOf("MSIE 6.0") !== -1;
var isIE7 = navigator.userAgent.indexOf("MSIE 7.0") !== -1;
var isIE8 = navigator.userAgent.indexOf("MSIE 8.0") !== -1;
var isIE9 = navigator.userAgent.indexOf("MSIE 9.0") !== -1;
var isIE10 = navigator.userAgent.indexOf("MSIE 10.0") !== -1;
//!var isIE11 = navigator.userAgent.indexOf("IE 11.0") !== -1;
var isIE11 = /\btrident\/[0-9].*rv[ :]11\.0/.test(navigator.userAgent);

// 多个浏览器识别
var isIE67 = /\bMSIE [67]\.0\b/.test(navigator.userAgent);
var isIE678 = /\bMSIE [678]\.0\b/.test(navigator.userAgent);

git操作常见错误及解决方法

1、 error: Your local changes to the following files would be overwritten by merge:

出现原因:如果系统中有一些配置文件在服务器上做了配置修改,然后后续开发又新添加一些配置项的时候,在发布这个配置文件的时候,会发生代码冲突。

主要就是文件修改不一致。需要合并代码。

解决方法:

1)如果希望保留生产服务器上所做的改动,仅仅并入新配置项, 处理方法如下:

git stash
git pull
git stash pop

然后可以使用git diff -w +文件名 来确认代码自动合并的情况.

2) 如果希望用代码库中的文件完全覆盖本地工作版本. 方法如下:

git reset --hard
git pull

其中git reset是针对版本,如果想针对文件回退本地修改,使用

git checkout HEAD file/to/restore

============ 
后续遇到其他问题继续更新!

利用chrome的workspace快速调试CSS

使用Workspace条件:

  • Chrome V31+(正式版)
  • 本地服务器开发
image001

1、点击F12工具的设置按钮 

image002
image003

2、点击左侧的workspace 

3、点击Add folder 

image004
image005
image006

4、选择服务器所在的根目录,之后确定会chrome会在上面做出一个提示,点击允许 

5、双击下图所示的地方,配置映射关系, 

6、点击Edit按钮写映射关系,视具体情况填写,注意右边的/一定要填写(关键性步骤) 

image007
image008

7、然后回到一个页面中去,试着去更改一个样式数值,验证是否生效 

8、最后看看是否成功 

注意Workspace只对外部引入的CSS样式有效!

bootstrap中 $.fn.Aa.Constructor = Aa

在bootstrap js源码中,在插件最后经常看到

$.fn.Aa.Constructor = Aa

这样一句。

这里注意,Constructor 是大写的C,而不是我们常写的那个constructor。

这句的作用,是将插件类暴露给外界,这样可以修改和添加类里面的方法了。

如下面语句,初始化tooltip后,给Tooltip新增test方法。

$.fn.tooltip.Constructor.prototype.test = function(){
        console.log('test')
    }
    $('#example').tooltip('test')

在调用插件后,在控制台会输出test字符串。

再举一个栗子:

var tmp = $.fn.tooltip.Constructor.prototype.show;
$.fn.tooltip.Constructor.prototype.show = function () {
  tmp.call(this);
  if (this.options.callback) {
    this.options.callback();
  }
}

$('#selector').tooltip({ 
  placement: 'top', 
  callback: function() { 
    alert('hello') 
  } 
});

给show方法新增一个callback回调。

javascript中constructor的作用

这里其实并不是要讲 constructor 的作用。 
而是为了要分析这句代码的含义:

f.prototype.constructor = f

经常会在别人写的类里面看到这句代码(其中f为function名称)。

为了搞清楚这句代码的含义,首先要大概先了解constructor的作用。 
在上一篇文章 《javascript中关于new的理解》 ,中,我们知道了如何创建一个构造函数。 
文章重点主要是侧重new的用法,而省去了很多其他相关联的知识点。

那么在创建构造函数的时候,会同时创建这个构造函数的 prototype 属性,(更准确的说应该是每个函数都有一个默认的prototype 属性),而prototype里的constructer 则指向构造函数。 
也就是说 constructor始终指向创建当前对象的构造函数 。记住这个点。 
如下面代码:

function Person(name) {
	 this.name = name;
 };

Person.prototype.getName = function() {
	return this.name;
};

//实例化对象
var p = new Person("ZhangSan");
//查看结果:Person的constructor始终是指向Person的
console.log(p.constructor === Person);  // true
console.log(Person.prototype.constructor === Person); // true

那么也就是说

f.prototype.constructor = f

这句代码是多余的,因为默认情况下就是这样。

但是 ,当时当我们重新定义函数的prototype时(注意:和上例的区别,这里不是修改而是 覆盖 ), constructor就指向Object里。

看下面的代码:

function Person(name) {
	this.name = name;
};
Person.prototype = {
	getName: function() {
		return this.name;
	}
};
var p = new Person("ZhangSan");
console.log(p.constructor === Person);  // false
console.log(Person.prototype.constructor === Person); // false
console.log(p.constructor.prototype.constructor === Person); // false

注意这里是直接修改了prototype,而不是在prototype上加方法。

为什么会发生这种情况?因为 constructor始终指向创建自身的构造函数 ,那上面那段代码实际等价为:

Person.prototype = new Object({
    getName: function() {
        return this.name;
    }
});

这样的话,就易于理解了。为什么prototype={}之后,constructor指向就发生了变化。

为了使构造函数的实例的创建者保持正确的引用,就要用这句代码来修正引用

f.prototype.constructor == f

再引用网上的一张图,也许理解起来更直观:

图片来源: http://www.nowamagic.net/librarys/veda/detail/1642

最后总结下:

f.prototype.constructor = f,这句代码只有这样写 f.prototype ={} 的情况下才使用。 
也许你会问,我不加这句好像也没什么影响啊。。 
确实,这种“高级代码”对于我等普通的P民几乎没作用,因为我们写不出那些高上大的代码。一般写框架、写类库的时候也许会用到。

但是为了保持良好的编码习惯,还是加一下比较好,呵呵。

javascript中关于new的理解

Javascript中,实例化一个对象,会用到new关键字。

经常有人会问我,对于一个函数,什么时候该使用new关键字。

在回答这个问题之前,需要先了解清楚new的本质,在调用new Function的时候,new做了什么操作。

先看如下代码:

// 定义类 类名字是 classA
function classA(){
	this.name=1;
}
classA.prototype.show = function(){
	alert(this.name);
};
// 用new实例化
var b = new classA();
b.show();

var b = new classA();

这句中,new做了以下几件事情。 
1、创建一个新的对象,这个对象的类型是object; 
2、查找class的prototype上的所有方法、属性,复制一份给创建的Object 
3、将构造函数classA内部的this指向创建的Object 
4、创建的Object的__proto__指向class的prototype 
5、执行构造函数class 
6、返回新创建的对象给变量b

这个流程应该比较好理解的。这里再解释一下: 
1、构造函数:我们一般把new 后面的函数称为构造函数,如new classA(),其中classA就为构造函数 
2、第四点的__proto__,可能比较难理解。 
每个对象都会在其内部初始化一个属性,就是__proto__,可以在chrome中的调试器里写个对象查看下。 当我们访问一个对象的属性时,如果这个对象内部不存在这个属性,那么他就会去__proto__里找这个属性 ,这个__proto__又会有自己的__proto__,于是就这样一直找下去,也就是我们平时所说的原型链的概念。

当我们调用b.show()时,首先b中没有show这个属性,于是,它就需要到它的__proto__中去找,也就是ClassA.prototype, 
而我们在上面定义了ClassA.prototype.show=function(){}; 于是,就找到了这个方法。

再用下面的代码来理解

var b = {}
b.__proto__ =  ClassA.prototype
ClassA.call(b)

最后再用一句话总结:new关键字以ClassA()为模板创建了一个新的对象,它复制了ClassA构造器中的所有成员变量,同时this指向新创建的对象。

有2点需要注意: 
1、如果构造函数内没有返回值,则默认是返回this(当前上下文),要不然就返回 任意非原始类型值 。 
2、如果不用new关键字,如

var b = classA();

则classA值会返回undefined,并且this(执行上下文)是window对象。 
也就是说如果你不new的话,this指的就是window全局对象了。 
如下面代码:

// 定义类 类名字是 classA
function classA(){
	this.name=1;
}
//执行classA
classA();
//看下name是undefined还是1
name //返回1

看到这里,相信绝大多数人应该都理解了new的用法了。

jquery插件及zepto插件 写法异同

jquery插件及zepto插件,写法上有些区别。

区别点: 
1、自定义事件的命名空间 
jq的时间命名空间是用点“.”,而zepto是用冒号“:” 

//jquery
$(this).trigger('cusevent.pluginname');

//zepto
$(this).trigger('cusevent:pluginname');

2、data() 方法 
jq的data方法非常强大,可以存储字符串、对象、函数等一切js数据 
而zepto的data方法则非常简陋,只能纯一下字符串。 
由于写插件时,常用data方法来缓存插件实例化后的内容,所以这里需要做一下兼容修改。

// i is simply a counter, the rest 
// of what is stored will be instances
$.waiting.lookup = {
  i: 0
};

// store the new instance.. $t=$(this)
$.waiting.lookup[++$.waiting.lookup.i] = new $.waiting($t, o);
$t.data('waiting', $.waiting.lookup.i);

// retrieve the instance
var inst = $.waiting.lookup[$(this).data('waiting')];

最后附上,JQ插件的编写模板,写插件的时候就不用考虑代码组织结构了。

/**
 * Created by hugohua on 14-4-1.
 * jQuery plugin template
 */

/**
 * 将插件封装在一个闭包里面,防止外部代码污染  冲突
 */
(function ($) {
    /**
     * 定义一个插件 Plugin
     */
    var Plugin,
        privateMethod;  //插件的私有方法,也可以看做是插件的工具方法集

    /**
     * 这里是插件的主体部分
     * 这里是一个自运行的单例模式。
     * 这里之所以用一个 Plugin 的单例模式 包含一个 Plugin的类,主要是为了封装性,更好的划分代码块
     * 同时 也 方便区分私有方法及公共方法
     * PS:但有时私有方法为了方便还是写在了Plugin类里,这时建议私有方法前加上"_"
     */
    Plugin = (function () {

        /**
         * 插件实例化部分,初始化时调用的代码可以放这里
         * @param element 传入jq对象的选择器,如 $("#J_plugin").plugin() ,其中 $("#J_plugin") 即是 element
         * @param options 插件的一些参数神马的
         * @constructor
         */
        function Plugin(element, options) {
            //将dom jquery对象赋值给插件,方便后续调用
            this.$element = $(element);

            //将插件的默认参数及用户定义的参数合并到一个新的obj里
            this.settings = $.extend({}, $.fn.plugin.defaults,options);
            //如果将参数设置在dom的自定义属性里,也可以这样写
            this.settings = $.extend({}, $.fn.plugin.defaults, this.$element.data(), options);

            //初始化调用一下
            this.init();
        }

        /**
         * 写法一
         * 插件的公共方法,相当于接口函数,用于给外部调用
         */
        Plugin.prototype.doSomething = function () {
            /**
             * 方法内容
             */
        };

        /**
         * 写法二
         * 将插件所有函数放在prototype的大对象里
         * @type {{}}
         */
        Plugin.prototype = {

            init:function(){
                console.log('init');
            },

            doSomething2:function(){

            }
        };

        return Plugin;

    })();

    /**
     * 插件的私有方法
     */
    privateMethod = function () {

    };

    /**
     * 这里是将Plugin对象 转为jq插件的形式进行调用
     * 定义一个插件 plugin
     */
    $.fn.plugin = function (options) {
        return this.each(function () {
            var $me = $(this),
                instance = $me.data('plugin');
            if(!instance){
                //将实例化后的插件缓存在dom结构里(内存里)
                $me.data('plugin', new Plugin(this, options));
            }

            /**
             * 优雅处: 如果插件的参数是一个字符串,则 调用 插件的 字符串方法。
             * 如 $('#id').plugin('doSomething') 则实际调用的是 $('#id).plugin.doSomething();
             * doSomething是刚才定义的接口。
             * 这种方法 在 juqery ui 的插件里 很常见。
             */
            if ($.type(options) === 'string') instance[options]();
        });
    };

    /**
     * 插件的默认值
     */
    $.fn.plugin.defaults = {
        property1: 'value',
        property2: 'value'
    };

    /**
     * 优雅处: 通过data-xxx 的方式 实例化插件。
     * 这样的话 在页面上就不需要显示调用了。
     * 可以查看bootstrap 里面的JS插件写法
     */
    $(function () {
        return new Plugin($('[data-plugin]'));
    });
})(JQuery);