パッケージ、リポジトリ、アプリカテゴリを検索

パッケージ詳細v3.3.0

system_theme

システムのアクセントカラーを取得およびリスニングするためのFlutterプラグインです。Android、iOS、Web、Windows、macOS、Linuxをサポートしています。

AndroidiOSWebmacOSWindowsLinux
30日間ダウンロード
8260
いいね数
123
Pub ポイント
160

パッケージをインストール

flutter pub add system_theme

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

system_theme パッケージは、Android、iOS、Web、macOS、Windows、Linux を含む複数のプラットフォームで、システムのアクセントカラーにアクセスして応答できるようにします。現在のシステムアクセントカラーを取得し、変更をリッスンする簡単な方法を提供し、デバイスレベルのテーマとアプリUIの一貫性を高めます。手動でのテーマ管理なしにネイティブなシステムの美学に合わせたいアプリに最適です。

用途

  • アプリUIでのシステム強調色の一致
  • システムの設定に基づいてダイナミックなテーマを作成する
  • ネイティブな見た目と感触でクロスプラットフォームアプリを作成する
  • システムテーマが変更されたときに色を自動的に更新する
  • システム定義のカラースキームによるアクセシビリティの向上

主な機能

  • リアルタイムでシステムのアクセントカラーの変更をリッスン
  • すべての主要オペレーティングシステムにおけるクロスプラットフォーム対応
  • 現在のアクセントカラーを取得するためのシンプルなAPI
  • システムテーマが変更されたときに自動更新
  • 軽量で統合が簡単

適している対象

  • ネイティブに近いUIをターゲットにする開発者
  • 動的テーマの適応を必要とするアプリ
  • アクセシビリティとユーザーエクスペリエンスに焦点を当てたプロジェクト
  • クロスプラットフォームのFlutterアプリケーション
  • シームレスなシステム統合を望むデザイナー

注意事項

  • アクセントカラーに限定される;完全なテーマモードを管理しない
  • 動作はプラットフォームによってわずかに異なる場合があります
  • 一部のOSでは、プラットフォーム固有の権限が必要です
  • 強調色を超える複雑なテーマ管理には適していません
  • システムレベルの色の利用可能性に依存します

元の README

関連するソースリポジトリの README 原文のスナップショットです。最新の内容はリポジトリをご覧ください。

system_theme

A flutter plugin to retrieve the current system theme information

Supported platforms
Platform Accent Color Listen to Color Changes Minimum Version
Android ✔️ Android 10+
iOS ✔️ iOS 14+
Windows ✔️ ✔️ Windows 10+
macOS ✔️ ✔️ Mojave 10.14+
Linux ✔️ GTK 3+
Web ✔️ All modern browsers

Usage

Import it:

import 'package:system_theme/system_theme.dart';
Get system accent color

Use the getter SystemTheme.accentColor.accent to get the accent color.

final accentColor = SystemTheme.accentColor.accent;

To reload the accent colors, use the method load():

await SystemTheme.accentColor.load();

You can load the colors before running the app, so the colors can't be wrong at runtime:

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await SystemTheme.accentColor.load();
  runApp(MyApp());
}
Configure a fallback accent color

To avoid unexpected outcomes at runtime, it's recommended to configure your own fallback color. The fallback color is used if the system is not able to provide the color.

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  SystemTheme.fallbackColor = const Color(0xFF865432);
  await SystemTheme.accentColor.load();

  runApp(MyApp());
}
Listen to changes on the system accent color

To simply listen to changes on the system accent color, use the SystemTheme.onChange stream:

SystemTheme.onChange.listen((event) {
  debugPrint('Accent color changed to ${event.accentColor}');
});

Alteratively, you can the SystemThemeBuilder widget to listen to changes on the system accent color:

SystemThemeBuilder(
  builder: (context, color) {
    return ColoredBox(
      color: color.accent, // Automatically updates when system theme changes
      child: const Center(
        child: Text('System Accent Color'),
      ),
    );
  },
);
Notes

On iOS 14 and later, this is the application's SwiftUI accent color (for example, the accent configured in the app's asset catalog), or the platform's app-level default when none is configured. Unlike Windows and macOS, iOS does not expose an equivalent global user-selected system accent color. If the app accent is unavailable or cannot be converted, the existing fallback or last loaded palette is retained. iOS does not automatically report accent changes; call load() to refresh it.

Contribution

See native testing for platform test commands and manual verification steps.

Feel free to open an issue if you find an error or make pull requests.

Acknowlegments

カテゴリー

依存関係

依存関係一覧 1 件

  • system_theme_web^0.0.5

ソースリポジトリ

このパッケージを使用しているプロジェクト