-
Notifications
You must be signed in to change notification settings - Fork 29.7k
Update Theme documentation with Cupertino details
#161980
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
|
Some more context around this change can be found here: #161573 (comment) |
justinmc
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM with nits.
I left a question, I want to understand this more, but I'm giving an LGTM just to make sure I don't end up blocking this PR from landing. It's definitely an improvement already.
| /// To interact seamlessly with descendant Cupertino widgets, the [Theme] widget | ||
| /// implies a [CupertinoTheme] widget with a [CupertinoThemeData] inherited from | ||
| /// the nearest ancestor [CupertinoTheme] or if none exists, derived from the | ||
| /// Material [data] for the [Theme]. The values in the Material derived [CupertinoThemeData] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nit: hyphen "Material-derived"
| /// [ThemeData.iconTheme] of the [data] for the [Theme]. | ||
| /// | ||
| /// To interact seamlessly with descendant Cupertino widgets, the [Theme] widget | ||
| /// implies a [CupertinoTheme] widget with a [CupertinoThemeData] inherited from |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What do you mean by "implies" here?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I was trying to say "internally creates a CupertinoTheme for its descendants" without saying it. Maybe I should just say "the [Theme] widget provides a [CupertinoTheme] for its descendants with a [CupertinoThemeData]....".
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yeah I think that's better. I think "implies" could be interpreted to mean that CupertinoTheme must be present elsewhere or something like that.
|
Golden file changes have been found for this pull request. Click here to view and triage (e.g. because this is an intentional change). If you are still iterating on this change and are not ready to resolve the images on the Flutter Gold dashboard, consider marking this PR as a draft pull request above. You will still be able to view image results on the dashboard, commenting will be silenced, and the check will not try to resolve itself until marked ready for review. For more guidance, visit Writing a golden file test for Reviewers: Read the Tree Hygiene page and make sure this patch meets those guidelines before LGTMing. |
674373c to
6e53934
Compare
justinmc
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM 👍
Updates
Themedocumentation to note how it interacts with descendantCupertinowidgets.Fixes #161573
Pre-launch Checklist
///).