1. Giới thiệu
Dart 3 giới thiệu mẫu cho ngôn ngữ, một danh mục ngữ pháp chính. Ngoài cách viết mã Dart này, Dart 3 còn có một số điểm cải tiến khác về ngôn ngữ:
- Bản ghi để gộp dữ liệu thuộc nhiều loại khác nhau.
- Đối tượng sửa đổi lớp (chẳng hạn như
sealed) để kiểm soát quyền truy cập và bật tính năng kiểm tra tính đầy đủ. - Biểu thức switch, câu lệnh if-case và mệnh đề bảo vệ nâng cao.
Các tính năng này mở rộng các lựa chọn của bạn khi viết mã Dart. Trong lớp học lập trình này, bạn sẽ cộng tác với Google Antigravity để tìm hiểu cách sử dụng các hàm này nhằm giúp mã của bạn gọn gàng, hợp lý và linh hoạt hơn.
Sản phẩm bạn sẽ tạo ra
Trong lớp học lập trình này, bạn sẽ cộng tác với Google Antigravity để xây dựng một ứng dụng hiển thị tài liệu JSON có cấu trúc trong Flutter. Ứng dụng mô phỏng JSON đến từ một nguồn bên ngoài chứa siêu dữ liệu tài liệu (tiêu đề và ngày sửa đổi) và các khối nội dung (tiêu đề, đoạn văn và hộp đánh dấu việc cần làm).
Bạn sẽ nhắc Antigravity đóng gói dữ liệu vào các bản ghi để có thể chuyển và giải nén dữ liệu ở bất cứ nơi nào tiện ích Flutter cần, sử dụng các mẫu để xác thực và phân rã dữ liệu JSON thành các biến cục bộ, đồng thời kết hợp biểu thức switch với các lớp sealed để tạo tiện ích phù hợp cho từng khối nội dung.

