github/flutter
7
0
Fork 0
mirror of https://github.com/flutter/flutter.git synced 2025-06-03 00:51:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

Fix StatefulWidget and StatelessWidget Sample Documentation (#30814)

Browse Source
This commit is contained in:
Shi-Hao Hong 2019-04-09 19:32:00 -07:00 committed by GitHub
parent eb30745faf
commit b3bb5cd6b0
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 15 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
packages/flutter/lib/src/widgets/framework.dart
View File

@ -490,7 +490,10 @@ abstract class Widget extends DiagnosticableTree {
///
/// {@tool sample}
///
/// The following is a skeleton of a stateless widget subclass called `GreenFrog`:
/// The following is a skeleton of a stateless widget subclass called `GreenFrog`.
///
/// Normally, widgets have more constructor arguments, each of which corresponds
/// to a `final` property.
///
/// ```dart
/// class GreenFrog extends StatelessWidget {
@ -503,22 +506,21 @@ abstract class Widget extends DiagnosticableTree {
/// }
/// ```
/// {@end-tool}
///
/// {@tool sample}
///
/// Normally widgets have more constructor arguments, each of which corresponds
/// to a `final` property. The next example shows the more generic widget `Frog`
/// which can be given a color and a child:
/// This next example shows the more generic widget `Frog` which can be given
/// a color and a child:
///
/// ```dart
/// class Frog extends StatelessWidget {
/// const Frog({
/// Key key,
/// this.color: const Color(0xFF2DBD3A),
/// this.color = const Color(0xFF2DBD3A),
/// this.child,
/// }) : super(key: key);
///
/// final Color color;
///
/// final Widget child;
///
/// @override
@ -702,7 +704,11 @@ abstract class StatelessWidget extends Widget {
///
/// {@tool sample}
///
/// The following is a skeleton of a stateful widget subclass called `YellowBird`:
/// This is a skeleton of a stateful widget subclass called `YellowBird`.
///
/// In this example. the [State] has no actual state. State is normally
/// represented as private member fields. Also, normally widgets have more
/// constructor arguments, each of which corresponds to a `final` property.
///
/// ```dart
/// class YellowBird extends StatefulWidget {
@ -722,11 +728,7 @@ abstract class StatelessWidget extends Widget {
/// {@end-tool}
/// {@tool sample}
///
/// In this example. the [State] has no actual state. State is normally
/// represented as private member fields. Also, normally widgets have more
/// constructor arguments, each of which corresponds to a `final` property.
///
/// The next example shows the more generic widget `Bird` which can be given a
/// This example shows the more generic widget `Bird` which can be given a
/// color and a child, and which has some internal state with a method that
/// can be called to mutate it:
///
@ -734,12 +736,11 @@ abstract class StatelessWidget extends Widget {
/// class Bird extends StatefulWidget {
/// const Bird({
/// Key key,
/// this.color: const Color(0xFFFFE306),
/// this.color = const Color(0xFFFFE306),
/// this.child,
/// }) : super(key: key);
///
/// final Color color;
///
/// final Widget child;
///
/// _BirdState createState() => _BirdState();