Skip to content

Commit 65564e6

Browse files
authored
Add missing Widget of the Week videos to widget API docs (flutter#191070)
Add missing Widget of the Week videos to widget API docs. <img width="1512" height="982" alt="Screenshot 2026-08-14 at 12 50 04 AM" src="https://github.com/user-attachments/assets/b3a2072e-4b4d-4ad7-baa7-50baf9aeed15" /> Audited all [181](https://www.youtube.com/playlist?list=PLjxrf2q8roU23XGwz3Km7sQZFTdB996iG) videos and added missing ones in the docs. <!-- Thanks for filing a pull request! Reviewers are typically assigned within a week of filing a request. To learn more about code review, see our documentation on Tree Hygiene: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md --> Fixes flutter#191031 Also check flutter/packages#12468 ## Pre-launch Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [AI contribution guidelines] and understand my responsibilities, or I am not using AI tools. - [x] I read the [Tree Hygiene] wiki page, which explains my responsibilities. - [x] I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement]. - [x] I signed the [CLA]. - [x] I listed at least one issue that this PR fixes in the description above. - [x] I updated/added relevant documentation (doc comments with `///`). - [ ] I added new tests to check the change I am making, or this PR is [test-exempt]. - [x] I followed the [breaking change policy] and added [Data Driven Fixes] where supported. - [x] All existing and new tests are passing. If you need help, consider asking for advice on the #hackers-new channel on [Discord]. If this change needs to override an active code freeze, provide a comment explaining why. The code freeze workflow can be overridden by code reviewers. See pinned issues for any active code freezes with guidance. **Note**: The Flutter team is currently trialing the use of [Gemini Code Assist for GitHub](https://developers.google.com/gemini-code-assist/docs/review-github-code). 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. <!-- Links --> [Contributor Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview [AI contribution guidelines]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#ai-contribution-guidelines [Tree Hygiene]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md [test-exempt]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests [Flutter Style Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md [Features we expect every widget to implement]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement [CLA]: https://cla.developers.google.com/ [flutter/tests]: https://github.com/flutter/tests [breaking change policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes [Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md [Data Driven Fixes]: https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md
1 parent 3ce270e commit 65564e6

6 files changed

Lines changed: 18 additions & 1 deletion

File tree

‎packages/flutter/lib/src/widgets/basic.dart‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3955,6 +3955,8 @@ class IgnoreBaseline extends SingleChildRenderObjectWidget {
39553955

39563956
/// A sliver that contains a single box widget.
39573957
///
3958+
/// {@youtube 560 315 https://www.youtube.com/watch?v=vWec9DrAbHE}
3959+
///
39583960
/// Slivers are special-purpose widgets that can be combined using a
39593961
/// [CustomScrollView] to create custom scroll effects. A [SliverToBoxAdapter]
39603962
/// is a basic sliver that creates a bridge back to one of the usual box-based
@@ -4397,6 +4399,9 @@ sealed class _SemanticsBase extends SingleChildRenderObjectWidget {
43974399
///
43984400
/// {@macro flutter.widgets.SemanticsBase}
43994401
/// * [Semantics], the widget variant of this sliver.
4402+
///
4403+
/// {@youtube 560 315 https://www.youtube.com/watch?v=lPWrd08swlw}
4404+
///
44004405
@immutable
44014406
class SliverSemantics extends _SemanticsBase {
44024407
/// Creates a semantic annotation.
@@ -6987,7 +6992,9 @@ class RawImage extends LeafRenderObjectWidget {
69876992
);
69886993
properties.add(DiagnosticsProperty<bool>('invertColors', invertColors));
69896994
properties.add(EnumProperty<FilterQuality>('filterQuality', filterQuality));
6990-
properties.add(EnumProperty<BlendMode>('blendMode', blendMode, defaultValue: BlendMode.srcOver));
6995+
properties.add(
6996+
EnumProperty<BlendMode>('blendMode', blendMode, defaultValue: BlendMode.srcOver),
6997+
);
69916998
}
69926999
}
69937000

‎packages/flutter/lib/src/widgets/expansible.dart‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -203,6 +203,8 @@ class ExpansibleController extends ChangeNotifier {
203203

204204
/// A [StatefulWidget] that expands and collapses.
205205
///
206+
/// {@youtube 560 315 https://www.youtube.com/watch?v=TfoJ55nx1S4}
207+
///
206208
/// An [Expansible] consists of a header, which is always shown, and a
207209
/// body, which is hidden in its collapsed state and shown in its expanded
208210
/// state.

‎packages/flutter/lib/src/widgets/magnifier.dart‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -429,6 +429,8 @@ class MagnifierDecoration {
429429

430430
/// A common base class for magnifiers.
431431
///
432+
/// {@youtube 560 315 https://www.youtube.com/watch?v=YBRkVCRP1Gw}
433+
///
432434
/// {@tool dartpad}
433435
/// This sample demonstrates what a magnifier is, and how it can be used.
434436
///

‎packages/flutter/lib/src/widgets/nested_scroll_view.dart‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,8 @@ typedef NestedScrollViewHeaderSliversBuilder =
4242
/// A scrolling view inside of which can be nested other scrolling views, with
4343
/// their scroll positions being intrinsically linked.
4444
///
45+
/// {@youtube 560 315 https://www.youtube.com/watch?v=DeB2kyLfvfo}
46+
///
4547
/// The most common use case for this widget is a scrollable view with a
4648
/// flexible [SliverAppBar] containing a [TabBar] in the header (built by
4749
/// [headerSliverBuilder]), and with a [TabBarView] in the [body], such that the

‎packages/flutter/lib/src/widgets/overlay.dart‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1791,6 +1791,8 @@ enum OverlayChildLocation {
17911791

17921792
/// A widget that renders its overlay child on an [Overlay].
17931793
///
1794+
/// {@youtube 560 315 https://www.youtube.com/watch?v=S0Ylpa44OAQ}
1795+
///
17941796
/// The overlay child is initially hidden until [OverlayPortalController.show]
17951797
/// is called on the associated [controller]. The [OverlayPortal] uses
17961798
/// [overlayChildBuilder] to build its overlay child and renders it on the

‎packages/flutter/lib/src/widgets/sliver_fill.dart‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -178,6 +178,8 @@ class _RenderSliverFractionalPadding extends RenderSliverEdgeInsetsPadding {
178178
/// A sliver that contains a single box child that fills the remaining space in
179179
/// the viewport.
180180
///
181+
/// {@youtube 560 315 https://www.youtube.com/watch?v=egZjhWNqrXc}
182+
///
181183
/// _To learn more about slivers, see [CustomScrollView.slivers]._
182184
///
183185
/// [SliverFillRemaining] will size its [child] to fill the viewport in the

0 commit comments

Comments
 (0)