萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 動態建立 DOM 元素完整工具函式庫:屬性、事件、位置計算

封裝一組健壯的動態 DOM 建立與操作工具函式,涵蓋元素查找、位置計算、事件綁定/移除、參數化建立元素(含屬性與事件註冊),相容 IE 與標準瀏覽器。

核心工具函式

1. 獲取元素 (支援 ID 字串或 DOM 物件)

function getElement(obj) {
  return typeof obj === 'string' ? document.getElementById(obj) : obj;
}

2. 獲取元素絕對位置 (跨瀏覽器)

function getObjectPosition(obj) {
  obj = getElement(obj);
  if (!obj) return;
  if (obj.getBoundingClientRect) { // IE, 現代瀏覽器
    var rect = obj.getBoundingClientRect();
    return { x: rect.left, y: rect.top };
  } else if (document.getBoxObjectFor) { // 老 Firefox
    var box = document.getBoxObjectFor(obj);
    return { x: box.x, y: box.y };
  } else { // 回退:累加 offsetParent
    var pos = { x: obj.offsetLeft, y: obj.offsetTop };
    var parent = obj.offsetParent;
    while (parent) {
      pos.x += parent.offsetLeft;
      pos.y += parent.offsetTop;
      parent = parent.offsetParent;
    }
    return pos;
  }
}

3. 事件綁定/移除 (標準 + IE)

function addEventHandler(target, eventType, handler) {
  if (target.addEventListener) {
    target.addEventListener(eventType, handler, false);
  } else if (target.attachEvent) { // IE
    target.attachEvent("on" + eventType, handler);
  } else {
    target["on" + eventType] = handler;
  }
}

function removeEventHandler(target, eventType, handler) {
  if (target.removeEventListener) {
    target.removeEventListener(eventType, handler, false);
  } else if (target.detachEvent) {
    target.detachEvent("on" + eventType, handler);
  } else {
    target["on" + eventType] = undefined;
  }
}

4. 參數化動態建立元素

function dynCreateDomObject(params) {
  // params: {
  //   parentNode: HTMLElement|string, // 父元素
  //   domId: string,                   // 元素 ID
  //   domTag: string,                  // 標籤名 div/span/p...
  //   content: string,                 // innerHTML
  //   otherAttributes: [{attrName, attrValue}], // 額外屬性
  //   eventRegisters: [{eventType, eventHandler}] // 事件註冊
  // }

  var parent = getElement(params.parentNode);
  var existing = getElement(params.domId);
  if (existing) { parent.removeChild(existing); }

  var el = document.createElement(params.domTag);
  el.id = params.domId;
  el.innerHTML = params.content;

  // 設定額外屬性
  if (params.otherAttributes) {
    params.otherAttributes.forEach(function(attr) {
      el.setAttribute(attr.attrName, attr.attrValue);
    });
  }

  // 綁定事件
  if (params.eventRegisters) {
    params.eventRegisters.forEach(function(reg) {
      addEventHandler(el, reg.eventType, reg.eventHandler);
    });
  }

  parent.appendChild(el);
  return el;
}

使用範例

// 建立一個紅色可點擊的 div,點擊後移除
dynCreateDomObject({
  parentNode: document.body,
  domId: 'dynamicBox',
  domTag: 'div',
  content: '點擊我消失',
  otherAttributes: [
    { attrName: 'style', attrValue: 'color:red;cursor:pointer;padding:20px;border:1px solid #ccc' }
  ],
  eventRegisters: [
    { eventType: 'click', eventHandler: function() { this.parentNode.removeChild(this); } }
  ]
});

現代化建議

  • 使用 element.dataset 替代 setAttribute 存取 data-* 屬性
  • 事件委派:父元素綁定單一事件,透過 event.target.matches() 判斷
  • classList.add/remove/toggle 替代 style 字串操作
  • 建立元素優先用 document.createElement + 屬性賦值,避免 innerHTML XSS 風險

此工具庫適合需支援舊瀏覽器的專案,現代專案建議直接使用原生 API 或輕量庫 (如 uhtml, lit-html)。

copyright © 萬盛學電腦網 all rights reserved