• Home
• Felgo
• VisibilityRefreshHandler

VisibilityRefreshHandler

A helper item for handling data reload actions as soon as the item becomes visible. More...

• List of all members, including inherited members

Properties

• canRefresh : bool
• defaultAppActivityIndicatorVisible : bool
• listView : ListView

Signals

• refresh()

Detailed Description

This item is a convenience item that can be added as the header or footer of an AppListView.

As soon as the item gets visible within the AppListView the refresh signal is emitted. It's then possible to take appropriate actions in your app logic. This can be used to implement infinite scrolling for apps showing a news stream or similar data.

As an example you can load the next 20 tweets in your Twitter app as soon as a user scrolls to the bottom of the feed, as shown in the following sample:

 import Felgo

 AppListView {
   footer: VisibilityRefreshHandler {
     onRefresh: twitterCient.loadNextTweets()
   }
 }

After all elements are displayed in a list and there is no new additional data you might want to show, set canRefresh to false to prevent showing the item any longer. If your app supports true "inifite scrolling", you can keep the default value for canRefresh (true).

The default height is 48dp and the default width is the parent width. If the VisibilityRefreshHandler is invisible, its size is set to 0.

Customize the Delegate

An AppActivityIndicator is displayed by default during the refresh.

To set a custom Item instead of the default delegate, see this example:

 import QtQuick
 import Felgo

 AppListView {
   footer: VisibilityRefreshHandler {

     // disable the default view
     defaultAppActivityIndicatorVisible: false

     Rectangle {
       anchors.fill: parent
       color: "grey"
       Text {
         text: "Refreshing ..."
         anchors.centerIn: parent
       }
     }

     onRefresh: twitterClient.loadNextTweets()

   }
 }

Property Documentation

Signal Documentation