DIV CSS 佈局教程網

100 個實用 JavaScript 自定函式整理:依功能分類的完整工具箱
編輯:JavaScript綜合知識     

日常開發中,有些功能會反覆出現:字串截斷、格式驗證、瀏覽器判斷、編碼轉換、頁面尺寸計算……與其每次重新 Google,不如整理成一份自己的工具箱。以下依功能分類,挑選最實用的原生 JavaScript 函式並附上說明。

一、字串處理

1. 按顯示寬度截斷字串(中文算兩個字元)

function cutstr(str, len) {
    var temp, icount = 0;
    var patrn = /[^\x00-\xff]/;   // 非 ASCII 視為全形
    var strre = "";
    for (var i = 0; i < str.length; i++) {
        if (icount < len - 1) {
            temp = str.substr(i, 1);
            icount += (patrn.exec(temp) == null) ? 1 : 2;
            strre += temp;
        } else {
            break;
        }
    }
    return strre + "...";
}

2. 去除首尾空白、取代全部

String.prototype.trim = function () {
    return this.replace(/^\s*(.*?)\s+$/, "$1");
};

String.prototype.replaceAll = function (s1, s2) {
    return this.replace(new RegExp(s1, "gm"), s2);
};

現代寫法可直接用原生的 str.trim() 與 str.replaceAll()(後者 ES2021 起標準支援)。若要動態組字串成正則,記得先跳脫特殊字元。

3. 判斷前綴、後綴與空值

String.prototype.startWith = function (s) { return this.indexOf(s) === 0; };
String.prototype.endWith = function (s) {
    var d = this.length - s.length;
    return (d >= 0 && this.lastIndexOf(s) === d);
};

function isNULL(chars) {
    if (chars == null) return true;
    return String(chars).replace(/^\s+|\s+$/g, "").length === 0;
}

4. 全形與半形互轉

function ToDBC(str) {   // 全形 → 半形
    var result = "";
    for (var i = 0; i < str.length; i++) {
        var code = str.charCodeAt(i);
        if (code >= 65281 && code <= 65374) {
            result += String.fromCharCode(code - 65248);
        } else if (code === 12288) {
            result += String.fromCharCode(32);
        } else {
            result += str.charAt(i);
        }
    }
    return result;
}

function ToCDB(str) {   // 半形 → 全形
    var result = "";
    for (var i = 0; i < str.length; i++) {
        var code = str.charCodeAt(i);
        if (code >= 33 && code <= 126) {
            result += String.fromCharCode(code + 65248);
        } else if (code === 32) {
            result += String.fromCharCode(12288);
        } else {
            result += str.charAt(i);
        }
    }
    return result;
}

5. HTML 轉義與還原

