从零开始学习jQuery UI垂直导航菜单制作完整教程手把手教你创建响应式交互式导航栏解决网站导航设计难题提升用户体验和网站专业性
引言
在当今的网页设计中，导航菜单是网站不可或缺的组成部分。一个好的导航菜单不仅能够帮助用户快速找到所需内容，还能提升网站的整体用户体验和专业性。jQuery UI作为一个强大的JavaScript库，提供了丰富的交互组件，使得创建美观且功能强大的导航菜单变得简单易行。
垂直导航菜单因其节省水平空间、易于组织和展示多层次内容的特点，在许多网站中得到了广泛应用。本教程将从零开始，手把手教你如何使用jQuery UI创建一个响应式、交互式的垂直导航菜单，帮助你解决网站导航设计难题，提升用户体验和网站专业性。
准备工作
在开始创建jQuery UI垂直导航菜单之前，我们需要进行一些准备工作，确保开发环境正确配置。
1. 下载必要的库文件
首先，我们需要下载jQuery和jQuery UI库。你可以从官方网站下载这些文件，或者通过CDN链接引入它们。
以下是使用CDN引入这些库的代码：
<!-- 引入jQuery库 --> <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script> <!-- 引入jQuery UI库 --> <script src="https://code.jquery.com/ui/1.13.2/jquery-ui.min.js"></script> <!-- 引入jQuery UI CSS --> <link rel="stylesheet" href="https://code.jquery.com/ui/1.13.2/themes/ui-lightness/jquery-ui.css"> 2. 创建项目文件结构
为了保持代码的有序性，我们建议创建以下项目文件结构：
project/ ├── index.html ├── css/ │ └── style.css └── js/ └── script.js 3. 基本HTML模板
创建一个基本的HTML文件，作为我们开发垂直导航菜单的起点：
<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>jQuery UI垂直导航菜单教程</title> <!-- 引入jQuery UI CSS --> <link rel="stylesheet" href="https://code.jquery.com/ui/1.13.2/themes/ui-lightness/jquery-ui.css"> <!-- 引入自定义CSS --> <link rel="stylesheet" href="css/style.css"> </head> <body> <!-- 导航菜单将在这里 --> <!-- 引入jQuery库 --> <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script> <!-- 引入jQuery UI库 --> <script src="https://code.jquery.com/ui/1.13.2/jquery-ui.min.js"></script> <!-- 引入自定义JavaScript --> <script src="js/script.js"></script> </body> </html> 现在，我们已经完成了准备工作，可以开始创建垂直导航菜单的基本HTML结构了。
基础HTML结构
创建一个语义化良好的HTML结构是构建导航菜单的第一步。我们将使用无序列表（<ul>）和列表项（<li>）来构建导航菜单的基本框架。
1. 基本导航菜单结构
在<body>标签中添加以下HTML代码：
<div class="container"> <nav class="vertical-menu"> <ul id="menu"> <li><a href="#">首页</a></li> <li><a href="#">关于我们</a></li> <li><a href="#">服务</a> <ul> <li><a href="#">网站设计</a></li> <li><a href="#">应用开发</a></li> <li><a href="#">数字营销</a></li> </ul> </li> <li><a href="#">产品</a> <ul> <li><a href="#">产品类别1</a></li> <li><a href="#">产品类别2</a></li> <li><a href="#">产品类别3</a> <ul> <li><a href="#">子产品1</a></li> <li><a href="#">子产品2</a></li> <li><a href="#">子产品3</a></li> </ul> </li> </ul> </li> <li><a href="#">博客</a></li> <li><a href="#">联系我们</a></li> </ul> </nav> <div class="content"> <h1>欢迎访问我们的网站</h1> <p>这是一个使用jQuery UI创建的垂直导航菜单示例。</p> </div> </div> 这个HTML结构创建了一个包含多级菜单的垂直导航菜单。顶级菜单项包括”首页”、”关于我们”、”服务”、”产品”、”博客”和”联系我们”。其中，”服务”和”产品”菜单项包含子菜单，”产品类别3”还包含一个三级子菜单。
2. 添加辅助内容
为了使示例更加完整，我们添加一些辅助内容，以便更好地展示导航菜单的效果：
<div class="content"> <h1>欢迎访问我们的网站</h1> <p>这是一个使用jQuery UI创建的垂直导航菜单示例。</p> <h2>关于本教程</h2> <p>本教程将教你如何从零开始创建一个响应式、交互式的垂直导航菜单。通过使用jQuery UI，我们可以轻松地添加各种交互效果，提升用户体验。</p> <h2>导航菜单的特点</h2> <ul> <li>响应式设计，适应不同屏幕尺寸</li> <li>多级菜单支持</li> <li>平滑的展开/收起动画</li> <li>可定制的主题和样式</li> <li>键盘导航支持</li> </ul> </div> 现在，我们已经创建了垂直导航菜单的基本HTML结构。接下来，我们将使用CSS来美化导航菜单的外观。
CSS样式设计
CSS样式对于创建美观的导航菜单至关重要。在这一部分，我们将为垂直导航菜单添加样式，使其看起来更加专业和吸引人。
1. 基本样式
在css/style.css文件中添加以下基本样式：
/* 全局样式 */ * { margin: 0; padding: 0; box-sizing: border-box; } body { font-family: 'Arial', sans-serif; line-height: 1.6; color: #333; background-color: #f5f5f5; } .container { display: flex; min-height: 100vh; } /* 垂直导航菜单样式 */ .vertical-menu { width: 250px; background-color: #2c3e50; padding: 20px 0; box-shadow: 2px 0 5px rgba(0, 0, 0, 0.1); } .vertical-menu ul { list-style: none; } .vertical-menu ul li { position: relative; } .vertical-menu ul li a { display: block; padding: 12px 20px; color: #ecf0f1; text-decoration: none; transition: all 0.3s ease; } .vertical-menu ul li a:hover { background-color: #34495e; color: #3498db; } /* 内容区域样式 */ .content { flex: 1; padding: 30px; } .content h1 { margin-bottom: 20px; color: #2c3e50; } .content h2 { margin-top: 30px; margin-bottom: 15px; color: #34495e; } .content p { margin-bottom: 15px; } .content ul { margin-left: 20px; margin-bottom: 15px; } .content ul li { margin-bottom: 8px; } 这些基本样式为垂直导航菜单提供了一个深色背景，并设置了菜单项的基本样式，包括颜色、内边距和悬停效果。同时，我们也为内容区域添加了基本样式，使其看起来更加整洁和专业。
2. 子菜单样式
接下来，我们为子菜单添加样式，使其与父菜单有所区别，并提供更好的视觉层次：
/* 子菜单样式 */ .vertical-menu ul ul { display: none; background-color: #34495e; } .vertical-menu ul li:hover > ul { display: block; } .vertical-menu ul ul li a { padding-left: 40px; font-size: 0.9em; } .vertical-menu ul ul ul li a { padding-left: 60px; font-size: 0.8em; } 这些样式为子菜单设置了不同的背景颜色和缩进，使它们在视觉上与父菜单区分开来。目前，我们使用简单的CSS悬停效果来显示子菜单，稍后我们将使用jQuery UI来增强这些交互效果。
3. 添加图标
为了使导航菜单更加直观和吸引人，我们可以为菜单项添加图标。我们将使用Font Awesome图标库，这是一个广泛使用的图标库，提供了大量免费图标。
首先，在HTML文件的<head>部分添加Font Awesome的CDN链接：
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css"> 然后，修改HTML结构，为每个菜单项添加相应的图标：
<div class="container"> <nav class="vertical-menu"> <ul id="menu"> <li><a href="#"><i class="fas fa-home"></i> 首页</a></li> <li><a href="#"><i class="fas fa-info-circle"></i> 关于我们</a></li> <li><a href="#"><i class="fas fa-concierge-bell"></i> 服务</a> <ul> <li><a href="#"><i class="fas fa-paint-brush"></i> 网站设计</a></li> <li><a href="#"><i class="fas fa-code"></i> 应用开发</a></li> <li><a href="#"><i class="fas fa-bullhorn"></i> 数字营销</a></li> </ul> </li> <li><a href="#"><i class="fas fa-box"></i> 产品</a> <ul> <li><a href="#"><i class="fas fa-cube"></i> 产品类别1</a></li> <li><a href="#"><i class="fas fa-cube"></i> 产品类别2</a></li> <li><a href="#"><i class="fas fa-cube"></i> 产品类别3</a> <ul> <li><a href="#"><i class="fas fa-gem"></i> 子产品1</a></li> <li><a href="#"><i class="fas fa-gem"></i> 子产品2</a></li> <li><a href="#"><i class="fas fa-gem"></i> 子产品3</a></li> </ul> </li> </ul> </li> <li><a href="#"><i class="fas fa-blog"></i> 博客</a></li> <li><a href="#"><i class="fas fa-envelope"></i> 联系我们</a></li> </ul> </nav> <div class="content"> <!-- 内容保持不变 --> </div> </div> 最后，为图标添加一些样式，使它们与文本更好地配合：
/* 图标样式 */ .vertical-menu ul li a i { margin-right: 10px; width: 20px; text-align: center; } 现在，我们的垂直导航菜单已经具有了基本的样式和图标。接下来，我们将使用jQuery UI来添加交互功能，使菜单更加动态和用户友好。
jQuery UI初始化
jQuery UI提供了许多交互组件，我们可以利用这些组件来增强导航菜单的功能。在这一部分，我们将使用jQuery UI的Menu组件来初始化我们的垂直导航菜单，并添加一些交互效果。
1. 初始化jQuery UI Menu组件
在js/script.js文件中添加以下代码：
$(document).ready(function() { // 初始化jQuery UI Menu组件 $("#menu").menu({ position: { my: "left top", at: "right top" }, icons: { submenu: "ui-icon-caret-1-e" }, // 禁用默认的动画效果，我们将自定义动画 menus: "ul", // 添加自定义类名，便于样式定制 classes: { "ui-menu": "ui-menu-custom", "ui-menu-item": "ui-menu-item-custom" } }); }); 这段代码使用jQuery UI的Menu组件初始化了我们的导航菜单。我们设置了一些选项，如子菜单位置、子菜单图标和自定义类名，以便于后续的样式定制。
2. 自定义jQuery UI Menu样式
虽然jQuery UI提供了一些默认样式，但我们可能需要根据自己的设计需求进行一些调整。在css/style.css文件中添加以下样式：
/* 自定义jQuery UI Menu样式 */ .ui-menu-custom { width: 100%; background-color: #2c3e50; border: none; border-radius: 0; box-shadow: none; } .ui-menu-item-custom { margin: 0; padding: 0; } .ui-menu-item-custom a { display: block; padding: 12px 20px; color: #ecf0f1; text-decoration: none; transition: all 0.3s ease; border: none; border-radius: 0; background-color: transparent; } .ui-menu-item-custom a:hover, .ui-menu-item-custom a:focus { background-color: #34495e; color: #3498db; border: none; } .ui-menu-item-custom.ui-state-active { background-color: #3498db; color: #fff; border: none; } /* 子菜单样式 */ .ui-menu-custom .ui-menu { width: 100%; background-color: #34495e; border: none; border-radius: 0; box-shadow: none; top: 0 !important; left: 100% !important; } .ui-menu-custom .ui-menu .ui-menu-item a { padding-left: 40px; font-size: 0.9em; } .ui-menu-custom .ui-menu .ui-menu .ui-menu-item a { padding-left: 60px; font-size: 0.8em; } /* 子菜单图标 */ .ui-menu-custom .ui-menu-icon { position: absolute; right: 10px; top: 50%; margin-top: -8px; } 这些样式覆盖了jQuery UI的默认样式，使导航菜单的外观与我们的设计保持一致。我们调整了菜单项的背景色、文字颜色、悬停效果等，并确保子菜单正确显示在父菜单的右侧。
3. 添加动画效果
为了使导航菜单的交互更加流畅和吸引人，我们可以添加一些动画效果。修改js/script.js文件中的代码：
$(document).ready(function() { // 初始化jQuery UI Menu组件 $("#menu").menu({ position: { my: "left top", at: "right top" }, icons: { submenu: "ui-icon-caret-1-e" }, // 添加自定义动画 beforeShow: function(event, ui) { $(ui.item).children("ul").hide().slideDown(300); }, beforeHide: function(event, ui) { $(ui.item).children("ul").show().slideUp(300); }, menus: "ul", // 添加自定义类名，便于样式定制 classes: { "ui-menu": "ui-menu-custom", "ui-menu-item": "ui-menu-item-custom" } }); // 为菜单项添加点击事件 $("#menu .ui-menu-item").on("click", function() { // 移除所有菜单项的活动状态 $("#menu .ui-menu-item").removeClass("active"); // 为当前点击的菜单项添加活动状态 $(this).addClass("active"); }); }); 这段代码添加了子菜单的展开和收起动画效果，并为菜单项添加了点击事件，以便在用户点击菜单项时添加活动状态。
在css/style.css文件中添加以下样式，以支持活动状态：
/* 菜单项活动状态 */ .ui-menu-item-custom.active > a { background-color: #3498db; color: #fff; } 现在，我们的垂直导航菜单已经具有了基本的交互功能。接下来，我们将使其响应式，以适应不同设备的屏幕尺寸。
响应式设计
在当今的移动优先时代，使导航菜单响应式是非常重要的。在这一部分，我们将添加一些CSS和JavaScript代码，使我们的垂直导航菜单能够适应不同设备的屏幕尺寸。
1. 添加媒体查询
在css/style.css文件中添加以下媒体查询，以适应不同的屏幕尺寸：
/* 平板设备 */ @media (max-width: 768px) { .container { flex-direction: column; } .vertical-menu { width: 100%; padding: 10px 0; } .content { padding: 20px; } .ui-menu-custom .ui-menu { position: static !important; width: 100% !important; box-shadow: none !important; left: 0 !important; top: 0 !important; } .ui-menu-custom .ui-menu .ui-menu-item a { padding-left: 30px; } .ui-menu-custom .ui-menu .ui-menu .ui-menu-item a { padding-left: 45px; } } /* 移动设备 */ @media (max-width: 480px) { .vertical-menu { padding: 5px 0; } .vertical-menu ul li a { padding: 10px 15px; font-size: 0.9em; } .ui-menu-custom .ui-menu .ui-menu-item a { padding-left: 25px; } .ui-menu-custom .ui-menu .ui-menu .ui-menu-item a { padding-left: 35px; } .content { padding: 15px; } .content h1 { font-size: 1.5em; } .content h2 { font-size: 1.3em; } } 这些媒体查询根据屏幕宽度调整了导航菜单和内容区域的布局和样式。在平板设备上，我们将导航菜单从垂直布局改为水平布局，而在移动设备上，我们进一步调整了内边距和字体大小，以适应更小的屏幕。
2. 添加响应式切换按钮
在小屏幕设备上，我们可能希望默认隐藏导航菜单，并通过一个按钮来切换其显示状态。让我们实现这个功能。
首先，修改HTML结构，添加一个切换按钮：
<div class="container"> <button class="menu-toggle"> <i class="fas fa-bars"></i> 菜单 </button> <nav class="vertical-menu"> <!-- 导航菜单内容保持不变 --> </nav> <div class="content"> <!-- 内容保持不变 --> </div> </div> 然后，在css/style.css文件中添加以下样式：
/* 菜单切换按钮 */ .menu-toggle { display: none; background-color: #2c3e50; color: #ecf0f1; border: none; padding: 10px 15px; cursor: pointer; width: 100%; text-align: left; font-size: 1em; } .menu-toggle:hover { background-color: #34495e; } .menu-toggle i { margin-right: 10px; } /* 移动设备样式 */ @media (max-width: 768px) { .menu-toggle { display: block; } .vertical-menu { display: none; width: 100%; } .vertical-menu.active { display: block; } } 最后，在js/script.js文件中添加以下代码，以实现菜单切换功能：
$(document).ready(function() { // 之前的代码保持不变 // 菜单切换功能 $(".menu-toggle").on("click", function() { $(".vertical-menu").slideToggle(300, function() { $(this).toggleClass("active"); }); }); // 在窗口大小改变时检查是否需要显示菜单 $(window).on("resize", function() { if ($(window).width() > 768) { $(".vertical-menu").show().addClass("active"); } else { $(".vertical-menu").hide().removeClass("active"); } }); }); 这段代码添加了一个菜单切换按钮，在小屏幕设备上显示。当用户点击这个按钮时，导航菜单会以滑动动画的形式显示或隐藏。此外，我们还添加了一个窗口大小改变事件监听器，以确保在窗口大小改变时，导航菜单的显示状态正确。
现在，我们的垂直导航菜单已经完全响应式，可以适应不同设备的屏幕尺寸。接下来，我们将添加一些高级功能，使导航菜单更加功能强大和用户友好。
高级功能
在这一部分，我们将添加一些高级功能，如搜索功能、固定位置导航、滚动效果等，使我们的垂直导航菜单更加功能强大和用户友好。
1. 添加搜索功能
在导航菜单中添加搜索功能可以帮助用户快速找到所需内容。让我们实现这个功能。
首先，修改HTML结构，在导航菜单中添加搜索框：
<nav class="vertical-menu"> <div class="menu-search"> <input type="text" id="menu-search-input" placeholder="搜索菜单..."> <button id="menu-search-button"><i class="fas fa-search"></i></button> </div> <ul id="menu"> <!-- 导航菜单内容保持不变 --> </ul> </nav> 然后，在css/style.css文件中添加以下样式：
/* 菜单搜索框样式 */ .menu-search { padding: 10px 15px; display: flex; border-bottom: 1px solid #34495e; } #menu-search-input { flex: 1; padding: 8px 10px; border: none; border-radius: 3px 0 0 3px; background-color: #34495e; color: #ecf0f1; } #menu-search-input:focus { outline: none; background-color: #3d566e; } #menu-search-button { padding: 8px 12px; border: none; background-color: #3498db; color: #fff; cursor: pointer; border-radius: 0 3px 3px 0; } #menu-search-button:hover { background-color: #2980b9; } /* 搜索结果高亮 */ .ui-menu-item-custom.search-result > a { background-color: #3498db; color: #fff; } .ui-menu-item-custom.no-search-result > a { color: #95a5a6; cursor: default; } .ui-menu-item-custom.no-search-result > a:hover { background-color: transparent; color: #95a5a6; } 最后，在js/script.js文件中添加以下代码，以实现搜索功能：
$(document).ready(function() { // 之前的代码保持不变 // 菜单搜索功能 $("#menu-search-input").on("keyup", function() { var searchTerm = $(this).val().toLowerCase(); if (searchTerm === "") { // 如果搜索框为空，显示所有菜单项 $("#menu .ui-menu-item").removeClass("search-result no-search-result").show(); $("#menu .ui-menu").show(); } else { var found = false; // 遍历所有顶级菜单项 $("#menu > .ui-menu-item").each(function() { var menuItem = $(this); var menuText = menuItem.text().toLowerCase(); if (menuText.includes(searchTerm)) { // 如果菜单项包含搜索词，显示该菜单项及其所有子菜单 menuItem.removeClass("no-search-result").addClass("search-result").show(); menuItem.find(".ui-menu").show(); menuItem.find(".ui-menu-item").removeClass("no-search-result").show(); found = true; } else { // 检查子菜单是否包含搜索词 var subMenuFound = false; menuItem.find(".ui-menu-item").each(function() { var subMenuItem = $(this); var subMenuText = subMenuItem.text().toLowerCase(); if (subMenuText.includes(searchTerm)) { subMenuItem.removeClass("no-search-result").show(); subMenuFound = true; found = true; } else { subMenuItem.removeClass("search-result").addClass("no-search-result").hide(); } }); if (subMenuFound) { menuItem.removeClass("no-search-result").show(); menuItem.find(".ui-menu").show(); } else { menuItem.removeClass("search-result").addClass("no-search-result").hide(); menuItem.find(".ui-menu").hide(); } } }); // 如果没有找到任何匹配项，显示一条消息 if (!found) { if ($("#no-search-result").length === 0) { $("#menu").append('<li class="ui-menu-item no-search-result" id="no-search-result"><a>没有找到匹配的菜单项</a></li>'); } } else { $("#no-search-result").remove(); } } }); // 清除搜索按钮功能 $("#menu-search-button").on("click", function() { $("#menu-search-input").val("").trigger("keyup"); }); }); 这段代码实现了一个实时搜索功能，当用户在搜索框中输入内容时，导航菜单会实时过滤显示匹配的菜单项。如果菜单项的文本包含搜索词，该菜单项及其父菜单会被高亮显示；如果没有找到任何匹配项，会显示一条提示消息。
2. 固定位置导航
在某些情况下，我们可能希望导航菜单在页面滚动时保持固定位置，以便用户随时可以访问。让我们实现这个功能。
在css/style.css文件中添加以下样式：
/* 固定位置导航 */ .vertical-menu.fixed { position: fixed; top: 0; left: 0; height: 100vh; overflow-y: auto; z-index: 1000; } .content.with-fixed-menu { margin-left: 250px; } /* 响应式调整 */ @media (max-width: 768px) { .content.with-fixed-menu { margin-left: 0; } .vertical-menu.fixed { width: 100%; height: auto; max-height: 50vh; } } 然后，在js/script.js文件中添加以下代码：
$(document).ready(function() { // 之前的代码保持不变 // 固定位置导航功能 function initFixedMenu() { // 添加固定位置切换按钮 if ($(".menu-fixed-toggle").length === 0) { $(".vertical-menu").prepend('<button class="menu-fixed-toggle"><i class="fas fa-thumbtack"></i></button>'); } // 固定位置切换按钮点击事件 $(".menu-fixed-toggle").on("click", function() { $(".vertical-menu").toggleClass("fixed"); $(".content").toggleClass("with-fixed-menu"); $(this).toggleClass("active"); }); } // 初始化固定位置菜单功能 initFixedMenu(); }); 最后，在css/style.css文件中添加以下样式：
/* 固定位置切换按钮 */ .menu-fixed-toggle { display: block; width: 100%; padding: 10px; background-color: transparent; border: none; color: #95a5a6; cursor: pointer; text-align: right; font-size: 1em; } .menu-fixed-toggle:hover { color: #ecf0f1; } .menu-fixed-toggle.active { color: #3498db; } .menu-fixed-toggle i { margin-right: 5px; } 这段代码实现了一个固定位置导航功能，用户可以通过点击导航菜单右上角的图钉按钮来切换导航菜单的固定位置状态。当导航菜单处于固定位置时，它会始终显示在屏幕的左侧，即使用户滚动页面也是如此。
3. 添加平滑滚动效果
如果导航菜单中的链接指向页面内的锚点，我们可以添加平滑滚动效果，使页面滚动更加平滑和自然。
在js/script.js文件中添加以下代码：
$(document).ready(function() { // 之前的代码保持不变 // 平滑滚动效果 $("#menu a[href^='#']").on("click", function(e) { e.preventDefault(); var target = $(this.getAttribute("href")); if (target.length) { $("html, body").animate({ scrollTop: target.offset().left }, 500); // 如果在移动设备上，点击菜单项后关闭菜单 if ($(window).width() <= 768) { $(".vertical-menu").slideToggle(300, function() { $(this).toggleClass("active"); }); } } }); }); 这段代码为导航菜单中指向页面内锚点的链接添加了平滑滚动效果。当用户点击这些链接时，页面会平滑滚动到目标位置，而不是立即跳转。在移动设备上，点击菜单项后还会自动关闭导航菜单，以提供更好的用户体验。
4. 添加活动菜单项指示器
为了指示当前活动的菜单项，我们可以添加一个活动菜单项指示器，使用户清楚地知道他们当前在哪个页面或部分。
在css/style.css文件中添加以下样式：
/* 活动菜单项指示器 */ .ui-menu-item-custom.active > a::before { content: ''; position: absolute; left: 0; top: 0; height: 100%; width: 4px; background-color: #3498db; } .ui-menu-custom .ui-menu .ui-menu-item.active > a::before { width: 3px; } .ui-menu-custom .ui-menu .ui-menu .ui-menu-item.active > a::before { width: 2px; } 然后，在js/script.js文件中添加以下代码：
$(document).ready(function() { // 之前的代码保持不变 // 设置活动菜单项 function setActiveMenuItem() { // 获取当前URL的路径部分 var currentPath = window.location.pathname; // 遍历所有菜单链接 $("#menu a").each(function() { var linkPath = $(this).attr("href"); // 如果链接指向外部网站，跳过 if (linkPath.indexOf("http") === 0) { return; } // 如果链接路径与当前路径匹配，设置为活动状态 if (linkPath === currentPath) { $(this).closest(".ui-menu-item").addClass("active"); // 展开父菜单 $(this).closest(".ui-menu").show(); $(this).closest(".ui-menu-item").parents(".ui-menu-item").addClass("active"); } }); } // 初始化活动菜单项 setActiveMenuItem(); }); 这段代码实现了一个活动菜单项指示器，它会根据当前页面的URL自动设置对应的菜单项为活动状态，并在活动菜单项的左侧显示一个蓝色指示条。同时，它还会展开包含活动菜单项的所有父菜单，使用户能够清楚地看到当前页面在导航菜单中的位置。
现在，我们的垂直导航菜单已经具有了许多高级功能，包括搜索功能、固定位置导航、平滑滚动效果和活动菜单项指示器。接下来，我们将讨论一些常见问题的解决方法。
常见问题解决
在开发和使用jQuery UI垂直导航菜单的过程中，可能会遇到一些常见问题。在这一部分，我们将讨论这些问题的解决方法。
1. 子菜单不显示或显示不正确
问题：子菜单不显示或显示位置不正确。
解决方案：
这个问题通常是由于CSS样式冲突或jQuery UI初始化不正确导致的。首先，检查jQuery UI是否正确初始化：
$(document).ready(function() { $("#menu").menu({ position: { my: "left top", at: "right top" }, icons: { submenu: "ui-icon-caret-1-e" }, menus: "ul" }); }); 然后，检查CSS样式是否正确设置子菜单位置：
.ui-menu-custom .ui-menu { position: absolute; width: 100%; background-color: #34495e; border: none; border-radius: 0; box-shadow: none; top: 0 !important; left: 100% !important; } 如果问题仍然存在，尝试使用浏览器的开发者工具检查是否有其他CSS样式覆盖了这些设置。
2. 响应式布局不工作
问题：在小屏幕设备上，导航菜单的响应式布局不工作。
解决方案：
首先，确保HTML的<head>部分包含了视口元标签：
<meta name="viewport" content="width=device-width, initial-scale=1.0"> 然后，检查媒体查询是否正确设置：
@media (max-width: 768px) { .container { flex-direction: column; } .vertical-menu { width: 100%; padding: 10px 0; } /* 其他响应式样式 */ } 最后，确保JavaScript代码中包含了窗口大小改变事件监听器：
$(window).on("resize", function() { if ($(window).width() > 768) { $(".vertical-menu").show().addClass("active"); } else { $(".vertical-menu").hide().removeClass("active"); } }); 3. 菜单项点击事件不触发
问题：点击菜单项时，预期的点击事件不触发。
解决方案：
这个问题通常是由于事件委托或事件冒泡问题导致的。尝试使用事件委托来处理菜单项的点击事件：
$("#menu").on("click", ".ui-menu-item", function(e) { // 阻止事件冒泡 e.stopPropagation(); // 移除所有菜单项的活动状态 $("#menu .ui-menu-item").removeClass("active"); // 为当前点击的菜单项添加活动状态 $(this).addClass("active"); // 其他点击事件处理代码 }); 如果菜单项包含链接，确保链接的默认行为没有被意外阻止：
$("#menu").on("click", ".ui-menu-item a", function(e) { // 如果链接指向外部URL或锚点，允许默认行为 if ($(this).attr("href").indexOf("http") === 0 || $(this).attr("href").indexOf("#") === 0) { return; } // 阻止默认行为 e.preventDefault(); // 其他点击事件处理代码 }); 4. 搜索功能不工作
问题：菜单搜索功能不工作或搜索结果不准确。
解决方案：
首先，确保搜索输入框和按钮的HTML结构正确：
<div class="menu-search"> <input type="text" id="menu-search-input" placeholder="搜索菜单..."> <button id="menu-search-button"><i class="fas fa-search"></i></button> </div> 然后，检查搜索功能的JavaScript代码是否正确实现：
$("#menu-search-input").on("keyup", function() { var searchTerm = $(this).val().toLowerCase(); if (searchTerm === "") { // 如果搜索框为空，显示所有菜单项 $("#menu .ui-menu-item").removeClass("search-result no-search-result").show(); $("#menu .ui-menu").show(); } else { var found = false; // 遍历所有顶级菜单项 $("#menu > .ui-menu-item").each(function() { var menuItem = $(this); var menuText = menuItem.text().toLowerCase(); if (menuText.includes(searchTerm)) { // 如果菜单项包含搜索词，显示该菜单项及其所有子菜单 menuItem.removeClass("no-search-result").addClass("search-result").show(); menuItem.find(".ui-menu").show(); menuItem.find(".ui-menu-item").removeClass("no-search-result").show(); found = true; } else { // 检查子菜单是否包含搜索词 var subMenuFound = false; menuItem.find(".ui-menu-item").each(function() { var subMenuItem = $(this); var subMenuText = subMenuItem.text().toLowerCase(); if (subMenuText.includes(searchTerm)) { subMenuItem.removeClass("no-search-result").show(); subMenuFound = true; found = true; } else { subMenuItem.removeClass("search-result").addClass("no-search-result").hide(); } }); if (subMenuFound) { menuItem.removeClass("no-search-result").show(); menuItem.find(".ui-menu").show(); } else { menuItem.removeClass("search-result").addClass("no-search-result").hide(); menuItem.find(".ui-menu").hide(); } } }); // 如果没有找到任何匹配项，显示一条消息 if (!found) { if ($("#no-search-result").length === 0) { $("#menu").append('<li class="ui-menu-item no-search-result" id="no-search-result"><a>没有找到匹配的菜单项</a></li>'); } } else { $("#no-search-result").remove(); } } }); 如果问题仍然存在，尝试在搜索功能的代码中添加一些调试信息，以确定问题所在：
$("#menu-search-input").on("keyup", function() { var searchTerm = $(this).val().toLowerCase(); console.log("搜索词:", searchTerm); // 其他代码... }); 5. 固定位置导航导致内容被遮挡
问题：当导航菜单设置为固定位置时，页面内容被导航菜单遮挡。
解决方案：
这个问题通常是由于没有为内容区域设置足够的左边距导致的。检查并修改CSS样式：
.content.with-fixed-menu { margin-left: 250px; /* 这应该与导航菜单的宽度相同 */ } /* 响应式调整 */ @media (max-width: 768px) { .content.with-fixed-menu { margin-left: 0; /* 在小屏幕设备上不需要左边距 */ } .vertical-menu.fixed { width: 100%; height: auto; max-height: 50vh; } } 如果问题仍然存在，可能需要调整内容区域的内边距：
.content { padding: 30px; box-sizing: border-box; } .content.with-fixed-menu { margin-left: 250px; padding-left: 30px; /* 确保内容不会被导航菜单遮挡 */ } 总结与最佳实践
在本教程中，我们从零开始，手把手地学习了如何使用jQuery UI创建一个响应式、交互式的垂直导航菜单。我们涵盖了从准备工作到高级功能的各个方面，并解决了一些常见问题。
主要成果
通过本教程，我们实现了以下功能：
- 创建了一个基本的多级垂直导航菜单结构
- 使用CSS样式美化了导航菜单的外观
- 使用jQuery UI添加了交互功能
- 实现了响应式设计，使导航菜单适应不同设备的屏幕尺寸
- 添加了搜索功能，帮助用户快速找到所需内容
- 实现了固定位置导航，使用户在滚动页面时仍能访问导航菜单
- 添加了平滑滚动效果，提升用户体验
- 实现了活动菜单项指示器，帮助用户了解当前位置
最佳实践
在开发jQuery UI垂直导航菜单时，以下是一些最佳实践：
语义化HTML：使用适当的HTML标签（如
<nav>、<ul>、<li>）创建导航菜单的结构，提高代码的可读性和可访问性。模块化CSS：将CSS样式组织成模块，便于维护和扩展。使用类名来标识不同的组件和状态。
性能优化：避免使用过多的动画效果，以免影响页面性能。对于大型菜单，考虑使用延迟加载技术。
可访问性：确保导航菜单对所有用户都可访问，包括使用屏幕阅读器的用户。使用ARIA属性提高可访问性。
移动优先：采用移动优先的设计方法，首先为小屏幕设备设计导航菜单，然后逐步增强以适应更大的屏幕。
用户测试：在发布之前，进行用户测试，确保导航菜单易于使用和理解。
扩展功能
如果你想要进一步扩展导航菜单的功能，可以考虑以下方向：
添加面包屑导航：在页面顶部添加面包屑导航，帮助用户了解他们在网站中的位置。
实现拖放排序：使用jQuery UI的Sortable组件，允许管理员通过拖放来重新排序菜单项。
添加动画效果：使用CSS3动画或jQuery动画，为菜单项添加更多的动画效果，如淡入淡出、滑动等。
实现多语言支持：为导航菜单添加多语言支持，使网站能够适应不同语言的用户。
添加用户权限控制：根据用户角色和权限，动态显示或隐藏特定的菜单项。
通过本教程，你已经学会了如何从零开始创建一个功能丰富、响应式的jQuery UI垂直导航菜单。这个导航菜单不仅美观，而且功能强大，可以大大提升网站的用户体验和专业性。希望这个教程对你有所帮助，祝你在网站开发的道路上取得成功！
支付宝扫一扫
微信扫一扫 |
