标题栏框架（TitleBar）技术文档

标题栏框架（TitleBar）技术文档

TitleBar Android 标题栏框架，从此布局属性不用记 项目地址: https://gitcode.com/gh_mirrors/ti/TitleBar

---

安装指南

添加JitPack仓库

• 对于Gradle配置版本7.0以下的项目, 在build.gradle(项目级)文件中加入:

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

• 若Gradle配置版本为7.0及以上, 则在settings.gradle添加:

dependencyResolutionManagement {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

添加依赖

在模块的build.gradle文件中加入以下依赖:

dependencies {
    implementation 'com.github.getActivity:TitleBar:10.5'
}

确保已设置JDK 1.8兼容性:

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

---

项目使用说明

布局集成

在XML布局文件中添加TitleBar组件:

<com.github.getActivity.TitleBar
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize"
    app:title="示例标题" />

自定义属性

TitleBar提供了丰富可定制的XML属性, 包括标题样式、背景、分割线等。详细属性请参照项目中提供的declare-styleable定义。

监听事件

在Java代码中为TitleBar设置点击事件:

TitleBar titleBar = findViewById(R.id.title_bar);
titleBar.setOnTitleBarListener(new OnTitleBarListener() {
    @Override
    public void onLeftClick(TitleBar titleBar) {
        // 处理左按钮点击逻辑
    }

    @Override
    public void onTitleClick(TitleBar titleBar) {
        // 处理标题点击逻辑
    }

    @Override
    public void onRightClick(TitleBar titleBar) {
        // 处理右按钮点击逻辑
    }
});

---

项目API使用文档

• 标题栏实例化: 直接在XML布局中声明或通过Java代码动态创建。
• 属性设置: 通过XML属性或程序代码动态设置标题、图标、样式等。
• 监听器绑定: setOnTitleBarListener用于设置标题栏按钮的点击事件监听器。

---

示例与进阶

查看完整Demo以深入了解应用实例。此外，可通过项目博客深入理解其实现原理。

---

其他注意事项

• 混淆规则: 为了保证框架正常运行, 不要忘记在proguard-rules.pro中添加保护规则:

  -keep class com.hjq.bar.** {*;}
  

• 全局样式配置: 在Application类中可以通过实现setDefaultStyle方法统一设置所有TitleBar的样式。

通过遵循上述指南，您可以轻松地将TitleBar集成至您的Android应用中，提升界面的一致性和用户体验。

TitleBar Android 标题栏框架，从此布局属性不用记 项目地址: https://gitcode.com/gh_mirrors/ti/TitleBar