mirror of
https://github.com/flutter/flutter.git
synced 2026-02-20 02:29:02 +08:00
I recommend reviewing each commit individually. The following were suppressed instead of migrated to minimize the time the tree is closed: 1. The [`Radio` -> `RadioGroup` migration](https://docs.flutter.dev/release/breaking-changes/radio-api-redesign). Tracked by: https://github.com/flutter/flutter/issues/179088. Part of: https://github.com/flutter/flutter/issues/178827 ## Pre-launch Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [Tree Hygiene] wiki page, which explains my responsibilities. - [x] I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement]. - [x] I signed the [CLA]. - [x] I listed at least one issue that this PR fixes in the description above. - [x] I updated/added relevant documentation (doc comments with `///`). - [x] I added new tests to check the change I am making, or this PR is [test-exempt]. - [x] I followed the [breaking change policy] and added [Data Driven Fixes] where supported. - [x] All existing and new tests are passing. If you need help, consider asking for advice on the #hackers-new channel on [Discord]. **Note**: The Flutter team is currently trialing the use of [Gemini Code Assist for GitHub](https://developers.google.com/gemini-code-assist/docs/review-github-code). Comments from the `gemini-code-assist` bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed. <!-- Links --> [Contributor Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview [Tree Hygiene]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md [test-exempt]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests [Flutter Style Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md [Features we expect every widget to implement]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement [CLA]: https://cla.developers.google.com/ [flutter/tests]: https://github.com/flutter/tests [breaking change policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes [Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md [Data Driven Fixes]: https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md
168 lines
5.0 KiB
Dart
168 lines
5.0 KiB
Dart
// Copyright 2014 The Flutter Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file.
|
|
|
|
import 'package:flutter/material.dart';
|
|
import 'package:flutter/services.dart';
|
|
|
|
/// This sample demonstrates showing a confirmation dialog when the user
|
|
/// attempts to navigate away from a page with unsaved [Form] data.
|
|
|
|
void main() => runApp(const FormApp());
|
|
|
|
class FormApp extends StatelessWidget {
|
|
const FormApp({super.key});
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
return MaterialApp(
|
|
home: Scaffold(
|
|
appBar: AppBar(title: const Text('Confirmation Dialog Example')),
|
|
body: Center(child: _SaveableForm()),
|
|
),
|
|
);
|
|
}
|
|
}
|
|
|
|
class _SaveableForm extends StatefulWidget {
|
|
@override
|
|
State<_SaveableForm> createState() => _SaveableFormState();
|
|
}
|
|
|
|
class _SaveableFormState extends State<_SaveableForm> {
|
|
final TextEditingController _controller = TextEditingController();
|
|
String _savedValue = '';
|
|
bool _isDirty = false;
|
|
|
|
@override
|
|
void initState() {
|
|
super.initState();
|
|
_controller.addListener(_onChanged);
|
|
}
|
|
|
|
@override
|
|
void dispose() {
|
|
_controller.removeListener(_onChanged);
|
|
super.dispose();
|
|
}
|
|
|
|
void _onChanged() {
|
|
final bool nextIsDirty = _savedValue != _controller.text;
|
|
if (nextIsDirty == _isDirty) {
|
|
return;
|
|
}
|
|
setState(() {
|
|
_isDirty = nextIsDirty;
|
|
});
|
|
}
|
|
|
|
/// Shows a dialog and resolves to true when the user has indicated that they
|
|
/// want to pop.
|
|
///
|
|
/// A return value of null indicates a desire not to pop, such as when the
|
|
/// user has dismissed the modal without tapping a button.
|
|
Future<bool?> _showDialog() {
|
|
return showDialog<bool>(
|
|
context: context,
|
|
builder: (BuildContext context) {
|
|
return AlertDialog(
|
|
title: const Text('Are you sure?'),
|
|
content: const Text('Any unsaved changes will be lost!'),
|
|
actions: <Widget>[
|
|
TextButton(
|
|
child: const Text('Yes, discard my changes'),
|
|
onPressed: () {
|
|
Navigator.pop(context, true);
|
|
},
|
|
),
|
|
TextButton(
|
|
child: const Text('No, continue editing'),
|
|
onPressed: () {
|
|
Navigator.pop(context, false);
|
|
},
|
|
),
|
|
],
|
|
);
|
|
},
|
|
);
|
|
}
|
|
|
|
void _save(String? value) {
|
|
final String nextSavedValue = value ?? '';
|
|
setState(() {
|
|
_savedValue = nextSavedValue;
|
|
_isDirty = nextSavedValue != _controller.text;
|
|
});
|
|
}
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
return Center(
|
|
child: Column(
|
|
mainAxisAlignment: MainAxisAlignment.center,
|
|
children: <Widget>[
|
|
const Text(
|
|
'If the field below is unsaved, a confirmation dialog will be shown on back.',
|
|
),
|
|
const SizedBox(height: 20.0),
|
|
Form(
|
|
canPop: !_isDirty,
|
|
onPopInvokedWithResult: (bool didPop, Object? result) async {
|
|
if (didPop) {
|
|
return;
|
|
}
|
|
final bool shouldPop = await _showDialog() ?? false;
|
|
if (shouldPop) {
|
|
// Since this is the root route, quit the app where possible by
|
|
// invoking the SystemNavigator. If this wasn't the root route,
|
|
// then Navigator.maybePop could be used instead.
|
|
// See https://github.com/flutter/flutter/issues/11490
|
|
SystemNavigator.pop();
|
|
}
|
|
},
|
|
autovalidateMode: AutovalidateMode.always,
|
|
child: Column(
|
|
mainAxisAlignment: MainAxisAlignment.center,
|
|
children: <Widget>[
|
|
TextFormField(
|
|
controller: _controller,
|
|
onFieldSubmitted: (String? value) {
|
|
_save(value);
|
|
},
|
|
),
|
|
TextButton(
|
|
onPressed: () {
|
|
_save(_controller.text);
|
|
},
|
|
child: Row(
|
|
children: <Widget>[
|
|
const Text('Save'),
|
|
if (_controller.text.isNotEmpty)
|
|
Icon(_isDirty ? Icons.warning : Icons.check),
|
|
],
|
|
),
|
|
),
|
|
],
|
|
),
|
|
),
|
|
TextButton(
|
|
onPressed: () async {
|
|
final bool shouldPop =
|
|
!_isDirty || (await _showDialog() ?? false);
|
|
if (!shouldPop) {
|
|
return;
|
|
}
|
|
// Since this is the root route, quit the app where possible by
|
|
// invoking the SystemNavigator. If this wasn't the root route,
|
|
// then Navigator.maybePop could be used instead.
|
|
// See https://github.com/flutter/flutter/issues/11490
|
|
SystemNavigator.pop();
|
|
},
|
|
child: const Text('Go back'),
|
|
),
|
|
],
|
|
),
|
|
);
|
|
}
|
|
}
|