主题系统（`Theme`）

概述

RinUI 提供了一个轻量的主题管理器。

仅需 import RinUI，即可立即获得全局主题支持。主题系统以单例 pragma Singleton 的形式存在，适用于整个应用的风格切换与一致性维护。

您可以像这样使用主题Theme系统：

qml

import RinUI

Component {
    Component.onCompleted: {
        Theme.function()
    }
}

主题模式

`setTheme(mode: Theme.mode)`

setTheme函数用于切换 RinUI 全部组件的深浅色主题。该函数接受以下值：

Theme.mode.Light：切换为浅色主题
Theme.mode.Dark：切换为深色主题
Theme.mode.Auto：自动切换主题，根据当前系统的主题模式决定切换为浅色或深色主题

`toggleMode()`

toggleMode 会根据当前实际外观在 Theme.mode.Light 与 Theme.mode.Dark 之间切换。当前为深色时切换到浅色，当前为浅色时切换到深色：

qml

Theme.toggleMode()

该函数不会在 Light、Dark 与 Auto 三种配置模式之间轮换；需要进入或离开自动模式时，请直接调用 setTheme()。

`getTheme() -> str`

getTheme 函数用于获取当前保存的主题配置模式。函数会返回下列值：

"Light"：当前主题为浅色
"Dark"：当前主题为深色
"Auto"：当前主题为自动模式

Auto 模式下，getTheme() 仍返回 "Auto"，不会展开成当前实际使用的亮色或暗色。需要判断当前实际外观时，读取以下属性：

qml

let darkNow = Theme.currentTheme.isDark

也可以调用 Theme.isDark()，它会直接返回 currentTheme.isDark。

`setThemeColor(color)`

setThemeColor 函数用于设置 RinUI 组件的强调色。它接受十六进制颜色字符串或 QML color 值，例如 "#FF0000" 代表红色。

`getThemeColor() -> color`

getThemeColor 函数返回当前强调色对应的 QML color 值。主题管理器尚未初始化时会返回 "transparent"。

背景效果

NOTE

背景效果的设置仅在 Windows 平台上有效，且部分效果需要 Windows 11 及以上版本。

效果	支持的系统版本
Mica	> Windows 11
Acrylic	>= Windows 10
Tabbed	> Windows 11

`setBackdropEffect(effect: Theme.effect)`

setBackdropEffect函数用于设置 RinUI 组件的背景效果。该函数接受以下值：

Theme.effect.Mica：云母背景效果
Theme.effect.Acrylic：亚克力背景效果
Theme.effect.Tabbed：选项卡背景 (Mica Alt) 效果
Theme.effect.None：无背景效果

`getBackdropEffect() -> str`

getBackdropEffect函数用于获取当前组件的背景效果。函数会返回下列值：

"mica"：云母背景效果
"acrylic"：亚克力背景效果
"tabbed"：选项卡背景 (Mica Alt) 效果
"none"：无背景效果

主题系统（Theme） ​

概述 ​

主题模式 ​

setTheme(mode: Theme.mode) ​

toggleMode() ​

getTheme() -> str ​

setThemeColor(color) ​

getThemeColor() -> color ​

背景效果 ​

setBackdropEffect(effect: Theme.effect) ​

getBackdropEffect() -> str ​