Javascript自訂函數

$()

實至名歸，最值錢的函數，可以節省多少流量啊。最先由Prototype.js實現的，那個洪荒時代遺留下來的珍獸，現在有許多變種：
01.function $() {
02.    var elements = [];
03.    for (var i = 0; i < arguments.length; i++) {
04.        var element = arguments[i];
05.        if (typeof element == 'string')
06.            element = document.getElementById(element);
07.        if (arguments.length == 1)
08.            return element;
09.        elements.push(element);
10.    }
11.    return elements;
12.}
 

2、getStyle()與setStyle()

所有UI控制項都應該存在的函數，動態設定樣式與擷取樣式。這個可以寫得很短，也可以寫得很長，但要精確取得樣式，一個字：難！但我發現許多問題都是發端於IE，微軟的開發人員好像從來不打算給出getComputedStyle這樣的函數，與之相近的currentStyle會返回auto、inhert、‘ ’等讓你哭笑不得的值，這還沒有算上IE怪癖模式帶來的難度呢！各類庫的實現是非常長與難分離出來的，下面是我實現的版本：
01.function setStyle(el,prop,value){
02.   if(prop == "opacity" && !+"v1"){
03.     //IE7 bug:filter 濾鏡要求 hasLayout=true 方可執行（否則沒有效果）
04.     if (!el.currentStyle || !el.currentStyle.hasLayout) el.style.zoom = 1;
05.     prop = "filter";
06.     if(!!window.XDomainRequest){
07.       value ="progid:DXImageTransform.Microsoft.Alpha(style=0,opacity="+value*100+")";
08.     }else{
09.       value ="alpha(opacity="+value*100+")"
10.     }
11.   }
12.   el.style.cssText += ';' + (prop+":"+value);
13. }
14. function getStyle(el, style){
15.   if(!+"v1"){
16.     style = style.replace(/-(w)/g, function(all, letter){
17.       return letter.toUpperCase();
18.     });
19.     return el.currentStyle[style];
20.   }else{
21.     return document.defaultView.getComputedStyle(el, null).getPropertyValue(style)
22.   }
23. }
 

有關setStyle還可以看我另一篇博文，畢竟現在設定的樣式都是內聯樣式，與html混雜在一起。

3、getCookie()、setCookie()及deleteCookie()

做BBS與商業網站的應該經常用到，無理由每次都要讓使用者輸入密碼登入吧。我們需要藉助cookie實現自動登入功能：
01.function getCookie( name ) {
02.    var start = document.cookie.indexOf( name + "=" );
03.    var len = start + name.length + 1;
04.    if ( ( !start ) && ( name != document.cookie.substring( 0, name.length ) ) ) {
05.        return null;
06.    }
07.    if ( start == -1 ) return null;
08.    var end = document.cookie.indexOf( ';', len );
09.    if ( end == -1 ) end = document.cookie.length;
10.    return unescape( document.cookie.substring( len, end ) );
11.}
12.function setCookie( name, value, expires, path, domain, secure ) {
13.    var today = new Date();
14.    today.setTime( today.getTime() );
15.    if ( expires ) {
16.        expires = expires * 1000 * 60 * 60 * 24;
17.    }
18.    var expires_date = new Date( today.getTime() + (expires) );
19.    document.cookie = name+'='+escape( value ) +
20.        ( ( expires ) ? ';expires='+expires_date.toGMTString() : '' ) + //expires.toGMTString()
21.        ( ( path ) ? ';path=' + path : '' ) +
22.        ( ( domain ) ? ';domain=' + domain : '' ) +
23.        ( ( secure ) ? ';secure' : '' );
24.}
25.function deleteCookie( name, path, domain ) {
26.    if ( getCookie( name ) ) document.cookie = name + '=' +
27.            ( ( path ) ? ';path=' + path : '') +
28.            ( ( domain ) ? ';domain=' + domain : '' ) +
29.            ';expires=Thu, 01-Jan-1970 00:00:01 GMT';
30.}
 

4、inArray()

用於判斷檢查數組中是否存在某個值，下面方法取自Prototype類庫：
1.Array.prototype.inArray = function (value) {
2.    for (var i=0,l = this.length ; i <l ; i++) {
3.        if (this[i] === value) {
4.            return true;
5.        }
6.    }
7.    return false;
8.};
 

5、insertAfter()

DOM只提供了insertBefore，我們很有必要自己實現insertAfter。不過我認為 insertAdjacentElement是更好的選擇，現在除了Firefox其他瀏覽器都實現這個方法。下面是Jeremy Keith的版本：
1.function insertAfter(parent, node, referenceNode) {
2.    parent.insertBefore(node, referenceNode.nextSibling);
3.}

6、toggle()

用來顯示或隱藏一個DOM元素：
01.function toggle(obj) {
02.    var el = document.getElementById(obj);
03.    if ( el.style.display != 'none' ) {
04.        el.style.display = 'none';
05.    }
06.    else {
07.        el.style.display = '';
08.    }
09.}

7、cssQuery()

別名為getElementsBySeletor，由Dean Edwards最先實現，Prototype.js、JQuery等類庫都有相應實現，其中JQuery把它整合到$()選取器中，名聲蓋過其前輩。不過IE8等新銳瀏覽器已經實現querySelector與querySelectorAll方法，待到IE6與IE7報廢之日，它就無用了。無憂裡有它的實現原理講解。由於太長，就不粘出來了，具體可到原作者網站看看。

8、getElementsByClass()

