Skip to content

Commit 9284886

Browse files
authored
docs(replay_bloc): update example to follow naming conventions (#3031)
1 parent d9c6106 commit 9284886

File tree

3 files changed

+34
-25
lines changed

3 files changed

+34
-25
lines changed

packages/replay_bloc/README.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -96,14 +96,14 @@ class CounterCubit extends HydratedCubit<int> with ReplayCubitMixin {
9696
```dart
9797
class CounterEvent extends ReplayEvent {}
9898
99-
class Increment extends CounterEvent {}
99+
class CounterIncrementPressed extends CounterEvent {}
100100
101-
class Decrement extends CounterEvent {}
101+
class CounterDecrementPressed extends CounterEvent {}
102102
103103
class CounterBloc extends ReplayBloc<CounterEvent, int> {
104104
CounterBloc() : super(0) {
105-
on<Increment>((event, emit) => emit(state + 1));
106-
on<Decrement>((event, emit) => emit(state - 1));
105+
on<CounterIncrementPressed>((event, emit) => emit(state + 1));
106+
on<CounterDecrementPressed>((event, emit) => emit(state - 1));
107107
}
108108
}
109109
```
@@ -113,7 +113,7 @@ class CounterBloc extends ReplayBloc<CounterEvent, int> {
113113
```dart
114114
void main() {
115115
// trigger a state change
116-
final bloc = CounterBloc()..add(Increment());
116+
final bloc = CounterBloc()..add(CounterIncrementPressed());
117117
118118
// wait for state to update
119119
await bloc.stream.first;
@@ -136,14 +136,14 @@ If you wish to be able to use a `ReplayBloc` in conjuction with a different type
136136
```dart
137137
abstract class CounterEvent with ReplayEvent {}
138138
139-
class Increment extends CounterEvent {}
139+
class CounterIncrementPressed extends CounterEvent {}
140140
141-
class Decrement extends CounterEvent {}
141+
class CounterDecrementPressed extends CounterEvent {}
142142
143143
class CounterBloc extends HydratedBloc<CounterEvent, int> with ReplayBlocMixin {
144144
CounterBloc() : super(0) {
145-
on<Increment>((event, emit) => emit(state + 1));
146-
on<Decrement>((event, emit) => emit(state - 1));
145+
on<CounterIncrementPressed>((event, emit) => emit(state + 1));
146+
on<CounterDecrementPressed>((event, emit) => emit(state - 1));
147147
}
148148
149149
@override

packages/replay_bloc/example/lib/main.dart

Lines changed: 22 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -92,17 +92,23 @@ class CounterPage extends StatelessWidget {
9292
children: <Widget>[
9393
FloatingActionButton(
9494
child: const Icon(Icons.add),
95-
onPressed: () => context.read<CounterBloc>().add(Increment()),
95+
onPressed: () {
96+
context.read<CounterBloc>().add(CounterIncrementPressed());
97+
},
9698
),
9799
const SizedBox(height: 4),
98100
FloatingActionButton(
99101
child: const Icon(Icons.remove),
100-
onPressed: () => context.read<CounterBloc>().add(Decrement()),
102+
onPressed: () {
103+
context.read<CounterBloc>().add(CounterDecrementPressed());
104+
},
101105
),
102106
const SizedBox(height: 4),
103107
FloatingActionButton(
104108
child: const Icon(Icons.delete_forever),
105-
onPressed: () => context.read<CounterBloc>().add(Reset()),
109+
onPressed: () {
110+
context.read<CounterBloc>().add(CounterResetPressed());
111+
},
106112
),
107113
],
108114
),
@@ -133,32 +139,35 @@ class CounterCubit extends ReplayCubit<int> {
133139
class CounterEvent extends ReplayEvent {}
134140

135141
/// Notifies [CounterBloc] to increment its state.
136-
class Increment extends CounterEvent {
142+
class CounterIncrementPressed extends CounterEvent {
137143
@override
138-
String toString() => 'Increment';
144+
String toString() => 'CounterIncrementPressed';
139145
}
140146

141147
/// Notifies [CounterBloc] to decrement its state.
142-
class Decrement extends CounterEvent {
148+
class CounterDecrementPressed extends CounterEvent {
143149
@override
144-
String toString() => 'Decrement';
150+
String toString() => 'CounterDecrementPressed';
145151
}
146152

147153
/// Notifies [CounterBloc] to reset its state.
148-
class Reset extends CounterEvent {
154+
class CounterResetPressed extends CounterEvent {
149155
@override
150-
String toString() => 'Reset';
156+
String toString() => 'CounterResetPressed';
151157
}
152158

153159
/// {@template replay_counter_bloc}
154160
/// A simple [ReplayBloc] which manages an `int` as its state
155-
/// and reacts to three events: [Increment], [Decrement], and [Reset].
161+
/// and reacts to three events:
162+
/// * [CounterIncrementPressed]
163+
/// * [CounterDecrementPressed]
164+
/// * [CounterResetPressed]
156165
/// {@endtemplate}
157166
class CounterBloc extends ReplayBloc<CounterEvent, int> {
158167
/// {@macro replay_counter_bloc}
159168
CounterBloc() : super(0) {
160-
on<Increment>((event, emit) => emit(state + 1));
161-
on<Decrement>((event, emit) => emit(state - 1));
162-
on<Reset>((event, emit) => emit(0));
169+
on<CounterIncrementPressed>((event, emit) => emit(state + 1));
170+
on<CounterDecrementPressed>((event, emit) => emit(state - 1));
171+
on<CounterResetPressed>((event, emit) => emit(0));
163172
}
164173
}

packages/replay_bloc/lib/src/replay_bloc.dart

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,11 +30,11 @@ class _Undo extends ReplayEvent {
3030
///
3131
/// ```dart
3232
/// abstract class CounterEvent {}
33-
/// class Increment extends CounterEvent {}
33+
/// class CounterIncrementPressed extends CounterEvent {}
3434
///
3535
/// class CounterBloc extends ReplayBloc<CounterEvent, int> {
3636
/// CounterBloc() : super(0) {
37-
/// on<Increment>((event, emit) => emit(state + 1));
37+
/// on<CounterIncrementPressed>((event, emit) => emit(state + 1));
3838
/// }
3939
/// }
4040
/// ```
@@ -44,7 +44,7 @@ class _Undo extends ReplayEvent {
4444
/// ```dart
4545
/// final bloc = CounterBloc();
4646
///
47-
/// bloc.add(Increment());
47+
/// bloc.add(CounterIncrementPressed());
4848
///
4949
/// bloc.undo();
5050
///

0 commit comments

Comments
 (0)