Update the `RangeSlider` widget to the 2024 Material Design appearance by TahaTesser · Pull Request #163736 · flutter/flutter

TahaTesser · 2025-02-20T16:11:43Z

Fixes Update RangeSlider for Material 3 redesign

Description

This PR updates RangeSlider with year2023 flag which can be used to opt into the 2024 `RangeSlider design appearance.

Code Sample

expand to view the code sample

import 'package:flutter/material.dart';

void main() => runApp(const RangeSliderExampleApp());

class RangeSliderExampleApp extends StatelessWidget {
  const RangeSliderExampleApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        sliderTheme: const SliderThemeData(
          showValueIndicator: ShowValueIndicator.always,
        ),
      ),
      home: Scaffold(
        appBar: AppBar(title: const Text('RangeSlider Sample')),
        body: const RangeSliderExample(),
      ),
    );
  }
}

class RangeSliderExample extends StatefulWidget {
  const RangeSliderExample({super.key});

  @override
  State<RangeSliderExample> createState() => _RangeSliderExampleState();
}

class _RangeSliderExampleState extends State<RangeSliderExample> {
  RangeValues _currentRange1Values = const RangeValues(20.0, 60.0);
  RangeValues _currentRange2Values = const RangeValues(30.0, 80.0);

  @override
  Widget build(BuildContext context) {
    return Column(
      spacing: 20.0,
      mainAxisAlignment: MainAxisAlignment.center,
      children: <Widget>[
        RangeSlider(
          year2023: false,
          values: _currentRange1Values,
          max: 100,
          onChanged: (RangeValues values) {
            setState(() {
              _currentRange1Values = values;
            });
          },
        ),
        RangeSlider(
          year2023: false,
          values: _currentRange2Values,
          max: 100,
          divisions: 10,
          labels: RangeLabels(
            _currentRange2Values.start.round().toString(),
            _currentRange2Values.end.round().toString(),
          ),
          onChanged: (RangeValues values) {
            setState(() {
              _currentRange2Values = values;
            });
          },
        ),
      ],
    );
  }
}

Preview 1	Preview 2

Custom track gap and thumb size

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.

QuncCccccc

Thanks so much for adding the new M3 style for RangeSlider! I just did the first round review and it looks really great!

dev/tools/gen_defaults/lib/range_slider_template.dart

packages/flutter/lib/src/material/range_slider.dart

QuncCccccc · 2025-03-14T22:51:01Z

packages/flutter/lib/src/material/range_slider.dart

+    if (_active && thumbWidth != null && pressedThumbWidth != null && trackGap != null) {
+      delta = thumbWidth - pressedThumbWidth;
+      if (thumbWidth > 0.0) {
+        thumbWidth = pressedThumbWidth;


When thumbWidth is > 0, thumbWidth equals to pressedThumbWidth, but is it possible that thumbWidth is <= 0?

Good question! The thumb shape actually renders the thumb with a non-negative size when passing a negative thumbWidth. For instance, passing -10 will render a thumb shape with a width of 10 pixels.

As a result, the thumbWidth > 0.0 condition actually ignores the pressed width. We don't need this condition since the thumb renders just fine with a negative width, and it should have a pressed width as well. I'll remove this condition.

packages/flutter/test/material/range_slider_test.dart

packages/flutter/test/material/slider_theme_test.dart

dkwingsmt · 2025-04-23T18:00:49Z

@QuncCccccc Gentle nudge (from triage)

QuncCccccc

LGTM once we fix the conflicts! Sorry for the late response!

TahaTesser · 2025-05-08T18:40:16Z

LGTM once we fix the conflicts! Sorry for the late response!

Thanks! I'll resolve the conflicts.

TahaTesser · 2025-05-15T08:40:26Z

Resolved conflicts. Could you please take a last look? @QuncCccccc

QuncCccccc

LGTM:)

…ppearance (flutter/flutter#163736)

Roll Flutter from 9a78af5 to 33cdd8e (60 revisions) flutter/flutter@9a78af5...33cdd8e 2025-05-21 [email protected] Feat: Add persistentFooterDecoration for scaffold (flutter/flutter#167524) 2025-05-21 [email protected] Removed repeated entry in `CHANGELOG.md` (flutter/flutter#165273) 2025-05-21 [email protected] [native assets] Graduate to preview (flutter/flutter#169194) 2025-05-21 [email protected] [Impeller] disable gl ext render to texture on vivante. (flutter/flutter#169153) 2025-05-21 [email protected] fix(widget_inspector): add null check for flex factor property to prevent exception (flutter/flutter#167890) 2025-05-21 [email protected] Unpin leak_tracker. (flutter/flutter#169079) 2025-05-21 [email protected] runtime/dart: fuchsia::io::MODE_TYPE_FILE -> V_TYPE_FILE (flutter/flutter#168952) 2025-05-21 [email protected] Remove `isExplicitPackageDependenciesEnabled: true`, it is the default. (flutter/flutter#169156) 2025-05-21 [email protected] Roll pub packages (flutter/flutter#169181) 2025-05-20 [email protected] Fix the issue with Tooltip (flutter/flutter#168546) 2025-05-20 [email protected] [native assets] Roll dependencies (flutter/flutter#169073) 2025-05-20 [email protected] Add documentation for experimental branches, update artifacts. (flutter/flutter#169109) 2025-05-20 [email protected] [flutter_tool] Remove unused environment flags in JS compiler (flutter/flutter#169097) 2025-05-20 [email protected] Add support for hiding widget subtrees from the widget inspector (flutter/flutter#169007) 2025-05-20 [email protected] Roll Fuchsia GN SDK from jsZSHIOmQAs3URvWU... to _tkqOQZ2qB5CxDe57... (flutter/flutter#169113) 2025-05-20 [email protected] Skip running `Linux fuchsia_test` on non-master channel. (flutter/flutter#169106) 2025-05-19 [email protected] Roll Skia from c97451da059f to 13a299964c9f (61 revisions) (flutter/flutter#169099) 2025-05-19 [email protected] Shared element transition for predictive back (flutter/flutter#154718) 2025-05-19 [email protected] Fix DDC library bundle format test files to correctly pass flags (flutter/flutter#169095) 2025-05-19 [email protected] Clean up redundant new line in the GPUSurfaceGLSkia constructor initializer list (flutter/flutter#169031) 2025-05-19 [email protected] Fix keyboard_hot_restart_ios flakes (flutter/flutter#168518) 2025-05-19 [email protected] fix android studio lint about lambda argument (flutter/flutter#168901) 2025-05-19 [email protected] Fix typo in gpu_surface_gl_impeller.cc (flutter/flutter#168395) 2025-05-19 [email protected] Modernize system executable detection across components (flutter/flutter#169018) 2025-05-19 [email protected] Update documentation for `Size` and `Rect` classes (flutter/flutter#168031) 2025-05-19 [email protected] Update the `RangeSlider` widget to the 2024 Material Design appearance (flutter/flutter#163736) 2025-05-19 [email protected] Roll Packages from 58d4016 to af0b9a9 (5 revisions) (flutter/flutter#169075) 2025-05-19 [email protected] Only bundle assets and plugins from transitive closure of dependencies (flutter/flutter#160443) 2025-05-19 [email protected] Make FlutterGeneratedPluginSwiftPackage an Xcode root package (flutter/flutter#168789) 2025-05-19 [email protected] docs: Update deprecation message for Slider.year2023 (flutter/flutter#169053) 2025-05-18 [email protected] macOS: port ResizeSynchronizer to Swift (flutter/flutter#168959) 2025-05-17 [email protected] Roll Dart SDK from dc323ec0c1a3 to 7c40eba6bf77 (3 revisions) (flutter/flutter#169024) 2025-05-17 [email protected] [tool] Remove unused `reportNullSafety` getter (flutter/flutter#168484) 2025-05-17 [email protected] Add flag to skip bundling extension safe builds in frameworks for DDM (flutter/flutter#168955) 2025-05-16 [email protected] Fixes Navigator calls onPopInvokedWithResult when onPopPage return false (flutter/flutter#168567) 2025-05-16 [email protected] [hcpp/hc] Fix talkback for HC and HCPP Android platform views (flutter/flutter#168939) 2025-05-16 [email protected] [Impeller] separate immutable sampler descriptors. (flutter/flutter#169011) 2025-05-16 [email protected] TextField magnifier stuck on long press cancel (flutter/flutter#167881) 2025-05-16 [email protected] Fix Chip delete button semantic bounds (flutter/flutter#168310) 2025-05-16 [email protected] Roll Fuchsia Linux SDK from Jj-iDG5uPOsFgY2_H... to XtPp9bBW49iDJ0wbA... (flutter/flutter#169009) 2025-05-16 [email protected] [ Widget Preview ] Refactor `@Preview()` detection and code generation (flutter/flutter#168307) 2025-05-16 [email protected] Roll Packages from 2dff621 to 58d4016 (2 revisions) (flutter/flutter#168999) 2025-05-16 [email protected] Remove `unittests` from `windows_host_engine` GN targets. (flutter/flutter#168991) 2025-05-16 [email protected] Fix bug with debugging support code not getting injected on edge devices (flutter/flutter#168073) 2025-05-16 [email protected] Roll Dart SDK from a1db62a5dd14 to dc323ec0c1a3 (4 revisions) (flutter/flutter#168989) 2025-05-16 [email protected] Resolve Cupertino textstyle in MaterialBasedCupertinoThemeData (flutter/flutter#167597) ...

…ppearance (flutter/flutter#163736)

github-actions bot added framework flutter/packages/flutter repository. See also f: labels. f: material design flutter/packages/flutter/material repository. labels Feb 20, 2025

TahaTesser marked this pull request as ready for review February 21, 2025 11:24

TahaTesser requested a review from matanlurey as a code owner February 21, 2025 11:24

TahaTesser requested review from QuncCccccc and removed request for matanlurey February 21, 2025 11:24

TahaTesser mentioned this pull request Feb 21, 2025

FYI matanlurey (does not require review, but probably should) on dev/test infra. #162642

Merged

ferraridamiano mentioned this pull request Feb 22, 2025

[Proposal] Add Support for centered property to the new 2024 Material slider #163916

Open

QuncCccccc reviewed Mar 14, 2025

View reviewed changes

TahaTesser requested a review from QuncCccccc April 1, 2025 07:51

QuncCccccc approved these changes Apr 29, 2025

View reviewed changes

TahaTesser added 2 commits May 14, 2025 23:07

Update the RangeSlider widget to the 2024 Material Design appearance

bfc9ca5

Address feedback

7dd9f49

QuncCccccc self-requested a review May 15, 2025 23:41

QuncCccccc approved these changes May 19, 2025

View reviewed changes

QuncCccccc added the autosubmit Merge PR when tree becomes green via auto submit App label May 19, 2025

auto-submit bot added this pull request to the merge queue May 19, 2025

Merged via the queue into flutter:master with commit 559c314 May 19, 2025
151 checks passed

flutter-dashboard bot removed the autosubmit Merge PR when tree becomes green via auto submit App label May 19, 2025

engine-flutter-autoroll mentioned this pull request May 19, 2025

Roll Flutter from 9a78af5eb067 to 559c314ba3fd (35 revisions) flutter/packages#9290

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 19, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

d42f6d2

…ppearance (flutter/flutter#163736)

engine-flutter-autoroll mentioned this pull request May 19, 2025

Roll Flutter from 9a78af5eb067 to 5bcde8fa7b82 (36 revisions) flutter/packages#9291

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 19, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

3e88077

…ppearance (flutter/flutter#163736)

engine-flutter-autoroll mentioned this pull request May 19, 2025

Roll Flutter from 9a78af5eb067 to 80f5de5da95d (38 revisions) flutter/packages#9292

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 19, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

32fcbfa

…ppearance (flutter/flutter#163736)

TahaTesser deleted the m3_range_slider_design branch May 20, 2025 06:19

engine-flutter-autoroll mentioned this pull request May 20, 2025

Roll Flutter from 9a78af5eb067 to c04cd2b18ebf (46 revisions) flutter/packages#9294

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 20, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

e80cce7

…ppearance (flutter/flutter#163736)

engine-flutter-autoroll mentioned this pull request May 20, 2025

Roll Flutter from 9a78af5eb067 to c04cd2b18ebf (46 revisions) flutter/packages#9296

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 20, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

3669070

…ppearance (flutter/flutter#163736)

engine-flutter-autoroll mentioned this pull request May 21, 2025

Roll Flutter from 9a78af5eb067 to 61fe9b6b67c0 (55 revisions) flutter/packages#9299

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 21, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

d540455

…ppearance (flutter/flutter#163736)

engine-flutter-autoroll mentioned this pull request May 21, 2025

Roll Flutter from 9a78af5eb067 to dd671fae53d3 (56 revisions) flutter/packages#9301

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 21, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

26f0d23

…ppearance (flutter/flutter#163736)

engine-flutter-autoroll mentioned this pull request May 21, 2025

Roll Flutter from 9a78af5eb067 to 534b250a562c (58 revisions) flutter/packages#9303

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 21, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

81235e3

…ppearance (flutter/flutter#163736)

engine-flutter-autoroll mentioned this pull request May 21, 2025

Roll Flutter from 9a78af5eb067 to f7354da75b27 (59 revisions) flutter/packages#9304

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 21, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

553dedb

…ppearance (flutter/flutter#163736)

engine-flutter-autoroll mentioned this pull request May 21, 2025

Roll Flutter from 9a78af5eb067 to 33cdd8ef31dc (60 revisions) flutter/packages#9305

Merged

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 21, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

c5366e2

…ppearance (flutter/flutter#163736)

Piinks mentioned this pull request May 23, 2025

Flutter Notable Commits - 2025 #161460

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Aug 14, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

3fc9bb0

…ppearance (flutter/flutter#163736)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Aug 14, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

beff6d6

…ppearance (flutter/flutter#163736)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Aug 15, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

218ff29

…ppearance (flutter/flutter#163736)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Aug 15, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

b7ec35f

…ppearance (flutter/flutter#163736)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Aug 16, 2025

559c314 Update the RangeSlider widget to the 2024 Material Design a…

e6d993a

…ppearance (flutter/flutter#163736)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Update the `RangeSlider` widget to the 2024 Material Design appearance#163736

Update the `RangeSlider` widget to the 2024 Material Design appearance#163736
auto-submit[bot] merged 2 commits intoflutter:masterfrom
TahaTesser:m3_range_slider_design

TahaTesser commented Feb 20, 2025

Uh oh!

QuncCccccc left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

QuncCccccc Mar 14, 2025

Uh oh!

TahaTesser Mar 19, 2025

Uh oh!

Uh oh!

Uh oh!

dkwingsmt commented Apr 23, 2025

Uh oh!

QuncCccccc left a comment

Uh oh!

TahaTesser commented May 8, 2025

Uh oh!

TahaTesser commented May 15, 2025

Uh oh!

QuncCccccc left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

TahaTesser commented Feb 20, 2025

Description

Code Sample

Custom track gap and thumb size

Pre-launch Checklist

Uh oh!

QuncCccccc left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

QuncCccccc Mar 14, 2025

Choose a reason for hiding this comment

Uh oh!

TahaTesser Mar 19, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

dkwingsmt commented Apr 23, 2025

Uh oh!

QuncCccccc left a comment

Choose a reason for hiding this comment

Uh oh!

TahaTesser commented May 8, 2025

Uh oh!

TahaTesser commented May 15, 2025

Uh oh!

QuncCccccc left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants