這一篇當作隨身速查表來整理,涵蓋陣列 API、DOM 操作、常用集合結構、數字與日期處理、字串方法、瀏覽器特性偵測、繼承寫法,以及一批可直接複用的表單驗證函式。
// 定義與長度
var pageIds = new Array();
pageIds.push('A');
pageIds.length;
// shift:刪除第一項並回傳該元素,空陣列回傳 undefined
var a = [1,2,3,4,5];
var b = a.shift(); // a:[2,3,4,5] b:1
// unshift:從頭插入並回傳新長度(註:IE6 下回傳值為 undefined,不可靠,需要回傳值時可用 splice 代替)
var a = [1,2,3,4,5];
var b = a.unshift(-2,-1); // a:[-2,-1,1,2,3,4,5] b:7
// pop:刪除最後一項並回傳該元素
var a = [1,2,3,4,5];
var b = a.pop(); // a:[1,2,3,4] b:5
// push:從尾端追加並回傳新長度
var a = [1,2,3,4,5];
var b = a.push(6,7); // a:[1,2,3,4,5,6,7] b:7
// concat:回傳合併後的新陣列,原陣列不變
var a = [1,2,3,4,5];
var b = a.concat(6,7); // b:[1,2,3,4,5,6,7]
// splice(start, deleteCount, val1, val2...):刪除並插入,回傳被刪除的元素
var a = [1,2,3,4,5];
var b = a.splice(2,2,7,8,9); // a:[1,2,7,8,9,5] b:[3,4]
a.splice(0,1); // 等同 shift
a.splice(0,0,-2,-1); // 等同 unshift
a.splice(a.length-1,1); // 等同 pop
a.splice(a.length,0,6,7); // 等同 push
// reverse:原地反序
var a = [1,2,3,4,5];
var b = a.reverse(); // a、b 皆為 [5,4,3,2,1]
// sort:原地排序,可傳比較函式
var a = [3,1,2];
var b = a.sort(function(x,y){return x-y;}); // [1,2,3]
// slice(start,end):擷取片段,不改動原陣列
var a = [1,2,3,4,5];
var b = a.slice(2,5); // b:[3,4,5]
// join:以分隔符串接成字串
var a = [1,2,3,4,5];
var b = a.join("|"); // "1|2|3|4|5"
特別提醒:sort 不傳比較函式時會以字串順序排序,[1,2,10] 會排成 [1,10,2],這是無數 bug 的來源。
document 方法:
getElementById(id) → Node,回傳指定節點
getElementsByTagName(name) → NodeList,回傳符合的元素集合
createElement(name) → Node
createTextNode(text) → Node,建立純文字節點
documentElement → html 節點
document.body → body 節點
element 方法:
getAttribute(name) → 取得屬性值
setAttribute(name, value) → 設定屬性
removeAttribute(name) → 移除屬性
getElementsByTagName(name) → 節點內符合的集合
節點操作:
appendChild(child) / removeChild(child) / replaceChild(new, old)
insertBefore(newChild, refChild) → 在同層的參考節點前插入
hasChildNodes() → 是否有子節點
節點屬性:
nodeName、nodeType、nodeValue
parentNode、childNodes、firstChild、lastChild
previousSibling、nextSibling
用物件當底層儲存,外層包一組 Map 風格的介面:
function HashMap()
{
var size = 0;
var entry = new Object();
this.put = function (key , value)
{
if(!this.containsKey(key)) { size++; }
entry[key] = value;
}
this.get = function (key)
{
return this.containsKey(key) ? entry[key] : null;
}
this.remove = function ( key )
{
if( this.containsKey(key) && ( delete entry[key] ) ) { size--; }
}
this.containsKey = function ( key )
{
return (key in entry);
}
this.containsValue = function ( value )
{
for(var prop in entry) { if(entry[prop] == value) { return true; } }
return false;
}
this.values = function ()
{
var values = [];
for(var prop in entry) { values.push(entry[prop]); }
return values;
}
this.keys = function ()
{
var keys = [];
for(var prop in entry) { keys.push(prop); }
return keys;
}
this.size = function ()
{
return size;
}
this.clear = function ()
{
size = 0; entry = new Object();
}
}
要注意的是:把物件當 key 時,JS 會自動呼叫它的 toString(),所以實際存的仍是字串 key。兩個不同內容卻得到相同 toString 輸出的物件會互相覆蓋——除非自訂 toString,否則 object1 與 object2 會指向同一筆資料。這也是為什麼 ES6 的 Map 值得改用:它用真正的參照作為鍵,不會有這個問題。
var i = 1;
var str = i.toString(); // "1"
i = parseInt(str); // 1
i = parseFloat(str); // 1.0
// 注意:parseInt、parseFloat 會把 "32G" 轉成 32
typeof i == "number" // 判斷型別
isNaN(i) // 判斷是否為 NaN,但不適合直接當成「是否為數字字串」的檢查
var f = 1.5;
Math.round(f); // 2,四捨五入
Math.ceil(f); // 2,大於 f 的最小整數
Math.floor(f); // 1,小於 f 的最大整數
var i = 3.14159;
i.toFixed(2); // "3.14"
i.toPrecision(5); // "3.1415"
parseInt("0x1f", 16); // 進位轉換
Math.random(); // 0–1 之間的隨機小數
Math.floor(Math.random() * n); // 0 到 n-1 的隨機整數
function stack(){
if(this.top==undefined){
this.top=0;
this.unit=new Array();
}
this.push=function(pushvalue){
this.unit[this.top]=pushvalue;
this.top+=1;
}
this.readAllElements=function(){
if(this.top==0){ alert("當前棧空,無法讀取數據"); return ""; }
var count=0, outStr="";
for(count=0;count<this.top;count++){ outStr+=this.unit[count]+","; }
return outStr;
}
this.pop=function(){
if(this.top==0){ alert("當前棧空,無法彈出數據"); return ""; }
var popTo=this.unit[this.top-1];
this.top--;
return popTo;
// 這裡只把 top 減一,資料仍留在陣列中,只是無法再存取,尚未做資源釋放
}
}
var myDate = new Date(); // 現在
new Date(yyyy, mm, dd, hh, mm, ss) // mm 從 0 起算
new Date("monthName dd, yyyy hh:mm:ss")
new Date(epochMilliseconds)
getFullYear() 完整年份(getYear 只回兩位,不建議使用)
getMonth() 0–11
getDate() 1–31
getDay() 0–6,0 是週日
getTime() 從 1970.1.1 起的毫秒數,也就是時間戳
getHours() / getMinutes() / getSeconds() / getMilliseconds()
toLocaleDateString() / toLocaleTimeString() / toLocaleString()
myDate.setDate(myDate.getDate() + 10); // 加十天,其他 set 系列同理
// 兩個日期相減再除以 86400000 可得天數差
var r = /^(\d{2}|\d{4})[\/-]\d{1,2}[\/-]\d{1,2}$/; // 簡易日期格式檢查
var myString = "Every good boy does fine.";
myString.substring(6); // 從第 6 字到尾
myString.substring(0,10); // "Every good"
myString.slice(11,-6); // "boy does",支援負索引
myString.substr(6,4); // "good",第二參數是長度
toLowerCase() / toUpperCase()
indexOf("every") // 找不到回傳 -1
replace("is","am")
charCodeAt(3) / String.fromCharCode(66)
encodeURI() / decodeURI(),以及 encodeURIComponent() / decodeURIComponent()
轉義字元:
\b 後退 \t 水平定位
\n 換行 \v 垂直定位
\f 換頁 \r carriage return
\" 雙引號 \' 單引號 \\ 反斜線
比較時要小心:兩個內容相同但分別是字面值與 String 物件的變數,用 == 會是 true,用 === 則是 false。
abs、acos、asin、atan、atan2、ceil、cos、exp、floor、log、max、min、pow、random、round、sin、sqrt、tan,以及常數 E、LN2、LN10、LOG2E、LOG10E、PI、SQRT1_2、SQRT2。
navigator.appName // 瀏覽器名稱
navigator.appVersion // 版本資訊
navigator.userAgent.indexOf("Win") // 平台判斷
if (document.images) {} // 特性偵測:物件存在即代表支援
navigator.userLanguage // 使用者語言
navigator.cookieEnabled // 是否啟用 Cookie
特性偵測(判斷能力)永遠優於 UA 猜測(判斷身分),原生 Ajax 裡判斷 window.XMLHttpRequest 是否存在就是標準範例。
function animal(bSex){
this.sex = bSex;
this.getSex = function(){ return this.sex; }
}
animal.SEX_G = new Object(); // 類別靜態成員
animal.SEX_B = new Object();
function bird(bSex){
animal.call(this, bSex);
this.fly = function(iSpeed){ alert("飛行時速高達 " + iSpeed); }
}
function fish(bSex){
animal.call(this, bSex);
this.swim = function(iSpeed){ alert("游動時速高達 " + iSpeed); }
}
function crossBF(bSex){
bird.call(this, bSex);
fish.call(this, bSex);
}
var oPet = new crossBF(animal.SEX_G);
alert(oPet.getSex() == animal.SEX_G ? "雌性" : "雄性");
oPet.fly(124);
oPet.swim(254);
call 的作用是借用其他建構函式的 this,把父類別的屬性與方法「複製」到當前物件上。缺點是方法會被反覆建立,無法共用;ES6 class 的 extends 才是正解。
function jsonObj2Str(json) {
var str = "{";
for (prop in json) { str += prop + ":" + json[prop] + ","; }
str = str.substr(0, str.length - 1);
return str + "}";
}
function jsonStr2Obj(jsonstr) { return eval("("+jsonstr+")"); }
function getLeft(obj){
var offset=obj.offsetLeft;
if(obj.offsetParent!=null) offset+=getLeft(obj.offsetParent);
return offset;
}
function getTop(obj){
var offset=obj.offsetTop;
if(obj.offsetParent!=null) offset+=getTop(obj.offsetParent);
return offset;
}
function trim(str) { return str.replace(/(^\s*)|(\s*$)/g,""); }
function $(str) { return document.getElementById(str); }
function $byName(str) {
var arr = document.getElementsByName(str);
return arr ? arr[0] : null;
}
其中 jsonStr2Obj 用 eval 解析字串有執行任意程式碼的風險,正式環境請改用 JSON.parse。getLeft/getTop 的遞迴寫法在現代瀏覽器中可直接用 getBoundingClientRect() 取代。
function notNull(str, defaultStr) {
if (typeof(str) == "undefined" || str == null || str == '') {
return defaultStr ? defaultStr : '';
} else { return str; }
}
function compareTwoDate(smallDate, bigDate, msg) {
var v1 = $(smallDate).value;
var v2 = $(bigDate).value;
if (v1 >= v2) { alert(msg); v2.focus(); return false; }
return true;
}
function compareTwoNum(smallNum, bigNum, msg) {
var v1 = $(smallNum).value;
var v2 = $(bigNum).value;
if (parseFloat(v1) >= parseFloat(v2)) { alert(msg); v2.focus(); return false; }
return true;
}
function checkLength(textId, len, msg) {
obj = $(textId);
str = obj.value.replace(/[^\x00-\xff]/g, "**");
if (str.length > len) {
alert("[" + msg + "]" + "長度最大為" + len + "位,請重新輸入!\n注意:一個漢字占2位。");
obj.focus();
return false;
} else return true;
}
function checkIfEmpty(textId, msg) {
var textObj = $(textId);
if (trim(textObj.value) == '') { alert('[' + msg + ']不得為空!'); textObj.focus(); return false; }
return true;
}
function _isEmail(strEmail) {
if (strEmail.indexOf('@') == -1) { return false; }
var first = strEmail.indexOf('.');
var tempStr = strEmail.substring(first + 1);
if (tempStr.indexOf('.') != -1) { return false; }
return strEmail.search(/^\w+((-\w+)|(\.\w+))*\@[A-Za-z0-9]+((\.|-)[A-Za-z0-9]+)*\.[A-Za-z0-9]+$/) != -1;
}
function checkIsMail(textId, msg) {
var obj = $(textId);
if (!_isEmail(obj.value)) { alert('[' + msg + ']不是合法的郵件地址!'); obj.focus(); return false; }
return true;
}
function checkIsNum(textId, msg) {
obj = $(textId);
if (isNaN(obj.value)) { alert('[' + msg + ']必須為數字。'); obj.focus(); return false; }
return true;
}
function _isValidString(szStr, errMsg) {
voidChar = "'\"><`~!@#$%^&\(\)()!¥……??“”‘'*";
for (var i = 0; i < voidChar.length; i++) {
if (szStr.indexOf(voidChar.substring(i, i + 1)) > -1) { alert(errMsg); return false; }
}
return true;
}
function checkIsValid(textId, msg) {
obj = $(textId);
if (!_isValidString(obj.value, '[' + msg + ']不得含有非法字符。')) { obj.focus(); return false; }
return true;
}
其中 compareTwoDate 的字串比較只在日期格式完全一致(例如都是 2010-01-01)時才可靠,實務上建議先 new Date(v1) 再比 getTime()。另外 compareTwoDate 裡的 v2 是字串,v2.focus() 會出錯,正確應為 $(bigDate).focus()。
function checkChooseSelect(selectId, msg, nullValue) {
var obj = $(selectId);
if (obj.value == notNull(nullValue,'-1')) { alert('[' + msg + ']必選!'); obj.focus(); return false; }
return true;
}
function getSelectText(selectObj) { return selectObj.options[selectObj.selectedIndex].text; }
function getSelectValue(selectObj) { return selectObj.options[selectObj.selectedIndex].value; }
function setSelectValue(obj, value) { obj.value = value; }
function clearSelect(obj) { for (var i=obj.options.length; i>0; i--) { obj.remove(0); } }
function setSelectContent(obj, valAndText){
if(trim(valAndText)==''){ alert('沒有要進行組裝下拉菜單的數據!'); return false; }
clearSelect(obj);
var keyandvalues = valAndText.split(';');
for(var i=0;i<keyandvalues.length;i++){
var arr = keyandvalues[i].split(',');
if(arr){ obj.add(new Option(arr[1], arr[0])); }
}
}
function getCheckedIds(checks){
var selectedValue = '';
var len = checks.length;
for(var index=0; index<len; index++) {
if(checks[index].checked==true) { selectedValue += checks[index].value+","; }
}
if(selectedValue.length>0) return selectedValue.substring(0,selectedValue.length-1);
return selectedValue;
}
setSelectContent 接受形如 '1,男;2,女;3,未知' 的字串,用分號切分項目、逗號切分值與文字,動態組出 option。
function check(){
if(checkIfEmpty('a','非空校驗')
&&checkIsMail('b','郵箱校驗')
&&checkIsNum('c','數字校驗')
&&checkIsValid('d','合法性校驗')
&&compareTwoDate('e','f','小日期與大日期關系錯誤!')
&&checkLength('g',5,'長度校驗')
&&checkChooseSelect('h','下拉菜單非空','-1')
&&compareTwoNum('k','l','大小數目關系不正確!')){
alert('校驗通過!');
return true;
}else{
return false;
}
}
function getSelect(){
var sss = $('h');
alert('下拉菜單選擇的文本是:'+getSelectText(sss)+'\n'+'下拉菜單選擇的值是:'+getSelectValue(sss));
}
function setSelect(){
setSelectContent($('h'), $('i').value);
}
function getMulti(){
alert('多選選擇的id是:'+getCheckedIds(document.getElementsByName('j')));
}
對應的表格列只要放 id 為 a 到 l 的欄位、name 為 j 的核對方塊,以及觸發上述函式的按鈕即可。
整批函式的共同設計是「有錯回傳 false 並 focus 該欄位」,因此可以像 check() 那樣用 && 串成一條鏈,第一個失敗者中斷後續檢查,一次只提示一個問題,使用者體驗反而更好。
最後提醒一句:這些都是前端驗證,只能改善互動體驗,真正的資料合法性一定要在伺服器端再驗一次。