docs(main.dart, basic_provider_page.dart): 更新注释和格式
在 main.dart 文件中添加了对 Flutter 应用程序结构的详细注释,增强代码可读性。 在 basic_provider_page.dart 文件中调整了注释格式,确保一致性和清晰性。
This commit is contained in:
@ -1,5 +1,10 @@
|
||||
// 导入 Flutter 的 Material UI 包,用于构建用户界面
|
||||
import 'package:flutter/material.dart';
|
||||
|
||||
// 导入 provider 包,用于状态管理
|
||||
import 'package:provider/provider.dart';
|
||||
|
||||
// 导入各个示例页面的文件
|
||||
import 'pages/basic_provider_page.dart';
|
||||
import 'pages/multi_provider_page.dart';
|
||||
import 'pages/change_notifier_page.dart';
|
||||
@ -9,43 +14,66 @@ import 'pages/future_provider_page.dart';
|
||||
import 'pages/stream_provider_page.dart';
|
||||
import 'pages/proxy_provider_page.dart';
|
||||
|
||||
// Flutter 应用程序的入口点
|
||||
void main() {
|
||||
// 运行 MyApp 小部件作为应用程序的根
|
||||
runApp(const MyApp());
|
||||
}
|
||||
|
||||
// MyApp 是一个无状态小部件,是应用程序的根小部件
|
||||
class MyApp extends StatelessWidget {
|
||||
// MyApp 的构造函数
|
||||
const MyApp({super.key});
|
||||
|
||||
// build 方法描述了如何构建小部件的用户界面
|
||||
@override
|
||||
Widget build(BuildContext context) {
|
||||
// MaterialApp 是一个 Flutter 提供的便捷小部件,封装了应用程序通常需要的一些功能
|
||||
return MaterialApp(
|
||||
// 应用程序的标题,通常在任务切换器中显示
|
||||
title: 'Provider Examples',
|
||||
// 应用程序的主题
|
||||
theme: ThemeData(
|
||||
// 设置主题的主色调为蓝色
|
||||
primarySwatch: Colors.blue,
|
||||
),
|
||||
// 应用程序启动时显示的首页
|
||||
home: const HomePage(),
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
// HomePage 是一个无状态小部件,用于显示 Provider 示例的列表
|
||||
class HomePage extends StatelessWidget {
|
||||
// HomePage 的构造函数
|
||||
const HomePage({super.key});
|
||||
|
||||
// build 方法描述了如何构建小部件的用户界面
|
||||
@override
|
||||
Widget build(BuildContext context) {
|
||||
// Scaffold 是 Material Design 布局结构的基本实现
|
||||
return Scaffold(
|
||||
// 应用程序栏
|
||||
appBar: AppBar(
|
||||
// 应用程序栏的标题
|
||||
title: const Text('Provider Examples'),
|
||||
),
|
||||
// 页面的主体内容,使用 ListView 来显示可滚动的列表
|
||||
body: ListView(
|
||||
// 列表中的子项
|
||||
children: [
|
||||
// 列表项:基本 Provider 示例
|
||||
ListTile(
|
||||
// 列表项的标题
|
||||
title: const Text('Basic Provider'),
|
||||
// 点击列表项时的回调函数
|
||||
onTap: () => Navigator.push(
|
||||
context,
|
||||
// 创建一个 MaterialPageRoute 来导航到 BasicProviderPage
|
||||
MaterialPageRoute(builder: (_) => const BasicProviderPage()),
|
||||
),
|
||||
),
|
||||
// 列表项:MultiProvider 示例
|
||||
ListTile(
|
||||
title: const Text('MultiProvider'),
|
||||
onTap: () => Navigator.push(
|
||||
@ -53,6 +81,7 @@ class HomePage extends StatelessWidget {
|
||||
MaterialPageRoute(builder: (_) => const MultiProviderPage()),
|
||||
),
|
||||
),
|
||||
// 列表项:ChangeNotifierProvider 示例
|
||||
ListTile(
|
||||
title: const Text('ChangeNotifierProvider'),
|
||||
onTap: () => Navigator.push(
|
||||
@ -60,6 +89,7 @@ class HomePage extends StatelessWidget {
|
||||
MaterialPageRoute(builder: (_) => const ChangeNotifierPage()),
|
||||
),
|
||||
),
|
||||
// 列表项:Consumer 示例
|
||||
ListTile(
|
||||
title: const Text('Consumer'),
|
||||
onTap: () => Navigator.push(
|
||||
@ -67,6 +97,7 @@ class HomePage extends StatelessWidget {
|
||||
MaterialPageRoute(builder: (_) => const ConsumerPage()),
|
||||
),
|
||||
),
|
||||
// 列表项:Selector 示例
|
||||
ListTile(
|
||||
title: const Text('Selector'),
|
||||
onTap: () => Navigator.push(
|
||||
@ -74,6 +105,7 @@ class HomePage extends StatelessWidget {
|
||||
MaterialPageRoute(builder: (_) => const SelectorPage()),
|
||||
),
|
||||
),
|
||||
// 列表项:FutureProvider 示例
|
||||
ListTile(
|
||||
title: const Text('FutureProvider'),
|
||||
onTap: () => Navigator.push(
|
||||
@ -81,6 +113,7 @@ class HomePage extends StatelessWidget {
|
||||
MaterialPageRoute(builder: (_) => const FutureProviderPage()),
|
||||
),
|
||||
),
|
||||
// 列表项:StreamProvider 示例
|
||||
ListTile(
|
||||
title: const Text('StreamProvider'),
|
||||
onTap: () => Navigator.push(
|
||||
@ -88,6 +121,7 @@ class HomePage extends StatelessWidget {
|
||||
MaterialPageRoute(builder: (_) => const StreamProviderPage()),
|
||||
),
|
||||
),
|
||||
// 列表项:ProxyProvider 示例
|
||||
ListTile(
|
||||
title: const Text('ProxyProvider'),
|
||||
onTap: () => Navigator.push(
|
||||
|
Reference in New Issue
Block a user