[a11y] Add support for high contrast themes in the a11y assessments app #185801
Conversation
There was a problem hiding this comment.
Code Review
This pull request centralizes theme creation into a _buildTheme helper function and defines static ThemeData constants for light, dark, and high-contrast modes. Redundant AppBar background color overrides are removed across multiple use case files, and the MaterialApp is updated to explicitly provide high-contrast themes, with corresponding updates to the home page tests. Feedback recommends adding documentation comments to private members to align with the repository style guide and suggests evaluating the impact of overriding platform-specific page transitions.
| } | ||
| } | ||
|
|
||
| ThemeData _buildTheme({required Brightness brightness, double contrastLevel = 0.0}) { |
There was a problem hiding this comment.
According to the Repository Style Guide (Rule 67), documentation comments (///) should be used even for private members to explain their purpose. Please add a doc comment for _buildTheme.
| ThemeData _buildTheme({required Brightness brightness, double contrastLevel = 0.0}) { | |
| /// Builds a [ThemeData] with the given [brightness] and [contrastLevel]. | |
| ThemeData _buildTheme({required Brightness brightness, double contrastLevel = 0.0}) { |
References
- Use /// for public-quality documentation, even on private members. (link)
| final ThemeData _lightTheme = _buildTheme(brightness: Brightness.light); | ||
| final ThemeData _darkTheme = _buildTheme(brightness: Brightness.dark); | ||
| final ThemeData _highContrastTheme = _buildTheme(brightness: Brightness.light, contrastLevel: 1.0); | ||
| final ThemeData _highContrastDarkTheme = _buildTheme( | ||
| brightness: Brightness.dark, | ||
| contrastLevel: 1.0, | ||
| ); |
There was a problem hiding this comment.
These theme variables should have documentation comments explaining their specific use cases (e.g., light, dark, high contrast) per Rule 67 of the Repository Style Guide.
/// The default light theme.
final ThemeData _lightTheme = _buildTheme(brightness: Brightness.light);
/// The default dark theme.
final ThemeData _darkTheme = _buildTheme(brightness: Brightness.dark);
/// The high contrast light theme.
final ThemeData _highContrastTheme = _buildTheme(brightness: Brightness.light, contrastLevel: 1.0);
/// The high contrast dark theme.
final ThemeData _highContrastDarkTheme = _buildTheme(
brightness: Brightness.dark,
contrastLevel: 1.0,
);References
- Use /// for public-quality documentation, even on private members. (link)
| pageTransitionsTheme: PageTransitionsTheme( | ||
| builders: <TargetPlatform, PageTransitionsBuilder>{ | ||
| for (final TargetPlatform platform in TargetPlatform.values) | ||
| platform: const FadeForwardsPageTransitionsBuilder(), | ||
| }, | ||
| ), |
There was a problem hiding this comment.
Overriding the pageTransitionsTheme for all platforms with FadeForwardsPageTransitionsBuilder removes native transition behaviors (e.g., the horizontal slide transition on iOS). Unless this global override is specifically required for consistent accessibility assessment across platforms, it is generally better to respect platform-specific defaults.
Roll Flutter from 81bc3d69535f to 707dbc0420a3 (85 revisions) flutter/flutter@81bc3d6...707dbc0 2026-05-01 [email protected] Removing TODOs from the WebParagraph code and addressing technical debts. (flutter/flutter#185168) 2026-05-01 [email protected] Ensure that vulkan_interface.h gets included before vk_mem_alloc.h (flutter/flutter#185777) 2026-05-01 [email protected] [flutter_tools] Bump dwds dependency to v27.1.1 (flutter/flutter#185357) 2026-05-01 [email protected] Roll Dart SDK from 6d4a319cbdac to 9aa7097f2e3e (3 revisions) (flutter/flutter#185888) 2026-05-01 [email protected] Roll Skia from fa1dcb289709 to 7ac6d42f2fd0 (1 revision) (flutter/flutter#185887) 2026-05-01 [email protected] Roll Skia from 54cc00adde38 to fa1dcb289709 (3 revisions) (flutter/flutter#185880) 2026-05-01 [email protected] [iOS] Migrate to FlutterFMLTaskRunner(s) (flutter/flutter#185815) 2026-05-01 [email protected] Remove material imports from navigator_on_did_remove_page_test and scrollable_in_overlay_test (flutter/flutter#182546) 2026-05-01 [email protected] Roll Skia from 2e279266f06a to 54cc00adde38 (3 revisions) (flutter/flutter#185872) 2026-05-01 [email protected] dev: Remove unused parameters (flutter/flutter#185345) 2026-05-01 [email protected] Roll Fuchsia Linux SDK from HN5VYzftnf_B8T-n9... to VnzuUefDQR0UhQ1L1... (flutter/flutter#185870) 2026-05-01 [email protected] Use g_free when using glib memory allocation (flutter/flutter#185519) 2026-05-01 [email protected] Roll Dart SDK from d30df3428f2e to 6d4a319cbdac (2 revisions) (flutter/flutter#185862) 2026-05-01 [email protected] Remove trivial test utility cross-imports from material and cupertino… (flutter/flutter#184295) 2026-05-01 [email protected] Inline test callback painter in tab scaffold test (flutter/flutter#184851) 2026-05-01 [email protected] [a11y] Add support for high contrast themes in the a11y assessments app (flutter/flutter#185801) 2026-05-01 [email protected] [a11y assessment app] Use default color for banner (flutter/flutter#185804) 2026-04-30 [email protected] Added name to AUTHORS (flutter/flutter#185586) 2026-04-30 [email protected] Remove semantics_tester import from raw_material_button_test.dart (flutter/flutter#184806) 2026-04-30 [email protected] Remove semantics_tester import from user_accounts_drawer_header_test.dart (flutter/flutter#184809) 2026-04-30 [email protected] Roll Skia from 7b88c5c281e5 to 2e279266f06a (5 revisions) (flutter/flutter#185854) 2026-04-30 [email protected] Handle symmetric rectangular and elliptical round super ellipses in the uber SDF renderer (flutter/flutter#185695) 2026-04-30 [email protected] Match on process name before killing for SwiftPM (flutter/flutter#185774) 2026-04-30 [email protected] Sync CHANGELOG.md from stable (flutter/flutter#185838) 2026-04-30 [email protected] Roll Dart SDK from 25910e31a6d2 to d30df3428f2e (5 revisions) (flutter/flutter#185839) 2026-04-30 [email protected] Check cross imports test subfolders (flutter/flutter#185493) 2026-04-30 [email protected] test: inline TestCallbackPainter in cupertino/picker_test.dart (flutter/flutter#185398) 2026-04-30 [email protected] Update customer testing version (flutter/flutter#185830) 2026-04-30 [email protected] Adapt the Metal shader library output list for debug versus release mode (flutter/flutter#185798) 2026-04-30 [email protected] [Impeller] Port a recent Vulkan swapchain fence waiting fix to the AHB version of the swapchain (flutter/flutter#185763) 2026-04-30 [email protected] Roll Skia from 26a59aa71eff to 7b88c5c281e5 (1 revision) (flutter/flutter#185821) 2026-04-30 [email protected] Roll Skia from 6b4167b4e204 to 26a59aa71eff (4 revisions) (flutter/flutter#185808) 2026-04-30 [email protected] [a11y] Mark SemanticsNode dirty when customSemanticsActions change (flutter/flutter#185707) 2026-04-30 [email protected] Roll Skia from 1bd2f1cc2746 to 6b4167b4e204 (8 revisions) (flutter/flutter#185799) 2026-04-30 [email protected] [iOS] Extract FlutterVSyncClient from vsync_waiter_ios (flutter/flutter#185737) 2026-04-30 [email protected] Roll Fuchsia Linux SDK from nnv8-SSam6yE8dw4z... to HN5VYzftnf_B8T-n9... (flutter/flutter#185782) 2026-04-29 [email protected] [iOS] Soften TaskRunner.postTask(delay:task:) delay check (flutter/flutter#185729) 2026-04-29 [email protected] Add reportErrors to ImageStreamListener (flutter/flutter#180327) 2026-04-29 [email protected] Roll Skia from f5c781c083c7 to 1bd2f1cc2746 (5 revisions) (flutter/flutter#185761) 2026-04-29 [email protected] Update merge semantics logic to merge sibling nodes (flutter/flutter#183745) 2026-04-29 [email protected] Roll Packages from ba80f8f to cde5b36 (12 revisions) (flutter/flutter#185748) 2026-04-29 [email protected] examples: Remove unused parameters (flutter/flutter#185346) 2026-04-29 [email protected] Update TickerMode.getValuesNotifier to handle initialization during State.dispose (flutter/flutter#185248) 2026-04-29 [email protected] Update triage links (flutter/flutter#185714) 2026-04-29 [email protected] Add support for high contrast and color inversion on Android (flutter/flutter#182263) 2026-04-29 [email protected] Roll Skia from 05251260fda6 to f5c781c083c7 (2 revisions) (flutter/flutter#185743) ...
The app bar was using
backgroundColor: inversePrimarybefore. the inversePrimary color doesn't change in high contrast mode. update it to use primary and onPrimary.Also added PageTransition
Pre-launch Checklist
///).If you need help, consider asking for advice on the #hackers-new channel on Discord.
If this change needs to override an active code freeze, provide a comment explaining why. The code freeze workflow can be overridden by code reviewers. See pinned issues for any active code freezes with guidance.
Note: The Flutter team is currently trialing the use of Gemini Code Assist for GitHub. Comments from the
gemini-code-assistbot 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.