RinUI とは？

RinUI は Qt Quick (QML) アプリケーション向けの UI コンポーネントライブラリです。Fluent Design に着想を得たコントロール、テーマ機能、ユーティリティを提供し、統一感のある外観と分かりやすい操作性を備えたデスクトップアプリの開発を支援します。

TIP

RinUI を試すには、はじめにを参照してインストールし、サンプルを実行してください。

import QtQuick
import QtQuick.Controls
import RinUI

RinUI モジュールをインポートすれば、既存の Qt Quick プロジェクトで各コントロールを組み合わせて使用できます。Python アプリケーションでは PySide6 でアプリを起動し、QML を読み込みます。別の言語やフレームワークへ UI を書き換える必要はなく、アプリの画面は引き続き QML で構築できます。

RinUI が提供するもの

• 一般的な UI コンポーネント：ボタン、入力、ナビゲーション、ポップアップ、レイアウト、状態表示など。各コンポーネントのプロパティ、シグナル、使用例はドキュメントを参照してください。
• Fluent に着想を得たデザイン：明確な階層、軽やかなサーフェス、一貫した操作性。
• テーマ機能：ライト・ダークの外観設定。テーマで設定方法を確認できます。
• QML ワークフロー：モジュールをインポートし、Qt Quick のレイアウト、バインディング、コンポーネント構成をそのまま活用できます。

適したプロジェクト

Qt Quick / QML でデスクトップアプリを構築し、一般的な UI の重複実装を減らしたい場合や、Fluent に着想を得た一貫したデザインを採用したい場合に、RinUI を UI 開発の基盤として利用できます。RinUI が提供するのは UI コンポーネントと関連ユーティリティです。業務ロジック、データモデル、アプリケーション構成はアプリ側で管理します。

プロジェクトの状態

RinUI は現在も開発が続いています。コンポーネント、API、テーマ機能はバージョン間で変更される可能性があります。インストール済みバージョンのドキュメントを参照し、リリースするアプリでは依存バージョンを固定して、アップグレード時に影響を確認してください。

次に読むページ

• 初めて使う場合：はじめにでインストールしてサンプルを実行します。
• QML ページとリソースの構成：プロジェクト構成とリソースを参照してください。
• コントロールを探す場合：サイドバーからコンポーネントを選択し、使用方法と実行可能な例を確認してください。
• 全体設定：テーマとユーティリティを参照してください。

謝辞

RinUI の実装とデザインは、次のプロジェクトやリソースを参考にしています。

• Qt / Qt Quick
• Fluent Design System
• Fluent UI System Icons

RinUI に貢献してくださる皆様に感謝します。