Qt导航栏组件C05：抽屉式侧边栏

系列编号：C-05
导航风格：滑入抽屉面板，Material Design 风格，深色调，半透明遮罩覆盖内容区
适用场景：后台管理系统、移动端风格桌面应用、模块层级深但常用功能需快速触达的多页导航场景

一、引言

实现抽屉式侧边栏时通常会遇到三个问题：

• 抽屉面板滑入时需要同时出现半透明遮罩，若用 QGraphicsOpacityEffect 控制遮罩透明度，遮罩自身的不透明背景仍会遮挡下层主页内容，透过遮罩看不到任何文字；
• DrawerNavWidget 作为覆盖层铺满 centralWidget，控件自身的背景色会在抽屉关闭时依然遮挡主页；
• 窗口 resize 时若无差别地同步面板 geometry，关闭状态下面板位置被重置到 (0,0)，下次打开时面板从可见位置滑出再滑入产生闪烁。

本文以 DrawerOverlay + DrawerNavWidget 双控件为核心，用 WA_TranslucentBackground 使容器透明、paintEvent 绘制真半透明背景、resizeEvent 分状态同步尺寸，完整实现该导航组件。

二、最终效果预览

• 左侧