Hành trình học tập của bạn
Lớp học lập trình này sẽ hướng dẫn bạn từng bước xây dựng trình xem tài liệu:
- Thiết lập môi trường Flutter – Định cấu hình SDK Flutter và Google Antigravity cho nền tảng mục tiêu.
- Tạo dự án – Nhắc Antigravity tạo khung
patterns_codelabbằng dữ liệu JSON mô phỏng tronglib/data.dartvàDocumentScreenkhởi đầu tronglib/main.dart. - Tạo và trả về bản ghi – Trả về nhiều giá trị thuộc nhiều loại khác nhau từ phương thức getter bằng cách sử dụng bản ghi và đọc các trường vị trí và trường được đặt tên của bản ghi đó.
- Khớp và phân rã bằng mẫu – Trực tiếp giải nén các trường bản ghi vào biến cục bộ bằng cách sử dụng nội dung khai báo biến mẫu và viết tắt trường.
- Sử dụng mẫu để trích xuất dữ liệu – Xác thực và trích xuất các giá trị JSON lồng nhau một cách an toàn bằng cách sử dụng các mẫu bản đồ
if-casecó thể bác bỏ. - Chuẩn bị ứng dụng cho nhiều mẫu hơn – Phân tích cú pháp một mảng JSON thành các thực thể
Blockbằng cách sử dụng mẫu bản đồ và giá trị cố định danh sách collection-for. - Sử dụng mẫu để hiển thị tài liệu – Hiển thị các mục
Blocktrong giao diện người dùng bằng cách sử dụng câu lệnhswitchnâng cao với mẫu logic-or và mẫu ký tự đại diện. - Sử dụng biểu thức switch – Chuyển đổi câu lệnh
switchthành biểu thứcswitchngắn gọn để trả về trực tiếp một giá trị. - Sử dụng mẫu đối tượng – So khớp với các thuộc tính
Durationvà áp dụng mệnh đề bảo vệwhenđể định dạng ngày tương đối mà con người có thể đọc được. - Niêm phong một lớp để chuyển đổi toàn diện – Tái cấu trúc
Blockthành một hệ phân cấp lớpsealedđể trình phân tích Dart thực thi việc chuyển đổi toàn diện trên mọi loại phụ của khối.
Kiến thức bạn sẽ học được
- Cách cộng tác với Google Antigravity để xây dựng và tuỳ chỉnh lặp lại trình xem tài liệu Flutter bằng các tính năng ngôn ngữ Dart 3.
- Cách tạo bản ghi lưu trữ và trả về nhiều giá trị thuộc nhiều loại.
- Cách sử dụng mẫu để so khớp, xác thực và phân rã dữ liệu từ bản ghi, bản đồ và đối tượng.
- Cách liên kết các giá trị khớp mẫu với các biến cục bộ mới.
- Cách sử dụng các chức năng nâng cao của câu lệnh
switch, biểu thứcswitch, mệnh đề bảo vệ (when) và câu lệnhif-case. - Cách tận dụng tính năng kiểm tra tính đầy đủ với các lớp
sealedđể đảm bảo mọi trường hợp đều được xử lý trong câu lệnhswitchhoặc biểu thứcswitch.
Điều kiện tiên quyết
Lớp học lập trình này giả định rằng bạn đã quen thuộc với Flutter và Dart. Nếu bạn cảm thấy hơi bỡ ngỡ, hãy cân nhắc việc ôn lại kiến thức cơ bản bằng các tài nguyên sau:
2. Thiết lập môi trường Flutter
Người chỉnh sửa
Lớp học lập trình này sử dụng Google Antigravity làm môi trường phát triển ưu tiên AI. Trong mỗi bước, bạn sẽ nhắc Antigravity tạo hoặc phát triển các thành phần của ứng dụng, xem xét các khái niệm chính về mẫu và bản ghi Dart 3 trong mã được tạo, đồng thời tuỳ ý khám phá các biến thể.
Cài đặt Flutter
Hướng dẫn mới nhất về cách cài đặt Flutter SDK luôn có trên docs.flutter.dev.
Đối với lớp học lập trình này, hãy cài đặt phần mềm sau:
- Flutter SDK
- Google Antigravity đã bật trình bổ trợ chính thức cho Dart và Flutter (có trong Plugin Marketplace (Thị trường trình bổ trợ) trong phần Xây dựng bằng Google).
- Phần mềm trình biên dịch cho mục tiêu phát triển mà bạn chọn (ví dụ: Visual Studio để nhắm đến Windows, Xcode để nhắm đến macOS hoặc iOS, hoặc Chrome để nhắm đến web).
Để xác minh rằng môi trường của bạn đã được thiết lập cho mục tiêu triển khai đã chọn, hãy chạy flutter doctor:
flutter doctor
3. Tạo dự án
Trước khi tìm hiểu sâu về mẫu, bản ghi và các tính năng khác của Dart 3, hãy yêu cầu Antigravity tạo một dự án Flutter có hai tệp Dart mà bạn sẽ phát triển trong suốt lớp học lập trình này:
lib/data.dart, chứa tài liệu JSON mô phỏng và lớp dữ liệuDocument.lib/main.dart, chứa các tiện ích Flutter hiển thị tài liệu.
Yêu cầu Antigravity tạo dự án
- Chạy Google Antigravity rồi mở một thư mục trống mà bạn muốn dùng để tạo dự án (chọn một đường dẫn không yêu cầu đặc quyền cấp cao hoặc không chứa dấu cách, chẳng hạn như một thư mục trong thư mục gốc hoặc
C:\src\). - Trong bảng trò chuyện của tác nhân Antigravity, hãy gửi câu lệnh sau để tạo dự án Flutter và thiết lập
lib/data.dartvàlib/main.dart:
Create a new empty Flutter project named `patterns_codelab` with a minimum Dart SDK constraint of `^3.0.0`, and add the `material_ui` package. Create `lib/data.dart` with a `Document` class that decodes a multi-line `documentJson` constant (containing a `"metadata"` object with `"title": "My Document"` and `"modified": "2023-05-10"`, and a `"blocks"` list with an `"h1"` header `"Section 1"`, a `"p"` paragraph `"Lorem ipsum dolor sit amet, consectetur adipiscing elit."`, and an unchecked `"checkbox"` `"Learn Dart 3"`) into a `final Map<String, Object?> _json` field. Then update `lib/main.dart` (importing `package:material_ui/material_ui.dart`) to run a `DocumentApp` widget whose home is `DocumentScreen(document: Document())`, rendering a `Scaffold` with placeholder `'Title goes here'` and `'Body goes here'` text.
Tìm hiểu về mã được tạo
Phiên bản SDK tối thiểu trong pubspec.yaml
Việc truyền cờ --empty đến flutter create sẽ tạo ra một dự án Flutter tối thiểu mà không có mã nguyên mẫu của ứng dụng bộ đếm mặc định. Trong pubspec.yaml, quy tắc ràng buộc về phiên bản SDK chỉ định Dart 3 trở lên bằng cú pháp dấu mũ:
environment:
sdk: ^3.0.0
Mô phỏng JSON đến trong lib/data.dart
Hãy tưởng tượng một chương trình nhận dữ liệu từ một nguồn bên ngoài, chẳng hạn như luồng vào/ra hoặc yêu cầu HTTP. Trong lib/data.dart, documentJson mô phỏng tải trọng JSON đến bằng một chuỗi nhiều dòng và hàm khởi tạo Document phân tích cú pháp chuỗi đó thành _json bằng jsonDecode:
import 'dart:convert';
class Document {
final Map<String, Object?> _json;
Document() : _json = jsonDecode(documentJson);
}
Giàn giáo DocumentApp và DocumentScreen trong lib/main.dart
Trong lib/main.dart, Antigravity xác định hai tiện ích không có trạng thái:
DocumentAppthiết lập Material Design (package:material_ui/material_ui.dart) để tạo giao diện cho giao diện người dùng.DocumentScreencung cấp bố cục trực quan của trang bằng tiện íchScaffold:
class DocumentScreen extends StatelessWidget {
final Document document;
const DocumentScreen({required this.document, super.key});
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('Title goes here')),
body: const Column(children: [Center(child: Text('Body goes here'))]),
);
}
}
Chạy và kiểm thử ứng dụng
Chạy ứng dụng trên nền tảng mục tiêu mà bạn chọn (chẳng hạn như Chrome, macOS, Windows, Linux, iOS hoặc Android). Bạn sẽ thấy một khung ứng dụng hiển thị văn bản phần giữ chỗ title và body được xác định trong DocumentScreen:

