Pakete, Repositories und App-Kategorien suchen

Paketdetailsv3.0.1

scroll_to_index

Zum bestimmten Kind eines beliebigen Scrollwidgets in Flutter scrollen

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
537.000
Likes
821
Pub-Punkte
140

Paket installieren

flutter pub add scroll_to_index

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Das scroll_to_index-Paket ermöglicht eine präzise Scrollbewegung zu einem bestimmten Kind innerhalb eines beliebigen scrollbaren Widgets in Flutter, wie z. B. ListView oder GridView. Es bietet eine einfache API, um programmgesteuert zu einem Index zu scrollen, was es ideal für die Navigation innerhalb langer Listen oder dynamischer Inhalte macht. Das Paket funktioniert auf allen wichtigen Plattformen, einschließlich Android, iOS, Web, macOS, Windows und Linux. Es ist besonders nützlich, wenn Sie basierend auf Benutzerinteraktionen oder Zustandsänderungen zu einem bestimmten Element springen müssen. Die Implementierung ist leichtgewichtig und integriert sich nahtlos mit bestehenden scrollbaren Widgets.

Anwendungsfälle

  • Zum bestimmten Listenpunkt springen
  • Navigation innerhalb langer scrollbarer Listen
  • Programmatische Scrollung in dynamischen Benutzeroberflächen
  • Verbesserung der Zugänglichkeit in scrollbaren Schnittstellen
  • Synchronisieren der Scrollposition mit externen Ereignissen

Hauptmerkmale

  • Scrollen zu einem beliebigen Index per Indexnummer
  • Unterstützt alle scrollbaren Widgets
  • Plattformübergreifende Kompatibilität
  • Leichtgewichtig und einfach zu integrieren
  • Funktioniert mit dynamischen Listen

Geeignet für

  • Entwickler, die listenintensive Apps erstellen
  • Apps mit reibungsloser Navigation
  • Zugängliche Benutzeroberflächen
  • Dynamischer Inhalt mit häufigen Aktualisierungen

Hinweise

  • Benötigt manuelle Handhabung des Scrollcontrollers
  • Möglicherweise benötigt man zusätzliche Logik für reibungslose Animationen
  • Nicht geeignet für sehr große Listen ohne Optimierung

Original-README

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

scroll-to-index

This package provides the scroll to index mechanism for fixed/variable row height for Flutter scrollable widget.

Getting Started

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

dependencies:
  ...
  scroll_to_index: any

In your library add the following import:

import 'package:scroll_to_index/scroll_to_index.dart';

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

Usage

This is a widget level library, means you can use this mechanism inside any Flutter scrollable widget.

Example for Flutter ListView

ListView(
  scrollDirection: scrollDirection,
  controller: controller,
  children: randomList.map<Widget>((data) {
  	final index = data[0];
  	final height = data[1];
    return AutoScrollTag(
      key: ValueKey(index),
      controller: controller,
      index: index,
      child: Text('index: $index, height: $height'),
      highlightColor: Colors.black.withOpacity(0.1),
    );
  }).toList(),
)

you can wrap any of your row widget which has dynamic row height

AutoScrollTag(
  key: ValueKey(index),
  controller: controller,
  index: index,
  child: child
)

with the AutoScrollController controller.

when you need to trigger scroll to a specified index, you can call

controller.scrollToIndex(index, preferPosition: AutoScrollPosition.begin)

even more, with a fixed row height, you can give it a suggested height for more efficient scrolling. there are more configuration.

final controller = AutoScrollController(
  //add this for advanced viewport boundary. e.g. SafeArea
  viewportBoundaryGetter: () => Rect.fromLTRB(0, 0, 0, MediaQuery.of(context).padding.bottom),

  //choose vertical/horizontal
  axis: scrollDirection,

  //this given value will bring the scroll offset to the nearest position in fixed row height case.
  //for variable row height case, you can still set the average height, it will try to get to the relatively closer offset 
  //and then start searching.
  suggestedRowHeight: 200
);

for full example, please see this Demo.

Who Uses

  • Quire - a simple, collaborative, multi-level task management tool.

Kategorien

Quell-Repository

Projekte, die dieses Paket verwenden