3. Flutter 入门
3.1. 示例 01:Flutter 应用的结构
3.1.1. 项目
一个 [Flutter] 项目通过 [flutter create] 命令创建:
- [--org fr.stahe]:应用 ID 的前缀,像域名一样倒写。[Android] 应用将被命名为 [fr.stahe.my_application];同一部手机上安装的两个应用必须有不同的 ID;
- [--platforms=...]:目标平台。对于每个平台,[flutter create] 会创建一个文件夹([android/]、[web/]、[windows/],如有需要还会有 [ios/]、[macos/]、[linux/] ):这是一个小型的平台专用项目,仅负责启动 [Flutter] 引擎并把应用加载到其中。我们很少修改它(应用的名称、图标和权限);
- [my_application]:项目名称,同时也是 [Dart] 包名:小写字母、数字和下划线。
该命令会生成一个完整的、可直接运行的应用(一个计数器)。示例项目也是这样创建的,然后手动填充其 [lib/] 文件夹,将二十五个应用合并为一个项目:这样它们共享相同的包,这些包只需下载一次。
3.1.2. pubspec.yaml 文件
文件 [pubspec.yaml] 描述了项目:它的名称、所需的 [Dart] 版本、所使用的包,以及随应用一起打包的文件。示例项目的该文件如下:
- 第 14–18 行:项目名称(同时也是包名——项目文件通过 [package:examples_flutter/...] 导入)、描述和版本。[publish_to: none]:该项目不是库,永远不会发布到 [pub.dev];
- 第 20–22 行:所需的 [Dart] 语言版本。前缀 [^] 表示接受同一主版本内的任何更新版本(3.12、3.13……但不包括 4.0);
- 第 24–45 行:应用所需的包。其中一些来自 [Flutter] SDK 本身([sdk: flutter]):[flutter] (框架)、[flutter_localizations] ([Flutter] 的文本被翻译成各种语言)、[flutter_web_plugins] (Web 专用配置)。其余的从 pub.dev 下载,那里是 [Dart] 包的仓库:它们的用途在注释中有说明,每个包都会在使用它的示例中演示。[intl: any]:任意版本([flutter_localizations] 会自行规定);
- 第 47–52 行:仅在开发时使用、不包含在发布应用中的包:[flutter_test] (测试)和 [flutter_lints] (分析器风格规则);
- 第 54–67 行:特定于 [Flutter] 的配置:
- [uses-material-design: true]:应用使用 [Material Design] 的图标字体([Icons.add]、[Icons.delete]……);
- [assets]:随 应用 一起提供的文件(图像、词典等),通过其路径读取。指定一个文件夹([assets/])即可直接交付其中包含的所有文件;
- [fonts]:随应用一起打包的字体;[Roboto Mono] 是一种等宽字体,用于显示 JSON。[Material Design] 的标准字体 [Roboto] 是 [Android] 的系统字体:无需包含它。
包版本遵循与 [npm] 相同的约定:[^16.2.0] 表示接受从 16.2.0 开始的任何 16.x.y 版本。命令 [flutter pub get] 会下载这些包,并将所选的确切版本写入文件 [pubspec.lock]。当 [flutter run] 发现 [pubspec.yaml] 已更改时会自动执行它;[VS Code] 也会在保存该文件时立即运行它。要添加一个包,除了手动编辑该文件,还可以输入 [flutter pub add go_router]:该命令会添加一行,写入该包的最新版本。
3.1.3. analysis_options.yaml 文件
在输入代码时,[Dart] 分析器会检查代码:[VS Code] 用红色下划线标出错误,用黄色或蓝色标出警告。你也可以用 [flutter analyze] 对整个项目运行它。它的规则:
- 第 9 行:由 [Flutter] 团队推荐的规则([flutter_lints] 包):组件在可能时必须有 [const] 构造函数,控制器必须被释放,等等;
- 第 14–15 行:更严格的类型检查。[Dart] 是一种静态类型语言,但它有一个类型 [dynamic] (“任意类型”):例如,解码后的 JSON 就由 [dynamic] 构成。[strict-casts] 禁止隐式转换为另一种类型:必须显式书写([json['lastName'] as String]),这样任何错误都会在那里发生并且可见;
- 第 20–24 行:几条风格规则:字符串使用单引号(如果字符串包含撇号,则使用双引号:["it's"]),以及 [final] 用于从不重新赋值的变量。
3.1.4. 入口点:main.dart
例如,有一个名为 [main.dart] 的文件,其中包含函数 [main]——任何 [Dart] 程序的入口点。示例 01 中的该文件如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 | |
让我们从末尾开始:程序。
- 第 13 行:[Material] 库,来自 [Flutter]:包含 [Material Design] 的所有组件,这是 [Google] 的视觉语言(按钮、输入字段、栏、窗口等)。它会自行导入 [Flutter] 的其余部分;
- 第 16–17 行:两个普通的数据值,声明在组件之外:它们永远不会改变。[const]:编译时已知的常量;
- 第 20–23 行:一个普通函数,返回当前时间,格式为“12:05:09”。它自己包含一个小函数 [twoDigits],用 [=>] 写在一行里;
- 第 27–29 行:函数 [main],在启动时被调用。[runApp] 启动 [Flutter]:它接管屏幕,并显示传给它的组件——即应用的 根 组件。
根组件 [Application]:
- 第 34 行:组件就是一个类。这个类继承自 [StatelessWidget],即一个 无状态组件:它显示的内容完全取决于其参数,自身永远不会改变;
- 第 29 行:它的构造函数。[{super.key}]:传给父类的可选命名参数。每个组件都有一个:用于标识它的“key”(见示例 04)。该构造函数是 [const] 的:[Application()] 可以是一个常量,[Flutter] 永远不需要重新构造它;
- 第 38–47 行:[build] 方法,是组件的核心。它返回构成该组件的各个组件。[@override]:它重写了父类的 [build] 方法。参数 [context] 表示该组件在组件树中的位置:它用于获取其祖先提供的内容(例如第 90 行的主题);
- 第 41–47 行:[MaterialApp] 是把组件树变成 [Material] 应用的组件:包含标题([title],即应用在手机最近应用列表或浏览器标签页中的名称)、主题([theme])和主屏幕([home])。[debugShowCheckedModeBanner: false] 会移除开发版应用在角落显示的“DEBUG”横幅。[ThemeData(colorSchemeSeed: Colors.indigo)]:应用中的所有颜色(按钮、栏、字段等)都由一种基础颜色派生,依据 [Material Design] 3 的规则。
第一个屏幕 [HomePage] 带有会变化的数据:它是一个 有状态组件。
- 第 54–58 行:[StatefulWidget] 由两部分组成。组件本身和任何组件一样永远不会改变(它的字段是 [final] 的);它唯一的任务是通过 [createState] 创建一个 [State] 对象,由这个对象来保存会变化的数据。[Flutter] 只创建该对象一次,只要组件仍停留在树中的同一位置,就一直保留它;
- 第 62 行:对象 [State]。它的名称以下划线开头:在 [Dart] 中,以 [_] 开头的一切都是 私有的 ,在文件之外不可见;
- 第 64–65 行:状态:简单字段,属于 [State] 对象;
- 第 68–75 行:按钮调用的方法。它不影响屏幕:它修改状态,在 传给 [setState] 的函数内部进行。[setState] 执行这个函数,然后通知 [Flutter] 状态已改变:[Flutter] 会调用 [build],将新的组件树与旧的组件树进行比较,并重绘发生变化的部分;
- 第 79–105 行:屏幕的 [build] 方法:
- [Scaffold] (“脚手架”)是 [Material] 屏幕的结构:顶部栏([appBar])、主体([body]),以及按需提供的底部栏、浮动按钮和侧边菜单;
- [AppBar]:顶部栏;它的标题是一个组件([Text]),就像 [Flutter] 中几乎所有的东西一样;
- [Padding]:围绕其唯一子组件 [child] 的边距。[EdgeInsets.all(16)]:每一边 16 个点(逻辑“点”,与屏幕密度无关:在截图所示的手机上约为 2.6 像素);
- [Column]:它的子组件 [children] 上下依次排列。[crossAxisAlignment: CrossAxisAlignment.start]:左对齐(列的“交叉”轴是水平轴);
- [Text]:文本。它的样式可以从主题派生:[Theme.of(context).textTheme.headlineSmall] 是“小标题”的样式;
- [SizedBox]:指定高度的空盒子——两个组件之间的间隔;
- 第 98 行:[${expression}] 把表达式的值插入字符串;对于简单变量,[$_counter] 就够了(第 104 行);
- 第 101 行:一个按钮。[onPressed] 接收按下按钮时要调用的函数。我们传入函数本身,不带 括号:[onPressed: _increment()] 会在构建屏幕时立即调用它;
- 第 104–105 行:取决于状态的文本。状态改变时,会调用 [build] ,这段文本随之改变。
关于 [Dart] 的两点说明:
- 几乎所有组件的参数都是 命名参数 ([title: ...]、[child: ...]):组件树读起来就像一份描述,参数的顺序无关紧要。命名参数是可选的,除非它被声明为 [required];
- 位于组件前的关键字 [const] ([const SizedBox(height: 12)])会在编译时一次性创建该组件。[Flutter] 于是知道它永远不会改变,也不会浪费时间去比较它。分析器会标出所有被遗漏的 [const]。[VS Code] 知道如何自动添加它们。
屏幕的组件树,由 [Flutter DevTools] 工具(组件检查器)显示:
在 [Flutter] 应用中,你写的“实现”代码很少,“描述性”代码很多:屏幕是一棵组件树,每个组件由其参数配置。这与 [React] 的 JSX 是同一概念,只是没有模板语言:这棵树是用 [Dart] 写的。
3.1.5. 运行
在打开到 [examples_flutter] 文件夹的控制台中,在 [Android] 模拟器运行的情况下:
控制台显示:
第一次构建 [Android] 应用(使用 [Gradle] 工具)需要一两分钟;之后的构建只需几秒钟。应用会安装到模拟器上并启动。左侧是启动屏幕;右侧是按两次按钮之后的屏幕:
![]() | ![]() |
可以尝试两个实验:
- 修改 [main.dart] 中的标题文本,保存文件,然后在控制台中键入 `r` (或者直接在 [VS Code] 中保存文件):屏幕会在一秒内更新,计数器保持其值。这就是“热重载”:新代码被注入到正在运行的应用中;[Flutter] 会调用 [build],但 [State] 对象会被保留。R (“热重启”)会从 [main] 重新启动应用:计数器重置为 0;
- 在浏览器中启动同一个应用:[flutter run -d chrome -t lib/ex01_first_application/main.dart]。屏幕是同一个,由同一个引擎渲染;变化的只有窗口大小。使用 [-d windows] 时,它就是一个 [Windows] 应用。
3.2. 示例 02:状态与计算值
状态是 [Flutter] 的核心,就像它在 [React] 中一样。这个示例计算一件商品的含税价格:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 | |
- 第 21 行:一个美式英语风格的金额格式化器(€1,234.50),在组件之外一次性创建,使用 [intl] 包(见示例 09)。[final]:只赋值一次的变量,但其值在运行时才能确定(与 [const] 不同);
- 第 23–28 行:程序;这一次,[MaterialApp] 直接写在 [main] 中。大多数示例都会这样开头;
- 第 42–45 行:四项状态数据,都是简单字段,类型分别为:[String]、[double]、[int]。在 [Dart] 中,[int] 和 [double]、是两种不同的数字类型;
- 第 47 行:最近五次总额变化的历史记录,一个列表。该字段是 [final]:列表永远不会被替换,只会被修改(添加、删除);
- 第 52–53 行:两个输入字段的 控制器。[Flutter] 的输入字段把文本存放在控制器中,控制器被创建并分配给它:这样就可以在代码中读取或修改该文本(“重置”按钮)。示例 05 会详细介绍;
- 第 56–58 行:由状态计算得出的三个值。它们不是状态字段;它们是 getter——不带括号、像字段一样使用的方法([_totalInclVat])。每次读取时都会重新计算,因此始终是最新的。这和我们在 [React] 中已经见过的规则相同:只把无法计算的内容存入状态,其余一律计算得出;
- 第 63–73 行:含税总额的历史记录取决于总额的 先后取值,而 getter 无法表达这一点。因此,所有状态更改都通过 [_change] 方法进行,该方法接收要执行的更改作为参数(一个无参数、无返回值的函数,类型为 [void Function()]):它记录更改前的总额,在 `[setState]` 中应用更改,将其与更改后的总额比较,如有变化则更新历史记录。这是进行该计算的自然位置:即状态发生变化的地方,而不是 `[build]`(它只应该 描述 屏幕);
- 第 78–81 行:更改商品时会把数量重置为 1。这是在处理字段更改的方法中完成的,在那里我们知道状态为什么会改变;
- 第 85–93 行:在同一个 [setState] 中进行多项状态更改:[build] 只会被调用一次。然后控制器接收其初始文本:字段会立即显示它;
- 第 98–101 行:[dispose] 会在 [State] 对象永久消失(退出该屏幕)时被调用。在这里,释放所创建的对象——此处即控制器。示例 13 将说明 [State] 对象的生命周期。
方法 [build]:
- 第 106 行:根据主题计算出的文本样式——中号标题样式([titleMedium]),加粗。[copyWith] 创建一个属性被修改过的对象副本:这是 [Flutter] 的一个惯例,我们会经常看到。[!] 告诉 [Dart] 该值不是 [null]([titleMedium] 的类型是 [TextStyle?],即一个样式,或 [null]);
- 第 109–111 行:[Title] 组件提供应用的标题:在 Web 上,它是浏览器标签页的标题;在 [Android] 上,它是最近应用列表中显示的名称。在 [React] 中要用 effect([useEffect])来修改 [document.title] (在页面显示之后),而 [Flutter] 不需要任何特殊处理:标题就是一个组件,和屏幕的其余部分一样由 [build] 描述,并且会自动更新其状态;
- 第 115 行:[ListView] 是一个列,超出屏幕高度时会 滚动 。在手机上,这几乎总是你所需要的:一个过高的 [Column] 会被截断(并且 [Flutter] 会显示黄黑相间的条带,表示“溢出”);
- 第 124–127 行:一个输入字段([TextField]):它的控制器、它的标签([decoration: InputDecoration(labelText: ...)]),以及 [onChanged],即每次按键时调用的函数,并附带新的文本;
- 第 130–135 行:价格。[keyboardType] 选择手机的键盘:这里是数字键盘,包括逗号。输入的文本由 [double.tryParse] 转换为数字,如果文本不是数字,则返回 [null] ([?? 0]:此处为 0)。把法语的小数逗号替换为句点后,它也能被接受;
- 第 138–147 行:数量,带有两个按钮“–”和“+”。[Row] 把它的子组件并排放置;[Expanded] 让它的子组件占满剩余的全部宽度。[IconButton]:只有图标的按钮。[onPressed: null] 会禁用 按钮:数值不能低于 0;
- 第 152–159 行:增值税税率,三个“分段”按钮,只能选中其中一个。[selected] 接收一个值的 集合 ([{_vatRate}]:只含一个元素的 [Set] ),[onSelectionChanged] 接收新的选中集合;
- 第 173–177 行:结果:由 [_line] 方法生成的三行;
- 第 190 行:历史记录中的每个元素对应一行文本,由一个 [for] 循环生成,该循环直接写 在 子组件列表中(见示例 03);
- 第 202–208 行:一个创建组件的方法。[{TextStyle? style}]:可选的命名参数,如果未提供,则默认为 [null] 。把一个 [build] 拆分为若干方法可以提高可读性;示例 10 将表明,更好的做法通常是把它们变成真正的组件。
我们依次修改价格、数量和税率,然后修改商品:
![]() | ![]() |
每当含税总额发生变化时,历史记录中就会增加一行。更改商品会把数量重置为 1(见右图)。
与 [React] 的区别在于一个细节:[React] 体现的是组件的 行为,它每次都会重新创建其变量;因此状态必须通过 [useState] 单独存储。在 [Flutter] 中,状态存在于一个 对象 ([State])中,它只创建一次并被保留:状态就是它的字段,而 [build] 只是它的一个方法。因此,我们既不需要 Hook,也不需要它们的规则(例如不能在条件中调用它们,或管理它们的依赖项)。黄金法则保持不变:我们只在 [setState] 中修改状态,而 [build] 只是根据状态描述屏幕。
3.3. 示例 03:编写组件树
在 [Flutter] 中没有模板语言:屏幕是用 [Dart] 编写的。对于条件和循环,[Dart] 提供了创建子组件列表的工具。这个示例显示一个可以过滤的医生列表:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 | |
- 第 24 行:一个 枚举:专业只有三个可能的值([Specialty.pediatrician]……);
- 第 28–36 行:一个数据类。它的字段是 [final]:一个 [Doctor] 永远不会改变。构造函数 [Doctor(this.id, this.title, ...)] 直接把它的参数赋给同名的字段。它是 [const] 的:可以创建常量医生(第 39 行);
- 第 47–50 行:“根据某个值,在多个值中取其一”:一个 [switch] 表达式 (不是语句),它有一个值。每个分支写成 [pattern => value]。对于枚举,编译器会验证所有情况都已处理:新增一个专业而不补全这个 [switch] 会导致编译错误;
- 第 53–56 行:选择图标时也是同样的原理;模式 [_] 表示“所有其他情况”。在 [Material Design] 中,图标是类 [Icons] 的常量;
- 第 77–79 行:屏幕的状态。
方法 [build]:
- 第 84–91 行:显示的列表:一个在每次调用 [build] 时重新计算的变量。[where] 保留满足条件的元素;[toList()] 把结果转换为列表;
- 第 94–100 行:三个可能的值之一,通过 [if] 在 [return] 之前选定。组件是和其他值一样的值:可以存放在变量中。[final Widget content;] 声明变量但不初始化:编译器会验证每个分支恰好给它赋一次值;
- 第 103–117 行:列表。一个 `[for]` 直接写 在 列表字面量(`[children: [ ... ]]`)中时,会在每次循环迭代时向其中添加一个元素:这就是“集合 for”。[displayed.indexed] 返回元组(序号、医生),[(i, m)] 把它“解包”为两个变量;
- 第 106 行:[Opacity] 使其子组件部分透明:不可用的医生显示为灰色。该值由运算符 [? :] 计算得出;
- 第 108–112 行:[ListTile] 是 [Material Design] 的列表项:包括头部元素([leading],这里是显示序号的圆盘)、标题、副标题和末尾元素([trailing])。这些全都是组件:可以是任意组件。副标题是一个 [Wrap]:一种在空间不足时换行到下一行的 [Row] (在手机上,图标和专业不一定能与“可用”标签并排放下);
- 第 117–120 行:一个“标签”([Chip]),其文本和颜色取决于医生。[Colors.green.shade100]:浅绿色。
[return]:
- 第 131 行:一张随应用一起提供的 SVG 图像(文件夹 [assets/],在 [pubspec.yaml] 中声明)。[Flutter] 无法自行渲染 SVG:[flutter_svg] 包提供了 [SvgPicture] 组件。对于 PNG 或 JPEG 图像,[Flutter] 有 [Image.asset] 组件;
- 第 138–139 行:搜索字段。[hintText] 是字段为空时显示的灰色文本;[prefixIcon] 是左侧的图标。这一次没有控制器:我们只需要输入的值,通过 [onChanged] 接收;
- 第 142–145 行:一个开关,带有其标签:一个点按即可切换的列表项;
- 第 150 行:一个直接写在参数中的匿名函数:它切换状态;
- 第 155–160 行:一个“if 集合”:帮助卡片 只有 当 [_showHelp] 为 true 时才存在。不存在“隐藏”的组件:条件为 false 时,子组件列表就少了一项;
- 第 163 行:先前选定的内容;
- 第 167–168 行:一个计算得出的样式:文本大小取决于所显示的医生数量。
小结一下 [Dart] 中的这些工具,在子组件列表中,它们取代了其他框架在模板中编写的内容:
在 Dart 中 | 作用 |
if (condition) widget | 仅当条件为 true 时才存在的子组件 |
if (c) widgetA else widgetB | 二者择一 |
condition? widgetA : widgetB | 在表达式中二者择一 |
for (final x in list) widget | 列表中每个元素对应一个子组件 |
...otherList | 另一个列表的元素,插入到此处 |
...[widgetA, widgetB] | 一次添加多个子组件(常用在 `if` 语句之后) |
switch (value) { pattern => widget } | 根据某个值,在多个子组件中选择一个 |
启动时,然后输入“gen”并隐藏帮助后,再输入“xyz”时:
![]() | ![]() | ![]() |
3.4. 示例 04:事件
交互式组件接收 函数 作为参数,在发生某些事情时调用;这些函数通常被称为“回调”。这个示例管理一个待办事项列表:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 | |
- 第 23–28 行:一个任务。[done] 不是 [final]:我们会修改它。[{this.done = false}]:一个带默认值的可选命名参数;
- 第 49–53 行:状态:任务列表和一份事件日志;
- 第 56–57 行:为了在代码中操作输入字段,与它关联了两个对象:一个 控制器 ([TextEditingController]),用于访问它的文本,以及一个 [FocusNode],用于访问它的 焦点 (闪烁的光标和手机键盘,字段获得焦点时键盘会弹出);
- 第 60 行:[State] 对象中一个不显示的字段:修改它不需要 [setState]。这就是 [React] 所说的“引用”([useRef]);在 [Flutter] 中,它就是一个普通字段;
- 第 63–66 行:控制器和 [FocusNode] 会在屏幕消失时被释放;
- 第 69–71 行:在日志顶部增加一行。[TimeOfDay] 是来自 [Flutter] 的一天中的时间;[format(context)] 按照应用语言的惯例对其进行格式化;
- 第 75–86 行:添加任务,由按钮和键盘上的 Enter 键触发。我们读取控制器中的文本([_field.text]),添加任务(在 [setState] 中),清空字段([_field.clear()]),并把焦点还给它([_focus.requestFocus()]):现在可以输入下一个任务了;
- 第 89–92 行:勾选或取消勾选一个任务:我们直接修改 [Task] 对象本身,在 [setState] 中进行。与 [React] 不同,这里不需要创建新列表:[setState] 会通知 [Flutter] 状态已经改变,而不管它是如何改变的;
- 第 96–99 行:删除,可以通过按钮,也可以通过滑动(见下文);
- 第 104–106 行:点按底部区域时调用的函数。它接收事件的 详细信息:此处是 [localPosition],即手指相对于被点按组件的位置。
方法 [build]:
- 第 121–122 行:[CallbackShortcuts] 为物理键盘(计算机、模拟器、带键盘的平板)把键盘快捷键与函数关联起来:Esc 键清空字段。[{ key: function }] 是一个 [Map] 字面量;
- 第 124–129 行:输入字段,与其控制器和 [FocusNode] 相关联。[textInputAction] 选择手机键盘上的“Enter”键;[onSubmitted] 在按下该键时被调用,并附带文本(这里没有用到它:按惯例,该参数命名为 [_]);
- 第 134 行:按钮调用同一个方法;
- 第 138–151 行:每个任务一行,放在 [Dismissible] 中:这个组件可以用手指 滑动 来删除,这是手机上列表的典型手势。[direction]:只能向左;[background]:滑动期间出现在该行下方的内容(红色背景上的垃圾桶图标);[onDismissed]:当该行被滑出屏幕时调用的函数;
- 第 143 行:key 用于 [Dismissible]。当组件列表发生变化时,[Flutter] 会把旧列表与新列表比较,以确定保留哪些组件:没有 key 时,它按序号配对(第一个对第一个,第二个对第二个,依此类推)。如果第一个任务消失,第二个任务就会取代它的位置……并带着第一个任务的状态。key 赋予每个组件一个 标识:[Flutter] 随后按 key 来匹配组件。key 在兄弟组件之间必须唯一且稳定:应使用任务的标识符,而不是它的序号。[Dismissible] 必须有 key;
- 第 152–157 行:带复选框的列表项。[controlAffinity] 把复选框放在左侧。[onChanged] 接收复选框的新值,类型为 [bool?] (复选框可以有第三种状态,“未确定”):[!] 表示它不是 [null];
- 第 160 行:标签的样式取决于任务:已完成则带删除线并显示为灰色,否则使用默认样式([null]);
- 第 163–165 行:一个“垃圾桶”按钮。匿名函数 [() => _remove(t, 'button')] 允许传递参数:即 这一 行上的任务;
- 第 171–174 行:[GestureDetector] 让 任何 组件都能响应手势:点按([onTap]、[onTapDown]……)、双击、长按、滑动、捏合……这里,一个简单的彩色方框([Container])响应三种手势;
- 第 175–178 行:[Container] 是一个方框,可指定边距、背景、边框、大小和对齐方式。[decoration] 描述它的背景:颜色、圆角。[Color(0xFFE7F5FF)]:用 ARGB 代码指定的颜色(不透明度 FF,然后是红、绿、蓝);
- 第 184 行:日志。
添加一个任务,勾选第二个任务,点按底部区域;然后把第一个任务向左拖动(拖动过程中位于中间;该行被移除后位于右侧):
![]() | ![]() | ![]() |
在 [React] 中,浏览器事件([click]、[keydown]……)对所有元素都相同;在 [Flutter] 中,每个交互式组件声明自己的事件,带有类型化的参数([onPressed]、[onChanged]、[onSubmitted]……),而 [GestureDetector] 为没有手势的组件添加手势。知道每个组件有哪些参数的编辑器会在你输入时给出提示。
3.5. 示例 05:所有类型的字段
这个示例使用课程 [React] 的示例 05 中的表单,并使用 [Flutter] 的输入字段:文本框、单选按钮、复选框、下拉列表、项目符号列表、滑块和日历。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 | |
一个 受控 字段显示来自状态的值,并把任何更改通知组件([onChanged]),组件据此更新状态:状态是唯一的事实来源。这一点适用于 [Flutter] 中的所有字段……文本框除外,它们把文本存放在控制器中。
- 第 39–41 行:[Flutter] 自身的文本(日历的星期和月份、其窗口中的“OK”和“CANCEL”按钮)默认是英文的。我们声明应用的语言([supportedLocales])、所选语言([locale]),以及为 [Flutter] 提供翻译的“委托”(delegate),位于 [flutter_localizations] 包中。示例 21 将再次讨论这一点;
- 第 56–66 行:每个字段对应一个状态。[final _name = TextEditingController()]:对于文本字段,状态就是控制器本身;[Set<String>]:爱好和语言的集合(无重复项);[DateTime? _birthDate]:一个日期,或者 [null] (在选定日期之前);
- 第 69–74 行:[initState] 只在 [State] 对象创建时调用一次(见示例 13)。控制器会把文本的每一次更改 通知 给它的监听器([addListener]):屏幕会重绘,使底部显示的模型跟上输入。[setState(() {})]:无需更改任何内容,只需重绘;
- 第 87 行:采用 [RdvMedecins] API 格式的日期,“2026-10-05”。[_birthDate?.toIso8601String()]:[?.] 运算符仅在 [_birthDate] 不是 [null] 时才调用该方法(否则结果为 [null]);
- 第 90–100 行:所有的值,合并成一个 [Map] (它将被发送到服务器)。[int.tryParse(_age.text)]:年龄,或者 [null] (如果该字段不是数字);
- 第 105–113 行:出生日期从日历窗口中选择。[showDatePicker] 打开该窗口,并返回一个 [Future]:即选定的日期,稍后在用户关闭窗口时给出(如果用户没有做出选择就关闭了窗口,则为 [null] )。该方法是 [async] 的:[await] 会等待 [Future] 完成,而不阻塞应用。凡是需要等待的地方(窗口、服务器),都使用这一机制;
- 第 118–126 行:状态 由代码修改:字段随之变化。对于文本框,我们写入其控制器。[..clear()..addAll([...])]:这是 [Dart] 的“级联”写法,即对同一个对象进行多次方法调用;
- 第 132 行:[jsonEncode] (来自 [dart:convert])根据 [Map] 创建 JSON。
字段位于 [build] 中:
- 第 146–151 行:单选按钮。[RadioGroup] 包含选中的值([groupValue])以及选中另一个值时调用的函数([onChanged]);它包含各个按钮 [Radio],每个按钮有自己的值。[...[a, b, c]] 一次插入多个组件:为每个标题生成一个按钮、它的标签和一个间隔;
- 第 160–169 行:两个文本字段并排放在一个 [Row] 中。[Expanded(flex: 2, ...)]:姓名占用的空间是年龄的两倍。年龄字段使用数字键盘;
- 第 178–186 行:一个 非受控 字段:[TextFormField] 可以接收初始值([initialValue])来代替控制器,并自行管理它的文本。每次按键时文本都会更新,但不使用 [setState]:不会重绘任何内容。[Focus] 组件会在其子组件获得或失去焦点时发出通知([onFocusChange]):只有在离开该字段时才会重绘。这相当于 HTML 的 [blur] 事件;
- 第 190–195 行:一个单独的复选框及其标签;
- 第 199–206 行:针对同一个集合的多项选择:用于选择的标签([FilterChip])。如果集合包含某个标签的值,该标签即为选中状态;点按它会添加或移除该值。[Wrap] 把它的子组件并排放置,空间不足时换到下一行;
- 第 216–222 行:一个下拉列表。[value] 指定选中的是哪一项;[items] 列出各项,每项带有其值和组件。[for (final MapEntry(key: code, value: name) in countries.entries)] 遍历 [Map] [countries] 的各个条目 ,把每个条目“解包”为两个变量,[code] 和 [name];
- 第 230–234 行:所说的语言,也用标签列出。(在 [Flutter] 中没有多选列表:标签或复选框就起这个作用);
- 第 244–249 行:一个滑块,范围从 1 到 5,分为四个区间([divisions])。它的值是一个 [double];
- 第 254–259 行:出生日期和打开日历的按钮;
- 第 278–279 行:实时显示的模型:它的 JSON,缩进两个空格,使用随应用一起提供的等宽字体;
- 第 283–289 行:只有在发送消息之后才出现的块:[if] 后接 [...[ ]] 会插入若干个组件,或者一个也不插入。
你选择称谓、姓名、爱好和语言;然后打开日历;然后发送:
![]() | ![]() | ![]() |
下表总结了每种字段向其对应的函数 [onChanged] 传递的内容:
字段 | 传递的值 |
TextField, TextFormField | String(文本);或者读取控制器 |
Checkbox, CheckboxListTile | bool?(已选中、未选中或未确定) |
Switch, SwitchListTile | bool |
Radio(位于 RadioGroup 中) | 所选按钮的值(T?) |
DropdownButton<T> | 所选元素的值(T?) |
FilterChip | bool:该标签是否被选中? |
SegmentedButton<T> | Set<T>:所选的值 |
Slider | double |
showDatePicker | Future<DateTime?>:所选的日期,稍后给出 |
3.6. 示例 06:表单、对象、归约器
示例 05 为每个表单字段都设置了一个状态字段。对于真正的表单,我们更倾向于使用 一个 对象来包含所有的值——即 模型——并在一个函数中描述它的变化,也就是 归约器:[reducer(currentState, action) -> newState]。这就是 Hook [useReducer] 在 [React] 中所做的事;在 [Flutter] 中,无需导入任何东西:[Dart] 提供了所需的一切。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 | |
模型:
- 第 30 行:表单中每个字段的名称;
- 第 34–43 行:表单数据:一个 不可修改 的对象,其所有字段都是 [final] 的;
- 第 45–54 行:一个带命名参数的构造函数,所有参数都是必需的([required]);
- 第 59–79 行:要“修改”一个不可修改的对象,就创建一个副本,其中某些字段被更改:这就是方法 [copyWith],它是 [Flutter] 的一种惯用写法(我们在 [TextStyle] 中遇到过)。每个参数都是可选的([String? title]:一个字符串或 [null]);[title ?? this.title]:如果提供了新值就用新值,否则用旧值;
- 第 84–93 行:以名称指定的字段的值:一个针对该枚举的 [switch] 表达式;
- 第 97–106 行:一个副本,其中以名称指定的某一个字段有了新值。[v as String]:收到的值(类型为 [Object],可以是任何东西)被转换为字符串;如果它不是字符串,就会导致运行时错误;
- 第 109 行:一个 [Map] “字段名 -> 值”,由一个 [for] 在 [Map] 字面量内创建。[c.name]:枚举值的名称(“firstName”);
- 第 112–121 行:初始值;
- 第 125–129 行:完整的状态:各个值,以及所有已经处理过(“触碰过”)的字段。
动作与归约器:
- 第 134–154 行:可能的动作:一个 密封 类([sealed])及其四个子类。[sealed] 告诉编译器,除了此文件中的子类之外没有其他子类。一个动作 描述发生了什么:[Edit(Field.lastName, 'Dupont')], [Leave(Field.lastName)]……;
- 第 160–167 行:归约器。它是一个 纯函数:相同的输入,相同的输出,没有副作用;它从不修改收到的状态,而是返回一个新状态。[switch] 作用于动作,每个分支都是一个 模式 ,用来测试其类型:[Edit(:final field, :final value)] 验证该动作是一个 [Edit],并把它的 [field] 和 [value] 字段 存入同名变量。由于该类是密封的,编译器会验证全部四个动作都已处理;如果增加第五个动作而不补全归约器,就会导致编译错误;
- 第 162 行:一个新的集合,由旧集合的元素([...state.touched])和刚离开的字段组成。
屏幕:
- 第 193 行:屏幕的状态:只有一个字段,即对象 [ProfileState];
- 第 195 行:每个文本字段的控制器,保存在一个 [Map] 中,该 Map 由一个 [for] 创建;
- 第 206–213 行:修改状态的唯一方法:描述发生了什么。[_dispatch](这是 [React] 给它起的名字) 使用归约器计算新状态,在 [setState] 中进行。然后,由于归约器可能修改了某些文本(Uppercase、Reset),这些值会被复制到尚未拥有它们的控制器中;
- 第 221–223 行:值 由状态派生 :如果字段的值与初始值不同,则该字段已被修改;不订阅 newsletter 时,电子邮件被禁用;只要有任一字段被修改,表单就被视为已修改([any])。[Field.values]:枚举值的列表;
- 第 226–237 行:一个创建与模型关联的文本字段的方法:它的控制器、它的禁用状态([enabled]),以及两个动作:[Edit] 对应每次按键,[Leave] 对应字段失去焦点;
- 在 [build] 中,每个字段 描述 它的更改,使用的是动作:[_dispatch(Edit(Field.title, t!))], [_dispatch(const Uppercase())]……;
- 第 320–338 行:一个表格([DataTable]),带有列和行:每个被跟踪字段的状态;
- 第 344–349 行:由若干种不同样式的部分组成的文本:[Text.rich] 及其 [TextSpan]。
我们修改姓名,离开该字段,并订阅 newsletter;然后把姓名首字母大写:
![]() | ![]() |
表单的全部逻辑都包含在归约器中——一个只有几行、不含任何组件的函数——它可以单独测试。组件现在只负责显示状态并描述发生了什么。
3.7. 示例 07:手动验证表单
一个 纯 函数 [validate(account)] 返回各字段的错误;每次执行 [build] 时都会调用它,因此错误始终是最新的。它们不会立即显示(一个满是红色的空表单会让人不舒服),只对已经离开过的字段显示。提交表单会显示所有错误。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 | |
- 第 24 行:输入的账户是一个 记录(record):一小组具名的值,无需编写类。[typedef] 为它指定一个名称。记录写成 [(title: 'Mr', firstName: 'Marie', ...)] ,读取方式为 [account.firstName];
- 第 27–28 行:一个正则表达式(登录名的格式)和一个常量:规则与 [RdvMedecins] 服务器相同;
- 第 32–59 行:规则:一个只依赖其参数的纯函数,返回一个 [Map] “出错字段 → 消息”。最后一条规则比较两个字段:确认密码和密码;
- 第 82–84 行:每个文本字段一个验证器;
- 第 86 行:已经离开过的字段;
- 第 99–105 行:账户,按输入时的样子:根据验证器按需生成的记录。[_texts[Field.firstName]!]:访问 [Map] 会返回一个值或 [null] (键可能不存在);[!] 确认它存在;
- 第 108–113 行:提交会把所有字段标记为已触碰(错误随之出现),然后仅在表单有效时才采取行动;
- 第 120 行:在 [build] 中,错误每次都会重新计算;它们从不存储在状态中;
- 第 123 行:一个局部函数:要 显示 的某个字段的错误,仅当该字段被触碰过时才有;
- 第 126–142 行:一个创建字段的局部函数。[InputDecoration] 知道如何显示错误:[errorText]。当它不是 [null] 时,字段会被红色轮廓框住,并在其下方显示消息(最多两行:[errorMaxLines])。[suffixIcon]:字段右侧的图标——这里是用于已填写且有效字段的绿色对勾。[obscureText] 会遮蔽密码的字符;
- 第 165–168 行:表单末尾的消息;
- 第 176–187 行:一个小型私有组件,避免把同一个彩色方框重复写两次。
填写几个字段,然后提交;再把所有内容改正,重新提交:
![]() | ![]() |
注意:这种验证只是为用户提供的 便利 ——无需与服务器往返通信即可立即得到响应。它不保护任何东西:任何人都可以向服务器发送手工构造的请求([curl]……),而移动应用的代码也可以被修改。因此服务器始终会重新验证一切(见示例 25)。
3.8. 示例 08:Flutter 表单、Form 和 FormField
示例 07 中的表单,使用由 [Flutter] 自身提供的工具编写。[React] 需要一个库([React Hook Form]),而 [Flutter] 有自己的表单组件:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 | |
- 第 46 行:一个 [Form] 包含若干表单字段。要在代码中与它交互(验证、保存),我们给它分配一个 全局 key,即 [GlobalKey]:一个能让你访问组件树中某个组件状态的对象([_formKey.currentState]);
- 第 48 行:某一个字段的 key,以便单独对它重新验证;
- 第 50 行:密码的控制器:确认密码的规则必须读取它;
- 第 52 行:提交时保存的值;
- 第 62–69 行:[validate()] 验证所有表单字段,显示出现的错误,如果一切正确则返回 [true] 。[save()] 随后对每个字段调用函数 [onSaved] ,由它设置该字段的值;
- 第 73–77 行:规则生成器。验证规则([FormFieldValidator])是一个接收字段值的函数,如果值有效则返回 [null] ;否则返回错误消息。[_required('...')] 创建一条规则;[_maximum(20, other)] 创建一条规则,它先应用规则 [other],再应用它自己的规则([??]:如果第一条规则没有发现问题);
- 第 83 行:表单及其 key;
- 第 89–94 行:一个同时也是表单字段的下拉列表。[initialValue]:它的初始值;此后,该字段自行管理其值;
- 第 96–100 行:[TextFormField] 就是一个 [TextField] ,同时也是一个表单字段:它有一条规则([validator])、一个保存函数([onSaved]),以及一种自动验证模式:[AutovalidateMode.onUserInteraction] 会在用户一修改字段时就验证它,此后每次按键都会验证;
- 第 112–117 行:一条直接写出的规则,带有两项测试;
- 第 132–134 行:密码更改时,如果确认密码已经输入过,就用该字段的 key 对确认密码重新验证;
- 第 144 行:一条读取另一个字段的规则。
输入一些不正确的值并提交;然后改正它们:
![]() | ![]() |
该选择这两种方法中的哪一种?[Form] 和 [TextFormField] 足以应对规则写在应用中的表单。但在本课程中,服务器的规则优先:案例研究的应用中没有任何规则,而是在每个字段下方显示服务器返回的错误(示例 25)。这就是示例 07 中使用的方法,它涵盖了字段及其错误。
3.9. 示例 09:格式化值
表格的每一行显示一段代码及其显示结果。
3.9.1. 格式化函数
[Flutter] 没有内置的格式化机制(即 [Angular] 中的“管道”):在 [build] 中,我们调用保存在一个文件中的标准函数,这些函数可以单独测试:
- 第 16–22 行:一个时间段,如 [RdvMedecins] 的 API 中所描述:小时和分钟,均为数字;
- 第 28 行:“8:05”而不是“8:5”:[padLeft(2, '0')] 在左侧补零;
- 第 31–34 行:一个带有 可选位置 参数(在方括号中)的函数,以及它的默认值:[timeRange(c)] 或 [timeRange(c, Part.start)];
- 第 38–47 行:一个 扩展:它为 [String] 类型添加方法(这里是 getter),作用于所有字符串:['marie pelissier'.capitalized]。这是 [Dart] 的一个特色,对格式化非常有用。[replaceAllMapped] 把每个单词(由带重音或不带重音的字母组成的序列:[\p{L}+] 配合 [unicode: true])替换为函数的返回值;
- 第 51 行:“2026-10-05”(API 的格式)-> 一个日期([DateTime])。
3.9.2. 屏幕
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 | |
- 第 21–25 行:来自 [intl] 包的日期格式化器。[DateFormat] 包含“预定义”格式,由要显示的部分来标识:[yMMMd] (年、缩写的月、日)、[yMMMMEEEEd] (外加完整的星期几)、[Hms] (时、分、秒)……你也可以指定一个模式:['MM/dd/yyyy HH:mm']。第二个参数是语言;
- 第 27–29 行:数字格式化器:金额、整数、百分比;
- 第 40–42 行:每种语言的星期和月份名称默认并不加载:[initializeDateFormatting] 会在 [runApp] 之前加载它们。[main] 可以是异步的;
- 第 65–83 行:表格:一个由 位置式 记录 [(code, value)] 构成的列表,不带字段名;
- 第 93–111 行:[Table] 绘制一个简单的表格。[columnWidths]:第一列占宽度的 55%;[border]:行与行之间的线。[for (final (code, value) in rows)] 拆解每一条记录;
- 第 124 行:遍历 [Map] 中的条目:[:key] 是 [key: key] 的简写;
- 第 127 行:自定义函数。
![]() | ![]() |
对于日期、数字和金额,[intl] 的作用与 Web 浏览器中的 [Intl] API 相同:它理解每种语言的惯例(分隔符、月份名称、各部分的顺序)。该表使用美式英语的惯例(€1,234.50、“month day, year”);请注意,在法语中,千位用细的不换行空格分隔(1 234,50 €),顺序是“日 月 年”([frenchDay] 一行)。




















