主题样式

SDK 提供了标题栏的全局配置，包含标题栏样式、背景、文字大小、颜色等。同时，SDK 提供对部分页面标题栏及点击事件进行自定义。

全局配置标题栏样式

可以通过修改 KIMUIConfig相关属性全局配置标题栏样式。

接口定义

属性	类型	说明
titleBarBackground	@DrawableRes Int	标题栏背景
titleBarTitleAlignment	@KIMTextAlignment Int	标题栏标题对齐方式，仅支持 left、center
titleBarTitleColor	Android：@ColorRes Int	标题栏标题颜色
titleBarBackButtonIcon	@DrawableRes Int	返回按钮的图片，为空则使用默认图标
titleBarStatusBarStyle	@KIMStatusBarStyle Int	系统状态栏风格
titleBarTabTextColor	@ColorRes Int	标题栏 Tab 文字颜色
titleBarTabTextColorSelected	@ColorRes Int	标题栏 Tab 选中文字颜色
titleBarButtonTextColor	@ColorRes Int	标题栏文本按钮颜色（如“确定”按钮）
titleBarButtonIconColor	@ColorRes Int	标题栏按钮图标颜色
titleBarInputTextColor	@ColorRes Int	标题栏输入框文本颜色
titleBarInputHintColor	@ColorRes Int	标题栏输入框提示文本颜色
robotLabelIcon	@DrawableRes Int	机器人标签图标

代码示例

Kotlin

class MyKIMUIConfig : KIMUIConfig() {
        init {
            titleBarBackground = R.color.blue
            titleBarTitleAlignment = KIMTextAlignment.LEFT
            titleBarTitleColor = R.color.white
            titleBarStatusBarStyle = KIMStatusBarStyle.LIGHT
            //...
        }
    }

KIM.uiConfig = MyKIMUIConfig()

效果展示

标题栏背景色

自定义前	自定义后

系统状态栏背景色

自定义前	自定义后

标题位置

居左	居中

标签组颜色

自定义前	自定义后

暗黑模式

SDK提供内置的深色/浅色模式切换实现，可使用相关接口，实现在深色模式、浅色模式、跟随系统三种状态自由切换。

效果展示

浅色模式

深色模式

获取配置

获取当前的显示模式。可通过调用该方法，获取当前的主题显示模式。

接口定义

KIMUIConfig:

Kotlin

/**
 * 获取当前的主题模式，context为空时则默认为跟随系统
 * @return ThemeMode
 */
fun getCurrentDarkMode(context: Context): ThemeMode 

// 枚举ThemeMode
enum class ThemeMode {
    LIGHT_MODE, // 浅色模式
    DARK_MODE, // 深色模式
    MODE_NIGHT_FOLLOW_SYSTEM, // 跟随系统
}

代码示例

Kotlin

// 获取当前的主题样式
KIMUIConfig().getCurrentDarkMode(context)

更新配置

  配置SDK界面主题模式。可通过调用该方法，通过 themeMode 参数配置当前的显示模式，对界面的主题样式进行调整。

接口定义

KIMUIConfig:

Kotlin

/**
 * 设置主题模式
 * @param themeMode ThemeMode 主题模式
 */
fun changeDarkMode(activity: Activity, themeMode: ThemeMode)

参数说明

参数	类型	说明
activity	Activity
themeMode	ThemeMode	ThemeMode包括： LIGHT_MODE：浅色模式 DARK_MODE：深色模式 MODE_NIGHT_FOLLOW_SYSTEM：跟随系统。

代码示例

Kotlin

// 设置当前主题样式为浅色模式
KIMUIConfig().changeDarkMode(requireActivity(), LIGHT_MODE)