Skip to content

[cupertino_ui] Document translucent default background of CupertinoSlidingSegmentedControl - #13178

Merged
auto-submit[bot] merged 5 commits into
flutter:mainfrom
samar70:docs/sliding-segmented-control-background
Oct 28, 2026
Merged

auto-submit[bot] merged 5 commits into
flutter:mainfrom
samar70:docs/sliding-segmented-control-background

Conversation

@samar70

@samar70 samar70 commented Oct 9, 2026 •

Copy link
Copy Markdown
Contributor

Fixes flutter/flutter#164073
Ports flutter/flutter#186645. Part of flutter/flutter#188444.

Documents that the default background of CupertinoSlidingSegmentedControl is translucent, so content behind unselected segments shows through unless an opaque color is passed. The original issue is flutter/flutter#164073. Tracking issue: flutter/flutter#188444.

cc @NadeemIqbal

Docs-only change, so this is test-exempt. I used AI assistance to port the approved documentation.

Pre-Review Checklist

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. 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.

Footnotes

  1. Regular contributors who have demonstrated familiarity with the repository guidelines only need to comment if the PR is not auto-exempted by repo tooling. ↩ ↩2

@flutter-dashboard

Copy link
Copy Markdown

It looks like this pull request may not have tests. Please make sure to add tests or get an explicit test exemption before merging.

If you are not sure if you need tests, consider this rule of thumb: the purpose of a test is to make sure someone doesn't accidentally revert the fix. Ask yourself, is there anything in your PR that you feel it is important we not accidentally revert back to how it was before your fix?

Reviewers: Read the Tree Hygiene page and make sure this patch meets those guidelines before LGTMing. If you believe this PR qualifies for a test exemption, contact "@test-exemption-reviewer" in the #hackers channel in Discord (don't just cc them here, they won't see it!). The test exemption team is a small volunteer group, so all reviewers should feel empowered to ask for tests, without delegating that responsibility entirely to the test exemption group.

@github-actions github-actions Bot added p: cupertino_ui triage-design Should be looked at in design triage labels Oct 9, 2026

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the documentation for CupertinoSlidingSegmentedControl to clarify that its default background color, CupertinoColors.tertiarySystemFill, is translucent to match the native iOS behavior. It also adds a corresponding changelog entry noting this documentation update. There are no review comments, and I have no feedback to provide.

@Piinks
Piinks requested review from dkwingsmt and pjkammer October 20, 2026 21:24
@pjkammer pjkammer added the CICD Run CI/CD label Oct 23, 2026

@dkwingsmt dkwingsmt left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@flutter-dashboard flutter-dashboard Bot added missing-tests and removed CICD Run CI/CD labels Oct 26, 2026
@flutter-dashboard

Copy link
Copy Markdown

It looks like this pull request may not have tests. Please make sure to add tests or get an explicit test exemption before merging.

If you are not sure if you need tests, consider this rule of thumb: the purpose of a test is to make sure someone doesn't accidentally revert the fix. Ask yourself, is there anything in your PR that you feel it is important we not accidentally revert back to how it was before your fix?

Reviewers: Read the Tree Hygiene page and make sure this patch meets those guidelines before LGTMing. If both you and the PR author believe this PR qualifies for a test exemption, escalate to the tech lead for the changed area to review and apply the test-exempt label. All reviewers should feel empowered to ask for tests before escalating.

@@ -0,0 +1,2 @@
changelog: Documents that the default background of CupertinoSlidingSegmentedControl is translucent.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this should probably follow the template format, even for a single item, so that it's formatted correctly and not merged with another item. That is...

changelog: |
  - Documents that the default background of `CupertinoSlidingSegmentedControl` is translucent.

@pjkammer pjkammer added the CICD Run CI/CD label Oct 28, 2026
@pjkammer pjkammer added the autosubmit Merge PR when tree becomes green via auto submit App label Oct 28, 2026
@auto-submit auto-submit Bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Oct 28, 2026
@auto-submit

auto-submit Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

autosubmit label was removed for flutter/packages/13178, because - This pull request has the missing-tests label and does not have the test-exempt label. Please add tests or obtain a test exemption from a tech lead before re-applying the autosubmit label.

@pjkammer pjkammer added autosubmit Merge PR when tree becomes green via auto submit App test-exempt Exempt from tests. Overrides `missing-tests` label labels Oct 28, 2026
@auto-submit
auto-submit Bot merged commit 4dd0e3e into flutter:main Oct 28, 2026
14 checks passed
Rheoz pushed a commit to Rheoz/flutter that referenced this pull request Oct 29, 2026
flutter/packages@13d38e0...0b72e92

2026-10-29 [email protected] [material_ui]
Mirror the GappedSliderTrackShape secondary track correctly in RTL
(flutter/packages#13226)
2026-10-29 [email protected] [pigeon] update jni dependency to ^1.1.1
and remove workaround proguard rules (flutter/packages#13464)
2026-10-28 [email protected] [cupertino_ui]
Document translucent default background of
CupertinoSlidingSegmentedControl (flutter/packages#13178)
2026-10-28 [email protected] [flutter_svg] Throw on non-2xx responses in
SvgNetworkLoader (flutter/packages#13403)
2026-10-28 [email protected] [tool] Fix package
matching logic for `--package-tags` filter (flutter/packages#13472)
2026-10-28 [email protected] Roll Flutter from
d4c8577 to 0c2473c (21 revisions) (flutter/packages#13470)

If this roll has caused a breakage, revert this CL and set the roller
to dry run mode using the controls here:
https://autoroll.skia.org/r/flutter-packages-flutter-autoroll
Please CC [email protected] on the revert to ensure that a
human
is aware of the problem.

To file a bug in Flutter:
https://github.com/flutter/flutter/issues/new/choose

To report a problem with the AutoRoller itself, please file a bug:
https://issues.skia.org/issues/new?component=1389291&template=1850622

Documentation for the AutoRoller is here:
https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

autosubmit Merge PR when tree becomes green via auto submit App CICD Run CI/CD missing-tests p: cupertino_ui test-exempt Exempt from tests. Overrides `missing-tests` label triage-design Should be looked at in design triage

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Clearly document that CupertinoSlidingSegmentedControl's unselected segments are translucent

3 participants