有些互動需要在點擊之後才產生新的畫面元素,而不是事先寫在 HTML 裡。以下把相關的基礎工具函式整理出來,作為備忘。
/** 取得元素的 DOM 物件,@obj 可為元素或該元素的 ID */
function getElement(obj) {
return typeof obj == 'string' ? document.getElementById(obj) : obj;
}
/** 取得元素的位置 */
function getObjectPosition(obj) {
obj = typeof obj === 'string' ? getElement(obj) : obj;
if (!obj) return;
if (obj.getBoundingClientRect) { // IE 與現代瀏覽器
var position = obj.getBoundingClientRect();
return { x: position.left, y: position.top };
} else if (document.getBoxObjectFor) { // 舊 Firefox
var position = document.getBoxObjectFor(obj);
return { x: position.x, y: position.y };
} else {
var position = { x: obj.offsetLeft, y: obj.offsetTop };
var parent = obj.offsetParent;
while (parent) {
position.x += obj.offsetLeft;
position.y += obj.offsetTop;
parent = obj.offsetParent;
}
return position;
}
}
/** 動態綁定事件,@sEventType 不加 on 前綴,如 'click' */
function addEventHandler(oTarget, sEventType, fnHandler) {
if (oTarget.addEventListener) {
oTarget.addEventListener(sEventType, fnHandler, false);
} else if (oTarget.attachEvent) { // 舊 IE
oTarget.attachEvent("on" + sEventType, fnHandler);
} else {
oTarget["on" + sEventType] = fnHandler;
}
}
/** 移除事件 */
function removeEventHandler(oTarget, sEventType, fnHandler) {
if (oTarget.removeEventListener) {
oTarget.removeEventListener(sEventType, fnHandler, false);
} else if (oTarget.detachEvent) {
oTarget.detachEvent(sEventType, fnHandler);
} else {
oTarget['on' + sEventType] = undefined;
}
}
/** 建立動態 DOM 物件 */
function dynCreateDomObject(domParams) {
if (getElement(domParams.domId)) {
childNodeAction('remove', domParams.parentNode, domParams.domId);
}
var dynObj = document.createElement(domParams.domTag);
dynObj.id = domParams.domId;
dynObj.innerHTML = domParams.content;
// 添加屬性
if (null != domParams.otherAttributes) {
for (var i = 0; i < domParams.otherAttributes.length; i++) {
var attr = domParams.otherAttributes[i];
dynObj.setAttribute(attr.attrName, attr.attrValue);
}
}
// 添加事件
if (null != domParams.eventRegisters) {
for (var i = 0; i < domParams.eventRegisters.length; i++) {
var reg = domParams.eventRegisters[i];
addEventHandler(dynObj, reg.eventType, reg.eventHandler);
}
}
try {
childNodeAction('append', domParams.parentNode, dynObj);
} catch ($e) {}
return dynObj;
}
/** 從父節點中新增或刪除子節點 */
function childNodeAction(actionType, parentNode, childNode) {
if (!parentNode) return;
parentNode = typeof parentNode === 'string' ? getElement(parentNode) : parentNode;
childNode = typeof childNode === 'string' ? getElement(childNode) : childNode;
if (!parentNode || !childNode) return;
var action = actionType.toLowerCase();
if (null == actionType || action.length <= 0 || action == 'append') {
action = 'parentNode.appendChild';
} else {
action = 'parentNode.removeChild';
}
try {
eval(action)(childNode);
} catch ($e) {
alert($e.message);
}
}
var htmlAttributes = [
{ attrName: 'class', attrValue: '樣式名稱' }, // for IE
{ attrName: 'className', attrValue: '樣式名稱' } // for Firefox
];
var domParams = {
domTag: 'div',
content: '動態 div 的 innerHTML',
otherAttributes: htmlAttributes
};
var newHtmlDom = dynCreateDomObject(domParams);
// 注意:用 setAttribute('style', '...') 設定樣式沒有效果
// 必須逐一指定 style 屬性
newHtmlDom.style.zIndex = '8888';
newHtmlDom.style.position = 'absolute';
newHtmlDom.style.left = '100px';
newHtmlDom.style.top = '200px';
第一,childNodeAction 用 eval("parentNode.appendChild") 這種字串拼接的方式來決定呼叫哪個方法,完全沒有必要,直接寫 if/else 呼叫 parentNode.appendChild(childNode) 即可,既安全又快。
第二,同時設定 class 與 className 兩個屬性是舊時代的相容手段,在 IE8 之後已無必要,setAttribute('class', ...) 各家都支援。
第三,getObjectPosition 的手動累加 offsetTop 邏輯,在現代瀏覽器中一律可以用 getBoundingClientRect() 取代,而且結果不受 transform 影響。
function createEl(tag, props, children) {
var el = document.createElement(tag);
Object.keys(props || {}).forEach(function(key) {
if (key === 'style') Object.assign(el.style, props[key]);
else if (key.slice(0, 2) === 'on') el.addEventListener(key.slice(2), props[key]);
else el.setAttribute(key, props[key]);
});
(children || []).forEach(function(c) {
el.appendChild(typeof c === 'string' ? document.createTextNode(c) : c);
});
return el;
}
document.body.appendChild(createEl('div', {
id: 'myBox',
class: '樣式名稱',
style: { position: 'absolute', left: '100px', top: '200px' },
onclick: function(){ console.log('clicked'); }
}, ['這是文字內容']));
這個版本沒有 eval、沒有跨瀏覽器判斷、事件綁定走標準 API,程式碼不到原版的三分之一。