DIV CSS 佈局教程網

用 JS 動態建立 HTML DOM 元素並定位顯示
編輯:關於JavaScript     

有些互動需要在點擊之後才產生新的畫面元素,而不是事先寫在 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,程式碼不到原版的三分之一。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved