Need help with nl.fokkezb.pullToRefresh?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

Topener
190 Stars 64 Forks 98 Commits 3 Opened issues

Description

Widget to implement a table pull-to-refresh header in Titanium Alloy

Services available

!
?

Need anything else?

Contributors list

# 40,693
titaniu...
Objecti...
Swift
React N...
58 commits
# 232,243
C
C++
Shell
titaniu...
6 commits
# 653,449
JavaScr...
2 commits
# 545,209
HTML
JavaScr...
1 commit
# 318,241
Python
CSS
1 commit
# 311,301
C
C++
Shell
titaniu...
1 commit
# 117,247
Go
command...
Shell
Docker
1 commit
# 632,979
JavaScr...
1 commit
# 120,214
dotnet-...
c-sharp
linq
Univers...
1 commit

Alloy Pull to Refresh Widget

gitTio NPM René Pot

NOTE: Starting TiSDK 6.2 this widget is no longer needed as RefreshControl is build in for Android like previously for iOS, you can stick with the Ti.UI.RefreshControl

The Alloy Pull to Refresh widget is a cross-platform no-brainer wrapper of Ti.UI.RefreshControl for iOS and Ivan's fork of Ti.SwipeRefreshLayout for Android.

Before version 2.0.0 this widget emulated the native Pull to Refresh concept for

Ti.UI.TableView
on both platforms. Since 2.0.0 it uses the native controls now available in Titanium Core and through Ivan's module for both
Ti.UI.TableView
and
Ti.UI.ListView
.

Also take a look at the Infinite Scroll widget.

Examples

Android

Android

iOS

iOS

Usage

  1. Download and install the distribution 0.4.1 or later of Ivan's fork of Ti.SwipeRefreshLayout.

  2. Install the widget via gitTio: gitTio

    gittio install nl.fokkezb.pullToRefresh

Or NPM: NPM

`npm i --save nl.fokkezb.pulltorefresh`
  1. Wrap the widget around your

     or 
     in the view:
    
        
        
            
                
                    
                        
                    
                
            
        
    
    

    NOTE: The

     tag can't be the root element due to an Alloy limitation!
  2. Add your

    myRefresher
    function to the controller and call the
    e.hide()
    callback when you're done:
    function myRefresher(e) {
        myCollection.fetch({
            success: e.hide,
            error: e.hide
        });
    }
    
  3. Call the widget's

    refresh()
    to programmatically trigger the (initial) refresh:
    $.ptr.refresh();
    
  4. To pass arguments to

    Ti.UI.createRefreshControl
    and
    createSwipeRefresh()
    simply pass them to the widget as attributes of

     or second arguments of 
    createWidget()
    .

Methods

Both platforms share the same API:

| Function | Parameters | Usage | | ---------- | ---------- | ----- | | refresh | | Manually trigger pull + release | | show | | Show the loading indicator | | hide | | Hide the loading indicator | | getList | | Get the list the widget is bound to | getControl | | Get the refresh control

Changelog

  • 3.0
    • Removes
      setTitle()
      .
    • Passes all arguments/attributes on to
      Ti.UI.createRefreshControl()
      for iOS (e.g. to set title or tintColor) and
      createSwipeRefresh()
      for Android.
  • 2.2
  • 2.1
  • 2.0
    • Rewritten to use native API's.
  • 1.5
    • Workaround for regression in Alloy 1.3.0-cr
    • Closes #17 by checking source of events
    • New
      top
      option for compatibility with
      Ti.UI.Window.extendEdges
      on iOS7
    • Arrow now properly hidden on Android, using opacity
    • Default style updated to match Twitter on iOS7
  • 1.4
    • Now compatible with Android and other OS!
  • 1.3
    • From now on declared in the XML view instead of the controller!
    • Splitted
      init
      into
      setOptions
      and
      attach
    • Renamed
      remove
      to
      dettach
    • Renamed
      trigger
      to
      refresh
      to not interfere with BackBone
  • 1.2
    • Retina arrow images, including new (default) grey one
    • Removed text showing last update for more clear view
    • Easier styling
  • 1.1
    • Exposed new API functions to
      show
      /
      hide
      the view, set the
      date
      and
      trigger
      the widget manually.
    • Renamed
      load
      parameter to
      loader
      in line with upcomming widgets.
  • 1.0
    • Initial version

License

Copyright 2013-2015 Fokke Zandbergen

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.