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
154 lines
4.5 KiB
Dart
154 lines
4.5 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/foundation.dart';
|
|
import 'package:flutter/material.dart';
|
|
|
|
/// Flutter code sample for [SelectionArea].
|
|
|
|
void main() => runApp(const SelectionAreaSelectionListenerExampleApp());
|
|
|
|
class SelectionAreaSelectionListenerExampleApp extends StatelessWidget {
|
|
const SelectionAreaSelectionListenerExampleApp({super.key});
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
return MaterialApp(
|
|
title: 'Flutter Demo',
|
|
theme: ThemeData(
|
|
colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
|
|
),
|
|
home: const MyHomePage(title: 'Flutter Demo Home Page'),
|
|
);
|
|
}
|
|
}
|
|
|
|
class MyHomePage extends StatefulWidget {
|
|
const MyHomePage({super.key, required this.title});
|
|
|
|
final String title;
|
|
|
|
@override
|
|
State<MyHomePage> createState() => _MyHomePageState();
|
|
}
|
|
|
|
class _MyHomePageState extends State<MyHomePage> {
|
|
final SelectionListenerNotifier _selectionNotifier =
|
|
SelectionListenerNotifier();
|
|
SelectableRegionSelectionStatus? _selectableRegionStatus;
|
|
|
|
void _handleOnSelectionStateChanged(SelectableRegionSelectionStatus status) {
|
|
setState(() {
|
|
_selectableRegionStatus = status;
|
|
});
|
|
}
|
|
|
|
@override
|
|
void dispose() {
|
|
_selectionNotifier.dispose();
|
|
_selectableRegionStatus = null;
|
|
super.dispose();
|
|
}
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
return Scaffold(
|
|
appBar: AppBar(
|
|
backgroundColor: Theme.of(context).colorScheme.inversePrimary,
|
|
title: Text(widget.title),
|
|
),
|
|
body: Center(
|
|
child: Column(
|
|
children: <Widget>[
|
|
Column(
|
|
crossAxisAlignment: CrossAxisAlignment.start,
|
|
children: <Widget>[
|
|
for (final (int? offset, String label)
|
|
in <(int? offset, String label)>[
|
|
(
|
|
_selectionNotifier.registered
|
|
? _selectionNotifier.selection.range?.startOffset
|
|
: null,
|
|
'StartOffset',
|
|
),
|
|
(
|
|
_selectionNotifier.registered
|
|
? _selectionNotifier.selection.range?.endOffset
|
|
: null,
|
|
'EndOffset',
|
|
),
|
|
])
|
|
Text('Selection $label: $offset'),
|
|
Text(
|
|
'Selection Status: ${_selectionNotifier.registered ? _selectionNotifier.selection.status : 'SelectionListenerNotifier not registered.'}',
|
|
),
|
|
Text('Selectable Region Status: $_selectableRegionStatus'),
|
|
],
|
|
),
|
|
const SizedBox(height: 15.0),
|
|
SelectionArea(
|
|
child: MySelectableText(
|
|
selectionNotifier: _selectionNotifier,
|
|
onChanged: _handleOnSelectionStateChanged,
|
|
),
|
|
),
|
|
],
|
|
),
|
|
),
|
|
);
|
|
}
|
|
}
|
|
|
|
class MySelectableText extends StatefulWidget {
|
|
const MySelectableText({
|
|
super.key,
|
|
required this.selectionNotifier,
|
|
required this.onChanged,
|
|
});
|
|
|
|
final SelectionListenerNotifier selectionNotifier;
|
|
final ValueChanged<SelectableRegionSelectionStatus> onChanged;
|
|
|
|
@override
|
|
State<MySelectableText> createState() => _MySelectableTextState();
|
|
}
|
|
|
|
class _MySelectableTextState extends State<MySelectableText> {
|
|
ValueListenable<SelectableRegionSelectionStatus>? _selectableRegionScope;
|
|
|
|
void _handleOnSelectableRegionChanged() {
|
|
if (_selectableRegionScope == null) {
|
|
return;
|
|
}
|
|
widget.onChanged.call(_selectableRegionScope!.value);
|
|
}
|
|
|
|
@override
|
|
void didChangeDependencies() {
|
|
super.didChangeDependencies();
|
|
_selectableRegionScope?.removeListener(_handleOnSelectableRegionChanged);
|
|
_selectableRegionScope = SelectableRegionSelectionStatusScope.maybeOf(
|
|
context,
|
|
);
|
|
_selectableRegionScope?.addListener(_handleOnSelectableRegionChanged);
|
|
}
|
|
|
|
@override
|
|
void dispose() {
|
|
_selectableRegionScope?.removeListener(_handleOnSelectableRegionChanged);
|
|
_selectableRegionScope = null;
|
|
super.dispose();
|
|
}
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
return SelectionListener(
|
|
selectionNotifier: widget.selectionNotifier,
|
|
child: const Text(
|
|
'This is some text under a SelectionArea that can be selected.',
|
|
),
|
|
);
|
|
}
|
|
}
|