搜索插件、代码仓与 APP 分类

插件详情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 包使 Flutter 应用程序能够跨多个平台(包括 Android、iOS、Web、macOS、Windows 和 Linux)访问并响应系统的强调色。它提供了一种简单的方法来获取当前系统强调色并监听其变化,从而增强应用 UI 与设备级主题的一致性。非常适合希望匹配原生系统美学而无需手动管理主题的应用。

适合场景

  • 匹配应用程序用户界面中的系统强调色
  • 基于系统偏好创建动态主题
  • 使用原生外观和感觉构建跨平台应用
  • 系统主题更改时自动更新颜色
  • 通过系统定义的颜色方案增强可访问性

主要特点

  • 实时监听系统强调色变化
  • 跨平台支持所有主要操作系统
  • 用于检索当前强调色的简单API
  • 系统主题更改时自动更新
  • 轻量且易于集成

适合对象

  • 针对原生用户体验的开发者
  • 需要动态主题适配的应用程序
  • 专注于无障碍和用户体验的项目
  • 跨平台 Flutter 应用
  • 希望实现无缝系统集成的设计人员

使用建议

  • 仅限强调色;不管理完整主题模式
  • 行为在不同平台之间可能略有差异
  • 在某些操作系统上需要特定平台的权限
  • 不适合超出强调色之外的复杂主题管理
  • 取决于系统级别的颜色可用性

原始 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

源码仓库

使用此插件的项目