Paketdetailsv0.1.6

scrollable_list_tabview

Ein Flutter-Widget, das einen ScrollView und eine benutzerdefinierte Tab-Ansicht synchronisiert.

pub.dev API-Dokumentation Quellcode

30-Tage-Downloads: 49
Likes: 166
Pub-Punkte: 40

Paket installieren

flutter pub add scrollable_list_tabview

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein Flutter-Widget, das eine scrollbare Liste mit einer benutzerdefinierten Tab-Ansicht synchronisiert und eine reibungslose Ausrichtung zwischen den beiden Komponenten gewährleistet. Es ermöglicht Benutzern, über das Scrollen durch Inhalte zu navigieren, während gleichzeitig die ausgewählte Registerkarte aktualisiert wird, und umgekehrt. Ideal für kohärente, interaktive Schnittstellen, bei denen Listenitems und Registerkarten eng miteinander verbunden sind. Das Paket ist leichtgewichtig und für nahtlose Integration in bestehende Flutter-Projekte konzipiert.

Anwendungsfälle

Synchronisierte Listen- und Tab-Navigation
Inhaltsreiche Dashboards erstellen
Geführte Onboarding-Flows erstellen
Implementierung von scrollbaren Registerkarten-Schnittstellen

Hauptmerkmale

Echtzeit-Synchronisierung zwischen Scrollen und Registerkarten
Anpassbare Tab-Stilisierung
Unterstützt dynamischen Inhalt
Einfache Integration mit bestehenden Widgets
Reaktionsfähiges Verhalten über Geräte hinweg

Geeignet für

Entwickler, die Tab-basierte Inhaltslayouts erstellen
Apps, die synchronisiertes Scrollen und Tab-Auswahl erfordern
UI-Designer, die interaktive Navigationsmuster suchen

Hinweise

Erfordert manuelle Handhabung der Tab-Element-Daten
Eingeschränkte plattformspezifische Optimierungen
Keine eingebauten Animationen
Nicht geeignet für hochkomplexe verschachtelte Navigationen

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

scrollable_list_tabview

A Flutter widget which synchronize a ScrollView and a custom tab view.

The main idea is to create a custom tab view synchronizing with inner ScrollView. The scroll activity will trigger custom tab view at the top to follow the index of the inner scroll view widget.

Demo

Installation

Add dependency for package on your pubspec.yaml:

dependencies:
    scrollable_list_tabview: <latest>

Usage

To use this widget we must first define how our tabs will look like.

ListTab

Parameter	Definition
`Widget icon`	Trailing widget for a tab, typically an Icon.
`Widget label`	Label to be shown in the tab, must be non-null.
`BorderRadiusGeometry borderRadius`	BorderRadius value for a single tab.
`Color activeBackgroundColor`	Color to be used when the tab is selected.
`Color inactiveBackgroundColor`	Color to be used when the tab isn't selected.
`bool showIconInList`	Decide whether show icon widget in the scrollable view.
`Color borderColor`	Color of the border of tab when its not selected

Then we can use LisTab in ScrollableListTab.

ScrollableListTab

Parameter	Definition
`ListTab tab`	Data model used for rendering tab widgets.
`ScrollView body`	An individual inner scrollable widget.

Then ScrollableListTabView will take a list of ScrollableListTab as an argument.

ScrollableListTabView

Parameter	Definition
`List<ScrollableListTab> tabs`	List of tabs to be built.
`double height`	Height of the tab at the top of the view.
`Duration tabAnimationDuration`	Duration of tab change animation.
`Duration bodyAnimationDuration`	Duration of inner scroll view animation.
`Curve tabAnimationCurve`	Animation curve used when animating tab change.
`Curve bodyAnimationCurve`	Animation curve used when changing index of inner ScrollView(s).

Example

import 'package:flutter/material.dart';
import 'package:scrollable_list_tabview/scrollable_list_tabview.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        primarySwatch: Colors.blue,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: MyHomePage(title: 'Flutter ScrollableListTabView Example'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key key, this.title}) : super(key: key);

  final String title;

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: ScrollableListTabView(
        tabHeight: 48,
        tabs: [
          ScrollableListTab(
              tab: ListTab(label: Text('Label 1'), icon: Icon(Icons.group)),
              body: ListView.builder(
                shrinkWrap: true,
                physics: NeverScrollableScrollPhysics(),
                itemCount: 10,
                itemBuilder: (_, index) => ListTile(
                  leading: Container(
                    height: 40,
                    width: 40,
                    decoration: BoxDecoration(
                        shape: BoxShape.circle, color: Colors.grey),
                    alignment: Alignment.center,
                    child: Text(index.toString()),
                  ),
                  title: Text('List element $index'),
                ),
              )),
        ],
      ),
    );
  }
}

Limitations & Considerations

There are some limitations on this package. For example we only support ScrollView to be the body. Also, we could have used builder pattern to build the widgets.

I would like to thank Google developers for creating awesome package called ScrollablePositionedList.