本文提供一個基於 jQuery 的樹形目錄導航實現,支持多級嵌套、點擊展開/摺疊、平滑動畫效果。適用於側邊欄導航、文件目錄展示、分類選單等場景。
採用語義化的巢狀列表結構,配合唯一 ID 實現精確控制:
<div class="st_tree">
<ul>
<li><a href="#">一級目錄 1</a></li>
<li id="li1"><a href="#">一級目錄 2</a></li>
<ul id="ul1" class="ul">
<li><a href="#">二級目錄 2.1</a></li>
<li><a href="#">二級目錄 2.2</a></li>
</ul>
<li id="li2"><a href="#">一級目錄 3</a></li>
<ul id="ul2" class="ul">
<li><a href="#">二級目錄 3.1</a></li>
<li><a href="#">二級目錄 3.2</a></li>
<li id="li3"><a href="#">二級目錄 3.3</a></li>
<ul id="ul3" class="ul">
<li><a href="#">三級目錄 3.3.1</a></li>
<li><a href="#">三級目錄 3.3.2</a></li>
</ul>
</ul>
</ul>
</div>
<style>
.st_tree ul li {
font-size: 13px;
color: #222;
line-height: 18px;
cursor: pointer;
list-style: none;
background: url(st_folder.gif) no-repeat;
padding: 0 0 3px 20px;
}
.ul { display: none; } /* 子目錄默認隱藏 */
</style>
原始代碼重複綁定多個 $(document).ready(),現重構為單一入口,採用事件委託提升性能:
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>
$(function() {
// 初始隱藏所有子目錄
$('.ul').hide();
// 事件委託:統一處理所有可展開項目
$('.st_tree').on('click', 'li[id^="li"]', function(e) {
e.stopPropagation(); // 防止事件冒泡觸發父級
var targetId = '#ul' + this.id.slice(2); // li1 -> #ul1
$(targetId).slideToggle(200); // 平滑動畫
});
// 可選:點擊空白處收起所有
$(document).on('click', function() {
$('.ul:visible').slideUp(200);
});
});
</script>

▶/▼ 或資料夾圖標| 問題 | 原因 | 解決方案 |
|---|---|---|
| 點擊無反應 | ID 不匹配 / 選擇器錯誤 | 檢查 li/ul ID 對應關係,使用開發者工具調試 |
| 動畫卡頓 | DOM 過多 / 重繪頻繁 | 使用 CSS transform 代替 slideToggle,或虛擬滾動 |
| 樣式失效 | CSS 優先級 / 路徑錯誤 | 檢查背景圖路徑,提高選擇器具體性 |
這個樹形目錄實現了核心的展開/摺疊交互,代碼結構清晰,易於擴展。實際項目中建議採用優化後的事件委託寫法,並根據業務需求添加圖標狀態、鍵盤支持、數據驅動渲染等增強功能。