4. Tạo và trả về bản ghi
Trong bước này, bạn sẽ sử dụng một bản ghi để trả về nhiều giá trị từ một lệnh gọi phương thức getter, sau đó truy cập vào các trường của bản ghi trong DocumentScreen để hiển thị các trường đó trong giao diện người dùng.
Yêu cầu Antigravity trả về và đọc một bản ghi
Gửi câu lệnh sau trong Antigravity:
In `lib/data.dart`, add a `metadata` getter to `Document` with return type `(String, {DateTime modified})` that returns a hardcoded record `('My Document', modified: DateTime.now())`. In `lib/main.dart`, call `document.metadata` inside `DocumentScreen.build`, display the positional title field (`metadataRecord.$1`) in the `AppBar`, and display `'Last modified ${metadataRecord.modified}'` in the body.
Tìm hiểu về mã được tạo
Trả về bản ghi từ Document.metadata
Trong lib/data.dart, phương thức getter metadata trả về một bản ghi có hai trường – một trường có kiểu String và trường còn lại có kiểu DateTime:
(String, {DateTime modified}) get metadata {
const title = 'My Document';
final now = DateTime.now();
return (title, modified: now);
}
Câu lệnh trả về tạo một bản ghi mới bằng cách đặt hai giá trị trong dấu ngoặc đơn: (title, modified: now). Trường đầu tiên là trường vị trí và không có tên, còn trường thứ hai có tên là modified.
Truy cập vào các trường bản ghi theo vị trí và tên
Trong lib/main.dart, DocumentScreen.build gán document.metadata cho metadataRecord và đọc các trường của nó bằng cách sử dụng phương thức getter tích hợp sẵn của bản ghi:
@override
Widget build(BuildContext context) {
final metadataRecord = document.metadata;
return Scaffold(
appBar: AppBar(title: Text(metadataRecord.$1)),
body: Column(
children: [
Center(child: Text('Last modified ${metadataRecord.modified}')),
],
),
);
}
- Để lấy một trường vị trí (trường không có tên, chẳng hạn như
title), hãy sử dụng phương thức getter$trên bản ghi (bắt đầu từ$1và bỏ qua các trường có tên). - Các trường được đặt tên như
modifiedkhông có phương thức getter theo vị trí; bạn truy cập trực tiếp vào các trường đó bằng tên trường, chẳng hạn nhưmetadataRecord.modified.
Ví dụ: trong một bản ghi kết hợp các trường được đặt tên và trường vị trí, phương thức getter vị trí chỉ đánh số các trường chưa được đặt tên:
var record = (named: 'v', 'y', named2: 'x', 'z');
print(record.$1); // prints y
print(record.$2); // prints z
Mỗi trường trong bản ghi duy trì kiểu tĩnh: Text() nhận metadataRecord.$1 dưới dạng String, trong khi metadataRecord.modified là DateTime chuyển đổi thành String bằng cách sử dụng phép nội suy chuỗi.
Chạy và kiểm thử ứng dụng
Tải lại ứng dụng để xem tiêu đề và dấu thời gian hiện tại hiển thị trên màn hình:

