flutter_sticky_header

A Flutter implementation of sticky headers with a sliver as a child.

Features

• Accepts one sliver as content.
• Header can overlap its sliver (useful for sticky side header for example).
• Notifies when the header scrolls outside the viewport.
• Can scroll in any direction.
• Supports overlapping (AppBars for example).
• Supports not sticky headers (with sticky: false parameter).
• Supports a controller which notifies the scroll offset of the current sticky header.

Getting started

In the pubspec.yaml of your flutter project, add the following dependency:

dependencies:
  ...
  flutter_sticky_header:

In your library add the following import:

import 'package:flutter_sticky_header/flutter_sticky_header.dart';

For help getting started with Flutter, view the online documentation.

SliverStickyHeader

You can place one or multiple SliverStickyHeaders inside a CustomScrollView.

SliverStickyHeader(
  header: Container(
    height: 60.0,
    color: Colors.lightBlue,
    padding: EdgeInsets.symmetric(horizontal: 16.0),
    alignment: Alignment.centerLeft,
    child: Text(
      'Header #0',
      style: const TextStyle(color: Colors.white),
    ),
  ),
  sliver: SliverList(
    delegate: SliverChildBuilderDelegate(
      (context, i) => ListTile(
            leading: CircleAvatar(
              child: Text('0'),
            ),
            title: Text('List tile #$i'),
          ),
      childCount: 4,
    ),
  ),
);

SliverStickyHeader.builder

If you want to change the header layout during its scroll, you can use the SliverStickyHeader.builder constructor.

The example belows changes the opacity of the header as it scrolls off the viewport.

SliverStickyHeader.builder(
  builder: (context, state) => Container(
        height: 60.0,
        color: (state.isPinned ? Colors.pink : Colors.lightBlue)
            .withOpacity(1.0 - state.scrollPercentage),
        padding: EdgeInsets.symmetric(horizontal: 16.0),
        alignment: Alignment.centerLeft,
        child: Text(
          'Header #1',
          style: const TextStyle(color: Colors.white),
        ),
      ),
  sliver: SliverList(
    delegate: SliverChildBuilderDelegate(
      (context, i) => ListTile(
            leading: CircleAvatar(
              child: Text('0'),
            ),
            title: Text('List tile #$i'),
          ),
      childCount: 4,
    ),
  ),
);

You can find more examples in the Example project.

Changelog

Please see the Changelog page to know what’s recently changed.

Contributions

Feel free to contribute to this project.

If you find a bug or want a feature, but don’t know how to fix/implement it, please fill an issue.
If you fixed a bug or implemented a new feature, please send a pull request.

Download implementation of sticky headers package source code on GitHub

Flutter implementation of sticky headers for sliver
https://github.com/letsar/flutter_sticky_header
174 forks.
907 stars.
32 open issues.

Recent commits:

• Bump version v0.7.0, Romain Rastel
• Merge pull request #100 from fengxuway/fixhashValues update to Object.hash, GitHub
• fix The method 'hashValues' isn't defined for the class 'SliverStickyHeaderState', fengxu04
• bump to 0.6.5, Romain Rastel
• Merge pull request #83 from crunchloop/masterFix the tap offset when overlaps is > 0, GitHub