gits_base

Description:

gits base

Gits Base #
GitsStatePage dan GitsCubit (State Management) #
To use gits base you can use StatefullWidget and in the class extends State add the mixin with GitsStatePage<T extends StatefullWidget, C extends GitsCubit>.
Methods that need to be overridden setCubit and buildWidget. the build method is deprecated when using with GitsStatepage and is replaced by buildWidget.
Example #
import 'package:core/core.dart';
import 'package:flutter/material.dart';
import 'package:onboarding/widgets/widgets.dart';

import '../cubit/onboarding_cubit.dart';

class OnboardingPage extends StatefulWidget {
const OnboardingPage({Key? key}) : super(key: key);

@override
State<OnboardingPage> createState() => _OnboardingPageState();
}

class _OnboardingPageState extends State<OnboardingPage>
with GitsStatePage<OnboardingPage, OnboardingCubit> {
@override
OnboardingCubit setCubit() => locator();

@override
Widget buildWidget(BuildContext context) {
return Scaffold(
body: Stack(
children: [
PageView(
controller: cubit.pageController,
onPageChanged: cubit.onPageChange,
children: cubit.listOnboarding,
),
const Positioned(
left: GitsSizes.s16,
right: GitsSizes.s16,
bottom: GitsSizes.s16,
child: OnboardingButton(),
),
],
),
);
}
}
copied to clipboard
To use GitsCubit first we need State from the data class which added the copyWith method to replace the variables in State.
part of 'onboarding_cubit.dart';

class OnboardingStateCubit extends Equatable {
const OnboardingStateCubit({
required this.selected,
required this.isLast,
});

final int selected;
final bool isLast;

OnboardingStateCubit copyWith({
int? selected,
bool? isLast,
}) {
return OnboardingStateCubit(
selected: selected ?? this.selected,
isLast: isLast ?? this.isLast,
);
}

@override
List<Object?> get props => [selected, isLast]; // add all variables to list props
}
copied to clipboard
GitsCubit is a controller for all the logic that will be used, by creating a class with extends GitsCubit<State> in the constructor must call super(State()) to give the initial value to State.
import 'package:core/core.dart';
import 'package:flutter/material.dart';

import '../widgets/onboarding.dart';

part 'onboarding_state.dart';

class OnboardingCubit extends GitsCubit<OnboardingStateCubit> {
OnboardingCubit()
: super(const OnboardingStateCubit( // must call super with value initial state
selected: 0,
isLast: false,
));
...
@override
void initState(BuildContext context) async {}

@override
void initAfterFirstLayout(BuildContext context) {}

@override
List<BlocProvider> blocProviders(BuildContext context) => [];

@override
List<BlocListener> blocListeners(BuildContext context) => [];

@override
void dispose() {}

void onPageChange(int value) => emit(state.copyWith(
selected: value,
isLast: value == listOnboarding.length - 1,
));

...
}
copied to clipboard
here's an example of using GitsCubit with bloc to fetch data to api on login_cubit.dart.
import 'package:core/core.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';

import '../../data/models/body/login_body.dart';
import '../bloc/login/login_bloc.dart';

part 'login_state.dart';

class LoginCubit extends GitsCubit<LoginStateCubit> {
LoginCubit({required this.loginBloc}) : super(LoginStateCubit());

final LoginBloc loginBloc;

...

@override
List<BlocProvider> blocProviders(BuildContext context) => [
BlocProvider<LoginBloc>(create: (context) => loginBloc),
];

@override
List<BlocListener> blocListeners(BuildContext context) => [
BlocListener<LoginBloc, LoginState>(listener: _listenerLogin),
];

@override
void dispose() {
try {
loginBloc.close();
} catch (e) {
if (kDebugMode) print(e.toString());
}
}

...

void onLoginWithEmailPressed(BuildContext context) {
_setValidate();
if (_isValidEmailPassword()) {
_fetchLogin(LoginBody(email: emailKey.text, password: passwordKey.text));
}
}

...

void _fetchLogin(LoginBody body) {
loginBloc.add(FetchLogin(body));
}

void _listenerLogin(BuildContext context, LoginState state) {
if (state is LoginFailed) {
state.failure.showSnackbar(context);
} else if (state is LoginSuccess) {
context.go(GitsRoutes.main);
}
}
}
copied to clipboard