5. Khớp và phân rã bằng mẫu
Bản ghi có thể thu thập hiệu quả nhiều loại dữ liệu và truyền dữ liệu đó đi. Bây giờ, bạn sẽ cải thiện mã trong DocumentScreen bằng cách sử dụng mẫu.
Mẫu đại diện cho một cấu trúc mà một hoặc nhiều giá trị có thể nhận, giống như một bản thiết kế. Mẫu được so sánh với giá trị thực tế để xác định xem chúng có khớp hay không. Khi một mẫu khớp, mẫu đó có thể phân rã giá trị khớp bằng cách lấy dữ liệu ra khỏi giá trị đó và liên kết các giá trị đó với biến cục bộ.
Nhắc Antigravity phân rã bản ghi
Gửi câu lệnh sau trong Antigravity:
Refactor `DocumentScreen.build` in `lib/main.dart` to destructure `document.metadata` directly into local `title` and `modified` variables using the record pattern shorthand `final (title, :modified) = document.metadata;`, and use `title` and `modified` in the `AppBar` and body `Text` widgets.
Tìm hiểu về mã được tạo
Phân rã một bản ghi thành các biến cục bộ
Thay vì lưu trữ bản ghi trong một biến tạm thời và đọc $1 và .modified, bạn có thể khởi tạo một khai báo biến mẫu:
@override
Widget build(BuildContext context) {
final (title, :modified) = document.metadata;
return Scaffold(
appBar: AppBar(title: Text(title)),
body: Column(children: [Center(child: Text('Last modified $modified'))]),
);
}
Mẫu bản ghi (title, :modified) (viết tắt của (title, modified: modified)) chứa hai mẫu biến khớp với các trường của bản ghi do metadata trả về:
- Biểu thức khớp với mẫu vì kết quả là một bản ghi có hai trường, một trường vị trí và một trường có tên
modified. - Vì chúng khớp nhau, nên mẫu khai báo biến sẽ phân rã biểu thức, truy cập vào các giá trị của biểu thức và liên kết các giá trị đó với các biến cục bộ mới có cùng kiểu và tên:
String titlevàDateTime modified. - Khi tên của một trường được đặt tên và biến điền vào trường đó giống nhau,
:modifiedlà viết tắt củamodified: modified. Nếu muốn có một biến cục bộ có tên khác, bạn có thể viếtmodified: localModified.
Chạy và kiểm thử ứng dụng
Tải lại ứng dụng để xác minh rằng kết quả giống hệt với bước trước, giờ đây được viết bằng mã ngắn gọn và dễ đọc hơn.
6. Sử dụng mẫu để trích xuất dữ liệu
Trong một số bối cảnh nhất định, các mẫu không chỉ khớp và phân rã mà còn có thể đưa ra quyết định về việc mã thực hiện dựa trên việc mẫu có khớp hay không. Đây được gọi là mẫu có thể bác bỏ.
Mẫu khai báo biến mà bạn đã sử dụng ở bước trước là mẫu không thể bác bỏ: giá trị phải khớp với mẫu, nếu không thì sẽ xảy ra lỗi thời gian biên dịch và quá trình phân rã sẽ không diễn ra (giống như bạn không thể gán giá trị cho một biến thuộc loại khác).
Mặt khác, các mẫu có thể bác bỏ được dùng trong ngữ cảnh luồng điều khiển:
- Họ dự kiến rằng một số giá trị mà họ so sánh sẽ không khớp.
- Các câu lệnh này nhằm ảnh hưởng đến luồng điều khiển, dựa trên việc giá trị có khớp hay không.
- Các câu lệnh này không làm gián đoạn quá trình thực thi bằng lỗi nếu không khớp; chúng chỉ chuyển sang câu lệnh hoặc nhánh tiếp theo.
- Các mẫu này có thể phân rã và liên kết các biến chỉ có thể sử dụng trong nhánh mà chúng khớp.
Yêu cầu Antigravity phân tích cú pháp siêu dữ liệu bằng mẫu bản đồ
Gửi câu lệnh sau trong Antigravity:
Update the `metadata` getter in `lib/data.dart` to read and validate the JSON structure using an `if-case` map pattern (`if (_json case {'metadata': {'title': String title, 'modified': String localModified}})`) that returns `(title, modified: DateTime.parse(localModified))` and throws a `FormatException('Unexpected JSON')` otherwise.
Tìm hiểu về mã được tạo
So sánh quy trình xác thực JSON thủ công với mẫu bản đồ
Nếu không có tính năng so khớp mẫu, thì việc đọc và xác thực các giá trị lồng nhau từ _json sẽ yêu cầu nhiều lần kiểm tra lồng nhau và ép kiểu rõ ràng:
(String, {DateTime modified}) get metadata {
if (_json.containsKey('metadata')) {
final metadataJson = _json['metadata'];
if (metadataJson is Map) {
final title = metadataJson['title'] as String;
final localModified = DateTime.parse(
metadataJson['modified'] as String,
);
return (title, modified: localModified);
}
}
throw const FormatException('Unexpected JSON');
}
Với mẫu bản đồ có thể bác bỏ bên trong câu lệnh if-case (được giới thiệu trong Dart 3), bạn có thể xác minh rằng JSON có cấu trúc dự kiến và trích xuất các giá trị trong một bước:
(String, {DateTime modified}) get metadata {
if (_json case {
'metadata': {'title': String title, 'modified': String localModified},
}) {
return (title, modified: DateTime.parse(localModified));
} else {
throw const FormatException('Unexpected JSON');
}
}
Nội dung case chỉ thực thi nếu mẫu bản đồ khớp với dữ liệu trong _json. Mẫu duy nhất này xác thực rằng:
_jsonlà loạiMapvà không phải lànull._jsonchứa một khoá'metadata'._json['metadata']cũng là một loạiMapkhác rỗng._json['metadata']chứa các khoá'title'và'modified'.titlevàlocalModifiedlà các giá trịStringkhông rỗng.
Nếu giá trị không khớp với bất kỳ điều kiện nào trong số đó, thì mẫu sẽ từ chối kết quả khớp và quá trình thực thi sẽ chuyển sang mệnh đề else. Nếu khớp thành công, mẫu sẽ phân rã các chuỗi title và modified khỏi bản đồ và liên kết chúng với các biến cục bộ mới.
Để xem danh sách đầy đủ các mẫu, hãy xem Tài liệu về mẫu trên dart.dev.
Chạy và kiểm thử ứng dụng
Tải lại ứng dụng. Dấu thời gian Last modified hiện phản ánh "2023-05-10" từ documentJson thay vì DateTime.now() và cảnh báo unused_field trên _json đã biến mất.
7. Chuẩn bị ứng dụng cho nhiều mẫu hơn
Cho đến nay, bạn đã xử lý phần metadata của dữ liệu JSON. Trong bước này, bạn sẽ thêm một lớp Block và một phương thức getBlocks() trong lib/data.dart để phân tích cú pháp danh sách blocks từ documentJson để có thể hiển thị danh sách đó trong giao diện người dùng.
Yêu cầu Antigravity phân tích cú pháp danh sách blocks
Gửi câu lệnh sau trong Antigravity:
In `lib/data.dart`, add a `Block` class with `final String type` and `final String text` fields and a `factory Block.fromJson(Map<String, dynamic> json)` constructor that uses an `if-case` map pattern (`{'type': final type, 'text': final text}`) to return a `Block` or throw a `FormatException('Unexpected JSON format')`. Then add a `List<Block> getBlocks()` method to `Document` that matches `_json` against `{'blocks': List blocksJson}` and returns `[for (final blockJson in blocksJson) Block.fromJson(blockJson)]` (or throws a `FormatException('Unexpected JSON format')`).
Tìm hiểu về mã được tạo
Bỏ qua các khoá bổ sung trong mẫu bản đồ (Block.fromJson)
Trong lib/data.dart, hàm khởi tạo nhà máy Block.fromJson() sử dụng câu lệnh if-case có mẫu bản đồ để trích xuất 'type' và 'text':
class Block {
final String type;
final String text;
Block(this.type, this.text);
factory Block.fromJson(Map<String, dynamic> json) {
if (json case {'type': final type, 'text': final text}) {
return Block(type, text);
} else {
throw const FormatException('Unexpected JSON format');
}
}
}
Lưu ý rằng khối thứ ba trong documentJson ("type": "checkbox") cũng bao gồm một khoá "checked": false không được đề cập trong mẫu. Mẫu bản đồ vẫn khớp ngay cả khi bản đồ chứa các khoá bổ sung không có trong mẫu. Các mẫu này xác thực và trích xuất các khoá bạn chỉ định, đồng thời bỏ qua mọi mục bổ sung trong bản đồ.
Đang trích xuất danh sách trong Document.getBlocks
Trong Document, phương thức getBlocks() xác thực rằng _json chứa danh sách 'blocks' và tạo List:
List<Block> getBlocks() {
if (_json case {'blocks': List blocksJson}) {
return [for (final blockJson in blocksJson) Block.fromJson(blockJson)];
} else {
throw const FormatException('Unexpected JSON format');
}
}
Câu lệnh if-case xác thực rằng _json['blocks'] là List và liên kết câu lệnh đó với blocksJson (nếu không có mẫu, bạn sẽ cần một kiểu truyền rõ ràng hoặc toList()). Bên trong giá trị cố định của danh sách, bộ sưu tập for lặp lại trên blocksJson để tạo danh sách các đối tượng Block.
Chạy và kiểm thử ứng dụng
Tải lại ứng dụng để xác nhận rằng không có lỗi trình phân tích hoặc lỗi thời gian chạy. Trong bước tiếp theo, bạn sẽ hiển thị các mục Block đã phân tích cú pháp trên màn hình.
8. Sử dụng mẫu để hiển thị tài liệu
Bạn đã sử dụng câu lệnh if-case và mẫu có thể bác bỏ để phân rã và kết hợp lại dữ liệu JSON. Bây giờ, bạn sẽ áp dụng các mẫu có thể bác bỏ cho câu lệnh switch để tạo kiểu và hiển thị từng Block trong lib/main.dart.
Yêu cầu Antigravity kết xuất các khối tài liệu
Gửi câu lệnh sau trong Antigravity:
In `lib/main.dart`, create a `BlockWidget` `StatelessWidget` that takes a `required Block block` and uses a `switch` statement on `block.type` to assign `textStyle` (`displayMedium` for `'h1'`, `bodyMedium` for `'p' || 'checkbox'`, and `bodySmall` for the wildcard `_`), rendering `Text(block.text, style: textStyle)` inside an 8px-margin `Container`. Then update `DocumentScreen.build` to call `document.getBlocks()` and display `'Last modified: $modified'` above an `Expanded` `ListView.builder` that renders a `BlockWidget` for each block.
Tìm hiểu về mã được tạo
Khớp mẫu trong câu lệnh switch
Trong lib/main.dart, BlockWidget.build bật block.type bằng ba tính năng mẫu:
class BlockWidget extends StatelessWidget {
final Block block;
const BlockWidget({required this.block, super.key});
@override
Widget build(BuildContext context) {
TextStyle? textStyle;
switch (block.type) {
case 'h1':
textStyle = Theme.of(context).textTheme.displayMedium;
case 'p' || 'checkbox':
textStyle = Theme.of(context).textTheme.bodyMedium;
case _:
textStyle = Theme.of(context).textTheme.bodySmall;
}
return Container(
margin: const EdgeInsets.all(8),
child: Text(block.text, style: textStyle),
);
}
}
- Mẫu chuỗi hằng số (
case 'h1':): Khớp nếublock.typebằng hằng số'h1'. - Mẫu logic-or (
case 'p' || 'checkbox':): Khớp nếublock.typekhớp với một trong hai mẫu phụ'p'hoặc'checkbox'. (Mẫu logic-and sử dụng&&cũng được hỗ trợ.) - Mẫu ký tự đại diện (
case _:): Khớp với bất kỳ giá trị nào mà không liên kết biến. Trong câu lệnhswitch,case _:hoạt động giống như mệnh đềdefault:(vẫn được cho phép, chỉ dài dòng hơn một chút) và cũng có thể được dùng trong mọi ngữ cảnh mẫu, chẳng hạn nhưvar (title, _) = document.metadata;để loại bỏ trường bản ghi thứ hai.
Đang hiển thị danh sách chặn trong DocumentScreen
Trong DocumentScreen.build, việc gọi document.getBlocks() sẽ điền sẵn một Expanded ListView.builder để tạo BlockWidget cho từng mục:
final (title, :modified) = document.metadata;
final blocks = document.getBlocks();
return Scaffold(
appBar: AppBar(title: Text(title)),
body: Column(
children: [
Text('Last modified: $modified'),
Expanded(
child: ListView.builder(
itemCount: blocks.length,
itemBuilder: (context, index) {
return BlockWidget(block: blocks[index]);
},
),
),
],
),
);
Chạy và kiểm thử ứng dụng
Tải lại ứng dụng để xem các khối từ documentJson được kết xuất trên màn hình:

