Is there any definite list of Sliver widgets

robotoaster picture robotoaster · Jun 12, 2017 · Viewed 19.4k times · Source

I am trying to use Sliver to implement collapsible list header. As I am changing widgets from normal to Sliver I often end up with error like this:

I/flutter ( 3141): ══╡ EXCEPTION CAUGHT BY WIDGETS LIBRARY ╞═══════════════════════════════════════════════════════════
I/flutter ( 3141): The following assertion was thrown building NotificationListener<ScrollNotification>():
I/flutter ( 3141): A RenderViewport expected a child of type RenderSliver but received a child of type
I/flutter ( 3141): RenderRepaintBoundary.
I/flutter ( 3141): RenderObjects expect specific types of children because they coordinate with their children during
I/flutter ( 3141): layout and paint. For example, a RenderSliver cannot be the child of a RenderBox because a
I/flutter ( 3141): RenderSliver does not understand the RenderBox layout protocol.
I/flutter ( 3141):

I/flutter ( 3141): The RenderViewport that expected a RenderSliver child was created by:
I/flutter ( 3141):   Viewport ← _ScrollableScope ← IgnorePointer-[GlobalKey#307856652] ← Listener ← _GestureSemantics ←
I/flutter ( 3141):   RawGestureDetector-[LabeledGlobalKey<RawGestureDetectorState>#701223524] ← RepaintBoundary ←
I/flutter ( 3141):   CustomPaint ← RepaintBoundary ← NotificationListener<ScrollNotification> ←
I/flutter ( 3141):   GlowingOverscrollIndicator ← Scrollable ← ⋯
I/flutter ( 3141):
I/flutter ( 3141): The RenderRepaintBoundary that did not match the expected child type was created by:
I/flutter ( 3141):   RepaintBoundary ← NotificationListener<ScrollNotification> ← GlowingOverscrollIndicator ←
I/flutter ( 3141):   Scrollable ← SingleChildScrollView ← Viewport ← _ScrollableScope ←
I/flutter ( 3141):   IgnorePointer-[GlobalKey#307856652] ← Listener ← _GestureSemantics ←
I/flutter ( 3141):   RawGestureDetector-[LabeledGlobalKey<RawGestureDetectorState>#701223524] ← RepaintBoundary ← ⋯
I/flutter ( 3141):

My understanding is this is because normal widgets can't be used directly to render in Sliver widgets.

Is there any definite list of Sliver widgets in the framework?

sliver.dart doesn't show much

Answer

Collin Jackson picture Collin Jackson · Jun 12, 2017

The docs for RenderSliver seem to be the closest thing we have to definitive Sliver documentation at the moment.

RenderSliver is implemented by

  • RenderSliverHelpers (mixin)
  • RenderSliverMultiBoxAdaptor (abstract)
    • RenderSliverFixedExtentBoxAdaptor (abstract)
      • _RenderSliverPrototypeExtentList (concrete)
      • RenderSliverFillViewport (concrete)
      • RenderSliverFixedExtentList (concrete)
    • RenderSliverGrid (concrete)
    • RenderSliverList (concrete)
  • RenderSliverPadding (concrete)
  • RenderSliverPersistentHeader (abstract)
    • RenderSliverFloatingPersistentHeader (concrete)
      • RenderSliverFloatingPinnedPersistentHeader (concrete)
    • RenderSliverPinnedPersistentHeader (concrete)
    • RenderSliverScrollingPersistentHeader (concrete)
  • RenderSliverSingleBoxAdapter (abstract)
    • RenderSliverFillRemaining (concrete)
    • RenderSliverToBoxAdapter (concrete)

These RenderSliver implementations are created by the following widgets:

SliverMultiBoxAdaptorWidget subclasses:

StatelessWidget subclasses:

SingleChildRenderObjectWidget subclasses:

So those are the widgets you can use when you want to produce instances of RenderSliver.

Of course, it's likely that more and more RenderSliver-creating widgets will be added over time, and you can also make your own! Hopefully this list will be enough to get you started.