पैकेज विवरणv2.0.1

timelines_plus

Timelines पैकेज का नवीनतम संस्करण। ध्यान दें: यह केवल इस पैकेज का अद्यतन संस्करण है: https://pub.dev/packages/timelines

AndroidiOSWebmacOSWindowsLinux

pub.dev API दस्तावेज़ सोर्स कोड

30-दिन डाउनलोड: 54.1 हज़ार
लाइक: 281
Pub अंक: 160

पैकेज इंस्टॉल करें

flutter pub add timelines_plus

पैकेज अवलोकन

सार्वजनिक जानकारी से बना चयन मार्गदर्शन। केवल संदर्भ हेतु।

timelines_plus लोकप्रिय Timelines पैकेज का अद्यतन संस्करण है, जो Flutter एप्लिकेशन में टाइमलाइन UI बनाने के लिए बढ़ी हुई कार्यक्षमता प्रदान करता है। यह एंड्रॉइड, iOS, वेब, macOS, Windows और Linux प्लेटफॉर्म पर क्रमिक घटनाओं को दिखाने के लिए कस्टमाइज़ करने योग्य टाइमलाइन घटक प्रदान करता है। इस पैकेज में ऊर्ध्वाधर और क्षैतिज लेआउट दोनों का समर्थन है, जिसमें मार्कर, कनेक्टर और लेबल के लिए लचीले स्टाइलिंग विकल्प हैं। घटनाओं के क्रम को दिखाने के लिए भरोसेमंद, प्रभावी तरीके की तलाश करने वाले डेवलपर्स के लिए डिज़ाइन किया गया है, यह मूल पैकेज के साथ संगतता बनाए रखता है जबकि आधुनिक Flutter विकास के लिए सुधार लाता है।

उपयोग

घटना इतिहास प्रदर्शित करें
प्रोजेक्ट माइलस्टोन का दृश्यीकरण
चरण-दर-चरण प्रक्रियाएँ दिखाएं
ऑनबोर्डिंग फ्लो का निर्माण करें
उपयोगकर्ता गतिविधि समयरेखा का ट्रैकिंग

मुख्य विशेषताएँ

ऊर्ध्वाधर और क्षैतिज समयरेखा का समर्थन
कस्टमाइज़ेबल मार्कर और कनेक्टर
क्रॉस-प्लेटफ़ॉर्म संगतता
मूल पैकेज की तुलना में सुधारित प्रदर्शन
मौजूदा Flutter प्रोजेक्ट्स के साथ आसान एकीकरण

इनके लिए उपयुक्त

कार्य ट्रैकिंग ऐप बना रहे विकासकर्मी
प्रोजेक्ट प्रबंधन उपकरण बनाने वाली टीमें
क्रमागत यूआई को लागू करने वाले डिज़ाइनर
सीखने के प्रगति के साथ शैक्षिक ऐप्स
घटना क्रम दृश्यीकरण की आवश्यकता वाले अनुप्रयोग

विचार योग्य बातें

Flutter SDK 3.0 या उच्चतर की आवश्यकता है
उन्नत एनीमेशन के बिना मूल समय रेखा डिजाइनों तक सीमित
गतिशील डेटा अपडेट के लिए कोई निर्मित समर्थन नहीं है
स्थिर या सरल अंतरक्रियापूर्ण तिथियों के लिए उपयुक्त
उपरोक्त पैकेज की स्थिरता पर निर्भर करता है

मूल README

संबंधित सोर्स रिपॉज़िटरी के मूल README का स्नैपशॉट। नवीनतम सामग्री के लिए रिपॉज़िटरी देखें।

A powerful & easy to use timeline package for Flutter! 🚀

Caveat: This package is an early stage. Not enough testing has been done to guarantee stability. Some APIs may change.

Examples

Check it out on the web or look at the source code.

Timeline status	Package delivery tracking	Process timeline

More examples
🚧 WIP 🚧

Features

The timeline and each components are all WIDGET.

Common styles can be easily implemented with predefined components.
Vertical, horizontal direction.
Alternating contents.
Combination with Flutter widgets(Row, Column, CustomScrollView, etc).
Customize each range with themes.

