Buscar pacotes, repositórios e categorias de apps

Capa de appearance
Detalhes do pacotev0.0.1

appearance

Pacote Flutter para implementar modo claro, escuro e sistema de tema, e persistir na reinicialização do aplicativo.

AndroidiOSWeb
Downloads em 30 dias
83
Curtidas
5
Pontos Pub
150

Instalar pacote

flutter pub add appearance

Visão geral do pacote

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

O pacote de aparência simplifica a implementação dos modos de tema claro, escuro e sistema em aplicativos Flutter. Ele oferece uma maneira sem interrupções de alternar entre temas e preserva o modo selecionado após reiniciar o aplicativo. Projetado com facilidade de integração em mente, ele gerencia o estado do tema e garante uma experiência consistente em plataformas Android, iOS e web. O pacote suporta troca dinâmica de temas e se adapta automaticamente às preferências de tema no nível do sistema.

Casos de uso

  • Implementando alternadores de tema em aplicativos móveis e web
  • Persistindo a preferência de tema do usuário após o reinício do aplicativo
  • Suporte à conscientização do tema do sistema
  • Criando interface de usuário acessível com modos claro e escuro
  • Habilitar transições suaves de tema

Principais recursos

  • Suporte a tema claro, escuro e sistema
  • Armazenamento persistente do estado da temática
  • Detecção automática do tema do sistema
  • Compatibilidade multiplataforma (Android, iOS, Web)
  • API simples para alternância de tema

Indicado para

  • Desenvolvedores Flutter construindo aplicativos multiplataforma
  • Aplicativos que exigem temas personalizáveis pelo usuário
  • Projetos focados em acessibilidade e experiência do usuário
  • Desenvolvedores que querem pouco boilerplate para temas
  • Aplicações direcionadas tanto para dispositivos móveis quanto para a web

Considerações

  • Requer manipulação manual do estilo de widget específico do tema
  • Não inclui componentes de design de tema embutidos
  • Limitado à persistência do modo tema, não ao personalização completa do tema
  • Pode exigir configuração adicional para lógica de tema complexa
  • Depende de gerenciamento externo de estado se usado além da funcionalidade básica

README original

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

appearance

Appearance

Flutter package that easily implement Light, Dark and System theme mode in your application and persists the theme mode on restart of the application.

🚀 Demo: Appearance

📱 Screenshots

Appearance Demo 1 Appearance Demo 2

🛠 Installation

  1. Add dependency to pubspec.yaml file:
    Get the latest version from the 'Installing' tab on pub.dev
dependencies:
  appearance: ^latest_version
  1. Import the package
import 'package:appearance/appearance.dart';

📘 How to use

  1. Initialize SharedPreferencesManager singleton for SharedPreference and add it before runApp() method.
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await SharedPreferencesManager.instance.init();
  runApp(const MyApp());
}
  1. extend your root class with AppearanceState using keyword with.
class _MyAppState extends State<MyApp> with AppearanceState { }
  1. Wrap your MaterialApp or CupertinoApp with BuildWithAppearance
BuildWithAppearance(
    initial: ThemeMode.light, // optional : default value is [ThemeMode.system]
    builder: (context) => MaterialApp()
);
Using MaterialApp
BuildWithAppearance(
    initial: ThemeMode.light, // optional : default value is [ThemeMode.system]
    builder: (context) => MaterialApp(
        title: 'Appearance (Material Example)',
        themeMode: Appearance.of(context)?.mode,
        theme: ThemeData(
            brightness: Brightness.light,
        ),
        darkTheme: ThemeData(
            brightness: Brightness.dark,
        ),
        home: const HomeMaterialPage(),
    ),
);
Using CupertinoApp
BuildWithAppearance(
    initial: ThemeMode.light, // optional : default value is [ThemeMode.system]
    builder: (context) {
        return CupertinoApp(
            title: 'Appearance (Cupertino Example)',
            theme: CupertinoThemeData(
                brightness: Appearance.of(context)?.cupertinoBrightness!,
            ),
            localizationsDelegates: const [
                DefaultMaterialLocalizations.delegate,
                DefaultCupertinoLocalizations.delegate,
                DefaultWidgetsLocalizations.delegate,
            ],
            home: HomeCupertinoPage(),
        );
    },
);

🌟 Features

  • Light, Dark and System mode options to change theme of app.

  • Theme persistance: Saved theme is persisted using SharedPreferences on restart.

  • Auto Listen Theme Mode changes, without adding extra listener.

  • Material and Cupertino, both apps are supported.

🧰 Parameters

  • initial: [optional]
    Set the initial ThemeMode of the app, by default its value is ThemeMode.system

Change Theme Mode

You can use the setMode method to change the theme mode of the app.

 // sets theme mode to System
 Appearance.of(context)?.setMode(ThemeMode.system),

 // sets theme mode to Light
 Appearance.of(context)?.setMode(ThemeMode.light),

 // sets theme mode to Dark
 Appearance.of(context)?.setMode(ThemeMode.dark),

Get Theme Mode

 // get active theme mode
 Appearance.of(context)?.mode

Get Cupertino Theme brightness

 // get active cupertino theme brightness
 Appearance.of(context)?.cupertinoBrightness!,

💻 Example

Check out the example app in the example directory for both Material and Cupertino.

📝Contribution

Feel free to contribute to this project.

  • If you found a bug or have a feature request, open an issue.

  • If you want to contribute, submit a pull request.

💳 License

This project is LICENSED under the MIT License. Use it freely, but let's play nice and give credit where it's due!

🎉 Conclusion

I will be happy to answer any questions that you may have on this approach,
If you liked this package, don't forget to show some ❤️ by smashing the ⭐.

Categorias

Dependências

Lista de dependências 1 itens

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.