集成步骤
dependencies {
implementation 'com.hjq:titlebar:3.5'
}
属性大全(划重点,要考)
<declare-styleable name="TitleBar">
<!-- 标题栏的样式 -->
<attr name="bar_style">
<enum name="light" value="0x10" />
<enum name="night" value="0x20" />
<enum name="transparent" value="0x30" />
</attr>
<!-- 标题 -->
<attr name="title" format="string" />
<attr name="title_left" format="string"/>
<attr name="title_right" format="string" />
<!-- 图标 -->
<attr name="icon_left" format="reference" />
<attr name="icon_right" format="reference" />
<!-- 返回按钮,默认开 -->
<attr name="icon_back" format="boolean" />
<!-- 文字颜色 -->
<attr name="color_title" format="color" />
<attr name="color_right" format="color" />
<attr name="color_left" format="color" />
<!-- 文字大小 -->
<attr name="size_title" format="dimension" />
<attr name="size_right" format="dimension" />
<attr name="size_left" format="dimension" />
<!-- 按钮背景 -->
<attr name="background_left" format="reference|color" />
<attr name="background_right" format="reference|color" />
<!-- 分割线 -->
<attr name="line_visible" format="boolean" />
<attr name="line_color" format="color" />
<attr name="line_size" format="dimension" />
</declare-styleable>
<com.wjl.TitleBar
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:title="默认的标题栏" />
设置监听事件
mTitleBar.setOnTitleBarListener(new OnTitleBarListener() {
@Override
public void onLeftClick(View v) {
ToastUtils.show("左项View被点击");
}
@Override
public void onTitleClick(View v) {
ToastUtils.show("中间View被点击");
}
@Override
public void onRightClick(View v) {
ToastUtils.show("右项View被点击");
}
});
统一TitleBar样式
如果对TitleBar的默认样式不满意,可以在Application初始化样式,具体可参考TitleBarLightStyle的实现
public class XXApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
TitleBar.initStyle(new ITitleBarStyle());
}
}
框架亮点
-
性能最佳:不使用LayoutInflater,而使用代码创建View的形式
-
体验最优:TitleBar默认样式效果已经非常好,可下载Demo测试
-
支持夜间模式:可以直接引用框架中的TitleBarNightStyle样式
-
支持操控子控件:可以在代码中获取TitleBar的子控件进行调用相关的API
-
支持自定义布局:可将TitleBar当做FrameLayout使用,直接在XML中自定义布局
-
兼容沉浸式状态栏:兼容Github的沉浸式状态栏框架,达到完全沉浸的效果
-
框架兼容性良好:本框架不依赖任何第三方库,支持兼容所有的安卓版本
-
支持全局配置样式:可以在Application中初始化TitleBar样式,达到一劳永逸的效果