Pakete, Repositories und App-Kategorien suchen

Cover von story
Paketdetailsv1.1.0

story

Instagram-Stories-ähnliche Benutzeroberfläche mit reichhaltigen Animationen und Anpassungsmöglichkeiten.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
9430
Likes
348
Pub-Punkte
150

Paket installieren

flutter pub add story

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Das Story-Paket bietet eine Instagram-Stories-inspirierte Benutzeroberfläche mit fließenden Animationen und hoher Anpassbarkeit. Es ermöglicht Entwicklern, interaktive, swipable Story-Karten mit anpassbaren Übergängen, Zeitzählern und Inhaltslayouts zu erstellen. Ideal für Apps, die ein dynamisches Geschichtenerzählen erfordern, unterstützt es mehrere Plattformen wie Mobilgeräte, Web und Desktop. Das Paket ist für eine einfache Integration in das Widget-System von Flutter konzipiert und bietet umfangreiche Gestaltungsoptionen für Aussehen und Verhalten.

Anwendungsfälle

  • Soziale Medien-artige Story-Feeds erstellen
  • Interaktive Tutorials oder Onboarding-Flows erstellen
  • Anzeige zeitlich begrenzter Inhaltsaktualisierungen
  • Engagierende Marketingkampagnen gestalten
  • Benutzerprofil-Geschichte-Highlights implementieren

Hauptmerkmale

  • Reichhaltige, animierte Geschichtsübergänge
  • Anpassbare Story-Karten-Layouts
  • Swipe-Gesten-Unterstützung über Plattformen hinweg
  • Konfigurierbare Dauer und Fortschrittsanzeiger
  • Erweiterbare Themen- und Stiloptionen

Geeignet für

  • Entwickler, die soziale Funktionen erstellen
  • Apps, die eine zeitlich begrenzte Inhaltslieferung erfordern
  • Designer, die animierte Benutzeroberflächenkomponenten suchen
  • Plattformübergreifende Anwendungen mit geschichtenähnlichen Schnittstellen

Hinweise

  • Erfordert sorgfältige Behandlung des Zustands während der Navigation
  • Kann die Leistung bei großen Story-Sets beeinträchtigen
  • Eingeschränkte integrierte Analyse oder Verfolgung
  • Nicht für sehr lange Geschichten optimiert
  • Abhängig von externen Animationsbibliotheken für erweiterte Effekte

Original-README

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

version likes popularity License: MIT all contributors

Instagram stories like UI with rich animations and customizability.

final 2

Usage

StoryPageView requires at least three arguments: itemBuilder, pageLength, and storyLength.

/// Minimum example to explain the usage.
return Scaffold(
  body: StoryPageView(
    itemBuilder: (context, pageIndex, storyIndex) {
      return Center(
        child: Text("Index of PageView: $pageIndex Index of story on each page: $storyIndex"),
      );
    },
    storyLength: (pageIndex) {
      return 3;
    },
    pageLength: 4,
  );
  • itemBuilder builds the content of each story and is called with the index of the pageView and the index of the story on the page.

  • storyLength decides the length of story for each page. The example above always returns 3, but it should depend on pageIndex.

  • pageLength is just the length of StoryPageView

The example above just shows 12 stories by 4 pages, which is not practical.

This one is the proper usage, extracted from example.

return Scaffold(
  body: StoryPageView(
    itemBuilder: (context, pageIndex, storyIndex) {
      final user = sampleUsers[pageIndex];
      final story = user.stories[storyIndex];
      return Stack(
        children: [
          Positioned.fill(
            child: Container(color: Colors.black),
          ),
          Positioned.fill(
            child: Image.network(
              story.imageUrl,
              fit: BoxFit.cover,
            ),
          ),
          Padding(
            padding: const EdgeInsets.only(top: 44, left: 8),
            child: Row(
              children: [
                Container(
                  height: 32,
                  width: 32,
                  decoration: BoxDecoration(
                    image: DecorationImage(
                      image: NetworkImage(user.imageUrl),
                      fit: BoxFit.cover,
                    ),
                    shape: BoxShape.circle,
                  ),
                ),
                const SizedBox(
                  width: 8,
                ),
                Text(
                  user.userName,
                  style: TextStyle(
                    fontSize: 17,
                    color: Colors.white,
                    fontWeight: FontWeight.bold,
                  ),
                ),
              ],
            ),
          ),
        ],
      );
    },
    gestureItemBuilder: (context, pageIndex, storyIndex) {
      return Align(
        alignment: Alignment.topRight,
        child: Padding(
          padding: const EdgeInsets.only(top: 32),
          child: IconButton(
            padding: EdgeInsets.zero,
            color: Colors.white,
            icon: Icon(Icons.close),
            onPressed: () {
              Navigator.pop(context);
            },
          ),
        ),
      );
    },
    pageLength: sampleUsers.length,
    storyLength: (int pageIndex) {
      return sampleUsers[pageIndex].stories.length;
    },
    onPageLimitReached: () {
      Navigator.pop(context);
    },
  ),
);
  • gestureItemBuilder builds widgets that need gesture actions

In this case, IconButton to close the page is in the callback.

You CANNOT place the gesture widgets in itemBuilder as they are covered and disabled by the default story gestures.

  • onPageLimitReached is called when the very last story is finished.

  • It is recommended to use data model with two layers. In this case, UserModel which has the list of StoryModel

/// Example Data Model
class UserModel {
  UserModel(this.stories, this.userName, this.imageUrl);

  final List<StoryModel> stories;
  final String userName;
  final String imageUrl;
}

class StoryModel {
  StoryModel(this.imageUrl);

  final String imageUrl;
}
StoryImage

If you show images in StoryPageView, use StoryImage. It can stop the indicator until the image is fully loaded.

StoryImage(
  /// key is required
  key: ValueKey(story.imageUrl),
  imageProvider: NetworkImage(
    story.imageUrl,
  ),
  fit: BoxFit.fitWidth,
)

Be sure to assign the unique key value for each image, otherwise the image loading will not be handled properly.

indicatorAnimationController

If you stop/start the animation of the story with your custom widgets, use indicatorAnimationController

class _StoryPageState extends State<StoryPage> {
  late ValueNotifier<IndicatorAnimationCommand> indicatorAnimationController;

  @override
  void initState() {
    super.initState();
    indicatorAnimationController = ValueNotifier<IndicatorAnimationCommand>(
        IndicatorAnimationCommand.resume);
  }

  @override
  void dispose() {
    indicatorAnimationController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: StoryPageView(
        indicatorAnimationController: indicatorAnimationController,
        ...,
      ),
    );
  }
}

Once the instance is passed to StoryPageView, you can stop handle the indicator by the methods below.


/// To pause the indicator
indicatorAnimationController.value = IndicatorAnimationCommand.pause;

/// To resume the indicator
indicatorAnimationController.value = IndicatorAnimationCommand.resume;

Contributors

Santa Takahashi
Santa Takahashi

💻
Isaias Mejia de los Santos
Isaias Mejia de los Santos

💻
Медик
Медик

💻
Alperen Soysal
Alperen Soysal

💻
AtixD
AtixD

💻
harshitFinmapp
harshitFinmapp

💻
dmitry-kotorov
dmitry-kotorov

💻
sachin kumar rajput
sachin kumar rajput

💻
Mohamed Othman
Mohamed Othman

💻

Kategorien

Abhängigkeiten

Abhängigkeiten 1 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden