mirror of
https://github.com/flutter/flutter.git
synced 2026-02-20 02:29:02 +08:00
9d96df2364
WIP Commits separated as follows: - Update lints in analysis_options files - Run `dart fix --apply` - Clean up leftover analysis issues - Run `dart format .` in the right places. Local analysis and testing passes. Checking CI now. Part of https://github.com/flutter/flutter/issues/178827 - Adoption of flutter_lints in examples/api coming in a separate change (cc @loic-sharma) ## Pre-launch Checklist - [ ] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [ ] I read the [Tree Hygiene] wiki page, which explains my responsibilities. - [ ] I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement]. - [ ] I signed the [CLA]. - [ ] I listed at least one issue that this PR fixes in the description above. - [ ] I updated/added relevant documentation (doc comments with `///`). - [ ] I added new tests to check the change I am making, or this PR is [test-exempt]. - [ ] I followed the [breaking change policy] and added [Data Driven Fixes] where supported. - [ ] 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
619 lines
18 KiB
Dart
619 lines
18 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';
|
|
import 'package:flutter_test/flutter_test.dart';
|
|
|
|
void main() {
|
|
testWidgets('SemanticsDebugger will schedule a frame', (WidgetTester tester) async {
|
|
await tester.pumpWidget(SemanticsDebugger(child: Container()));
|
|
|
|
expect(tester.binding.hasScheduledFrame, isTrue);
|
|
});
|
|
|
|
testWidgets('SemanticsDebugger smoke test', (WidgetTester tester) async {
|
|
// This is a smoketest to verify that adding a debugger doesn't crash.
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: Stack(
|
|
children: <Widget>[
|
|
Semantics(),
|
|
Semantics(container: true),
|
|
Semantics(label: 'label', textDirection: TextDirection.ltr),
|
|
],
|
|
),
|
|
),
|
|
);
|
|
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
child: Stack(
|
|
children: <Widget>[
|
|
Semantics(),
|
|
Semantics(container: true),
|
|
Semantics(label: 'label', textDirection: TextDirection.ltr),
|
|
],
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
expect(true, isTrue); // expect that we reach here without crashing
|
|
});
|
|
|
|
testWidgets('SemanticsDebugger draw persistent color based on structure', (
|
|
WidgetTester tester,
|
|
) async {
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
child: Stack(
|
|
children: <Widget>[Semantics(container: true, child: Semantics(container: true))],
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
expect(
|
|
find.byType(SemanticsDebugger),
|
|
paints
|
|
..rect()
|
|
..rect(color: const Color(0xFFF866FF)),
|
|
);
|
|
});
|
|
|
|
testWidgets('SemanticsDebugger reparents subtree', (WidgetTester tester) async {
|
|
final GlobalKey key = GlobalKey();
|
|
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
child: Stack(
|
|
children: <Widget>[
|
|
Semantics(label: 'label1', textDirection: TextDirection.ltr),
|
|
Positioned(
|
|
key: key,
|
|
left: 0.0,
|
|
top: 0.0,
|
|
width: 100.0,
|
|
height: 100.0,
|
|
child: Semantics(label: 'label2', textDirection: TextDirection.ltr),
|
|
),
|
|
],
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
child: Stack(
|
|
children: <Widget>[
|
|
Semantics(label: 'label1', textDirection: TextDirection.ltr),
|
|
Semantics(
|
|
container: true,
|
|
child: Stack(
|
|
children: <Widget>[
|
|
Positioned(
|
|
key: key,
|
|
left: 0.0,
|
|
top: 0.0,
|
|
width: 100.0,
|
|
height: 100.0,
|
|
child: Semantics(label: 'label2', textDirection: TextDirection.ltr),
|
|
),
|
|
Semantics(label: 'label3', textDirection: TextDirection.ltr),
|
|
],
|
|
),
|
|
),
|
|
],
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
child: Stack(
|
|
children: <Widget>[
|
|
Semantics(label: 'label1', textDirection: TextDirection.ltr),
|
|
Semantics(
|
|
container: true,
|
|
child: Stack(
|
|
children: <Widget>[
|
|
Positioned(
|
|
key: key,
|
|
left: 0.0,
|
|
top: 0.0,
|
|
width: 100.0,
|
|
height: 100.0,
|
|
child: Semantics(label: 'label2', textDirection: TextDirection.ltr),
|
|
),
|
|
Semantics(label: 'label3', textDirection: TextDirection.ltr),
|
|
Semantics(label: 'label4', textDirection: TextDirection.ltr),
|
|
],
|
|
),
|
|
),
|
|
],
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
expect(tester.takeException(), isNull);
|
|
});
|
|
|
|
testWidgets('SemanticsDebugger interaction test', (WidgetTester tester) async {
|
|
final log = <String>[];
|
|
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
child: Material(
|
|
child: ListView(
|
|
children: <Widget>[
|
|
ElevatedButton(
|
|
onPressed: () {
|
|
log.add('top');
|
|
},
|
|
child: const Text('TOP'),
|
|
),
|
|
ElevatedButton(
|
|
onPressed: () {
|
|
log.add('bottom');
|
|
},
|
|
child: const Text('BOTTOM'),
|
|
),
|
|
],
|
|
),
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
await tester.tap(find.text('TOP'), warnIfMissed: false); // hitting the debugger
|
|
expect(log, equals(<String>['top']));
|
|
log.clear();
|
|
|
|
await tester.tap(find.text('BOTTOM'), warnIfMissed: false); // hitting the debugger
|
|
expect(log, equals(<String>['bottom']));
|
|
log.clear();
|
|
});
|
|
|
|
testWidgets('SemanticsDebugger interaction test - negative', (WidgetTester tester) async {
|
|
final log = <String>[];
|
|
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
child: Material(
|
|
child: ListView(
|
|
children: <Widget>[
|
|
ElevatedButton(
|
|
onPressed: () {
|
|
log.add('top');
|
|
},
|
|
child: const Text('TOP', textDirection: TextDirection.ltr),
|
|
),
|
|
ExcludeSemantics(
|
|
child: ElevatedButton(
|
|
onPressed: () {
|
|
log.add('bottom');
|
|
},
|
|
child: const Text('BOTTOM', textDirection: TextDirection.ltr),
|
|
),
|
|
),
|
|
],
|
|
),
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
await tester.tap(find.text('TOP'), warnIfMissed: false); // hitting the debugger
|
|
expect(log, equals(<String>['top']));
|
|
log.clear();
|
|
|
|
await tester.tap(find.text('BOTTOM'), warnIfMissed: false); // hitting the debugger
|
|
expect(log, equals(<String>[]));
|
|
log.clear();
|
|
});
|
|
|
|
testWidgets('SemanticsDebugger scroll test', (WidgetTester tester) async {
|
|
final Key childKey = UniqueKey();
|
|
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
child: ListView(
|
|
children: <Widget>[Container(key: childKey, height: 5000.0, color: Colors.green[500])],
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
expect(tester.getTopLeft(find.byKey(childKey)).dy, equals(0.0));
|
|
|
|
await tester.fling(
|
|
find.byType(ListView),
|
|
const Offset(0.0, -200.0),
|
|
200.0,
|
|
warnIfMissed: false,
|
|
); // hitting the debugger);
|
|
await tester.pump();
|
|
|
|
expect(tester.getTopLeft(find.byKey(childKey)).dy, equals(-480.0));
|
|
|
|
await tester.fling(
|
|
find.byType(ListView),
|
|
const Offset(200.0, 0.0),
|
|
200.0,
|
|
warnIfMissed: false,
|
|
); // hitting the debugger);
|
|
await tester.pump();
|
|
|
|
expect(tester.getTopLeft(find.byKey(childKey)).dy, equals(-480.0));
|
|
|
|
await tester.fling(
|
|
find.byType(ListView),
|
|
const Offset(-200.0, 0.0),
|
|
200.0,
|
|
warnIfMissed: false,
|
|
); // hitting the debugger);
|
|
await tester.pump();
|
|
|
|
expect(tester.getTopLeft(find.byKey(childKey)).dy, equals(-480.0));
|
|
|
|
await tester.fling(
|
|
find.byType(ListView),
|
|
const Offset(0.0, 200.0),
|
|
200.0,
|
|
warnIfMissed: false,
|
|
); // hitting the debugger);
|
|
await tester.pump();
|
|
|
|
expect(tester.getTopLeft(find.byKey(childKey)).dy, equals(0.0));
|
|
});
|
|
|
|
testWidgets('SemanticsDebugger long press', (WidgetTester tester) async {
|
|
var didLongPress = false;
|
|
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
child: GestureDetector(
|
|
onLongPress: () {
|
|
expect(didLongPress, isFalse);
|
|
didLongPress = true;
|
|
},
|
|
child: const Text('target', textDirection: TextDirection.ltr),
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
await tester.longPress(find.text('target'), warnIfMissed: false); // hitting the debugger
|
|
expect(didLongPress, isTrue);
|
|
});
|
|
|
|
testWidgets('SemanticsDebugger slider', (WidgetTester tester) async {
|
|
var value = 0.75;
|
|
|
|
await tester.pumpWidget(
|
|
MaterialApp(
|
|
home: Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
child: Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: MediaQuery(
|
|
data: MediaQueryData.fromView(tester.view),
|
|
child: Material(
|
|
child: Center(
|
|
child: Slider(
|
|
value: value,
|
|
onChanged: (double newValue) {
|
|
value = newValue;
|
|
},
|
|
),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
// The fling below must be such that the velocity estimation examines an
|
|
// offset greater than the kTouchSlop. Too slow or too short a distance, and
|
|
// it won't trigger. The actual distance moved doesn't matter since this is
|
|
// interpreted as a gesture by the semantics debugger and sent to the widget
|
|
// as a semantic action that always moves by 10% of the complete track.
|
|
await tester.fling(
|
|
find.byType(Slider),
|
|
const Offset(-100.0, 0.0),
|
|
2000.0,
|
|
warnIfMissed: false,
|
|
); // hitting the debugger
|
|
switch (defaultTargetPlatform) {
|
|
case TargetPlatform.iOS:
|
|
case TargetPlatform.macOS:
|
|
expect(value, equals(0.65));
|
|
case TargetPlatform.linux:
|
|
case TargetPlatform.windows:
|
|
case TargetPlatform.android:
|
|
case TargetPlatform.fuchsia:
|
|
expect(value, equals(0.70));
|
|
}
|
|
}, variant: TargetPlatformVariant.all());
|
|
|
|
testWidgets('SemanticsDebugger checkbox', (WidgetTester tester) async {
|
|
final Key keyTop = UniqueKey();
|
|
final Key keyBottom = UniqueKey();
|
|
|
|
bool? valueTop = false;
|
|
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
child: Material(
|
|
child: ListView(
|
|
children: <Widget>[
|
|
Checkbox(
|
|
key: keyTop,
|
|
value: valueTop,
|
|
onChanged: (bool? newValue) {
|
|
valueTop = newValue;
|
|
},
|
|
),
|
|
Checkbox(key: keyBottom, value: false, onChanged: null),
|
|
],
|
|
),
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
await tester.tap(find.byKey(keyTop), warnIfMissed: false); // hitting the debugger
|
|
expect(valueTop, isTrue);
|
|
valueTop = false;
|
|
expect(valueTop, isFalse);
|
|
|
|
await tester.tap(find.byKey(keyBottom), warnIfMissed: false); // hitting the debugger
|
|
expect(valueTop, isFalse);
|
|
});
|
|
|
|
testWidgets('SemanticsDebugger checkbox message', (WidgetTester tester) async {
|
|
final Key checkbox = UniqueKey();
|
|
final Key checkboxUnchecked = UniqueKey();
|
|
final Key checkboxDisabled = UniqueKey();
|
|
final Key checkboxDisabledUnchecked = UniqueKey();
|
|
final Key debugger = UniqueKey();
|
|
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
key: debugger,
|
|
child: Material(
|
|
child: ListView(
|
|
children: <Widget>[
|
|
Semantics(
|
|
container: true,
|
|
key: checkbox,
|
|
child: Checkbox(value: true, onChanged: (bool? _) {}),
|
|
),
|
|
Semantics(
|
|
container: true,
|
|
key: checkboxUnchecked,
|
|
child: Checkbox(value: false, onChanged: (bool? _) {}),
|
|
),
|
|
Semantics(
|
|
container: true,
|
|
key: checkboxDisabled,
|
|
child: const Checkbox(value: true, onChanged: null),
|
|
),
|
|
Semantics(
|
|
container: true,
|
|
key: checkboxDisabledUnchecked,
|
|
child: const Checkbox(value: false, onChanged: null),
|
|
),
|
|
],
|
|
),
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
expect(
|
|
_getMessageShownInSemanticsDebugger(
|
|
widgetKey: checkbox,
|
|
debuggerKey: debugger,
|
|
tester: tester,
|
|
),
|
|
'checked',
|
|
);
|
|
expect(
|
|
_getMessageShownInSemanticsDebugger(
|
|
widgetKey: checkboxUnchecked,
|
|
debuggerKey: debugger,
|
|
tester: tester,
|
|
),
|
|
'unchecked',
|
|
);
|
|
expect(
|
|
_getMessageShownInSemanticsDebugger(
|
|
widgetKey: checkboxDisabled,
|
|
debuggerKey: debugger,
|
|
tester: tester,
|
|
),
|
|
'checked; disabled',
|
|
);
|
|
expect(
|
|
_getMessageShownInSemanticsDebugger(
|
|
widgetKey: checkboxDisabledUnchecked,
|
|
debuggerKey: debugger,
|
|
tester: tester,
|
|
),
|
|
'unchecked; disabled',
|
|
);
|
|
});
|
|
|
|
testWidgets(
|
|
'SemanticsDebugger ignores duplicated label and tooltip for Android',
|
|
(WidgetTester tester) async {
|
|
final Key child = UniqueKey();
|
|
final Key debugger = UniqueKey();
|
|
final isPlatformAndroid = defaultTargetPlatform == TargetPlatform.android;
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
key: debugger,
|
|
child: Material(
|
|
child: Semantics(container: true, key: child, label: 'text', tooltip: 'text'),
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
expect(
|
|
_getMessageShownInSemanticsDebugger(
|
|
widgetKey: child,
|
|
debuggerKey: debugger,
|
|
tester: tester,
|
|
),
|
|
isPlatformAndroid ? 'text' : 'text\ntext',
|
|
);
|
|
},
|
|
variant: TargetPlatformVariant.all(),
|
|
);
|
|
|
|
testWidgets('SemanticsDebugger textfield', (WidgetTester tester) async {
|
|
final textField = UniqueKey();
|
|
final debugger = UniqueKey();
|
|
|
|
await tester.pumpWidget(
|
|
MaterialApp(
|
|
home: SemanticsDebugger(
|
|
key: debugger,
|
|
child: Material(child: TextField(key: textField)),
|
|
),
|
|
),
|
|
);
|
|
|
|
final dynamic semanticsDebuggerPainter = _getSemanticsDebuggerPainter(
|
|
debuggerKey: debugger,
|
|
tester: tester,
|
|
);
|
|
final RenderObject renderTextfield = tester.renderObject(
|
|
find.descendant(of: find.byKey(textField), matching: find.byType(Semantics)).first,
|
|
);
|
|
|
|
expect(
|
|
// ignore: avoid_dynamic_calls
|
|
semanticsDebuggerPainter.getMessage(renderTextfield.debugSemantics),
|
|
'textfield',
|
|
);
|
|
});
|
|
|
|
testWidgets('SemanticsDebugger label style is used in the painter.', (WidgetTester tester) async {
|
|
final debugger = UniqueKey();
|
|
const labelStyle = TextStyle(color: Colors.amber);
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.ltr,
|
|
child: SemanticsDebugger(
|
|
key: debugger,
|
|
labelStyle: labelStyle,
|
|
child: Semantics(label: 'label', textDirection: TextDirection.ltr),
|
|
),
|
|
),
|
|
);
|
|
|
|
expect(
|
|
// ignore: avoid_dynamic_calls
|
|
_getSemanticsDebuggerPainter(debuggerKey: debugger, tester: tester).labelStyle,
|
|
labelStyle,
|
|
);
|
|
});
|
|
|
|
testWidgets('SemanticsDebugger label for rtl.', (WidgetTester tester) async {
|
|
final debugger = UniqueKey();
|
|
final Key label = UniqueKey();
|
|
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.rtl,
|
|
child: SemanticsDebugger(
|
|
key: debugger,
|
|
child: Semantics(label: 'ملصق', textDirection: TextDirection.rtl, key: label),
|
|
),
|
|
),
|
|
);
|
|
|
|
expect(
|
|
_getMessageShownInSemanticsDebugger(widgetKey: label, debuggerKey: debugger, tester: tester),
|
|
'\u2067ملصق\u2069',
|
|
);
|
|
});
|
|
|
|
testWidgets('SemanticsDebugger turns on semantics.', (WidgetTester tester) async {
|
|
// Regression test for https://github.com/flutter/flutter/issues/147665.
|
|
expect(tester.binding.semanticsEnabled, isFalse);
|
|
await tester.pumpWidget(
|
|
Directionality(
|
|
textDirection: TextDirection.rtl,
|
|
child: SemanticsDebugger(child: Semantics(label: 'Hello World')),
|
|
),
|
|
);
|
|
expect(tester.binding.semanticsEnabled, isTrue);
|
|
}, semanticsEnabled: false);
|
|
}
|
|
|
|
String _getMessageShownInSemanticsDebugger({
|
|
required Key widgetKey,
|
|
required Key debuggerKey,
|
|
required WidgetTester tester,
|
|
}) {
|
|
final dynamic semanticsDebuggerPainter = _getSemanticsDebuggerPainter(
|
|
debuggerKey: debuggerKey,
|
|
tester: tester,
|
|
);
|
|
// ignore: avoid_dynamic_calls
|
|
return semanticsDebuggerPainter.getMessage(
|
|
tester.renderObject(find.byKey(widgetKey)).debugSemantics,
|
|
)
|
|
as String;
|
|
}
|
|
|
|
dynamic _getSemanticsDebuggerPainter({required Key debuggerKey, required WidgetTester tester}) {
|
|
final customPaint =
|
|
tester
|
|
.widgetList(
|
|
find.descendant(of: find.byKey(debuggerKey), matching: find.byType(CustomPaint)),
|
|
)
|
|
.first
|
|
as CustomPaint;
|
|
final dynamic semanticsDebuggerPainter = customPaint.foregroundPainter;
|
|
expect(semanticsDebuggerPainter.runtimeType.toString(), '_SemanticsDebuggerPainter');
|
|
return semanticsDebuggerPainter;
|
|
}
|