JavaScript动态添加li标签最直接的方式是使用document.createElement('li')创建节点,再通过appendChild或insertBefore插入到父级列表,同时可用setAttribute或classList添加标签和样式,这是原生JS操作的基准方案,且不依赖任何框架。
原生JS动态添加li标签的核心方法
动态操作列表是前端开发中的高频场景,无论是渲染后台数据还是构建交互组件,都绕不开在ul或ol中插入li,先理清最基础的三条路径,再根据场景选最合适的。
使用createElement和appendChild
这是W3C规范推荐的标准做法,执行步骤清晰,且不会触发内联脚本的解析安全问题。
// 获取父级ul
const ul = document.getElementById('myList');
// 创建li元素
const li = document.createElement('li');
// 设置文本内容
li.textContent = '新增项';
// 如果需要添加标签或类
li.classList.add('item');
// 追加到ul末尾
ul.appendChild(li);
关键点:textContent比innerHTML更安全,避免XSS;appendChild一次只能添加一个节点,如果需要批量添加,配合DocumentFragment可以大幅提升性能。
使用insertBefore在指定位置插入
很多场景需要把新li插入到某个已有项之前,而不是末尾,这时用insertBefore,它接受两个参数:要插入的节点和参考节点。
const ul = document.getElementById('myList');
const firstLi = ul.querySelector('li:first-child');
const newLi = document.createElement('li');
newLi.textContent = '插在最前面';
ul.insertBefore(newLi, firstLi);
如果参考节点为null,效果等同于appendChild,日常开发中,结合children索引或nextSibling能灵活控制位置。
使用innerHTML的注意事项
直接用ul.innerHTML += '<li>新项</li>'确实简洁,但存在两个硬伤:
- 每次赋值都会重新解析整个列表的HTML字符串,原有节点的绑定事件和状态全部丢失。
- 直接拼接字符串容易引入XSS漏洞,尤其是数据来自用户输入或接口返回时。
行业共识认为,在数据量较大或需要频繁更新的列表中,应避免使用innerHTML;仅在一次性渲染静态内容时考虑,且必须对数据做转义处理。
js动态添加li标签后添加class和属性
添加一个li只是第一步,绝大多数业务场景需要给这个标签附上类名、ID、自定义属性或样式,用于后续的样式控制、数据存储或事件绑定。
添加class的几种方式
| 方法 | 代码示例 | 适用场景 |
|---|---|---|
classList.add() |
li.classList.add('active', 'highlight') |
添加一个或多个类,不会覆盖原有类 |
className |
li.className = 'active' |
直接替换全部类名,需谨慎使用 |
setAttribute('class', ...) |
li.setAttribute('class', 'active') |
与className效果类似,但不推荐 |
实操建议:多数情况下优先使用classList.add(),因为它能保留原有类名,且支持contains、remove、toggle等实用方法。
添加自定义属性与data-
动态li常常需要携带业务数据,比如ID、状态等,使用dataset操作data-属性最直观:
li.dataset.id = '1001'; li.dataset.type = 'product'; // 渲染后:<li data-id="1001" data-type="product">...</li>
如果属性名不是标准data-前缀,也可以用setAttribute,但dataset更符合现代开发习惯,且自动处理驼峰命名转换。
js动态添加li标签并绑定事件
空有标签没有交互,等于白做,动态添加的li需要绑定点击、悬停、删除等事件,这里有两条路:直接在添加时绑定,或者利用事件委托。
事件委托 vs 直接绑定
- 直接绑定:在创建
li后立即用addEventListener挂载,优点是逻辑直观,缺点是每个li独立监听,大量元素时内存占用较高。 - 事件委托:在父级
ul上监听事件,通过event.target判断点击的是哪个li,这是业内高性能场景的首选方案,尤其适合频繁增删的列表。
// 事件委托示例
ul.addEventListener('click', function(e) {
if (e.target.tagName === 'LI') {
console.log('点击了:', e.target.textContent);
}
});
优势:新增的li无需额外绑定,自动获得事件能力;移除li时也不用担心内存泄漏,据统计,在包含数百个动态列表项的页面中,事件委托可将事件相关内存占用降低
相当比例。
绑定事件的同时传递数据
通过dataset或闭包可以传递自定义数据,主流做法是用data-属性存储关键信息,在事件回调中通过e.target.dataset读取,避免依赖闭包引发的内存问题。
js动态添加li标签与jQuery方案对比
不少老项目仍在使用jQuery,但现代前端开发趋势已转向原生或框架,做一次客观对比,帮你在实际选型时心里有数。
jQuery的简便性
jQuery提供append、prepend、after等方法,语法简洁,且自动处理了浏览器兼容性。
$('#myList').append('<li class="item">新项</li>');
// 或
$('<li>').text('新项').addClass('item').appendTo('#myList');
缺点:返回的是jQuery对象,与原生节点混用容易出错;链式调用虽然方便,但在复杂逻辑中可读性下降;对于现代浏览器,很多原生API已经足够简洁,不需要额外引入60KB+的库。
原生JS的三大优势
- 零依赖:项目体积更小,加载更快。
- 性能更优:原生方法直接操作DOM,没有中间层开销,在大量动态添加时,原生配合
DocumentFragment的提速效果非常明显。 - 标准统一:ES6+的API普及度已经很高,兼容性不再是障碍,即使是IE11,
createElement和appendChild也完全支持。
新项目建议直接使用原生JS或配合框架;维护老jQuery项目时,可以继续用jQuery方式,但要注意混合使用时的类型转换。
实际场景:ajax获取数据后动态添加li
这是最典型的应用场景从后端接口拿到数据,渲染成列表,下面给出一个完整的操作流程,可直接参考。
步骤分解
- 发起请求:使用
fetch或XMLHttpRequest获取JSON数据。 - 创建文档片段:初始化
DocumentFragment,用于批量添加,减少重绘回流。 - 循环生成li:遍历数据,为每条数据创建
li、类名、属性。 - 追加到片段:将每个
li添加到DocumentFragment中。 - 一次性插入:将片段整体追加到
ul。
fetch('/api/list')
.then(res =&g
t; res.json())
.then(data => {
const fragment = document.createDocumentFragment();
data.forEach(item => {
const li = document.createElement('li');
li.textContent = item.name;
li.dataset.id = item.id;
li.classList.add('list-item');
fragment.appendChild(li);
});
document.getElementById('myList').appendChild(fragment);
});
性能建议:如果数据量较大(超过几百条),考虑分页或虚拟滚动;创建li时避免在循环中操作offsetHeight等强制回流的属性。
js动态添加li标签后样式与动画的平滑处理
添加新li时,如果直接出现,视觉上会显得突兀,配合CSS过渡或动画,能让用户体验更好。
使用CSS配合JS切换类
在创建li时先添加一个初始类(如new-item),然后通过requestAnimationFrame或setTimeout移除它,触发过渡效果。
.new-item {
opacity: 0;
transform: translateY(-10px);
transition: all 0.3s ease;
}
li.classList.add('new-item');
ul.appendChild(li);
requestAnimationFrame(() => {
li.classList.remove('new-item');
});
这样新项目会以淡入加位移的方式出现,无需额外动画库。
Q&A:js动态添加li标签常见问题解答
Q1:动态添加的li为什么无法响应click事件?
最常见的错误是直接绑定在li上,但绑定时元素尚未存在,解决方案是改用事件委托,在父级ul上监听click,通过e.target.tagName判断是否LI,如果必须单独绑定,请在创建li后立即调用addEventListener,不要延迟。
Q2:大量动态添加li时页面卡顿怎么办?
卡顿的根本原因是DOM操作触发了多次重排和重绘,优化手段包括:使用DocumentFragment批量插入;将li的样式尽量用类名控制,避免逐个修改内联样式;如果数据量达到数千条,考虑只渲染可视区域,其他用占位占位,即虚拟滚动方案。
QL:动态添加的li如何添加删除按钮并实现删除功能?
在创建li时,内部追加一个<button class="delete-btn">删除</button>,然后利用事件委托在ul上监听点击,通过e.target.classList.contains('delete-btn')判断,找到目标li后调用removeChild或remove,注意删除后要同步清理关联的数据和事件。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/546306.html




