1. 官方demo解析
// Material Design 组件库,包含 runApp、Widget、MaterialApp、Scaffold、Text、ElevatedButton 等绝大多数 UI 组件
import 'package:flutter/material.dart';
// 入口函数
void main() {
// runApp()来自material 库,初始化渲染树并驱动界面,需要传入一个实例
runApp(const MyApp());
}
// 定义一个名为 MyApp 的类,它继承自 StatelessWidget
// StatelessWidget 是 Flutter 的无状态组件基类,来自material 库
// "无状态"指这个组件本身不持有会变化的状态,界面完全由构造时传入的参数决定,build 返回什么就显示什么,不会因为内部数据变化而重建
class MyApp extends StatelessWidget {
const MyApp({super.key});
// @override 是 Dart 的注解,来自 dart:core(语言内置)。它告诉编译器"这个方法覆盖了父类同名方法",拼写错误时能报错,属于安全检查,不影响运行
@override
// Widget:所有 UI 组件的基类,来自 material 库
// build 是 StatelessWidget 要求子类实现的抽象方法,Flutter 在需要绘制这个组件时调用它
// BuildContext context:构建上下文,代表这个组件在组件树中的位置
Widget build(BuildContext context) {
// MaterialApp 是 Flutter 提供的 Material 风格应用外壳,来自 material 库,它帮你统一配置导航(路由)、主题、本地化、标题栏等,内部会构建 Navigator、Theme 等基础设施
return MaterialApp(
// 应用标题
title: 'Flutter Demo',
// 设置应用主题
// ThemeData:Material 主题配置类,来自 material 库
theme: ThemeData(
colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
),
// 主页
home: const MyHomePage(title: 'Flutter Demo Home Page2'),
);
}
}
// 定义 MyHomePage 类,继承 StatefulWidget
// StatefulWidget 是 Flutter 的有状态组件基类,来自 material 库,会关联一个可变的 State 对象来保存会变化的数据
class MyHomePage extends StatefulWidget {
// 接收参数 title,并赋值给后面的 title
const MyHomePage({super.key, required this.title});
// StatefulWidget 上定义的任何公开字段(不以 _ 开头),都能在关联的 State 里通过 widget.字段名 读取
final String title;
// 重写 createState,返回 MyHomePage 对应的状态对象 _MyHomePageState
@override
// createState 是 StatefulWidget 的抽象方法,Flutter 创建该组件时调用它来获得 State 实例
State<MyHomePage> createState() => _MyHomePageState();
}
class _MyHomePageState extends State<MyHomePage> {
// 定义计数变量
int _counter = 0;
// 定义方法
void _incrementCounter() {
// setState(...) 是 State 类提供的方法,它的作用是:触发 build 重新执行、界面刷新
setState(() {
_counter++;
});
}
// 重写 build,描述界面长什么样
@override
Widget build(BuildContext context) {
// Scaffold 来自 material库,提供 Material 页面的标准结构槽位:appBar(顶栏)、body(主体)、floatingActionButton(悬浮按钮)、drawer(抽屉)等
return Scaffold(
// 顶部导航
appBar: AppBar(
// 导航背景色
backgroundColor: Theme.of(context).colorScheme.inversePrimary,
// 导航标题,读取其StatefulWidget里面定义的字段
title: Text(widget.title),
),
// 主体
body: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: <Widget>[
const Text('You have pushed the button this many times:'),
Text(
'$_counter',
style: Theme.of(context).textTheme.headlineMedium,
),
],
),
),
// 右下角悬浮按钮
floatingActionButton: FloatingActionButton(
onPressed: _incrementCounter,
tooltip: 'Increment',
child: const Icon(Icons.add),
),
);
}
}