9. Sử dụng biểu thức switch
Mẫu thêm các chức năng biểu đạt vào switch và case. Để có thể sử dụng các câu lệnh này ở nhiều nơi hơn (chẳng hạn như trình khởi tạo biến, câu lệnh trả về và cây tiện ích), Dart 3 giới thiệu biểu thức switch, giúp đánh giá một loạt trường hợp mẫu và trực tiếp tạo ra một giá trị.
Yêu cầu Antigravity chuyển đổi thành biểu thức switch
Gửi câu lệnh sau trong Antigravity:
Refactor `BlockWidget.build` in `lib/main.dart` to replace the `switch` statement on `block.type` with a `switch` expression that assigns `textStyle` directly.
Tìm hiểu về mã được tạo
Cú pháp biểu thức switch
Trong lib/main.dart, BlockWidget.build hiện chỉ định textStyle trực tiếp từ biểu thức switch:
@override
Widget build(BuildContext context) {
final textStyle = switch (block.type) {
'h1' => Theme.of(context).textTheme.displayMedium,
'p' || 'checkbox' => Theme.of(context).textTheme.bodyMedium,
_ => Theme.of(context).textTheme.bodySmall,
};
return Container(
margin: const EdgeInsets.all(8),
child: Text(block.text, style: textStyle),
);
}
Biểu thức switch có vẻ giống với câu lệnh switch, nhưng có 3 điểm khác biệt về cú pháp:
- Nó bỏ qua từ khoá
casetrước mỗi mẫu. - Hàm này sử dụng
=>thay vì:để phân tách từng mẫu khỏi phần thân biểu thức. - Hàm này phân tách các trường hợp bằng dấu phẩy (
,) và có thể được sử dụng ở bất cứ nơi nào cần có biểu thức.
Chạy và kiểm thử ứng dụng
Tải lại ứng dụng để xác minh rằng các khối tài liệu tiếp tục hiển thị với kiểu văn bản dự kiến.
10. Sử dụng mẫu đối tượng
Dart là ngôn ngữ hướng đối tượng và các mẫu áp dụng cho tất cả đối tượng Dart. Trong bước này, bạn sẽ so khớp với mẫu đối tượng và phân rã phương thức getter của đối tượng (kết hợp với when mệnh đề bảo vệ) để hiển thị ngày sửa đổi tương đối mà con người có thể đọc được (chẳng hạn như "today", "yesterday" hoặc "2 weeks ago").
Yêu cầu Antigravity định dạng ngày tương đối bằng mẫu đối tượng
Gửi câu lệnh sau trong Antigravity:
Add a `String formatDate(DateTime dateTime)` function in `lib/main.dart` that computes `final difference = dateTime.difference(DateTime.now())` and returns a `switch` expression matching `Duration` object patterns: `'today'` for `0` days, `'tomorrow'` for `1` day, `'yesterday'` for `-1` days, `'${days ~/ 7} weeks from now'` when `days > 7`, `'${days.abs() ~/ 7} weeks ago'` when `days < -7`, `'${days.abs()} days ago'` when `isNegative: true`, and `'$days days from now'` for any remaining `Duration(inDays: final days)`. Update `DocumentScreen.build` to format `modified` with `formatDate(modified)` and display `'Last modified: $formattedModifiedDate'`.
Tìm hiểu về mã được tạo
Phân rã phương thức getter bằng mẫu đối tượng Duration
Trong lib/main.dart, formatDate tính toán Duration giữa dateTime và DateTime.now() rồi bật difference:
String formatDate(DateTime dateTime) {
final today = DateTime.now();
final difference = dateTime.difference(today);
return switch (difference) {
Duration(inDays: 0) => 'today',
Duration(inDays: 1) => 'tomorrow',
Duration(inDays: -1) => 'yesterday',
Duration(inDays: final days) when days > 7 => '${days ~/ 7} weeks from now',
Duration(inDays: final days) when days < -7 =>
'${days.abs() ~/ 7} weeks ago',
Duration(inDays: final days, isNegative: true) => '${days.abs()} days ago',
Duration(inDays: final days) => '$days days from now',
};
}
Mặc dù Duration(inDays: ...) trông giống như một lệnh gọi hàm khởi tạo, nhưng trong ngữ cảnh mẫu, đây là một mẫu đối tượng xác minh giá trị là Duration và gọi phương thức getter inDays và isNegative trên difference:
- Ba trường hợp đầu tiên sử dụng các mẫu con không đổi (
0,1và-1) để khớp vớidifference.inDaysvà trả về'today','tomorrow'hoặc'yesterday'. - Hai trường hợp cuối cùng xử lý thời lượng vượt quá một ngày bằng cách liên kết
inDaysvớifinal days: nếuisNegativekhớp với hằng số booleantrue, thì ngày đó là trong quá khứ ('${days.abs()} days ago'); nếu không, trường hợp còn lại sẽ bắt được thời lượng dương ('$days days from now').
Lọc kết quả khớp bằng mệnh đề bảo vệ when
Để định dạng khoảng thời gian dài hơn 7 ngày dưới dạng tuần, hai trường hợp ở giữa sẽ thêm mệnh đề bảo vệ:
Duration(inDays: final days) when days > 7 => '${days ~/ 7} weeks from now',
Duration(inDays: final days) when days < -7 =>
'${days.abs() ~/ 7} weeks ago',
- Mệnh đề bảo vệ sử dụng từ khoá
whensau mẫu trường hợp và có thể được dùng trong câu lệnhif-case, câu lệnhswitchvà biểu thứcswitch. - Mệnh đề này đánh giá một điều kiện boolean tuỳ ý sau khi mẫu khớp và liên kết các biến của mẫu (
days). - Nếu biểu thức bảo vệ có giá trị là
false, thì mẫu sẽ bị bác bỏ và quá trình thực thi sẽ chuyển sang trường hợp tiếp theo thay vì thoát khỏiswitch.
Chạy và kiểm thử ứng dụng
Tải lại ứng dụng để xem ngày sửa đổi tương đối được định dạng trong DocumentScreen (thử thay đổi "modified" trong documentJson thành ngày của hai tuần trước để xem "Last modified: 2 weeks ago"):

