Pakete, Repositories und App-Kategorien suchen

Paketdetailsv3.3.0

system_theme

Ein Flutter-Plugin zum Abrufen und Beobachten der Systemakzentfarbe. Unterstützt Android, iOS, Web, Windows, macOS und Linux.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
8260
Likes
123
Pub-Punkte
160

Paket installieren

flutter pub add system_theme

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Das system_theme-Paket ermöglicht Flutter-Anwendungen den Zugriff auf und die Reaktion auf die Systemakzentfarbe über mehrere Plattformen hinweg, einschließlich Android, iOS, Web, macOS, Windows und Linux. Es bietet eine einfache Möglichkeit, die aktuelle Systemakzentfarbe abzurufen und Änderungen zu beobachten, wodurch die Konsistenz der App-Oberfläche mit Geräte-Ebene-Themen verbessert wird. Ideal für Apps, die native Systemästhetik nachahmen möchten, ohne manuell Themen verwalten zu müssen.

Anwendungsfälle

  • Systemakzentfarben in der App-Oberfläche abstimmen
  • Dynamische Themen basierend auf Systemeinstellungen erstellen
  • Erstellen von plattformübergreifenden Anwendungen mit nativem Aussehen und Gefühl
  • Farben werden automatisch aktualisiert, wenn sich das Systemthema ändert
  • Verbesserung der Barrierefreiheit durch systemdefinierte Farbschemata

Hauptmerkmale

  • Echtzeit-Überwachung von Änderungen der System-Akkzentfarbe
  • Plattformübergreifende Unterstützung für alle wichtigen Betriebssysteme
  • Einfache API zum Abrufen der aktuellen Akzentfarbe
  • Automatische Aktualisierungen bei Änderung des Systemthemas
  • Leicht und einfach zu integrieren

Geeignet für

  • Entwickler, die native Benutzeroberflächen anstreben
  • Apps, die eine dynamische Thema-Anpassung erfordern
  • Projekte, die auf Barrierefreiheit und Benutzererfahrung ausgerichtet sind
  • Plattformübergreifende Flutter-Anwendungen
  • Designer, die nahtlose Systemintegration wünschen

Hinweise

  • Beschränkt auf Akzentfarbe; verwaltet keine vollständigen Themenmodi
  • Das Verhalten kann sich leicht zwischen Plattformen unterscheiden
  • Erfordert plattformspezifische Berechtigungen auf einigen Betriebssystemen
  • Nicht geeignet für komplexe Themenverwaltung über Akzentfarben hinaus
  • Abhängig von der systemweiten Farbverfügbarkeit

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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

Kategorien

Abhängigkeiten

Abhängigkeiten 1 Einträge

  • system_theme_web^0.0.5

Quell-Repository

Projekte, die dieses Paket verwenden