動態產生 DOM 元素是前端的基本功。以 div 為例,整個流程可以拆成三段:建立元素 → 設定屬性 → 設定樣式 → 掛到文件上。以下分別說明,並附幾個容易踩的細節。
<script type="text/javascript">
function createElement(){
var createDiv = document.createElement("div");
createDiv.innerHTML = "Test create a div element!";
document.body.appendChild(createDiv);
}
</script>
createElement 只是產生一個還不屬於文件的節點,必須 appendChild 之後才會出現在畫面上。如果目標容器不是 body,就掛到那個容器上:
divFileitem.appendChild(divName); // 容器不是 body 時,掛到指定父節點
<script type="text/javascript">
function createElement(){
var createDiv = document.createElement("div");
createDiv.title = "this is a new div.";
createDiv.id = "newDivId";
createDiv.innerHTML = "Test create a div element!";
document.body.appendChild(createDiv);
// 直接指定多個 class 樣式
createDiv.className = "name file_col";
}
</script>
這裡有個常見錯誤:寫成 createDiv.class = "..."。DOM 屬性用的是 className,因為 class 是 JavaScript 的保留字。若要一次指定多個樣式名稱,用 className 以空白分隔即可。
<script type="text/javascript">
function createElement(){
var createDiv = document.createElement("div");
createDiv.style.background = "pink";
createDiv.style.border = "1px solid red";
createDiv.style.width = "50px";
createDiv.style.height = "50px";
createDiv.innerHTML = "Test create a div element!";
document.body.appendChild(createDiv);
}
</script>
用 style 直接寫樣式有兩個必記得的事: camelCase 命名(background-color 要寫成 backgroundColor),以及有單位的屬性一定要帶單位。舊版 Firefox 對 obj.style.height = imgObj.height 這種沒帶 px 的寫法是不接受的,必須寫成 imgObj.height + 'px'。
批次操作再掛載。 若要產生大量元素,先把節點組裝好、最後一次 appendChild,或使用 DocumentFragment 暫存,能大幅減少瀏覽器的重排次數。逐一插入會觸發很多次版面計算。
樣式優先用 class。 動態樣式寫在 style 上會讓樣式散落在 JavaScript 裡,難以維護;把外觀交給 CSS class、由 JavaScript 切換 className,是比較乾淨的分工。
現代寫法。 insertAdjacentHTML 與 template 元素都能讓建立整段結構的程式碼更簡潔:
document.body.insertAdjacentHTML('beforeend',
'<div class="name file_col" style="width:50px;height:50px">Hello</div>');
不過要注意,使用 innerHTML 或 insertAdjacentHTML 插入字串時,若內容含有使用者輸入的資料,務必先消毒,否則會有 XSS 風險。用 createElement 逐一建立再指定 textContent,是較安全的方式。