
本文详解如何使用 jquery 为树形菜单(treeview)添加平滑的展开/收起动画、点击延迟响应及加载提示图标,提升用户交互体验。
在构建可折叠的树形导航菜单时,生硬的即时显示/隐藏会降低用户体验。通过引入 CSS 过渡或 jQuery 动画方法(如 slideToggle),配合视觉反馈(如加载图标),可显著增强界面的专业性与响应感。
✅ 核心实现方案
原插件中使用的是 .toggle(),它仅做显隐切换,无过渡效果。我们将其替换为更自然的 .slideToggle(duration),并加入加载状态模拟:
branch.on('click', function (e) {
if (this === e.target) {
var icon = $(this).children('i:first');
icon.toggleClass(openedClass + " " + closedClass);
// 插入加载提示
$(this).append(' Loading...');
// 延迟 300ms 后执行动画,并移除加载提示
setTimeout(() => {
$(this).find('.loading').remove();
$(this).children().children().slideToggle(300);
}, 300);
}
});? 说明:fa-spin 是 Font Awesome 提供的旋转动画类,确保图标持续转动;setTimeout 模拟“异步加载”延迟,实际项目中可替换为真实 AJAX 请求逻辑。
?️ 完整增强版插件代码(含样式优化)
将以下代码整合进您的 JS 文件中,即可直接启用带动画与加载态的 Treeview:
$.fn.extend({
treed: function (o) {
var openedClass = 'fa-minus-circle';
var closedClass = 'fa-plus-circle';
if (typeof o !== 'undefined') {
if (typeof o.openedClass !== 'undefined') openedClass = o.openedClass;
if (typeof o.closedClass !== 'undefined') closedClass = o.closedClass;
}
var tree = $(this).addClass('tree');
tree.find('li').has('ul').each(function () {
var branch = $(this);
branch.prepend(``);
branch.addClass('branch');
branch.on('click', function (e) {
if (this === e.target) {
var icon = $(this).children('i:first');
icon.toggleClass(openedClass + ' ' + closedClass);
// 显示加载提示
$(this).append(' Loading...');
// 延迟后执行滑动动画
setTimeout(() => {
$(this).find('.loading').remove();
$(this).children().children().slideToggle(300);
}, 300);
}
});
// 初始隐藏子菜单
branch.children().children().hide();
});
// 支持点击指示器图标触发
tree.find('.branch .indicator').on('click', function () {
$(this).closest('li').click();
});
// 支持点击链接或按钮触发
tree.find('.branch > a, .branch > button').on('click', function (e) {
$(this).closest('li').click();
e.preventDefault();
});
}
});? 必备 CSS 补充样式
为确保加载提示正常显示,请在 CSS 中添加:
.loading {
font-style: italic;
color: #666;
padding: 4px 0;
font-size: 0.85em;
}
.loading .fa-spinner {
margin-right: 6px;
}⚠️ 注意事项与最佳实践
-
避免重复插入 loading 元素:当前示例未做防重复判断。生产环境建议先检查是否存在 .loading 再追加,例如:
if (!$(this).find('.loading').length) { $(this).append('...'); } -
动画中断处理:若用户快速连续点击,slideToggle 可能出现队列堆积。可使用 .stop(true, true) 清除动画队列:
$(this).children().children().stop(true, true).slideToggle(300);
- 无障碍支持:为 图标添加 aria-hidden="true",并用 aria-expanded 属性动态标记节点展开状态,提升屏幕阅读器兼容性。
- 性能优化:深层嵌套树节点较多时,建议对 slideToggle 使用 display: block/none 替代 height 动画(默认行为),或改用 CSS transition: max-height 实现更轻量的纯 CSS 方案。
✅ 初始化调用示例
$('#tree2').treed({
openedClass: 'fa-folder-open',
closedClass: 'fa-folder'
});通过以上改造,你的 Treeview 不仅具备视觉层次感与操作反馈,还为后续集成异步数据加载(如懒加载子节点)预留了清晰的扩展接口。动画与状态提示的结合,让交互更可信、更人性化。









