-
Notifications
You must be signed in to change notification settings - Fork 29.8k
Improve InputDecoration.errorMaxLines documentation #156468
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
Improve InputDecoration.errorMaxLines documentation #156468
Conversation
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 👍
Thanks for actually filing this PR after all the discussion in the issue.
| /// Defaults to null, which means that the [helperText] is not limited. | ||
| /// Defaults to null, which means that soft line breaks in [helperText] are | ||
| /// truncated with an ellipse while hard line breaks are respected. | ||
| /// For example, an [helperText] that overflows the width of the field will be |
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.
"an" => "a"
| /// Defaults to null, which means that soft line breaks in [helperText] are | ||
| /// truncated with an ellipse while hard line breaks are respected. | ||
| /// For example, an [helperText] that overflows the width of the field will be | ||
| /// truncated with an ellipse. However, an [helperText] with explicit linebreak |
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.
"an" => "a"
| /// | ||
| /// To get a long [helperText] wrapping, either set [helperMaxLines] or use | ||
| /// [helper] which offers more flexibility, for instance it can be set to a | ||
| /// Text widget with a specific overflow value. |
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: Maybe link Text: [Text].
| /// truncated with an ellipse. However, an [helperText] with explicit linebreak | ||
| /// characters (\n) will display on multiple lines. | ||
| /// | ||
| /// To get a long [helperText] wrapping, either set [helperMaxLines] or use |
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, maybe this sounds better: "To get a long [helperText] wrapping" => "To cause a long [helperText] to wrap"
Same for errorText below.
| /// characters (\n) will display on multiple lines. | ||
| /// | ||
| /// To get a long [helperText] wrapping, either set [helperMaxLines] or use | ||
| /// [helper] which offers more flexibility, for instance it can be set to a |
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: Just an idea to break up this long sentence: "which offers more flexibility, for instance it can" => "which offers more flexibility. For instance, it can"
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.
Same for below as well
406dc53 to
af90bfe
Compare
Description
This PR improves the
InputDecoration.errorMaxLinesandInputDecoration.helperMaxLinesdocumentations to explain when wrapping and ellipsing are applied.Related Issue
Fixes InputDecoration.errorMaxLines's documentation does not match behavior.