Code Monkey home page Code Monkey logo

aleixrodriala / react-native-ultimate-listview Goto Github PK

View Code? Open in Web Editor NEW

This project forked from gameboyvito/react-native-ultimate-listview

0.0 2.0 0.0 56.6 MB

A high performance FlatList providing customised pull-to-refresh | auto-pagination & infinite-scrolling | gridview layout | swipeable-row.

Home Page: https://www.npmjs.com/package/react-native-ultimate-listview

License: MIT License

JavaScript 95.74% Python 0.98% Java 0.79% Objective-C 2.49%

react-native-ultimate-listview's Introduction

React Native Ultimate Listview

This Library includes two components: UltimateListView and UltimateRefreshView

  • UltimateListView: A high performance FlatList providing customised pull-to-refresh | auto-pagination & infinite-scrolling | gridview layout | swipeable-row. The truly ultimate version that I have done the most tricky part for you, you can treat this module as an enhanced FlatList with all excellently extra features, comparing to the official version.
  • UltimateRefreshView: A refreshable ScrollView providing customised pull-to-refresh feature, which has already been using in the UltimateListView, but it can be used independently.

This module supports both of iOS and Android platforms.

All codes are written in ES6 syntax, and meet most rules of Eslint syntax

Quick installation

  • If on react-native < 0.43: yarn add [email protected]
  • If on react-native >= 0.43 yarn add react-native-ultimate-listview@latest

Know Issue (v3.3.0): On Android, if you are using CustomRefreshView, and the total hight of your first load data is less than your device height, then the RefreshView may still sticky on the top. However, if the data you loaded is beyond your screen, everything's fine. This issue only happen on Android, any PR is welcome.

Demo

iOS Android
FlatList

Usage

import { UltimateListView, UltimateRefreshView } from 'react-native-ultimate-listview'
    <UltimateRefreshView onRefresh={this.onRefresh}>
         <YourView/>
    </UltimateRefreshView>

    <UltimateListView
       ref={ref => this.listView = ref}
       key={this.state.layout}
       onFetch={this.onFetch}
       keyExtractor={(item, index) => `${index} - ${item}`} 
       refreshableMode="advanced" // basic or advanced
       item={this.renderItem} // this takes three params (item, index, separator)       
       displayDate
       arrowImageStyle={{ width: 20, height: 20, resizeMode: 'contain' }}/>

Or you can look through this link: Usage

Documentation

Breaking Changes

  • Provide a new Component , which extends

  • Change import syntax to:

    import { UltimateListView, UltimateRefreshView } from 'react-native-ultimate-listview'

Contribution

@gameboyVito - [email protected]

  1. Fork this Repository, then run yarn or npm install in the root folder
  2. After modifying the code, in the root folder, run yarn eslint-fix or npm run eslint-fix
  3. Make sure your code satisfy the eslint rules, then commit and push your code
  4. Open your Github, create a pull request to me. I will review it ASAP, thanks a lot.

Why FlatList

I have found some articles to explain why you need to use FlatList instead of the legacy ListView. There are some obvious reasons:

  1. FlatList is just like the UICollectionView or RecyclerView, which can dramatically reduce memory usage. It also provides smoother animation when you have an extremely long list.
  2. FlatList supports scrollToIndex function, which is pretty convenient when you want to scroll to an item with index, instead of depending the y-offset.
  3. FlatList recommend developer to use PureComponent to reduce unnecessary re-rendering, this can really boost the performance and make your app run faster.

License

MIT

react-native-ultimate-listview's People

Contributors

aleixrodriala avatar comigor avatar gameboyvito avatar imokhles avatar wanbaolu1985 avatar

Watchers

 avatar  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.