initState : same method on StatefullWidget when doing initState.
initAfterFirstLayout : method that is called when the application finishes rendering what is in the build widget.
blocProviders : initialize bloc to be used in this method.
blocListeners : catch callback of state bloc which will be listened when state bloc moves to another state.
dispose : same method on StatefullWidget when doing dispose.
emit : method used to change state and reactive change UI that requires state.

for pages that need reactive data from GitsCubit we can do the extensions context.select and context.watch and call them in build. then as for context.read is used to call methods that are in GitsCubit and are not listeners, for complete documentation it is in bloclibrary.dev.

context.select : listen for changes to a selected variable from GitsCubit or from State GitsCubit.

// fetch data from OnboardingCubit
final listOnboarding = context.select((OnboardingCubit element) => element.listOnboarding);

// fetch data from OnboardingCubit state
final selected = context.select((OnboardingCubit element) => element.state.selected);
copied to clipboard

context.watch : listen for State changes, usually used to listen for State fetch API changes starting from Initial, Loading, Succss & Failed.

final watchLoginState = context.watch<LoginBloc>().state;
...
GitsButton.elevated(
isLoading: watchLoginState is LoginLoading,
text: context.s.loginWithEmail,
onPressed: () =>
context.read<LoginCubit>().onLoginWithEmailPressed(context),
)
copied to clipboard

context.read : usually used for calling methods in GitsCubit.

GitsButton.elevated(
isLoading: watchLoginState is LoginLoading,
text: context.s.loginWithEmail,
onPressed: () =>
context.read<LoginCubit>().onLoginWithEmailPressed(context),
)
copied to clipboard
and the following is an example of implementing state management on onboarding_button.dart
import 'package:core/core.dart';
import 'package:flutter/material.dart';
import 'package:onboarding/cubit/onboarding_cubit.dart';
import 'package:onboarding/widgets/indicator.dart';

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

@override
Widget build(BuildContext context) {
final listOnboarding =
context.select((OnboardingCubit element) => element.listOnboarding);
final selected =
context.select((OnboardingCubit element) => element.state.selected);
final isLast =
context.select((OnboardingCubit element) => element.state.isLast);

return Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
isLast
? const SizedBox(width: 100)
: GitsButton.text(
isExpand: false,
text: context.s.skip,
style: TextButton.styleFrom(
minimumSize: const Size.fromWidth(100),
),
onPressed: context.read<OnboardingCubit>().onSkipPressed,
),
Indicator(length: listOnboarding.length, selected: selected),
GitsButton.elevated(
text: isLast ? context.s.started : context.s.next,
isExpand: false,
style: ElevatedButton.styleFrom(
minimumSize: const Size.fromWidth(100),
),
onPressed: () =>
context.read<OnboardingCubit>().onNextPressed(context),
),
],
);
}
}
copied to clipboard
Gits Hydrated #
inspired by the hydrated_bloc mixin GitsCubit which automatically persists and restores GitsCubit states.
storage used flutter_secure_storage so that the stored data is more encrypted.
import 'package:core/core.dart';
import 'package:flutter/material.dart';

import '../widgets/onboarding.dart';

part 'onboarding_state.dart';

class OnboardingCubit extends GitsCubit<OnboardingStateCubit> with GitsHydrated<OnboardingStateCubit> {
OnboardingCubit()
: super(const OnboardingStateCubit(
selected: 0,
isLast: false,
));
...

@override
void loadedHydrated(OnboardingStateCubit state) {
super.loadedHydrated(state);
pageController.jumpToPage(state.selected);
}

@override
OnboardingStateCubit fromMap(Map<String, dynamic> map) => OnboardingStateCubit.fromMap(map);

@override
Map<String, dynamic> toMap() => state.toMap();
}
copied to clipboard
to clear the hydrated cache you can use
clearHydrated();
copied to clipboard