主题样式

协作中台 SDK 提供了标题栏的全局配置，包含标题栏样式、背景、文字大小、颜色等。

全局配置标题栏样式

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

接口定义

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

代码示例

Swift

KIM.uiConfig.titleBarBackgroundColor = .white
KIM.uiConfig.titleBarTitleAlignment = .left
KIM.uiConfig.titleBarTitleColor = .black
KIM.uiConfig.titleBarStatusBarStyle = .lightContent
KIM.uiConfig.robotLabelIcon = newIcon

Objective-C

KIM.uiConfig.titleBarBackgroundColor = [UIColor whiteColor];
KIM.uiConfig.titleBarTitleAlignment = KIMTextAlignmentLeft;
KIM.uiConfig.titleBarTitleColor = [UIColor blackColor];
KIM.uiConfig.titleBarStatusBarStyle = UIStatusBarStyleLightContent;
KIM.uiConfig.robotLabelIcon = newIcon;

效果展示

标题栏背景色

自定义前	自定义后

系统状态栏背景色

自定义前	自定义后

标题位置

居左	居中

标签组颜色

自定义前	自定义后

自定义全局机器人图标

自定义前	自定义后

暗黑模式

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

效果展示

浅色模式

深色模式

获取配置

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

接口定义

Swift

// 获取应用当前的主题样式
func getCurrentDarkMode() -> UIUserInterfaceStyle

代码示例

Swift

// 获取当前的主题样式
let currentDarkMode = KIM.uiConfig.getCurrentDarkMode()

Objective-c

// 获取当前的主题样式
UIUserInterfaceStyle currentDarkMode = [KIM.uiConfig getCurrentDarkMode];

更新配置

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

接口定义

Swift

// 配置全局的主题模式。
func changeDarkMode(userInterfaceStyle: UIUserInterfaceStyle)

参数说明

参数	类型	说明
userInterfaceStyle	UIUserInterfaceStyle	暗黑模式主题类型。 unspecified：跟随系统； light：浅色模式； dark：暗黑模式。

代码示例

Swift

// 设置当前主题样式为深色模式
KIM.uiConfig.changeDarkMode(userInterfaceStyle: .dark)

Objective-c

// 设置当前主题样式为深色模式
[KIM.uiConfig changeDarkModeWithUserInterfaceStyle:UIUserInterfaceStyleDark];