辅助工具(Utils)
概述
RinUI 提供了一个名为 Utils 的单例对象,用于管理全局通用资源、字体和动画时长等。这是 RinUI 应用中不可或缺的辅助模块。您可以修改这些属性的值来自定义 RinUI 的外观和行为。
您可以像这样使用辅助工具Utils:
qml
import RinUI
Component {
// 获取 Utils 属性
property var property: Utils.property;
// 修改 Utils 属性
Component.onCompleted: {
Utils.property = newValue;
}
}外观与主题
| 属性 | 说明 |
|---|---|
| primaryColor | 主题主色,默认读取后端的配置文件默认值 #605ed2 建议通过 Theme.setThemeColor(color: str) 修改主题色 |
| colors | RinUI 当前选定主题的颜色表,RinUI 的所有控件的颜色都会引用 |
| appearance | 当前主题的外观设定(如圆角、阴影、透明度) |
| typography | 目前仅存储字体的大小信息 |
字体与图标
| 属性 | 说明 |
|---|---|
fontFamily | 默认应用字体,默认为(Qt.application.font.family) |
iconFontFamily | 字体图标的字体名(通常由 FontIconLoader 提供) |
fontIconSource | 字体图标.ttf文件路径 |
fontIconIndexSource | 字体图标索引.js文件路径 |
fontIconIndex | 图标索引对象,可直接通过 Utils.fontIconIndex['icon-name'] 获取字符 |
动画时长
| 属性 | 说明 |
|---|---|
animationSpeed | 标准动画速度(250ms) |
animationSpeedFaster | 快速动画速度(120ms) |
animationSpeedMiddle | 中等偏慢速度(450ms) |
appearanceSpeed | 界面切换速度(175ms) |
progressBarAnimationSpeed | 进度条动画时间(1550ms) |