docs: update quick start

This commit is contained in:
Kingkor Roy Tirtho
2023-10-06 22:21:28 +06:00
parent ae26534512
commit a1fa2cc4f8
+135 -94
View File
@@ -9,49 +9,39 @@ import TabItem from '@theme/TabItem';
This is a simple & dummy example that covers the usage of This is a simple & dummy example that covers the usage of
- [Query](/) - [Query](/)
- [QueryJob](/)
```dart ```dart
import 'package:fl_query_connectivity_plus_adapter/fl_query_connectivity_plus_adapter.dart';
import 'package:fl_query_hooks_example/router.dart';
import 'package:fl_query/fl_query.dart'; import 'package:fl_query/fl_query.dart';
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
void main() { void main() async {
runApp(const MyApp()); WidgetsFlutterBinding.ensureInitialized();
await QueryClient.initialize(
cachePrefix: 'fl_query_hooks_example',
connectivity: FlQueryConnectivityPlusAdapter(),
);
runApp(
QueryClientProvider(
child: const MainApp(),
),
);
} }
// A QueryJob is where the Logic of how the data should be class MainApp extends StatelessWidget {
// fetched can defined. The task callback is a PURE Function const MainApp({super.key});
// & have access to external resources through the second
// parameter where the first parameter is the queryKey
final successJob = QueryJob<String, void>(
queryKey: "query-example",
task: (queryKey, externalData) => Future.delayed(
const Duration(seconds: 2),
() =>
"The work successfully executed. Data: key=($queryKey) value=${
Random.secure().nextInt(100)
}",
),
);
class MyApp extends StatelessWidget {
const MyApp({Key? key}) : super(key: key);
@override @override
Widget build(BuildContext context) { Widget build(BuildContext context) {
// QueryBowlScope creates a Bowl (metaphor for Collection/Store) return MaterialApp(
// for all the Queries & Mutations theme: ThemeData(
return QueryBowlScope( colorSchemeSeed: Colors.red[100],
bowl: QueryBowl(), useMaterial3: true,
child: MaterialApp(
title: 'Fl-Query Quick Start',
theme: ThemeData(
useMaterial3: true,
primarySwatch: Colors.blue,
),
home: const MyHomePage(),
), ),
title: 'FL Query Hooks Example',
home: const QueryPage(),
); );
} }
} }
@@ -61,42 +51,68 @@ class MyApp extends StatelessWidget {
<TabItem value="vanilla" label="Vanilla"> <TabItem value="vanilla" label="Vanilla">
```dart ```dart
class MyHomePage extends StatelessWidget { import 'dart:math';
const MyHomePage({Key? key}) : super(key: key);
import 'package:fl_query/fl_query.dart';
import 'package:flutter/material.dart';
class QueryPage extends StatelessWidget {
const QueryPage({super.key});
@override @override
Widget build(BuildContext context) { Widget build(BuildContext context) {
return Column( final value = Random().nextInt(200000);
crossAxisAlignment: CrossAxisAlignment.start, return Scaffold(
children: [ appBar: AppBar(
Text( title: const Text('Query'),
"# Basic Query Example", ),
style: Theme.of(context).textTheme.headline5, floatingActionButton:
), QueryListenable<String, dynamic>('hello', builder: (context, query) {
// QueryBuilder Widget provides the expected query if (query == null) {
// instances through the builder callback based on return const SizedBox();
// the passed job & externalData argument }
QueryBuilder<String, void>( return FloatingActionButton(
job: successJob, onPressed: () {
externalData: null, query.refresh();
builder: (context, query) {
if (!query.hasData || query.isLoading || query.isRefetching) {
return const CircularProgressIndicator();
}
return Row(
children: [
Text(query.data!),
ElevatedButton(
child: const Text("Refetch"),
onPressed: () async {
await query.refetch();
},
), // Text
],
); // Row
}, },
), // QueryBuilder child: Text(query.data ?? 'No Data'),
], );
}),
body: QueryBuilder<String, dynamic>(
'hello',
() {
return Future.delayed(
const Duration(seconds: 6),
() => 'Hello World! $value',
);
},
initial: 'Hello',
jsonConfig: JsonConfig(
fromJson: (json) => json['data'],
toJson: (data) => {'data': data},
),
onData: (value) {
debugPrint('onData: $value');
},
onError: (error) {
debugPrint('onError: $error');
},
builder: (context, query) {
if(query.isLoading){
return const Center(
child: CircularProgressIndicator(),
);
}
else if(query.hasError){
return Center(
child: Text(query.error.toString()),
);
}
return Center(
child: Text(query.data ?? "Unfortunately, there's no data"),
);
},
),
); );
} }
} }
@@ -106,40 +122,65 @@ class MyHomePage extends StatelessWidget {
<TabItem value="hooks" label="Flutter Hooks"> <TabItem value="hooks" label="Flutter Hooks">
```dart ```dart
class MyHomePage extends HookWidget { import 'dart:math';
const MyHomePage({Key? key}) : super(key: key);
import 'package:fl_query/fl_query.dart';
import 'package:fl_query_hooks/fl_query_hooks.dart';
import 'package:flutter/material.dart';
import 'package:flutter_hooks/flutter_hooks.dart';
class QueryPage extends HookWidget {
const QueryPage({super.key});
@override @override
Widget build(BuildContext context) { Widget build(BuildContext context) {
// useQuery hook returns the expected query final value = Random().nextInt(200000);
// instances based on the passed job & externalData argument final query = useQuery<String, dynamic>(
final query= useQuery<String, void>( 'hello',
job: successJob, () {
externalData: null, return Future.delayed(
const Duration(seconds: 6), () => 'Hello World! $value');
},
initial: 'Hello',
jsonConfig: JsonConfig(
fromJson: (json) => json['data'],
toJson: (data) => {'data': data},
),
onData: (value) {
debugPrint('onData: $value');
},
onError: (error) {
debugPrint('onError: $error');
},
); );
return Column( return Scaffold(
crossAxisAlignment: CrossAxisAlignment.start, appBar: AppBar(
children: [ title: const Text('Query'),
Text( ),
"# Basic Query Example", floatingActionButton:
style: Theme.of(context).textTheme.headline5, QueryListenable<String, dynamic>('hello', builder: (context, query) {
), if (query == null) {
if (!query.hasData || query.isLoading || query.isRefetching) return const SizedBox();
const CircularProgressIndicator(); }
else return FloatingActionButton(
Row( onPressed: () {
children: [ query.refresh();
Text(query.data!), },
ElevatedButton( child: Text(query.data ?? 'No Data'),
child: const Text("Refetch"), );
onPressed: () async { }),
await query.refetch(); body: query.isLoading
}, ? const Center(
), // Text child: CircularProgressIndicator(),
], )
); // Row : query.hasError
], ? Center(
child: Text(query.error.toString()),
)
: Center(
child: Text(query.data ?? "Unfortunately, there's no data"),
),
); );
} }
} }
@@ -151,5 +192,5 @@ class MyHomePage extends HookWidget {
:::tip :::tip
If you want to explore more you can see the [Example Application](https://github.com/KRTirtho/fl-query/tree/main/packages/example) which covers a lot of use-cases If you want to explore more you can see the [Example Application](https://github.com/KRTirtho/fl-query/tree/main/packages/example) which covers a lot of use-cases
Also you can browse [Spotube/fl_query_integrate](https://github.com/KRTirtho/spotube/tree/fl_query_integrate) branch of [Spotube](https://github.com/KRTirtho/spotube/) where Fl-Query is used in a real-world application experimentally Also you can browse [Spotube/libs/services/queries](https://github.com/KRTirtho/spotube/tree/master/lib/services/queries) & [Spotube/libs/services/mutations](https://github.com/KRTirtho/spotube/tree/master/lib/services/mutations) directories of [Spotube](https://github.com/KRTirtho/spotube/) where Fl-Query is used in a real-world production application
::: :::