firka/flutter
firka/flutter
4
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Slight cleanup in PointerSignalResolver docs (#78817)

Browse Source
This commit is contained in:
Todd Volkert 2021-03-22 23:30:00 -07:00 committed by GitHub
parent 720dac5438
commit 5d37734ea1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 74 additions and 60 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

126
packages/flutter/lib/src/gestures/pointer_signal_resolver.dart
View File

@ -29,7 +29,6 @@ bool _isSameEvent(PointerSignalEvent event1, PointerSignalEvent event2) {
/// ///
/// To use this class, objects should register their event handler like so: /// To use this class, objects should register their event handler like so:
/// ///
/// {@tool snippet}
/// ```dart /// ```dart
/// void handleSignalEvent(PointerSignalEvent event) { /// void handleSignalEvent(PointerSignalEvent event) {
/// GestureBinding.instance!.pointerSignalResolver.register(event, (PointerSignalEvent event) { /// GestureBinding.instance!.pointerSignalResolver.register(event, (PointerSignalEvent event) {
@ -37,88 +36,103 @@ bool _isSameEvent(PointerSignalEvent event1, PointerSignalEvent event2) {
/// }); /// });
/// } /// }
/// ``` /// ```
/// {@end-tool}
/// ///
/// {@tool dartpad --template=stateful_widget_material} /// {@tool dartpad --template=stateful_widget_material}
/// Here is an example that demonstrates the effect of not using the resolver /// Here is an example that demonstrates the effect of not using the resolver
/// versus using it. /// versus using it.
/// ///
/// When this example is set to _not_ use the resolver, then scrolling the /// When this example is set to _not_ use the resolver, then triggering the
/// mouse wheel over the outer box will cause only the outer box to change /// mouse wheel over the outer box will cause only the outer box to change
/// color, but scrolling the mouse wheel over inner box will cause _both_ the /// color, but triggering the mouse wheel over the inner box will cause _both_
/// outer and the inner boxes to change color (because they're both receiving /// the outer and the inner boxes to change color (because they're both
/// the scroll event). /// receiving the event).
/// ///
/// When this excample is set to _use_ the resolver, then only the box located /// When this example is set to _use_ the resolver, then only the box located
/// directly under the cursor will change color when the mouse wheel is /// directly under the cursor will change color when the mouse wheel is
/// scrolled. /// triggered.
/// ///
/// ```dart imports /// ```dart imports
/// import 'package:flutter/gestures.dart'; /// import 'package:flutter/gestures.dart';
/// ``` /// ```
/// ///
/// ```dart preamble
/// class ColorChanger extends StatefulWidget {
/// const ColorChanger({
/// Key? key,
/// required this.initialColor,
/// required this.useResolver,
/// required this.child,
/// }) : super(key: key);
///
/// final HSVColor initialColor;
/// final bool useResolver;
/// final Widget child;
///
/// @override
/// _ColorChangerState createState() => _ColorChangerState();
/// }
///
/// class _ColorChangerState extends State<ColorChanger> {
/// late HSVColor color;
///
/// void rotateColor() {
/// setState(() {
/// color = color.withHue((color.hue + 6) % 360.0);
/// });
/// }
///
/// @override
/// void initState() {
/// super.initState();
/// color = widget.initialColor;
/// }
///
/// @override
/// Widget build(BuildContext context) {
/// return DecoratedBox(
/// decoration: BoxDecoration(
/// border: const Border.fromBorderSide(BorderSide()),
/// color: color.toColor(),
/// ),
/// child: Listener(
/// onPointerSignal: (PointerSignalEvent event) {
/// if (widget.useResolver) {
/// GestureBinding.instance!.pointerSignalResolver.register(event, (PointerSignalEvent event) {
/// rotateColor();
/// });
/// } else {
/// rotateColor();
/// }
/// },
/// child: widget.child,
/// ),
/// );
/// }
/// }
/// ```
///
/// ```dart /// ```dart
/// HSVColor outerColor = const HSVColor.fromAHSV(0.2, 120.0, 1, 1);
/// HSVColor innerColor = const HSVColor.fromAHSV(1, 60.0, 1, 1);
/// bool useResolver = false; /// bool useResolver = false;
/// ///
/// void rotateOuterColor() {
/// setState(() {
/// outerColor = outerColor.withHue((outerColor.hue + 6) % 360.0);
/// });
/// }
///
/// void rotateInnerColor() {
/// setState(() {
/// innerColor = innerColor.withHue((innerColor.hue + 6) % 360.0);
/// });
/// }
///
/// @override /// @override
/// Widget build(BuildContext context) { /// Widget build(BuildContext context) {
/// return Material( /// return Material(
/// child: Stack( /// child: Stack(
/// fit: StackFit.expand, /// fit: StackFit.expand,
/// children: <Widget>[ /// children: <Widget>[
/// Listener( /// ColorChanger(
/// onPointerSignal: (PointerSignalEvent event) { /// initialColor: const HSVColor.fromAHSV(0.2, 120.0, 1, 1),
/// if (useResolver) { /// useResolver: useResolver,
/// GestureBinding.instance!.pointerSignalResolver.register(event, (PointerSignalEvent event) {
/// rotateOuterColor();
/// });
/// } else {
/// rotateOuterColor();
/// }
/// },
/// child: DecoratedBox(
/// decoration: BoxDecoration(
/// border: const Border.fromBorderSide(BorderSide()),
/// color: outerColor.toColor(),
/// ),
/// child: FractionallySizedBox( /// child: FractionallySizedBox(
/// widthFactor: 0.5, /// widthFactor: 0.5,
/// heightFactor: 0.5, /// heightFactor: 0.5,
/// child: DecoratedBox( /// child: ColorChanger(
/// decoration: BoxDecoration( /// initialColor: const HSVColor.fromAHSV(1, 60.0, 1, 1),
/// border: const Border.fromBorderSide(BorderSide()), /// useResolver: useResolver,
/// color: innerColor.toColor(),
/// ),
/// child: Listener(
/// onPointerSignal: (PointerSignalEvent event) {
/// if (useResolver) {
/// GestureBinding.instance!.pointerSignalResolver.register(event, (PointerSignalEvent event) {
/// rotateInnerColor();
/// });
/// } else {
/// rotateInnerColor();
/// }
/// },
/// child: const AbsorbPointer(), /// child: const AbsorbPointer(),
/// ), /// ),
/// ), /// ),
/// ), /// ),
/// ),
/// ),
/// Align( /// Align(
/// alignment: Alignment.topLeft, /// alignment: Alignment.topLeft,
/// child: Row( /// child: Row(
@ -132,9 +146,9 @@ bool _isSameEvent(PointerSignalEvent event1, PointerSignalEvent event2) {
/// }); /// });
/// }, /// },
/// ), /// ),
/// Text( /// const Text(
/// 'Use the PointerSignalResolver?', /// 'Use the PointerSignalResolver?',
/// style: DefaultTextStyle.of(context).style.copyWith(fontWeight: FontWeight.bold), /// style: TextStyle(fontWeight: FontWeight.bold),
/// ), /// ),
/// ], /// ],
/// ), /// ),