GithubHelp home page GithubHelp logo

morristech / introviews-flutter Goto Github PK

View Code? Open in Web Editor NEW

This project forked from aagarwal1012/introviews-flutter

0.0 1.0 0.0 5.45 MB

☀️ A Flutter package for some material design app intro screens with some cool animations.

Home Page: https://pub.dartlang.org/packages/intro_views_flutter

License: MIT License

Java 0.74% Objective-C 1.53% Dart 97.73%

introviews-flutter's Introduction



IntroViews is inspired by Paper Onboarding and developed with love from scratch. I decided to rewrite almost all the features in order to make it available to the flutter developers and extensible as possible.

Table of contents

Features

  • Easy addition of pages.

  • Circular page reveal.

  • Cool Animations.

  • Animation control, if the user stops sliding in the midway.

  • Skip button, for skipping the app intro.

  • Custom font selection.

  • Material Design.

Getting Started

You should ensure that you add the intro_views_flutter as a dependency in your flutter project.

dependencies:
  intro_views_flutter: '^2.8.1'

You can also reference the git repository directly if you want:

dependencies:
  intro_views_flutter:
    git: git://github.com/aagarwal1012/IntroViews-Flutter

You should then run flutter packages get in your terminal so as to get the package.

Usage

  • IntroViewsFlutter widget require a list of PageViewModel , and some other parameters. Refer the code below to create a PageViewModel page.

    Final page = new PageViewModel(
        pageColor: const Color(0xFF607D8B),
          iconImageAssetPath: 'assets/taxi-driver.png',
          iconColor: null,
          bubbleBackgroundColor: null,
          body: Text(
            'Easy  cab  booking  at  your  doorstep  with  cashless  payment  system',
          ),
          title: Text('Cabs'),
          mainImage: Image.asset(
            'assets/taxi.png',
            height: 285.0,
            width: 285.0,
            alignment: Alignment.center,
          ),
          titleTextStyle: TextStyle(fontFamily: 'MyFont', color: Colors.white),
          bodyTextStyle: TextStyle(fontFamily: 'MyFont', color: Colors.white),
        );
  • Now refer the code below to get the IntroViewsFlutter widget.

    final Widget introViews = new IntroViewsFlutter(
          [page],
          onTapDoneButton: (){
            //Void Callback
          },
          showSkipButton: true,
          pageButtonTextStyles: new TextStyle(
              color: Colors.white,
              fontSize: 18.0,
              fontFamily: "Regular",
            ),
        );

    For further usage refer the example available.

    For Landscape preview click the link.

    Note : If you added more than four pages in the list then there might be overlapping between page icons and skip button, so my suggestion is just make the showSkipButton: false.

Documentation

PageViewModel Class

Dart attribute Datatype Description Default Value
pageColor Color Set color of the page. Null
mainImage Image / Widget Set the main image of the page. Null
title Text / Widget Set the title text of the page. Null
body Text / Widget Set the body text of the page. Null
iconImageAssetPath String Set the icon image asset path that would be displayed in page bubble. Null
iconColor Color Set the page bubble icon color. Null
bubbleBackgroundColor Color Set the page bubble background color. Colors.white / Color(0x88FFFFFF)
textStyle TextStyle Set TextStyle for both title and body title: color: Colors.white , fontSize: 50.0
body: color: Colors.white , fontSize: 24.0
titleTextStyle TextStyle Set TextStyle for title color: Colors.white , fontSize: 50.0
bodyTextStyle TextStyle Set TextStyle for body color: Colors.white , fontSize: 24.0
bubble Widget Set a custom widget for the inner bubble null

IntroViewFlutter Class

Dart attribute Datatype Description Default Value
pages List Set the pages of the intro screen. Null
onTapDoneButton VoidCallback Method executes on tapping done button. Null
onTapBackButton VoidCallback Method executes on tapping back button. Null
onTapNextButton VoidCallback Method executes on tapping next button. Null
showSkipButton Bool Show the skip button at the bottom of page. true
showBackButton Bool Show the Back button at the bottom of page. Overrides showSkipButton starting from the second page false
showNextButton Bool Show the Next button at the bottom of page. Overrides doneButtonPersist. false
pageButtonTextSize Double Set the button text size. 18.0
pageButtonFontFamily String Set the font of button text. Default
onTapSkipButton VoidCallback Method executes on tapping skip button. null
pageButtonTextStyles TextStyle Configure TextStyle for skip, done buttons, overrides pageButtonFontFamily, pageButtonsColor, pageButtonTextSize. fontSize: 18.0, color: Colors.white
skipText Text / Widget Override Skip Button Text and styles. Text('SKIP')
doneText Text / Widget Override Done Button Text and styles. Text('DONE')
backText Text / Widget Override Back Button Text and styles. Text('BACK')
nextText Text / Widget Override Next Button Text and styles. Text('NEXT')
doneButtonPersist Bool Show done Button throughout pages false
columnMainAxisAlignment MainAxisAlignment Control [MainAxisAlignment] for column MainAxisAlignment.spaceAround
fullTransition double Adjust scroll distance for full transition 300.0
background Color Set the background color to Colors.transparent if you have your own background image below null

For help on editing package code, view the flutter documentation.

Bugs or Requests

If you encounter any problems feel free to open an issue. If you feel the library is missing a feature, please raise a ticket on GitHub and I'll look into it. Pull request are also welcome.

See Contributing.md.

Donate

If you found this project helpful or you learned something from the source code and want to thank me, consider buying me a cup of ☕

Contributors

Thanks goes to these wonderful people (emoji key):


Tal Jacobson

🚧 📖 📆

marloncepeda

🐛

Kravchenko Igor

🐛

SiDevesh

🤔

Slawa Pidgorny

🤔

Haider Al-Tahan

🤔

Newerton

🐛

Kenneth Gulbrandsøy

🐛 ⚠️

Sahil Kumar

⚠️

Rodrigo Boratto

🐛

This project follows the all-contributors specification. Contributions of any kind welcome! See Contributing.md.

License

IntroViews-Flutter is licensed under MIT license.

introviews-flutter's People

Contributors

aagarwal1012 avatar taljacobson avatar allcontributors[bot] avatar haideraltahan avatar kengu avatar spidgorny avatar gorniv avatar newerton avatar rwrz avatar xsahil03x avatar sidevesh avatar marloncepeda avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.