相容性問題是實際開發中最容易被忽略、卻又最關鍵的一環。處理它的正確心態不是「判斷是哪個瀏覽器」,而是能力偵測——檢查當前環境是否支援即將呼叫的屬性或方法,再決定要走哪條路徑。
兩者作用相同,都是讀寫元素的純文字內容,差別只在支援範圍:
1)功能一致
2)innerText:IE8 之前的瀏覽器支援
3)textContent:舊版 Firefox 支援
4)新版本瀏覽器兩者皆支援
// 相容 innerText 與 textContent
function getText(element) {
if (element.textContent) {
return element.textContent;
} else {
return element.innerText;
}
}
順帶一提,兩者仍有細微差異:innerText 會反映 CSS 的渲染結果(例如隱藏的元素不計入),textContent 則取原始的節點文字。需要精確控制時應留意這點。
1)兄弟節點:所有瀏覽器都支援
① nextSibling:下一個兄弟節點,可能是非元素節點(例如空白文字節點)
② previousSibling:上一個兄弟節點,同樣可能是文字節點
2)兄弟元素:IE8 之前不支援
① previousElementSibling:上一個緊鄰的兄弟元素,會忽略空白
② nextElementSibling:下一個緊鄰的兄弟元素,會忽略空白
// 取得下一個緊鄰的兄弟元素
function getNextElement(element) {
if (element.nextElementSibling) {
return element.nextElementSibling;
} else {
var node = element.nextSibling;
while (node && node.nodeType !== 1) {
node = node.nextSibling;
}
return node;
}
}
// 取得上一個緊鄰的兄弟元素
function getPreviousElement(element) {
if (element.previousElementSibling) {
return element.previousElementSibling;
} else {
var el = element.previousSibling;
while (el && el.nodeType !== 1) {
el = el.previousSibling;
}
return el;
}
}
// 取得第一個子元素
function getFirstElement(parent) {
if (parent.firstElementChild) {
return parent.firstElementChild;
} else {
var el = parent.firstChild;
while (el && el.nodeType !== 1) {
el = el.nextSibling;
}
return el;
}
}
// 取得最後一個子元素
function getLastElement(parent) {
if (parent.lastElementChild) {
return parent.lastElementChild;
} else {
var el = parent.lastChild;
while (el && el.nodeType !== 1) {
el = el.previousSibling;
}
return el;
}
}
// 取得目前元素的所有兄弟元素
function sibling(element) {
if (!element) return;
var elements = [];
var el = element.previousSibling;
while (el) {
if (el.nodeType === 1) {
elements.push(el);
}
el = el.previousSibling;
}
el = element.nextSibling;
while (el) {
if (el.nodeType === 1) {
elements.push(el);
}
el = el.nextSibling;
}
return elements;
}
這些函式的共同套路是:先嘗試標準屬性,若不存在則退回手動走訪,用 nodeType === 1 過濾出元素節點。
用指定的函式測試所有元素,並建立一個包含所有通過測試元素的新陣列。
if (!Array.prototype.filter) {
Array.prototype.filter = function (fun /*, thisArg */) {
"use strict";
if (this === void 0 || this === null) throw new TypeError();
var t = Object(this);
var len = t.length >>> 0;
if (typeof fun !== "function") throw new TypeError();
var res = [];
var thisArg = arguments.length >= 2 ? arguments[1] : void 0;
for (var i = 0; i < len; i++) {
if (i in t) {
var val = t[i];
if (fun.call(thisArg, val, i, t)) {
res.push(val);
}
}
}
return res;
};
}
if (!Array.prototype.forEach) {
Array.prototype.forEach = function (callback, thisArg) {
var T, k;
if (this == null) {
throw new TypeError(' this is null or not defined');
}
var O = Object(this);
var len = O.length >>> 0;
if (typeof callback !== "function") {
throw new TypeError(callback + ' is not a function');
}
if (arguments.length > 1) {
T = thisArg;
}
k = 0;
while (k < len) {
var kValue;
if (k in O) {
kValue = O[k];
callback.call(T, kValue, k, O);
}
k++;
}
};
}
addEventListener(type, listener, useCapture) 的三個參數分別是事件名稱、事件處理函式、以及是否使用捕獲階段(true 捕獲、false 冒泡)。IE9 以後才支援,更早的版本需要用 attachEvent。
var EventTools = {
addEventListener: function (element, eventName, listener) {
if (element.addEventListener) {
element.addEventListener(eventName, listener, false);
} else if (element.attachEvent) {
element.attachEvent("on" + eventName, listener);
} else {
element["on" + eventName] = listener;
}
},
// 想要移除事件,不能使用匿名函式
removeEventListener: function (element, eventName, listener) {
if (element.removeEventListener) {
element.removeEventListener(eventName, listener, false);
} else if (element.detachEvent) {
element.detachEvent("on" + eventName, listener);
} else {
element["on" + eventName] = null;
}
}
};
註解裡那句提醒很重要:移除事件時必須傳入與註冊時同一個函式參照。若註冊時用的是匿名函式,就根本無法移除,這是新手最常踩的坑之一。
1)事件參數 e 就是事件物件,這是標準的取得方式:btn.onclick = function (e) { }
2)e.eventPhase 事件階段,IE8 之前不支援
3)e.target 永遠指向觸發事件的元素;IE8 之前則是 srcElement
var EventTools2 = {
// 取得事件物件
getEvent: function (e) {
return e || window.event;
},
// 相容取得 target
getTarget: function (e) {
return e.target || e.srcElement;
}
};
// 使用:var target = e.target || window.event.srcElement;
①在可視區域中的位置:e.clientX、e.clientY
②在文件中的位置:e.pageX、e.pageY,舊環境需自行計算:
var scrollTop = document.documentElement.scrollTop || document.body.scrollTop; var pageY = e.clientY + scrollTop;
var scrollTop = document.documentElement.scrollTop || document.body.scrolltop;
這個「標準模式讀 documentElement、怪異模式讀 body」的雙寫法,是處理捲動距離的固定套路。
window.getSelection ? window.getSelection().removeAllRanges() : document.selection.empty();
以上僅是部分整理,實際開發中還會遇到更多相容性議題,PC 端與行動端各有不同的適配課題,需要持續累積。
不過核心原則只有一條:一律用能力偵測取代瀏覽器判斷。不要寫「如果是 IE 就這麼做」,而要寫「如果不支援這個方法就那麼做」。前者在遇到版本更新或偽裝的 user-agent 時必然失效,後者則永遠指向正確的分支。
值得補充的是,這些 polyfill 在今天多數已無必要——現代瀏覽器對 ES5 以後的 API 支援度極高。真正需要處理相容性的場合,通常是維護老舊內部系統,或是明確得知使用者群體的環境分佈時。若確實需要廣泛降級,直接引入 Babel 搭配 core-js 這類工具鏈,會比手寫 polyfill 更可靠也更省成本。