The comment of the CircularProgressIndicator.adaptive() is misleading.

Here's a comment of the CircularProgressIndicator.adaptive()

 /// Creates an adaptive progress indicator that is a
 /// [CupertinoActivityIndicator] in iOS and [CircularProgressIndicator] in
 /// material theme/non-iOS.
 ///
 /// The [value], [backgroundColor], [valueColor], [strokeWidth],
 /// [semanticsLabel], and [semanticsValue] will be ignored in iOS.
 ///
 /// {@macro flutter.material.ProgressIndicator.ProgressIndicator}
 const CircularProgressIndicator.adaptive({
   super.key,
   super.value,
   super.backgroundColor,
   super.valueColor,
   this.strokeWidth = 4.0,
   super.semanticsLabel,
   super.semanticsValue,
 }) : _indicatorType = _ActivityIndicatorType.adaptive;

I noticed that comment says that

/// The [value], [backgroundColor], [valueColor], [strokeWidth],
/// [semanticsLabel], and [semanticsValue] will be ignored in iOS.

but it is actually not true. The backgroundColor changes the color of the CircularProgressIndicator in IOS.
This comment is misleading so it should be changed.

Steps to Reproduce

Execute flutter run on the code sample

Expected results:

CircularProgressIndicator with no backgroundColor

Actual results:

CircularProgressIndicator with a red backgroundColor

Code sample

import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(),
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    return const Scaffold(
      body: Center(
          child: CircularProgressIndicator.adaptive(
        backgroundColor: Colors.red,
      )),
    );
  }
}

@darrenaustin

Thanks for the report. Using below code sample, the listed property values are rendered for CircularProgressIndicator:

body: Center(
          child: CircularProgressIndicator(
            backgroundColor: Colors.blue,
            value: 0.5,
            valueColor: AlwaysStoppedAnimation(Colors.green),
            strokeWidth: 50,
          ),
      ),

For CircularProgessIndicator.adaptive(), though, except backgroundColor, all other properties don't render:

Maybe a similar fix needed: #81427

/cc @darrenaustin

Thank you for confirming the feature. I don't know if it's an expected feature but being able to change the backgroundColor is useful for my case.

Merged in

This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.

Navigation Menu

Repository navigation

The comment of the CircularProgressIndicator.adaptive() is misleading. #118144

Steps to Reproduce

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

The comment of the CircularProgressIndicator.adaptive() is misleading. #118144

Description

Steps to Reproduce

Activity

darshankawar commented on Jan 9, 2023

IsseiKanda commented on Jan 11, 2023

MitchellGoodwin commented on Jan 19, 2023

github-actions commented on Mar 4, 2023

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions