如何为 Treeview 菜单添加开闭动画与加载状态效果

12次阅读

如何为 Treeview 菜单添加开闭动画与加载状态效果

本文详解如何使用 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 不仅具备视觉层次感与操作反馈,还为后续集成异步数据加载(如懒加载子节点)预留了清晰的扩展接口。动画与状态提示的结合,让交互更可信、更人性化。

text=ZqhQzanResources