動態操作 DOM 是前端開發的核心技能之一。本文整理了一組實用的原生 JavaScript 函式,涵蓋取得元素、取得位置、綁定與移除事件,以及最核心的「動態創建 DOM 元素」,並附上使用範例。
/* 取得元素 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){ // For IE
var position = obj.getBoundingClientRect();
return {x: position.left, y: position.top};
} else if(document.getBoxObjectFor){
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){ // for 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){ // for IE
oTarget.detachEvent(sEventType, fnHandler);
} else {
oTarget['on' + sEventType] = undefined;
}
}
核心函式 dynCreateDomObject 以 JSON 描述要創建的元素屬性,包含父節點、id、標籤名、內容、其他屬性與事件註冊:
function dynCreateDomObject(domParams){
if(getElement(domParams.domId)){
childNodeAction('remove', domParams.parentNode, domParams.domId);
}
var dynObj = document.createElement(domParams.domTag);
with(dynObj){
id = domParams.domId;
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 FF
];
var domParams = {
domTag: 'div',
content: '動態 div 的 innerHTML',
otherAttributes: htmlAttributes
};
var newHtmlDom = dynCreateDomObject(domParams);
// style 需逐一指定,setAttribute('style', ...) 在此無效
newHtmlDom.style.zIndex = '8888';
newHtmlDom.style.position = 'absolute';
newHtmlDom.style.left = '100px';
newHtmlDom.style.top = '200px';
透過這組函式,就能以宣告式的方式靈活地在頁面上動態新增、定位與移除元素,並為其綁定事件。