11. Niêm phong một lớp để chuyển đổi toàn diện
Lưu ý rằng formatDate ở bước trước không cần trường hợp ký tự đại diện (_) ở cuối vì Duration(inDays: final days) tính đến mọi giá trị Duration có thể có. Khi mọi giá trị có thể có trong switch được xử lý, thì đó được gọi là switch toàn diện.
Trong Dart 3, đối tượng sửa đổi lớp sealed mở rộng quy trình kiểm tra tính đầy đủ cho hệ phân cấp lớp. Trong bước cuối cùng này, bạn sẽ cải tiến Block thành một lớp cha sealed có ba lớp con (HeaderBlock, ParagraphBlock và CheckboxBlock) và sử dụng biểu thức switch đầy đủ trong BlockWidget để hiển thị từng loại khối, bao gồm cả hàng Checkbox tương tác cho CheckboxBlock.
Yêu cầu Antigravity niêm phong Block và kết xuất tất cả các loại khối phụ
Gửi câu lệnh sau trong Antigravity:
In `lib/data.dart`, refactor `Block` into a `sealed class Block` with three subclasses (`HeaderBlock(this.text)`, `ParagraphBlock(this.text)`, and `CheckboxBlock(this.text, this.isChecked)`) and replace `Block.fromJson` (`Map<String, Object?> json`) with a `switch` expression matching map patterns for `'h1'`, `'p'`, and `'checkbox'`. Then update `BlockWidget.build` in `lib/main.dart` to use an exhaustive `switch (block)` expression directly as the `Container`'s `child`, destructuring `HeaderBlock(:final text)`, `ParagraphBlock(:final text)`, and `CheckboxBlock(:final text, :final isChecked)` (rendering a `Row` with a `Checkbox` and `Text` for `CheckboxBlock`).
Tìm hiểu về mã được tạo
Tạo mô hình hệ phân cấp lớp sealed trong lib/data.dart
Trong lib/data.dart, Block được đánh dấu bằng đối tượng sửa đổi lớp sealed và được mở rộng bằng HeaderBlock, ParagraphBlock và CheckboxBlock:
sealed class Block {
Block();
factory Block.fromJson(Map<String, Object?> json) {
return switch (json) {
{'type': 'h1', 'text': String text} => HeaderBlock(text),
{'type': 'p', 'text': String text} => ParagraphBlock(text),
{'type': 'checkbox', 'text': String text, 'checked': bool checked} =>
CheckboxBlock(text, checked),
_ => throw const FormatException('Unexpected JSON format'),
};
}
}
class HeaderBlock extends Block {
final String text;
HeaderBlock(this.text);
}
class ParagraphBlock extends Block {
final String text;
ParagraphBlock(this.text);
}
class CheckboxBlock extends Block {
final String text;
final bool isChecked;
CheckboxBlock(this.text, this.isChecked);
}
Từ khoá sealed có nghĩa là Block chỉ có thể được mở rộng hoặc triển khai trong cùng một thư viện (lib/data.dart). Vì trình phân tích Dart biết tập hợp đầy đủ, khép kín của các loại phụ trực tiếp cho Block, nên trình phân tích này có thể xác minh xem có switch nào trên một thực thể Block xử lý mọi loại phụ hay không.
Chuyển đổi mẫu đối tượng toàn diện trong BlockWidget
Trong lib/main.dart, BlockWidget.build truyền trực tiếp biểu thức switch (block) đến thuộc tính child của Container, so khớp với từng lớp con bằng một mẫu đối tượng và phân rã các trường của lớp con đó bằng cách viết tắt :final:
class BlockWidget extends StatelessWidget {
final Block block;
const BlockWidget({required this.block, super.key});
@override
Widget build(BuildContext context) {
return Container(
margin: const EdgeInsets.all(8),
child: switch (block) {
HeaderBlock(:final text) => Text(
text,
style: Theme.of(context).textTheme.displayMedium,
),
ParagraphBlock(:final text) => Text(text),
CheckboxBlock(:final text, :final isChecked) => Row(
children: [
Checkbox(value: isChecked, onChanged: (_) {}),
Text(text),
],
),
},
);
}
}
Chạy và kiểm thử ứng dụng
Tải lại ứng dụng để xem khối hộp đánh dấu được kết xuất bằng tiện ích Material Checkbox lần đầu tiên:

