Guides

主题与样式

ComPDFKit_Tools 提供两个层级的主题配置：全局主题模式 和 阅读器主题。

全局主题模式（themeMode）

GlobalConfig.themeMode 控制 UI 组件的整体外观风格：

{
  "global": {
    "themeMode": "system"
  }
}

值	说明
"light"	浅色模式
"dark"	深色模式
"system"	跟随系统设置

此配置影响工具栏、对话框、属性面板等所有 UI 组件的配色方案。

阅读器主题（themes）

ReaderViewConfig.themes 控制 PDF 文档阅读区域的背景和渲染主题：

{
  "readerViewConfig": {
    "themes": "light"
  }
}

值	说明
"light"	白色背景
"dark"	深色背景
"sepia"	护眼（泛黄）背景
"reseda"	豆沙绿背景

两者区别

维度	global.themeMode	readerViewConfig.themes
作用范围	UI 组件（工具栏、对话框等）	PDF 文档渲染区域
可选值	light、dark、system	light、dark、sepia、reseda
典型场景	适配系统深色模式	提供护眼阅读模式

两者可以独立配置。例如，可以让 UI 跟随系统深色模式，同时阅读区域使用护眼主题：

{
  "global": {
    "themeMode": "system"
  },
  "readerViewConfig": {
    "themes": "sepia"
  }
}

自定义主题色

如需进一步自定义颜色方案，可在 Android 资源文件中覆盖 ComPDFKit_Tools 定义的颜色值。Tools 模块使用标准 Android 资源体系，通过在应用的 res/values/colors.xml 和 res/values-night/colors.xml 中定义同名颜色值即可覆盖。