AdoptAWidget: FittedBox

[singhsuryanshu]

AdoptAWidget: FittedBox

Added a code / DartPad sample to the FittedBox API Docs

This pull request is:

• A code sample
• More references
• More explanation

closes #69478

[flutter-dashboard]

It looks like this pull request may not have tests. Please make sure to add tests before merging. If you need an exemption to this rule, contact Hixie on the #hackers channel in Chat.

Reviewers: Read the Tree Hygiene page and make sure this patch meets those guidelines before LGTMing.

[google-cla]

Thanks for your pull request. It looks like this may be your first contribution to a Google open source project (if not, look below for help). Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

📝 Please visit https://cla.developers.google.com/ to sign.

Once you've signed (or fixed any issues), please reply here with @googlebot I signed it! and we'll verify it.

---

What to do if you already signed the CLA

Individual signers

• It's possible we don't have your GitHub username or you're using a different email address on your commit. Check your existing CLA data and verify that your email is set on your git commits.

Corporate signers

• Your company has a Point of Contact who decides which employees are authorized to participate. Ask your POC to be added to the group of authorized contributors. If you don't know who your Point of Contact is, direct the Google project maintainer to go/cla#troubleshoot (Public version).
• The email used to register you as an authorized contributor must be the email used for the Git commit. Check your existing CLA data and verify that your email is set on your git commits.
• The email used to register you as an authorized contributor must also be attached to your GitHub account.

ℹ️ Googlers: Go here for more info.

[singhsuryanshu]

@googlebot I signed it!

[shihaohong]

You don't need the .tmpl suffix here. Also, Make sure there's at least one space between the code comment /// and the comment contents, here and throughout the change.

Suggested change

	///{@tool sample --template=stateless_widget_scaffold_center.tmpl}
	/// {@tool sample --template=stateless_widget_scaffold_center}

[shihaohong]

• Make sure that each line is shorter than 80 characters if possible
• The dartdocs automatically link widgets, so you do not need to include the URL like you would in a Github comment

Suggested change

	///In this example, the image is stretched to fill the entire [Container](https://master-api.flutter.dev/flutter/widgets/Container-class.html) which would not happen normally without using FittedBox.
	/// In this example, the image is stretched to fill the entire [Container], which would
	/// not happen normally without using FittedBox.

[shihaohong]

Suggested change

	///```dart
	///Widget build(BuildContext) {
	/// return Container(
	/// height: 400,
	/// width: 300,
	/// color: Colors.red,
	/// child: FittedBox(
	/// child: Image.network('https://flutter.github.io/assets-for-api-docs/assets/widgets/owl-2.jpg'),
	/// fit: BoxFit.fill,
	/// ),
	/// );
	///}
	///```
	/// ```dart
	/// Widget build(BuildContext) {
	/// return Container(
	/// height: 400,
	/// width: 300,
	/// color: Colors.red,
	/// child: FittedBox(
	/// child: Image.network('https://flutter.github.io/assets-for-api-docs/assets/widgets/owl-2.jpg'),
	/// fit: BoxFit.fill,
	/// ),
	/// );
	/// }
	/// ```

[shihaohong]

Suggested change

	///{@end-tool}
	/// {@end-tool}

[shihaohong]

Remove extra line

Suggested change

///

[shihaohong]

LGTM

[shihaohong]

nit: Just caught this extra line as well

Suggested change

///

[singhsuryanshu]

The checks are not running .....
@shihaohong

[shihaohong]

@singhsuryanshu The remaining checks are queued but not finished yet

[fluttergithubbot]

This pull request is not suitable for automatic merging in its current state.

• The status or check suite Windows tool_tests has failed. Please fix the issues identified (or deflake) before re-applying this label.

[johnpryan]

@singhsuryanshu Thanks for participating in AdoptAWidget. We would like to send you a special thanks. If you are interested, please send an email to nyener at google dot com and provide a link to this issue.