主题样式
协作中台 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 = newIconObjective-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 | 暗黑模式主题类型。
|
代码示例
Swift
// 设置当前主题样式为深色模式
KIM.uiConfig.changeDarkMode(userInterfaceStyle: .dark)Objective-c
// 设置当前主题样式为深色模式
[KIM.uiConfig changeDarkModeWithUserInterfaceStyle:UIUserInterfaceStyleDark];字体设置
协作中台SDK提供内置的字体大小切换实现,可以轻松实现文本的放大和缩小,以满足用户的不同阅读需求。
效果展示


开启/关闭大字体功能
通过调整该配置,即可实现大字体功能的启用与禁用。
代码示例
Swift
// 设置启用大字体功能
KIM.setting.enableFontSizeChange = trueObjectivec
// 设置启用大字体功能
[KIM.setting setEnableFontSizeChange:YES];获取配置
获取应用当前的字体大小。可通过调用该方法,获取当前的字体档位。
接口定义
Swift
// 获取应用当前的字体大小
func getCurrentFontLevel() -> Int代码示例
Swift
// 获取当前的字体大小
let currentFontLevel = KIM.uiConfig.getCurrentFontLevel()Objectivec
// 获取当前的字体大小
NSInteger currentFontLevel = [KIM.uiConfig getCurrentFontLevel];更新配置
修改应用当前的字体大小。可以通过该方法来更新应用的字体档位,实现字体大小的动态调整。
接口定义
Swift
// 修改当前的字体大小
func changeCurrentFontLevel(fontLevel: Int)参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| fontLevel | Int | 预设的字体大小。 提供六档可调范围,从0至5,分别代表第一档至第六档。默认设置为第二档。 |
代码示例
Swift
// 修改当前的字体大小
KIM.uiConfig.changeCurrentFontLevel(fontLevel: 5)Objectivec
// 修改当前的字体大小
[KIM.uiConfig changeCurrentFontLevelWithFontLevel:5];









