life-echo/skills/top-app-bar.md

Skill：顶部导航栏（App Bar）

与具体业务无关的顶部导航栏设计：透明化、状态栏占位与使用约定。

---

透明化

• 使用 TransparentTopAppBar（Material3 TopAppBar 封装），支持三种模式：
  • FULLY_TRANSPARENT：背景完全透明。
  • SEMI_TRANSPARENT：半透明，可设 alpha。
  • GRADIENT：自上而下渐变透明（常用）。
• 已处理状态栏占位：windowInsetsPadding(WindowInsets.statusBars)。
• 标题/返回/图标颜色需根据背景选：浅底用 onSurface，深色底用浅色，以保证可读性。

使用约定

• 普通页：在 Scaffold.topBar 中放 TransparentTopAppBar，按需选 transparencyType、gradientColors/alpha。
• 聊天页等：可用 ChatHeader，通过 isTransparent、transparencyType、alpha 控制透明效果。

文档

• 详细用法见：app-android/doc/透明化导航栏使用指南.md。