Buscar pacotes, repositórios e categorias de apps

Capa de custom_timer
Detalhes do pacotev0.2.3

custom_timer

Um pacote Flutter para criar um cronômetro personalizável com controlador.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
1,1 mil
Curtidas
147
Pontos Pub
150

Instalar pacote

flutter pub add custom_timer

Visão geral do pacote

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

Um pacote Flutter que permite aos desenvolvedores criar cronômetros altamente personalizáveis com funcionalidade de controlador embutida. Ele suporta atualizações em tempo real, controle preciso do tempo e integração perfeita em aplicativos Flutter em múltiplas plataformas. O cronômetro pode ser pausado, retomado, reiniciado e monitorado por meio de um controlador dedicado, tornando-o ideal para contagens regressivas, recursos de cronômetro ou qualquer componente de interface baseado no tempo. Projetado para flexibilidade e facilidade de uso, funciona em Android, iOS, Web, macOS, Windows e Linux.

Casos de uso

  • Cronômetros de contagem regressiva
  • Aplicações de cronômetro
  • Interações do usuário com limite de tempo
  • Monitoramento em tempo real do progresso
  • Aplicativos de aprendizagem interativa
  • Temporizadores de jogo

Principais recursos

  • Duração personalizável do temporizador
  • Controlador embutido para gerenciamento de estado
  • Funcionalidade de pausa, retomada e reinício
  • Compatibilidade multiplataforma
  • Eventos de retorno em tempo real
  • Integração fácil com widgets do Flutter

Indicado para

  • Desenvolvedores criando recursos sensíveis ao tempo
  • Aplicativos que exigem controle preciso do tempo
  • Ferramentas educacionais ou produtividade
  • Aplicações gamificadas
  • Componentes da interface precisando exibição dinâmica de tempo

Considerações

  • Requer manipulação manual do ciclo de vida do temporizador
  • Pode ser necessário lógica adicional para agendamento complexo
  • Não otimizado para atualizações de alta frequência além dos casos de uso típicos
  • Opções limitadas de estilo embutido (requer composição personalizada de widgets)

README original

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

Custom Timer ⌛

A Flutter package to create a customizable timer.


🎉 Features

  • Timer controller.
  • Auto count up / down timer.
  • Custom builder.
  • Millisecond support.

📌 Usage


example1


Add SingleTickerProviderStateMixin to your stateful widget. 👇

class _MyAppState extends State<MyApp> with SingleTickerProviderStateMixin {

Then define a CustomTimer controller

late CustomTimerController _controller = CustomTimerController(
  vsync: this,
  begin: Duration(hours: 24),
  end: Duration(),
  initialState: CustomTimerState.reset,
  interval: CustomTimerInterval.milliseconds
);

And you are ready to use the timer:

CustomTimer(
  controller: _controller,
  builder: (state, time) {
    // Build the widget you want!🎉
    return Text(
      "${time.hours}:${time.minutes}:${time.seconds}.${time.milliseconds}",
      style: TextStyle(fontSize: 24.0)
    );
  }
)

Now you can use the controller methods:

_controller.reset();
_controller.start();
_controller.pause();
_controller.finish();

_controller.add(Duration(minutes: 30));
_controller.subtract(Duration(minutes: 30));
_controller.jumpTo(Duration(hours: 12));

You can also set the begin or end, even with the counter running:

_controller.begin = Duration();
_controller.end = Duration(hours 12);

And add listeners to state changes or just use the properties when you need them:

_controller.state.addListener(() {
  print(_controller.state.value); // 👉 CustomTimerState.paused
  print(_controller.remaining.value.hours); // 👉 12h
});

Remember to dispose when you are no longer using it.


🔧 Installation

Add this to your package's pubspec.yaml file:

dependencies:
  custom_timer: ^0.2.3

Install it:

$ flutter pub get

Import the package in your project:

import 'package:custom_timer/custom_timer.dart';

🙇 Author


Hi there 👋 This package is in development so if you find a bug or have a suggestion please let me know so we can improve it! 😃 If you want to motivate me to continue, you can give me a cup of coffee ☕ and I will get a lot of energy out of it.


Buy Me A Coffee

Categorias

Repositório-fonte

Projetos que usam este pacote