system_theme
システムのアクセントカラーを取得およびリスニングするためのFlutterプラグインです。Android、iOS、Web、Windows、macOS、Linuxをサポートしています。
システムのアクセントカラーを取得およびリスニングするためのFlutterプラグインです。Android、iOS、Web、Windows、macOS、Linuxをサポートしています。
以下は英語原文のスナップショットです。最新版は GitHub をご覧ください。
| 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 |
Import it:
import 'package:system_theme/system_theme.dart';
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());
}
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());
}
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'),
),
);
},
);
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.
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.
用途で絞り込み、開発状況を比較し、採用前に元のリポジトリで要件を確認しましょう。
“A repository is the most basic element of GitHub.”
GitHub Docs — About repositories ↗