12. Xin chúc mừng
Xin chúc mừng! Bạn đã cộng tác với Google Antigravity để xây dựng một trình xem tài liệu Flutter dựa trên các bản ghi, mẫu, biểu thức switch nâng cao và lớp sealed của Dart 3.
Sản phẩm bạn đã tạo
- Trả về nhiều giá trị bằng bản ghi: Trả về các trường được đặt tên và theo vị trí (
(String, {DateTime modified})) từDocument.metadatavà phân rã chúng một cách rõ ràng thành các biến cục bộ bằngfinal (title, :modified) = document.metadata;. - Xác thực và trích xuất JSON an toàn: Sử dụng các câu lệnh
if-casecó thể bác bỏ và biểu thứcswitchcó mẫu bản đồ lồng nhau để xác thực các loại, kiểm tra khoá và trích xuất giá trị trong một biểu thức duy nhất. - Phân nhánh giao diện người dùng biểu cảm: Sử dụng biểu thức
switch, mẫu đối tượng (Duration(inDays: final days)) và mệnh đề bảo vệwhenđể định dạng dấu thời gian tương đối và tạo tiện ích cùng dòng. - Kiểm tra tính đầy đủ trong thời gian biên dịch: Mô hình hoá các khối nội dung tài liệu dưới dạng hệ phân cấp
sealed class Block(HeaderBlock,ParagraphBlockvàCheckboxBlock) để trình biên dịch đảm bảo mọi loại khối đều được kết xuất.
Tiếp theo là gì?
Hãy xem tài liệu chính thức về Dart để khám phá thêm nhiều loại mẫu, tính năng bản ghi và đối tượng sửa đổi lớp:
- Mẫu và Loại mẫu
- Hồ sơ lưu trữ
- Nhánh (
if-casevàswitch) - Đối tượng sửa đổi lớp (
sealed,final,interface,base)
Tài liệu tham khảo
Để biết thông số kỹ thuật ngôn ngữ chuyên sâu cho từng tính năng trong lớp học lập trình này, hãy xem tài liệu thiết kế ngôn ngữ Dart gốc: