> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 菜单栏

> 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 布局设置 → 菜单栏设置 / 访客样式切换

控制顶部导航：Logo、站名、菜单来源、移动端形态、是否固定，以及允许访客在前台改哪些样式。

## 配置项

| 选项          | 默认值 | 说明                                      |
| ----------- | --- | --------------------------------------- |
| 菜单栏 Logo    | 空   | 留空使用主题默认图标。建议透明背景、高度约 28px，会等比缩放        |
| 显示网站名       | 开启  | 关闭后菜单栏只显示 Logo / 默认图标，不影响页面其它位置的站点标题    |
| 菜单          | 空   | 选择导航栏使用的菜单，留空使用系统主菜单                    |
| 移动端菜单样式     | 手风琴 | 手风琴：菜单栏下方展开下拉面板，子菜单折叠；抽屉：右侧滑出圆角卡片，子菜单平铺 |
| 固定菜单栏       | 关闭  | 开启后桌面端滚动时不收起（移动端始终固定）                   |
| 语言切换        | 开启  | 显示语言切换按钮，可切简体中文 / 繁體中文 / English        |
| 配色（深浅色）切换   | 开启  | 显示明暗切换按钮；关闭后按「配色方案」的默认值显示               |
| 访客样式切换 → 允许 | 开启  | 总开关，决定是否显示前台的「显示设置」入口                   |
| 访客样式切换 → 外观 | 开启  | 访客可调整主题色相、文章布局与卡片样式                     |
| 访客样式切换 → 壁纸 | 开启  | 访客可调整壁纸模式与相关参数                          |
| 访客样式切换 → 特效 | 开启  | 访客可开关樱花特效                               |

## 推荐配法

**标准博客**：Logo 留空、显示站名、固定菜单栏关闭。滚动时导航自动隐藏，内容区更大；上滑立即出现。

**品牌站**：上传横向 Logo 并关闭「显示网站名」，固定菜单栏开启，导航常驻。

**内容很轻**：移动端用抽屉样式，子菜单平铺更直观；桌面端非固定，页面更透气。

**不希望访客改样式**：关闭「允许访客切换样式」，前台入口消失，所有访客都按后台默认值显示。

## 注意事项

- **固定菜单栏只影响桌面端**：非固定模式下，桌面端下滑会隐藏导航、上滑出现（有 8px 的方向死区防止抖动）；固定模式下导航始终可见
- 语言切换会**同步后台界面语言**，同一浏览器下次进后台也会是切换后的语言
- 访客样式面板是「标签页级」开关：只开一个标签页时不显示 Tab 栏，直接渲染该分区；全部关闭时入口不显示
- 访客在前台的改动保存在浏览器本地，会覆盖后台默认值；排查显示问题时先清一次站点数据
- 关闭「配色切换」只是隐藏按钮，访客既有的深浅色偏好仍会保留

## 相关

- 主题色、深浅色默认值：[主题风格](/ethereal/appearance/theme-style.md)
- 配色切换动画样式：[主题风格](/ethereal/appearance/theme-style.md)