Installation

1. Depend on it

Add this to your package's pubspec.yaml file:

dependencies:
  timelines_plus: ^[latest_version]

2. Install it

You can install packages from the command line:

with Flutter:

$ flutter pub get

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import 'package:timelines_plus/timelines_plus.dart';

Basic Usage

@override
Widget build(BuildContext context) {
  return Timeline.tileBuilder(
    builder: TimelineTileBuilder.fromStyle(
      contentsAlign: ContentsAlign.alternating,
      contentsBuilder: (context, index) => Padding(
        padding: const EdgeInsets.all(24.0),
        child: Text('Timeline Event $index'),
      ),
      itemCount: 10,
    ),
  );
}

Check the Example or the API reference for more details.

Components

Theme

Check out Theme Demo to see how the values inside TimelineTile work with the theme.

To customize the timeline component with a theme, do the following:

TimelineTheme(
  data: TimelineThemeData(...),
  child: DotIndicator(...),
);

If you only want to change part of the parent theme, use TimelineTheme.of(context):

TimelineTheme(
  data: TimelineThemeData.of(context).copyWith(...),
  child: DotIndicator(...),
);

If the component you want to customize is Timeline or FixedTimeline, this is also possible:

FixedTimeline(
  theme: TimelineThemeData(...),
  children: [...],
);

Indicator

ContainerIndicator
	ContainerIndicator( child: Container( width: 15.0, height: 15.0, color: Colors.blue, ), )
DotIndicator
	DotIndicator()
OutlinedDotIndicator
	OutlinedDotIndicator()

Connector

SolidLineConnector
	SizedBox( height: 20.0, child: SolidLineConnector(), )
DashedLineConnector
	SizedBox( height: 20.0, child: DashedLineConnector(), )
DecoratedLineConnector
	SizedBox( height: 20.0, child: DecoratedLineConnector( decoration: BoxDecoration( gradient: LinearGradient( begin: Alignment.topCenter, end: Alignment.bottomCenter, colors: [Colors.blue, Colors.lightBlueAccent[100]], ), ), ), )

TimelineNode

Pure timeline UI component with no content.

The TimelineNode contains an indicator and two connectors on both sides of the indicator:

Simple TimelineNode
	SizedBox( height: 50.0, child: TimelineNode.simple(), )
Complex TimelineNode
	SizedBox( height: 80.0, child: TimelineNode( indicator: Card( margin: EdgeInsets.zero, child: Padding( padding: EdgeInsets.all(8.0), child: Text('Complex'), ), ), startConnector: DashedLineConnector(), endConnector: SolidLineConnector(), ), )

Simple TimelineNode

SizedBox(
  height: 50.0,
  child: TimelineNode.simple(),
)

Complex TimelineNode

SizedBox(
  height: 80.0,
  child: TimelineNode(
    indicator: Card(
      margin: EdgeInsets.zero,
      child: Padding(
        padding: EdgeInsets.all(8.0),
        child: Text('Complex'),
      ),
    ),
    startConnector: DashedLineConnector(),
    endConnector: SolidLineConnector(),
  ),
)

TimelineTile

Displays content on both sides of the node:

TimelineTile
	TimelineTile( oppositeContents: Padding( padding: const EdgeInsets.all(8.0), child: Text('opposite\ncontents'), ), contents: Card( child: Container( padding: EdgeInsets.all(8.0), child: Text('contents'), ), ), node: TimelineNode( indicator: DotIndicator(), startConnector: SolidLineConnector(), endConnector: SolidLineConnector(), ), )

TimelineTile

TimelineTile(
  oppositeContents: Padding(
    padding: const EdgeInsets.all(8.0),
    child: Text('opposite\ncontents'),
  ),
  contents: Card(
    child: Container(
      padding: EdgeInsets.all(8.0),
      child: Text('contents'),
    ),
  ),
  node: TimelineNode(
    indicator: DotIndicator(),
    startConnector: SolidLineConnector(),
    endConnector: SolidLineConnector(),
  ),
)

