Skip to content

辅助工具(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) 修改主题色
colorsRinUI 当前选定主题的颜色表,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)

Released under the MIT License.