Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev3.3.0

system_theme

Um plugin Flutter para recuperar e ouvir a cor de destaque do sistema. Suporta Android, iOS, Web, Windows, macOS e Linux.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
8,3 mil
Curtidas
123
Pontos Pub
160

Instalar pacote

flutter pub add system_theme

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote system_theme permite que aplicativos Flutter acessem e respondam à cor de destaque do sistema em múltiplas plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux. Ele oferece uma forma simples de recuperar a cor de destaque atual do sistema e escutar mudanças, melhorando a consistência da interface do aplicativo com temas de nível de dispositivo. Ideal para aplicativos que buscam se alinhar com a estética nativa do sistema sem gerenciamento manual de temas.

Casos de uso

  • Cor de destaque do sistema correspondente na interface do aplicativo
  • Criando temas dinâmicos com base nas preferências do sistema
  • Criando aplicativos multiplataforma com aparência e sensação nativa
  • Atualização automática de cores quando o tema do sistema muda
  • Melhorando a acessibilidade com esquemas de cores definidos pelo sistema

Principais recursos

  • Escuta em tempo real das mudanças de cor de destaque do sistema
  • Suporte multiplataforma para todos os principais sistemas operacionais
  • API simples para recuperar a cor de destaque atual
  • Atualizações automáticas quando o tema do sistema muda
  • Leve e fácil de integrar

Indicado para

  • Desenvolvedores direcionados a interfaces nativas
  • Aplicativos que exigem adaptação dinâmica do tema
  • Projetos focados em acessibilidade e experiência do usuário
  • Aplicações Flutter multiplataforma
  • Designers que desejam integração de sistema sem interrupções

Considerações

  • Limitado à cor de destaque; não gerencia modos de tema completos
  • O comportamento pode variar ligeiramente entre plataformas
  • Requer permissões específicas da plataforma em alguns sistemas operacionais
  • Não adequado para gerenciamento de temas complexos além das cores de destaque
  • Depende da disponibilidade de cores no nível do sistema

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

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

Categorias

Dependências

Lista de dependências 1 itens

  • system_theme_web^0.0.5

Repositório-fonte

Projetos que usam este pacote