這一回合整理的是更偏「工具層」的腳本:字串拼接的效能問題、視窗與捲軸尺寸、元素透明度、滑鼠座標,以及樣式讀取與元素尺寸。這些都是每個前端專案遲早都會用到的基礎函式。
反覆用 += 拼接字串,在舊瀏覽器上會產生大量中間字串物件,迴圈一多就明顯卡頓。用陣列收集、最後一次 join 是經典的解法:
function StringBuffer() {
this.__strings__ = new Array();
}
StringBuffer.prototype.append = function (str) {
this.__strings__.push(str);
return this;
}
StringBuffer.prototype.toString = function () {
return this.__strings__.join("");
}
var buffer = new StringBuffer();
buffer.append("Hello ").append("javascript");
var result = buffer.toString();
alert(result); // Hello javascript
append 回傳 this,因此可以鏈式呼叫。今天的 JS 引擎早已最佳化字串拼接(內部用 ropes 之類的結構),效能差距不大;不過在迴圈裡組大量 HTML 時,寫成陣列再 join('') 仍是好習慣,程式碼也更清楚。
/* 頁面(文件)整體的高與寬 */
function pageHeight() { return document.body.scrollHeight; }
function pageWidth() { return document.body.scrollWidth; }
/* 捲軸的垂直與水平位置 */
function scrollX() {
var de = document.documentElement;
return self.pageXOffset || (de && de.scrollLeft) || document.body.scrollLeft;
}
function scrollY() {
var de = document.documentElement;
return self.pageYOffset || (de && de.scrollTop) || document.body.scrollTop;
}
/* 瀏覽器視口(可見區域)的高與寬 */
function windowHeight() {
var de = document.documentElement;
return self.innerHeight || (de && de.clientHeight) || document.body.clientHeight;
}
function windowWidth() {
var de = document.documentElement;
return self.innerWidth || (de && de.clientWidth) || document.body.clientWidth;
}
這幾段的共同手法是「多重 fallback」:標準模式取 documentElement,怪咖模式(Quirks Mode)取 body,再搭配各家瀏覽器的私有屬性。|| 短路運算在這裡同時扮演「取第一個有值的」的角色。
今天只需用 window.innerWidth、window.scrollY、document.documentElement.scrollHeight 即可,跨瀏覽器的差異早已消失。
/* level 為 0~100 的整數 */
function setOpacity(elem, level) {
if (elem.filters) {
// 舊 IE 的 alpha 濾鏡
elem.style.filter = 'alpha(opacity=' + level + ')';
} else {
elem.style.opacity = level / 100;
}
}
標準的 opacity 接受 0 到 1 的浮點數,舊 IE 則要用 filter: alpha(opacity=N) 且 N 是 0 到 100。現在只留 elem.style.opacity 就好。
/* 相對於整個頁面的位置 */
function getX(e) {
e = e || window.event;
return e.pageX || e.clientX + document.body.scrollLeft;
}
function getY(e) {
e = e || window.event;
return e.pageY || e.clientY + document.body.scrollTop;
}
/* 相對於觸發事件元素的位置 */
function getElementX(e) {
return (e && e.layerX) || window.event.offsetX;
}
function getElementY(e) {
return (e && e.layerY) || window.event.offsetY;
}
關鍵區別:pageX/pageY 是含捲動量的頁面座標,clientX/clientY 是視窗座標;offsetX/offsetY 則是相對於事件目標元素。同一個滑鼠位置,用哪個屬性會得到完全不同的數字,這是做彈出層定位時最常出錯的地方。
現在直接用 e.pageX/e.pageY/e.offsetX 即可;若需要觸控裝置的座標,則從 e.touches[0] 或 e.changedTouches[0] 取。
/** 隱藏元素,並記住原本的 display 值 */
function hide(elem) {
var curDisplay = getStyle(elem, 'display');
if (curDisplay != 'none') {
elem.$oldDisplay = curDisplay;
}
elem.style.display = 'none';
}
/** 還原為原本的 display 值 */
function show(elem) {
elem.style.display = elem.$oldDisplay || '';
}
直接寫 display='none' 再寫 display='block' 有個問題:原本可能是 inline、inline-block 或 flex,一律設成 block 會破版。這個做法先把原值存到自訂屬性上,還原時就不用猜。
/** 取得元素 elem 的樣式屬性 name */
function getStyle(elem, name) {
// 先看 inline style
if (elem.style[name]) {
return elem.style[name];
}
// 再看 IE 的 currentStyle
else if (elem.currentStyle) {
return elem.currentStyle[name];
}
// 最後走 W3C 標準
else if (document.defaultView && document.defaultView.getComputedStyle) {
name = name.replace(/([A-Z])/g, "-$1").toLowerCase();
var s = document.defaultView.getComputedStyle(elem, "");
return s && s.getPropertyValue(name);
}
else {
return null;
}
}
/** 取得元素真實高度,依賴上面的 getStyle */
function getHeight(elem) {
return parseInt(getStyle(elem, 'height'));
}
/** 取得元素真實寬度 */
function getWidth(elem) {
return parseInt(getStyle(elem, 'width'));
}
這段的三段式 fallback 是經典寫法,其中 name.replace(/([A-Z])/g, "-$1").toLowerCase() 把 backgroundColor 駝峰式轉成 CSS 的 background-color 連接符式,因為 getPropertyValue() 只接受後者。
今天用 window.getComputedStyle(elem).getPropertyValue('height') 一行即可;若只需要實際佔用的像素尺寸,elem.offsetHeight(含 border 與 padding)或 elem.getBoundingClientRect() 更直接,後者還能一次拿到位置與四邊尺寸。