我有收集癖，手頭上擁有許多版本，最後集思廣益自己實現了一個。下面是我的實現：
01.var getElementsByClassName = function (searchClass, node,tag) {
02.    if(document.getElementsByClassName){
03.        return  document.getElementsByClassName(searchClass)
04.    }else{
05.        node = node || document;
06.        tag = tag || "*";
07.        var classes = searchClass.split(" "),
08.        elements = (tag === "*" && node.all)? node.all : node.getElementsByTagName(tag),
09.        patterns = [],
10.        returnElements = [],
11.        current,
12.        match;
13.        var i = classes.length;
14.        while(--i >= 0){
15.            patterns.push(new RegExp("(^|\s)" + classes[i] + "(\s|$)"));
16.        }
17.        var j = elements.length;
18.        while(--j >= 0){
19.            current = elements[j];
20.            match = false;
21.            for(var k=0, kl=patterns.length; k<kl; k++){
22.                match = patterns[k].test(current.className);
23.                if (!match)  break;
24.            }
25.            if (match)  returnElements.push(current);
26.        }
27.        return returnElements;
28.    }
29.}
 

9、addLoadEvent()

我以前討論過這函數，不細說，就是慢了一點，各大類庫基本無視它，自行實現domReady版本。下面是Simon Willison 的實現：
01.var addLoadEvent = function(fn) {
02.  var oldonload = window.onload;
03.  if (typeof window.onload != 'function') {
04.    window.onload = fn;
05.  }else {
06.    window.onload = function() {
07.      oldonload();
08.      fn();
09.    }
10.  }
11.}
 

10、addEvent

網上最流行的版本是Scott Andrew的，據說Javascript界曾舉行一場比賽（此事件我們可以在Pro Javascript Techniques第100頁看到）或瀏覽PPK的網站，徵求添加事件與移除事件的函數，他就是其獲獎者。下面就是他的實現：
01.function addEvent(elm, evType, fn, useCapture) {
02.  if (elm.addEventListener) {
03.    elm.addEventListener(evType, fn, useCapture);//DOM2.0
04.    return true;
05.  }
06.  else if (elm.attachEvent) {
07.    var r = elm.attachEvent('on' + evType, fn);//IE5+
08.    return r;
09.  }
10.  else {
11.    elm['on' + evType] = fn;//DOM 0
12.  }
13.}
 

下面是Dean Edwards 的版本：
01.function addEvent(elm, evType, fn, useCapture) {
02.  if (elm.addEventListener) {
03.    elm.addEventListener(evType, fn, useCapture);//DOM2.0
04.    return true;
05.  }
06.  else if (elm.attachEvent) {
07.    var r = elm.attachEvent('on' + evType, fn);//IE5+
08.    return r;
09.  }
10.  else {
11.    elm['on' + evType] = fn;//DOM 0
12.  }
13.}

下面是Dean Edwards 的版本：
01.//addEvent/removeEvent written by Dean Edwards, 2005
02.//with input from Tino Zijdel
03.//http://dean.edwards.name/weblog/2005/10/add-event/
04.function addEvent(element, type, handler) {
05.    //為每一個事件處理函數指派一個唯一的ID
06.    if (!handler.$$guid) handler.$$guid = addEvent.guid++;
07.    //為元素的事件類型建立一個雜湊表
08.    if (!element.events) element.events = {};
09.    //為每一個"元素/事件"對建立一個事件處理常式的雜湊表
10.    var handlers = element.events[type];
11.    if (!handlers) {
12.        handlers = element.events[type] = {};
13.        //儲存存在的事件處理函數(如果有)
14.        if (element["on" + type]) {
15.            handlers[0] = element["on" + type];
16.        }
17.    }
18.    //將事件處理函數存入雜湊表
19.    handlers[handler.$$guid] = handler;
20.    //指派一個全域的事件處理函數來做所有的工作
21.    element["on" + type] = handleEvent;
22.};
23.//用來建立唯一的ID的計數器
24.addEvent.guid = 1;
25.function removeEvent(element, type, handler) {
26.    //從雜湊表中刪除事件處理函數
27.    if (element.events && element.events[type]) {
28.        delete element.events[type][handler.$$guid];
29.    }
30.};
31.function handleEvent(event) {
32.    var returnValue = true;
33.    //抓獲事件對象(IE使用全域事件對象)
34.    event = event || fixEvent(window.event);
35.    //取得事件處理函數的雜湊表的引用
36.    var handlers = this.events[event.type];
37.    //執行每一個處理函數
38.    for (var i in handlers) {
39.        this.$$handleEvent = handlers[i];
40.        if (this.$$handleEvent(event) === false) {
41.            returnValue = false;
42.        }
43.    }
44.    return returnValue;
45.};
46.//為IE的事件對象添加一些“缺失的”函數
47.function fixEvent(event) {
48.    //添加標準的W3C方法
49.    event.preventDefault = fixEvent.preventDefault;
50.    event.stopPropagation = fixEvent.stopPropagation;
51.    return event;
52.};
53.fixEvent.preventDefault = function() {
54.    this.returnValue = false;
55.};
56.fixEvent.stopPropagation = function() {
57.    this.cancelBubble = true;
58.};
 

功能非常強悍，解決IE的this指向問題，event總是作為第一個參數傳入，跨瀏覽器就更不在話下。

另，我還珍藏了一個HTML5工作群組的版本：
01.var addEvent=(function(){
02.    if(document.addEventListener){
03.        return function(el,type,fn){
04.            if(el.length){
05.                for(var i=0;i<el.length;i++){
06.                    addEvent(el[i],type,fn);
07.                }
08.            }else{
09.                el.addEventListener(type,fn,false);
10.            }
11.        };
12.    }else{
13.        return function(el,type,fn){
14.            if(el.length){
15.                for(var i=0;i<el.length;i++){
16.                    addEvent(el[i],type,fn);
17.                }
18.            }else{
19.                el.attachEvent('on'+type,function(){
20.                    return fn.call(el,window.event);
21.                });
22.            }
23.        };
24.    }
25.})();