function HtmlEncode(text) {
    return text.replace(/&/g, '&amp;')
               .replace(/</g, '&lt;')
               .replace(/>/g, '&gt;')
               .replace(/"/g, '&quot;');
}

function HtmlDecode(text) {
    return text.replace(/&lt;/g, '<')
               .replace(/&gt;/g, '>')
               .replace(/&quot;/g, '"')
               .replace(/&amp;/g, '&');
}

注意還原時 & 必須最後才處理,否則 &amp;lt; 會被連續還原成 <,造成 XSS 風險。

二、表單驗證與正則表達式

6. 常用驗證函式

function isDigit(value) { return /^[0-9]*$/.test(value) && value !== ""; }

function isEmail(str) {
    return /^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$/.test(str);
}

function isNumber(chars)  { return /^\d*$/.test(chars); }        // 整數
function isFloat(str)     { return /^-?\d+(\.\d+)?$/.test(str); } // 浮點數
function isLetters(str)   { return /^[A-Za-z]+$/.test(str); }
function isValidPost(c)   { return /^\d{6}$/.test(c); }           // 郵遞區號
function isValidLength(c, len) { return c.length >= len; }

function IsURL(strUrl) {
    return /^(https?:\/\/)?[\w-]+(\.[\w-]+)+([\/?%=&.-]*)?$/i.test(strUrl);
}

7. 過濾危險字元

function stripscript(s) {
    var pattern = new RegExp("[`~!@#$^&*()=|{}':;',\\[\\].<>/?~!@#¥……&*()——|{}【】‘;:”“'。,、?]");
    var rs = "";
    for (var i = 0; i < s.length; i++) {
        rs += s.substr(i, 1).replace(pattern, '');
    }
    return rs;
}

實務上更推薦用白名單而非黑名單:明確定義允許的字元集,其餘一律拒絕。黑名單永遠列不完,也容易誤傷正常輸入。

8. 全表單文字欄位驗證

function checkAllTextValid(form) {
    var resultTag = 0, flag = 0;
    for (var i = 0; i < form.elements.length; i++) {
        if (form.elements[i].type === "text") {
            flag++;
            if (/^[^|"'<>]*$/.test(form.elements[i].value)) {
                resultTag++;
            } else {
                form.elements[i].select();   // 選中有問題的欄位方便修正
            }
        }
    }
    if (resultTag === flag) return true;
    alert("文字欄位不可包含單引號、雙引號、豎線與尖括號,請檢查輸入!");
    return false;
}

9. checkbox 全選 / 全不選

function checkAll() {
    var selectall = document.getElementById("selectall");
    var allbox = document.getElementsByName("allbox");
    for (var i = 0; i < allbox.length; i++) {
        allbox[i].checked = selectall.checked;
    }
}

function get_checkbox_value(field) {
    if (field && field.length) {
        for (var i = 0; i < field.length; i++) {
            if (field[i].checked && !field[i].disabled) return field[i].value;
        }
    }
    return "";
}

三、URL 與 Cookie

10. 取得 URL 中的 GET 參數

function get_get() {
    var querystr = window.location.href.split("?");
    var GET = {};
    if (querystr[1]) {
        querystr[1].split("&").forEach(function (pair) {
            var kv = pair.split("=");
            GET[kv[0]] = decodeURIComponent(kv[1] || "");
        });
    }
    return GET;
}

// 取單一參數(正則版)
function getUrlParam(name) {
    var reg = new RegExp("(^|&)" + name + "=([^&]*)(&|$)");
    var r = window.location.search.substr(1).match(reg);
    return r != null ? decodeURIComponent(r[2]) : null;
}

現代寫法一行搞定:new URLSearchParams(location.search).get('cid')。

11. 從 URL 取出主機名稱

function getHost(url) {
    if (url == null) url = window.location.href;
    var match = url.match(/^w*:\/\/([^\/]*).*/);
    return (match != null) ? match[1] : "null";
}

12. Cookie 讀寫

function setCookie(name, value, Hours) {
    var exp = new Date(Date.now() + Hours * 60 * 60 * 1000);
    document.cookie = name + "=" + encodeURIComponent(value)
        + ";path=/;expires=" + exp.toUTCString();
}

function getCookie(name) {
    var arr = document.cookie.match(new RegExp("(^| )" + name + "=([^;]*)(;|$)"));
    return arr != null ? decodeURIComponent(arr[2]) : null;
}

四、日期格式化

Date.prototype.Format = function (formatStr) {
    var Week = ['日', '一', '二', '三', '四', '五', '六'];
    var pad = function (n) { return n > 9 ? String(n) : '0' + n; };
    var map = {
        'yyyy': this.getFullYear(),
        'yy': String(this.getFullYear() % 100),
        'MM': pad(this.getMonth() + 1),
        'dd': pad(this.getDate()),
        'HH': pad(this.getHours()),
        'mm': pad(this.getMinutes()),
        'ss': pad(this.getSeconds()),
        'ww': Week[this.getDay()]
    };
    return formatStr.replace(/yyyy|yy|MM|dd|HH|mm|ss|ww/g, function (k) {
        return map[k];
    });
};

// 用法:new Date().Format('yyyy-MM-dd HH:mm:ss')

用單次全域 replace 搭配對照表,比連續十幾個 replace 更簡潔,也避免了「先取代 MM 再取代 M」造成的連鎖誤換。

五、DOM 與事件

13. 簡易 $、顯示切換、insertAfter

function $(id) { return !id ? null : document.getElementById(id); }

function insertAfter(newChild, refChild) {
    var parElem = refChild.parentNode;
    if (parElem.lastChild === refChild) {
        refChild.appendChild(newChild);
    } else {
        parElem.insertBefore(newChild, refChild.nextSibling);
    }
}

function display(id) {
    var obj = $(id);
    if (obj.style.visibility) {
        obj.style.visibility = (obj.style.visibility === 'visible') ? 'hidden' : 'visible';
    } else {
        obj.style.display = (obj.style.display === '') ? 'none' : '';
    }
}

14. 跨瀏覽器綁定事件

function addEventSamp(obj, evt, fn) {
    if (obj.addEventListener) {
        obj.addEventListener(evt, fn, false);
    } else if (obj.attachEvent) {
        obj.attachEvent('on' + evt, fn);
    }
}

15. 依 class 名稱取得元素

function getElementsByClassName(name) {
    var tags = document.getElementsByTagName('*') || document.all;
    var els = [];
    for (var i = 0; i < tags.length; i++) {
        if ((' ' + tags[i].className + ' ').indexOf(' ' + name + ' ') > -1) {
            els.push(tags[i]);
        }
    }
    return els;
}

現代瀏覽器請直接用 document.getElementsByClassName(name) 或 querySelectorAll。

16. 回到頂部(緩動捲動)

function backTop(btnId) {
    var btn = document.getElementById(btnId);
    var d = document.documentElement, b = document.body;
    window.onscroll = function () {
        btn.style.display = (d.scrollTop + b.scrollTop > 100) ? 'block' : 'none';
    };
    btn.onclick = function () {
        btn.style.display = "none";
        window.onscroll = null;
        this.timer = setInterval(function () {
            d.scrollTop -= Math.ceil((d.scrollTop + b.scrollTop) * 0.1);
            b.scrollTop -= Math.ceil((d.scrollTop + b.scrollTop) * 0.1);
            if ((d.scrollTop + b.scrollTop) === 0) clearInterval(btn.timer);
        }, 10);
    };
}

17. offsetX 相容性處理(Firefox 不支援)

function getPageCoord(element) {
    var coord = { X: 0, Y: 0 };
    while (element) {
        coord.X += element.offsetLeft;
        coord.Y += element.offsetTop;
        element = element.offsetParent;
    }
    return coord;
}

function getOffset(e) {
    var pageCoord = getPageCoord(e.target);
    var eventCoord = {
        X: window.pageXOffset + e.clientX,
        Y: window.pageYOffset + e.clientY
    };
    return { X: eventCoord.X - pageCoord.X, Y: eventCoord.Y - pageCoord.Y };
}

六、頁面尺寸與捲動

function getPageHeight() {
    var g = document, a = g.body, f = g.documentElement;
    var d = (g.compatMode === "BackCompat") ? a : g.documentElement;
    return Math.max(f.scrollHeight, a.scrollHeight, d.clientHeight);
}

function getPageWidth() {
    var g = document, a = g.body, f = g.documentElement;
    var d = (g.compatMode === "BackCompat") ? a : g.documentElement;
    return Math.max(f.scrollWidth, a.scrollWidth, d.clientWidth);
}

function getPageScrollTop()  { return document.documentElement.scrollTop || document.body.scrollTop; }
function getPageScrollLeft() { return document.documentElement.scrollLeft || document.body.scrollLeft; }

function getPageViewWidth() {
    var d = document;
    return (d.compatMode === "BackCompat" ? d.body : d.documentElement).clientWidth;
}

function getViewSize() {
    var de = document.documentElement, db = document.body;
    return [
        de.clientWidth  === 0 ? db.clientWidth  : de.clientWidth,
        de.clientHeight === 0 ? db.clientHeight : de.clientHeight
    ];
}

七、瀏覽器與環境判斷

18. 用條件註解判斷 IE 版本(優雅且無需解析 userAgent)

var _IE = (function () {
    var v = 3, div = document.createElement('div'), all = div.getElementsByTagName('i');
    while (
        div.innerHTML = '<!--[if gt IE ' + (++v) + ']><i></i><![endif]-->',
        all[0]
    );
    return v > 4 ? v : false;
}());

這個技巧的優點是完全不依賴 userAgent 字串,而 userAgent 因為歷史包袱早被各家瀏覽器改得面目全非(IE11 的 UA 甚至完全不含 "MSIE")。若無特殊相容需求,現代專案更應改用特性偵測。

19. 行動裝置判斷

function isMobileUserAgent() {
    return /iphone|ipod|android.*mobile|windows.*phone|blackberry.*mobile/i
        .test(navigator.userAgent.toLowerCase());
}

function isAppleMobileDevice() {
    return /iphone|ipod|ipad|macintosh/i.test(navigator.userAgent.toLowerCase());
}

function isAndroidMobileDevice() {
    return /android/i.test(navigator.userAgent.toLowerCase());
}

function isTouchScreen() {
    return ('ontouchstart' in window)
        || (window.DocumentTouch && document instanceof DocumentTouch);
}

20. 判斷變數是否空值

function empty(v) {
    switch (typeof v) {
        case 'undefined': return true;
        case 'string':    return v.replace(/^\s+|\s+$/g, "").length === 0;
        case 'boolean':   return !v;
        case 'number':    return v === 0;
        case 'object':
            if (v === null) return true;
            if (v.length !== undefined && v.length === 0) return true;
            for (var k in v) { return false; }
            return true;
    }
    return false;
}

21. 判斷變數與函式是否存在

function isExitsFunction(funcName) {
    try {
        return typeof (eval(funcName)) === "function";
    } catch (e) { return false; }
}

function isExitsVariable(variableName) {
    try {
        return typeof (eval(variableName)) !== "undefined";
    } catch (e) { return false; }
}

八、編碼與進位

22. IP 與整數互轉

function _ip2int(ip) {
    var p = ip.split(".");
    var num = Number(p[0]) * 256 * 256 * 256
            + Number(p[1]) * 256 * 256
            + Number(p[2]) * 256
            + Number(p[3]);
    return num >>> 0;   // 轉為無正負號整數
}

function _int2ip(num) {
    return [
        (num >>> 24) >>> 0,
        ((num << 8) >>> 24) >>> 0,
        ((num << 16) >>> 24) >>> 0,
        (num << 24) >>> 24
    ].join(".");
}

23. Base64 與 UTF-8 解碼

function base64_decode(data) {
    var b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=";
    var o1, o2, o3, h1, h2, h3, h4, bits, i = 0, ac = 0, dec = "", tmp_arr = [];
    if (!data) return data;
    data += '';
    do {
        h1 = b64.indexOf(data.charAt(i++));
        h2 = b64.indexOf(data.charAt(i++));
        h3 = b64.indexOf(data.charAt(i++));
        h4 = b64.indexOf(data.charAt(i++));
        bits = h1 << 18 | h2 << 12 | h3 << 6 | h4;
        o1 = bits >> 16 & 0xff;
        o2 = bits >> 8 & 0xff;
        o3 = bits & 0xff;
        if (h3 === 64)      tmp_arr[ac++] = String.fromCharCode(o1);
        else if (h4 === 64) tmp_arr[ac++] = String.fromCharCode(o1, o2);
        else                tmp_arr[ac++] = String.fromCharCode(o1, o2, o3);
    } while (i < data.length);
    return utf8_decode(tmp_arr.join(''));
}

function utf8_decode(str_data) {
    var tmp_arr = [], i = 0, ac = 0, c1, c2, c3;
    str_data += '';
    while (i < str_data.length) {
        c1 = str_data.charCodeAt(i);
        if (c1 < 128) {
            tmp_arr[ac++] = String.fromCharCode(c1); i++;
        } else if (c1 > 191 && c1 < 224) {
            c2 = str_data.charCodeAt(i + 1);
            tmp_arr[ac++] = String.fromCharCode(((c1 & 31) << 6) | (c2 & 63));
            i += 2;
        } else {
            c2 = str_data.charCodeAt(i + 1);
            c3 = str_data.charCodeAt(i + 2);
            tmp_arr[ac++] = String.fromCharCode(((c1 & 15) << 12) | ((c2 & 63) << 6) | (c3 & 63));
            i += 3;
        }
    }
    return tmp_arr.join('');
}

現代專案請直接使用 btoa() / atob(),並注意它們只處理 Latin-1,處理中文需先 encodeURIComponent 或改用 TextEncoder。

九、金額大寫轉換

function transform(tranvalue) {
    try {
        var dw2 = new Array("", "萬", "億");            // 大單位
        var dw1 = new Array("拾", "佰", "仟");           // 小單位
        var dw  = new Array("零", "壹", "貳", "叁", "肆", "伍", "陸", "柒", "捌", "玖");
        var source = String(tranvalue).split(".");
        var num = source[0], dig = source[1] || "";
        var k1 = 0, k2 = 0, sum = 0, str = "";
        var len = num.length;
        for (var i = 1; i <= len; i++) {
            var n = num.charAt(len - i);
            var bn = (len - i - 1 >= 0) ? num.charAt(len - i - 1) : 0;
            sum += Number(n);
            if (sum !== 0) {
                str = dw[Number(n)] + str;
                if (n === '0') sum = 0;
            }
            if (len - i - 1 >= 0) {
                if (k1 !== 3) {
                    if (bn !== 0) str = dw1[k1] + str;
                    k1++;
                } else {
                    k1 = 0;
                    var temp = str.charAt(0);
                    if (temp === "萬" || temp === "億") str = str.substr(1);
                    str = dw2[k2] + str;
                    sum = 0;
                }
            }
            if (k1 === 3) k2++;
        }
        var strdig = "";
        if (dig !== "") {
            var d1 = dig.charAt(0), d2 = dig.charAt(1);
            if (Number(d1) !== 0) strdig += dw[Number(d1)] + "角";
            if (Number(d2) !== 0) strdig += dw[Number(d2)] + "分";
        }
        return str + "元" + strdig;
    } catch (e) {
        return "0元";
    }
}

這段邏輯的核心是從個位數往高處理,每三位插入一個大單位(萬、億),並處理連續零的合併。實務上若對格式要求嚴格(如財務報表),建議改用經過驗證的成熟函式庫並補齊測試案例。

十、常用正則表達式速查

// 數字類
非負整數   /^\d+$/
正整數     /^[0-9]*[1-9][0-9]*$/
負整數     /^-[0-9]*[1-9][0-9]*$/
整數       /^-?\d+$/
浮點數     /^-?\d+(\.\d+)?$/

// 字元類
中文字符   /[\u4e00-\u9fa5]/
雙位元組   /[^\x00-\xff]/
英文字串   /^[A-Za-z]+$/
帳號       /^[a-zA-Z][a-zA-Z0-9_]{4,15}$/

// 聯絡資訊
Email      /^[\w.-]+@[\w-]+(\.[\w-]+)+$/
URL        /^[a-zA-Z]+:\/\/[^\s]+$/ 
手機號碼   /^1[3-9]\d{9}$/
郵遞區號   /^[1-9]\d{5}$/

// 其他
空白行     /\n\s*\r/
首尾空白   /^\s+|\s+$/g
HTML 標記  /<(\S*?)[^>]*>.*?<\/\1>|<.*?\/>/
IP 位址    /((2[0-4]\d|25[0-5]|[01]?\d?\d)\.){3}(2[0-4]\d|25[0-5]|[01]?\d?\d)/

結語

這份工具箱的價值不在於「收藏」,而在於理解每一段程式碼背後的原理:為什麼中文要算兩個字元、為什麼 HTML 還原時 & 要最後處理、為什麼 IP 轉整數要用無號右移。理解了原理,你才能判斷哪些函式該留、哪些該被原生 API 取代。

同時要提醒:這類網路流傳的函式集合年代久遠,其中不少已有更好的原生替代(trim()、replaceAll()、URLSearchParams、Intl.DateTimeFormat、btoa()、querySelectorAll())。使用前請先確認目標環境是否支援,並優先選擇標準 API。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved