JS动态添加div时怎么设置class、style及内容
系统讲解使用原生JavaScript动态创建div元素并设置class类名、style行内样式以及文本内容的完整标准方法、API选型对比与高频避坑实践。
div 元素,标准开发流程可以划分为三个核心阶段:在内存中创建节点、配置属性与内容、挂载到文档树。设置 class 推荐优先使用 classList API 避免覆盖既有类名;设置 style 可以通过属性对象小驼峰命名或 setProperty 完成动态数值写入;填充内容时,纯文本应使用具备天然防 XSS 能力的 textContent,仅在确实需要渲染复杂子结构时再使用 innerHTML。
一、创建 div 节点与基础流程
在 JavaScript 中向页面动态插入元素,第一步是使用 document.createElement('div') 在内存中分配一个新的节点对象。此时该元素仅存活在浏览器的 JavaScript 堆内存中,尚未挂载到任何父容器上,因此对它的任何类名修改、样式赋值或文本填充,都不会引起页面的重排(Reflow)或重绘(Repaint)。
完成相关属性与内容的装配后,再通过容器节点的 append() 或 appendChild() 方法将其挂载到文档树指定位置。
// 1. 在内存中创建全新的 div 元素
const myDiv = document.createElement('div');
// 2. 装配类名、样式与内容
myDiv.classList.add('info-card');
myDiv.style.backgroundColor = '#F8F9FA';
myDiv.textContent = '动态创建的内容区块';
// 3. 挂载到页面已存在的容器中(例如 <div id="app"></div>)
const container = document.getElementById('app');
container.appendChild(myDiv);
<div id="app"><div class="info-card" style="background-color: rgb(248, 249, 250);">动态创建的内容区块</div></div>
二、设置 class 的三种方式与最佳实践
为动态生成的 div 赋予类名,主要有 classList、className 和 setAttribute 三种途径。在实际工程开发中,推荐以 classList 为首选。
1. 现代推荐方式:classList API
classList 返回元素的所有类名集合(DOMTokenList),它提供了一整套原子化的方法,不会误删已有类名,也不需要手动拼接空格:
- 添加类名:
myDiv.classList.add('box', 'active'),支持同时传入多个类名参数。 - 移除类名:
myDiv.classList.remove('hidden'),如果类名不存在也不会报错。 - 切换类名:
myDiv.classList.toggle('selected'),存在则移除,不存在则添加。 - 判断包含:
myDiv.classList.contains('active'),返回布尔值。 - 替换类名:
myDiv.classList.replace('old-class', 'new-class')。
const box = document.createElement('div');
// 批量添加多个类名
box.classList.add('card', 'card-primary', 'shadow-sm');
// 动态移除或切换
box.classList.remove('shadow-sm');
box.classList.toggle('is-visible', true); // 第二个参数可强制设置布尔状态
2. 传统赋值方式:className 属性
className 是 DOM 早期提供的字符串读写属性。它的特点是直接将整个 class 属性视作一个字符串进行全量读写。
const box = document.createElement('div');
// 一次性设置多个类名(以空格分隔)
box.className = 'card card-primary text-center';
// 风险提醒:以下操作会把之前设置的 card、text-center 全部覆盖清空
box.className = 'active';
// 若想追加,必须手动保留原有字符串并处理空格,较为繁琐且易出错
box.className += ' border-highlight';
3. 底层属性接口:setAttribute('class', ...)
setAttribute 直接操作 HTML 属性节点。它的行为表现与 className 完全一致,都是全量覆写整个 class 字符串。除了在处理特殊自定义属性或命名空间时使用外,普通样式类操作并不推荐使用该方式。
三、设置 style 的方法与属性名映射规则
给元素指定行内样式(Inline Style)可以通过 style 属性对象、setProperty 方法或 style.cssText 完成。在设置时需要严格遵循命名规则与单位规范。
1. 属性赋值与小驼峰命名法(camelCase)
元素的 style 属性是一个 CSSStyleDeclaration 对象。由于 JavaScript 语法中减号(-)会被识别为减法运算符,因此原本带有连字符的 CSS 属性名,在 JS 中必须转换为小驼峰命名:
- CSS 的
background-color对应 JS 的style.backgroundColor - CSS 的
font-size对应 JS 的style.fontSize - CSS 的
margin-top对应 JS 的style.marginTop - CSS 的
z-index对应 JS 的style.zIndex
const banner = document.createElement('div');
banner.style.width = '300px'; // 数值型属性必须显式带上单位(如 px, rem, %)
banner.style.backgroundColor = '#477DAD';
banner.style.fontSize = '14px';
banner.style.color = '#FFFFFF';
banner.style.borderRadius = '6px';
banner.style.display = 'flex';
width、height、fontSize 等涉及距离尺寸的样式赋值时,必须传入带单位的字符串(如 '100px')。如果直接赋纯数字 banner.style.width = 100,在非严格兼容模式下该样式会被浏览器直接忽略废弃。
2. 原生标准接口:style.setProperty()
setProperty 允许直接书写原始的 CSS 连字符属性名,同时也是设置 CSS 自定义属性(CSS Variables)的唯一标准途径:
const card = document.createElement('div');
// 使用原始连字符属性名
card.style.setProperty('background-color', '#F8F9FA');
card.style.setProperty('border-top', '2px solid #4F6272');
// 注入 CSS 变量(CSS Custom Properties)
card.style.setProperty('--main-theme-color', '#477DAD');
3. 批量写入行内样式:style.cssText
如果需要在一个操作中同时指定大量的内联样式,可以使用 cssText。该属性接受一段标准的 CSS 声明字符串:
const toast = document.createElement('div');
// 批量写入,完全等同于在 HTML 中写 style 属性
toast.style.cssText = 'position: fixed; top: 20px; right: 20px; padding: 12px 16px; background: #333; color: #fff; z-index: 9999;';
需要注意,cssText 会覆盖元素现存的所有内联样式。若需要追加样式,应写作 toast.style.cssText += ' box-shadow: 0 4px 12px rgba(0,0,0,0.15);'。
四、填充内容的途径与 XSS 安全防御
动态添加 div 时,内容填充决定了元素所承载的具体信息。常用的三个属性是 textContent、innerHTML 与 innerText,它们在解析机制和安全边界上存在本质区别。
1. 安全纯文本:textContent(首选推荐)
textContent 属性将内容作为纯文本节点(TextNode)插入到元素中。它不会触发浏览器的 HTML 解析器,因此即使用户传入的内容包含 <script> 或 <img onerror=...>,浏览器也只会将其当成普通的字符进行字面量渲染,绝不会执行任何脚本。
const label = document.createElement('div');
const userInput = '<b>重要提醒</b><script>alert("xss")</script>';
label.textContent = userInput;
// 页面显示内容:<b>重要提醒</b><script>alert("xss")</script>
// 标签不会被加粗,脚本绝对不会触发执行
2. 富文本与子结构渲染:innerHTML
当动态添加的 div 内部需要包含复杂的 HTML 子元素(例如嵌套的 span、图标、换行标签)时,可以使用 innerHTML。浏览器会启动完整的 HTML Tokenizer 词法解析器,将字符串构造成实际的子 DOM 节点树。
const badge = document.createElement('div');
// 仅在内容来源可信或已经过严格清洗时使用
badge.innerHTML = '<span class="dot"></span><span class="text">在线</span>';
innerHTML 写入页面,否则会导致跨站脚本攻击(XSS)。对于动态用户数据,应拆解后分别使用 textContent 填入对应标签。
3. innerText 与 textContent 的差异辨析
innerText 感知页面的视觉渲染效果(CSS 样式)。如果某个子节点被设置为 display: none,innerText 就不会读取该文本;同时给 innerText 赋值会引发页面的重新布局计算(Reflow)。相比之下,textContent 只基于节点树中的纯数据,不计算视觉布局,读写性能比 innerText 更快且行为更一致。
五、综合实战演练:从零构建动态信息卡片
下面是一个综合运用 classList、动态 style 计算与 textContent 组装的完整案例。演示如何在点击按钮时,动态创建一个具有不同主题状态的卡片组件并安全挂载到容器中:
/**
* 动态创建通知卡片组件
* @param { container: HTMLElement, title: string, content: string, type: 'info' | 'success', offsetY: number } options
*/
function createNotificationCard({ container, title, content, type = 'info', offsetY = 0 }) {
// 1. 创建卡片容器 div
const card = document.createElement('div');
// 2. 使用 classList 配置基础类与主题类
card.classList.add('notification-item', `theme-${type}`);
// 3. 动态计算行内样式:根据偏移量实时定位
card.style.position = 'relative';
card.style.top = `${offsetY}px`;
card.style.margin = '12px 0';
card.style.padding = '16px';
card.style.borderRadius = '8px';
card.style.backgroundColor = type === 'success' ? '#F0FDF4' : '#F8F9FA';
card.style.borderLeft = `4px solid ${type === 'success' ? '#22C55E' : '#477DAD'}`;
// 4. 创建并填充标题子节点(安全使用 textContent)
const titleEl = document.createElement('div');
titleEl.classList.add('notification-title');
titleEl.style.fontWeight = 'bold';
titleEl.style.color = '#1F2937';
titleEl.textContent = title;
// 5. 创建并填充正文子节点
const bodyEl = document.createElement('div');
bodyEl.classList.add('notification-body');
bodyEl.style.fontSize = '14px';
bodyEl.style.color = '#4B5563';
bodyEl.style.marginTop = '4px';
bodyEl.textContent = content;
// 6. 内存中装配子节点
card.append(titleEl, bodyEl);
// 7. 挂载到目标父容器
container.append(card);
return card;
}
// 执行示例调用:
const targetContainer = document.getElementById('notification-area');
createNotificationCard({
container: targetContainer,
title: '系统就绪提示',
content: '所有模块与动态节点属性装配完成。',
type: 'info',
offsetY: 0
});
<div class="notification-item theme-info" style="position: relative; top: 0px; margin: 12px 0px; padding: 16px; border-radius: 8px; background-color: rgb(248, 249, 250); border-left: 4px solid rgb(71, 125, 173);"><div class="notification-title" style="font-weight: bold; color: rgb(31, 41, 55);">系统就绪提示</div><div class="notification-body" style="font-size: 14px; color: rgb(75, 85, 99); margin-top: 4px;">所有模块与动态节点属性装配完成。</div></div>
六、高频踩坑排查与批量挂载性能优化
在实际项目编码过程中,动态创建与配置 div 往往伴随着几个典型的逻辑或性能陷阱,掌握针对性的排查方法有助于写出健壮高效的代码。
1. 为什么代码执行后页面没有任何变化?
初学者最容易遗漏的步骤是挂载操作。通过 document.createElement('div') 创建的节点只存在于内存变量中,如果不执行 parentElement.appendChild(div) 或 parentElement.append(div),该节点永远不会进入渲染树,页面自然不会显示。排查时可使用 document.body.contains(myDiv) 检查节点是否已建立树形关联。
2. 为什么设置的 style 属性没有生效?
样式不生效通常有三个原因:一是错误书写了连字符(例如误写成 div.style.background-color,在 JS 中会被当做减号引发语法错误或静默赋值失败);二是数值类型样式缺失了单位(如 div.style.height = 50 必须改为 '50px');三是外部 CSS 规则拥有更高优先级的 !important 声明,覆盖了当前的行内样式。
3. 循环批量插入多个 div 时的性能卡顿问题
如果在 for 循环中遍历生成大量 div,并且每次循环都直接调用 container.appendChild(item),那么每次调用都会引发一次 DOM 树的变更与重排重绘。当数据量达到数百甚至数千条时,会造成页面明显的卡顿与掉帧。
性能优化方案:使用 DocumentFragment
DocumentFragment 是一个轻量级的虚拟文档片段容器,它不是真实 DOM 树的一部分。所有新建的 div 可以先追加到虚拟片段中,循环结束后仅需调用一次 append() 将整个片段挂载到容器中,从而将多次重排压缩为仅有的一次。
// 批量生成 100 个动态卡片的高性能写法
const fragment = document.createDocumentFragment();
for (let i = 1; i <= 100; i++) {
const item = document.createElement('div');
item.classList.add('list-item');
item.textContent = `数据列表项 #${i}`;
// 先暂存到虚拟内存片段中,零重排开销
fragment.appendChild(item);
}
// 一次性挂载到真实 DOM,仅触发 1 次重排与重绘
document.getElementById('list-container').appendChild(fragment);兼容旧浏览器的JS垂直居中回退方案
2026-11-17 19:17:12
JS怎么修改伪元素::before的颜色
2026-11-17 18:48:12
页面切换后JS倒计时暂停与恢复的实现方法
2026-11-17 18:04:44
JS代码在Safari或IE中报错?常用不兼容API清单及替代方案
2026-11-17 16:20:35
display:none隐藏与JS删除HTML元素有什么区别
2026-11-17 15:50:00








