TitleBar标题栏框架

TitleBar为 Android 应用提供一个高度可定制化的顶部导航栏解决方案，支持文本、图标、操作按钮、副标题等丰富配置，同时完美适配沉浸式布局，助力开发者快速构建统一且美观的 UI 体验。

核心功能

1. 左侧区域：灵活配置图标与文字

支持仅显示图标、仅显示文字，或图标 + 文字组合；

图标可使用 Drawable 资源或矢量图；

文字样式、颜色、字体大小均可自定义。

2. 中间标题：自动居中 & 智能排版

标题文字始终水平居中，自动适应屏幕宽度；

支持设置主标题与副标题，通过 \n（换行）和 \t（缩进）控制排版格式；

示例："赛事中心\n\t实时比分" → 主标题“赛事中心”，副标题“实时比分”缩进显示。

3. 右侧区域：可扩展操作控件

可动态添加/移除多个操作项（最多支持 3–4 个）；

每个控件可独立设置为 图标按钮 或 文字按钮；

支持点击事件回调，便于集成搜索、分享、菜单等功能。

4. 视觉细节自定义

分割线下划线：可设置是否显示底部横线，并自定义其颜色与高度；

导航栏高度：支持全局或单页面自定义高度（如 48dp、56dp、64dp 等）；

背景样式：支持纯色、渐变或半透明背景，适配深色/浅色主题。

5. 沉浸式布局一键适配

仅需调用 一行代码，即可实现状态栏填充（Status Bar 融入导航栏）；

自动处理不同 Android 版本（含 Android 6.0+ 至最新版本）的兼容性问题；

完美支持全面屏、刘海屏、挖孔屏设备。

近期更新

注：项目暂未发布正式版本日志，以下为根据近期提交推测的功能演进

稳定性提升：修复多设备下布局错位、文字截断等 UI 异常问题；

API 扩展：新增若干方法以支持更细粒度的自定义（如单独控制副标题样式、动态隐藏/显示分割线等）；

兼容性增强：优化在 Android 8.0 ~ 14 各版本上的渲染表现，确保一致体验；

性能优化：减少不必要的视图重绘，提升列表滚动或页面切换时的流畅度。

适用场景

需要统一 App 导航风格的中大型项目；

追求沉浸式体验的视频、体育、新闻类应用；

希望快速替换系统 ActionBar / Toolbar 的轻量级方案；

对 UI 细节有高要求的设计驱动型产品。