Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev3.0.0

theme_mode_handler

Widget Flutter para alterar o `themeMode` durante a execução e persisti-lo entre reinícios

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
215
Curtidas
19
Pontos Pub
160

Instalar pacote

flutter pub add theme_mode_handler

Visão geral do pacote

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

Um pacote Flutter que permite alternar dinamicamente o modo de tema em tempo de execução e preserva o tema selecionado após reiniciar o aplicativo. Simplifica o gerenciamento das preferências de modo claro e escuro ao salvar automaticamente a escolha do usuário nas preferências compartilhadas, garantindo consistência quando o aplicativo for reaberto. O widget se integra perfeitamente em aplicativos Flutter existentes com configuração mínima, oferecendo uma maneira confiável de gerenciar o estado do tema sem lógica de armazenamento manual.

Casos de uso

  • Alternância dinâmica de temas em aplicativos móveis
  • Persistindo a preferência do tema do usuário entre sessões
  • Implementando alternância de modo escuro em aplicações web
  • Suporte à conscientização do tema do sistema
  • Habilitar a personalização de tema em aplicativos para desktop

Principais recursos

  • Alterações no modo de tema em tempo de execução
  • Persistência automática usando preferências compartilhadas
  • Integração simples com MaterialApp
  • Suporta todas as principais plataformas
  • Modo padrão configurável

Indicado para

  • Desenvolvedores criando aplicativos com alternadores de tema
  • Aplicativos que exigem configurações persistentes de tema do usuário
  • Aplicações multiplataforma direcionadas a vários dispositivos

Considerações

  • Requer dependência do shared_preferences
  • Limitado apenas ao themeMode (não personalização completa do tema)
  • Pode ser necessário lógica adicional para temas personalizados
  • Não adequado para gerenciamento de temas complexos além da troca de modo

README original

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

theme_mode_handler

This library is considered done - no new features or changes are foreseen. You may not see recent updates to this repository, but the library is totally functional. Please open an issue if you find an issue or think something is missing so we can discuss it.

version All Contributors

Flutter widget to change themeMode during runtime and persist it across restarts.

Motivation

Flutter 1.9 introduced a new way to control which theme is used: MaterialApp.themeMode. If you have specified the darkTheme and theme properties, you can use themeMode to control it. The property defaults to ThemeMode.system.

This package wraps this functionality and allows you to persist and retrieve the user's preference wherever you want by implementing an interface.

Installation

Add this to your pubspec.yaml:

dependencies:
  theme_mode_handler: ^3.0.0

Usage

  • Create a class that implements the IThemeModeManager interface:
class MyManager implements IThemeModeManager {
  @override
  Future<String> loadThemeMode() async {}

  @override
  Future<bool> saveThemeMode(String value) async {}
}
  • Import the ThemeModeHandler widget, wrap MaterialApp with it and pass it an instance of your manager:
import 'package:theme_mode_handler/theme_mode_handler.dart';

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return ThemeModeHandler(
      manager: MyManager(),
      builder: (ThemeMode themeMode) {
        return MaterialApp(
          themeMode: themeMode,
          darkTheme: ThemeData(
            brightness: Brightness.dark,
          ),
          theme: ThemeData(
            brightness: Brightness.light,
          ),
          home: MyHomePage(title: 'Flutter Demo Home Page'),
        );
      },
    );
  }
}
  • Change the themeMode with:
ThemeModeHandler.of(context).saveThemeMode(value);
  • Get the current themeMode with:
ThemeModeHandler.of(context).themeMode;

Check the example folder for a complete example.

API

builder

Type: Widget Function(ThemeMode themeMode).

Function that runs when themeMode changes.

manager

Type: IThemeModeManager.

Implementation of IThemeModeManager to load and save the selected value.

defaultTheme

Type: ThemeMode.

Default value to be used when manager.loadThemeMode returns null or an invalid value.

placeholderWidget

Type: Widget?.

While the themeMode is loaded, you can choose to render a different widget. By default, it'll render an empty container.

Extra

This package exports a dialog and a method to simplify its usage.

  • Import the dialog with:
import 'package:theme_mode_handler/theme_picker_dialog.dart';
  • Use it like this:
void _selectThemeMode(BuildContext context) async {
  final newThemeMode = await showThemePickerDialog(context: context);
  print(newThemeMode);
}

Inspiration

This package is inspired and based on the great package dynamic_theme.

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Arthur Denner

💻 🎨 💡 🚧

This project follows the all-contributors specification. Contributions of any kind welcome!

License

MIT © Arthur Denner

Categorias

Repositório-fonte

Projetos que usam este pacote