ephemeral_state_manager 1.0.6

Package simplificado para gerenciamento de estado efêmoro para widgets.

Ephemeral state manager

A package é um gerenciamento de estado efêmero simples e objetivo (é um estado temporário de uma widget), com essa package é possível usar o setState ou streamCotroller de forma segura indicando onde deve ser feito a build do widget multável sem re-buildar toda árvore de widget da página ativa exatamente como a documentação da framework recomenda.

• Não precisa usar annotations para indicar que é uma variável mutável ou observável.
• Não precisa usar gerador de código.
• Os widgets StateSetterBuilder e StateSetterBuilderKey são auto disposable.
• A página que usar o objeto ValuesStream(Streamcontroller) pode ser disposado usando um gerenciador de dependência, uma página StatefulWidget >> void dispose() ou uma página StatelessWidget >> WillPopScope >> Navigator.maybePop(context).
• Segundo a documentação da framework, ao usarmos um widget com um valor mutável totalmente isolada, que re-builda apenas o necessário, temos uma performance mais otimizada na renderização dos componentes da árvore de widgets.
• Dentro da pasta example da package tem 4 exemplos de uso mais detalhado.

Usando o widget StateSetterBuilder

// Métodos e atributos de controle
class PageStateSetterBuilderController {
  final ValuesState<int> counter = ValuesState<int>(0);

  void increment() => counter.value++;

  void decrement() => counter.value--;
}

//widget que se atualiza usando setState
StateSetterBuilder<int>(
  valueStateSetter: controller.counter,
  builder: (context, value) {
    print('Upadate: counter');
    return Text(
      '$value',
      style: Theme.of(context).textTheme.headline4,
    );
  }
),

Usando o widget StateSetterBuilderKey

// Métodos e atributos de controle
class PageStateSetterBuilderKeyController extends StateSetterValues {
  int counter = 0;

  void increment() =>
      super.updateValue(stateSetterKey: "counter", data: counter++);

  void decrement() =>
      super.updateValue(stateSetterKey: "counter", data: counter--);
}

//widget que se atualiza usando setState
StateSetterBuilderKey<PageStateSetterBuilderKeyController>(
  objectInstance: controller,
  stateSetterKey: "counter",
  builder: (context, object) {
    print('Upadate key: counter');
    return Text(
      '${object.counter}',
      //'${controller.counter}', //as duas formas funcionam
      style: Theme.of(context).textTheme.headline4,
    );
  }
),

Usando o widget StreamBuilder

// Métodos e atributos de controle
class PageValueStreamController extends Disposeble {
  final ValuesStream<int> counter = ValuesStream<int>(0);

  void incrementCounter() => counter.value++;
  void decrementCounter() => counter.value--;

  @override
  void dispose() => counter.dispose();
}

//widget que se atualiza usando StreamController
StreamBuilder<int>(
  stream: controller.counter.stream,
  initialData: controller.counter.value,
  builder: (context, snapshot) {
    print('Upadate: ${snapshot.data}');
    return Text(
      '${snapshot.data}',
      style: Theme.of(context).textTheme.headline4,
    );
  },
),

Exemplo de uso completo

import 'package:flutter/material.dart';
import 'package:ephemeral_state_manager/ephemeral_state_manager.dart';

void main() => runApp(const MyApp());

class MyApp extends StatelessWidget {
  const MyApp({ Key? key }) : super(key: key);
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: "App",
      theme: ThemeData(primaryColor: Colors.indigo),
      home: HomePage(),    
    );
  }
}

class HomePage extends StatelessWidget {
  const HomePage({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
  
    final Controller controller = Controller();

    print('Create HomaPage build');
    return Scaffold(
      appBar: AppBar(
        title: const Text('Exemplo de uso StateSetterBuilder')
      ),
      body: Center(
        child: Row(
           mainAxisAlignment: MainAxisAlignment.spaceAround,
           children: [
             IconButton(
               icon: Icon(Icons.exposure_neg_1, size: 45.0, color: Theme.of(context).primaryColor), 
               onPressed: controller.decrement,
             ),
             StateSetterBuilder<int>(
               valueStateSetter: controller.counter,
               builder: (context, value){
                 print('Upadate: counter');
                 return Text(
                   '$value',
                   style: Theme.of(context).textTheme.headline4,
                 );
               }
             ),
             IconButton(
               icon: Icon(Icons.exposure_plus_1, size: 45.0, color: Theme.of(context).primaryColor), 
               onPressed: controller.increment,
             ),
           ],
         ),
      ),
    );
  }
}

class Controller {

  final ValueState<int> counter = ValueState<int>(0);

  void increment() => counter.value++;

  void decrement() => counter.value--;

}