這一篇整理幾個在專案裡反覆用到的原生 JS 小工具,主題是字串拼接效能、視窗與捲軸測量、透明度、滑鼠座標,以及樣式讀取與元素可見性切換。
在需要組出成千上萬段字串的場景裡,反覆 += 會產生大量中間字串物件。用陣列收集、最後 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");
alert(buffer.toString()); // Hello javascript
append 回傳 this 讓它能串起來寫,這是很值得學的小設計。補充一點:現代 JS 引擎對 += 已有相當好的優化,多數情況下差異不大;但當拼接發生在迴圈中且規模很大時,陣列法的記憶體行為仍舊更可預測。
/* 頁面(文件)整體尺寸 */
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;
}
這組函式的重點是「多重退路」:新式屬性優先,再退回 documentElement,最後退回 body。早期瀏覽器在這三者上的行為不一致,這層 fallback 就是為了抹平差異。今天可以直接用 window.innerWidth、window.scrollX 與 document.documentElement.clientHeight,但若還要支援舊環境,這份寫法依然穩妥。
/* level 為 0-100 的百分比值 */
function setOpacity(elem, level) {
if (elem.filters) {
elem.style.filters = 'alpha(opacity=' + level + ')'; // 舊 IE
} else {
elem.style.opacity = level / 100; // 標準
}
}
注意兩邊的單位不同:標準 opacity 是 0 到 1 的小數,舊 IE 的 alpha 是 0 到 100。這個函式把轉換收在一處,呼叫端只需關心百分比。
/* 相對於整個頁面的位置 */
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 已含捲動量,clientX 沒有,所以退路裡要把 scrollLeft 加回來。這是最容易搞錯的地方:混用兩套座標會讓定位元素整體偏移一個捲動距離。
/* 取得元素某個樣式屬性 */
function getStyle(elem, name) {
if (elem.style[name]) { // 行內樣式,優先
return elem.style[name];
} else if (elem.currentStyle) { // 舊 IE
return elem.currentStyle[name];
} else if (document.defaultView && document.defaultView.getComputedStyle) {
name = name.replace(/(A-Z)/g, "-$1"); // 駝峰轉連字號
name = name.toLowerCase();
var s = document.defaultView.getComputedStyle(elem, "");
return s && s.getPropertyValue(name);
}
return null;
}
/* 依 getStyle 取得真實寬高 */
function getHeight(elem) { return parseInt(getStyle(elem, 'height')); }
function getWidth(elem) { return parseInt(getStyle(elem, 'width')); }
/* 用 display 切換可見性,並記住原本的值 */
function hide(elem) {
var curDisplay = getStyle(elem, 'display');
if (curDisplay != 'none') { elem.$oldDisplay = curDisplay; }
elem.style.display = 'none';
}
function show(elem) {
elem.style.display = elem.$oldDisplay || '';
}
hide/show 這對函式的巧思在 elem.$oldDisplay:直接設成 '' 雖然多數情況會回到預設值,但原本若是 flex 或 inline-block,清空後就會跑掉。先把原值存起來,還原時才不會破版。
getStyle 的三段分支順序也不能顛倒:行內樣式優先,其次才是 computed style。另外 computed style 取回的是使用後的實際值(例如 width 會是像素數值),這正是 getHeight 能直接 parseInt 的原因。
這些函式在框架盛行的年代是標配,即使今天多半用 jQuery 或原生 API 取代,理解背後的相容性處理仍有價值——特別是座標系統、computed style 與 fallback 順序這三件事,換成任何框架都還是同樣的道理。