TimelineTileBuilder

TimelineTileBuilder provides powerful build features.

Connection

Each tile draws only half of the line connecting the neighboring tiles. Using the connected constructor, lines connecting adjacent tiles can build as one index.

ConnectionDirection.before
	FixedTimeline.tileBuilder( builder: TimelineTileBuilder.connectedFromStyle( connectionDirection: ConnectionDirection.before, connectorStyleBuilder: (context, index) { return (index == 1) ? ConnectorStyle.dashedLine : ConnectorStyle.solidLine; }, indicatorStyleBuilder: (context, index) => IndicatorStyle.dot, itemExtent: 40.0, itemCount: 3, ), )
ConnectionDirection.after
	FixedTimeline.tileBuilder( builder: TimelineTileBuilder.connectedFromStyle( connectionDirection: ConnectionDirection.after, connectorStyleBuilder: (context, index) { return (index == 1) ? ConnectorStyle.dashedLine : ConnectorStyle.solidLine; }, indicatorStyleBuilder: (context, index) => IndicatorStyle.dot, itemExtent: 40.0, itemCount: 3, ), )

ConnectionDirection.before

FixedTimeline.tileBuilder(
  builder: TimelineTileBuilder.connectedFromStyle(
    connectionDirection: ConnectionDirection.before,
    connectorStyleBuilder: (context, index) {
      return (index == 1) ? ConnectorStyle.dashedLine : ConnectorStyle.solidLine;
    },
    indicatorStyleBuilder: (context, index) => IndicatorStyle.dot,
    itemExtent: 40.0,
    itemCount: 3,
  ),
)

ConnectionDirection.after

FixedTimeline.tileBuilder(
  builder: TimelineTileBuilder.connectedFromStyle(
    connectionDirection: ConnectionDirection.after,
    connectorStyleBuilder: (context, index) {
      return (index == 1) ? ConnectorStyle.dashedLine : ConnectorStyle.solidLine;
    },
    indicatorStyleBuilder: (context, index) => IndicatorStyle.dot,
    itemExtent: 40.0,
    itemCount: 3,
  ),
)

ContentsAlign

This value determines how the contents of the timeline will be built:

ContentsAlign.basic
	FixedTimeline.tileBuilder( builder: TimelineTileBuilder.connectedFromStyle( contentsAlign: ContentsAlign.basic, oppositeContentsBuilder: (context, index) => Padding( padding: const EdgeInsets.all(8.0), child: Text('opposite\ncontents'), ), contentsBuilder: (context, index) => Card( child: Padding( padding: const EdgeInsets.all(8.0), child: Text('Contents'), ), ), connectorStyleBuilder: (context, index) => ConnectorStyle.solidLine, indicatorStyleBuilder: (context, index) => IndicatorStyle.dot, itemCount: 3, ), )
ContentsAlign.reverse
	FixedTimeline.tileBuilder( builder: TimelineTileBuilder.connectedFromStyle( contentsAlign: ContentsAlign.reverse, oppositeContentsBuilder: (context, index) => Padding( padding: const EdgeInsets.all(8.0), child: Text('opposite\ncontents'), ), contentsBuilder: (context, index) => Card( child: Padding( padding: const EdgeInsets.all(8.0), child: Text('Contents'), ), ), connectorStyleBuilder: (context, index) => ConnectorStyle.solidLine, indicatorStyleBuilder: (context, index) => IndicatorStyle.dot, itemCount: 3, ), )
ContentsAlign.alternating
	FixedTimeline.tileBuilder( builder: TimelineTileBuilder.connectedFromStyle( contentsAlign: ContentsAlign.alternating, oppositeContentsBuilder: (context, index) => Padding( padding: const EdgeInsets.all(8.0), child: Text('opposite\ncontents'), ), contentsBuilder: (context, index) => Card( child: Padding( padding: const EdgeInsets.all(8.0), child: Text('Contents'), ), ), connectorStyleBuilder: (context, index) => ConnectorStyle.solidLine, indicatorStyleBuilder: (context, index) => IndicatorStyle.dot, itemCount: 3, ), )