API Documentation

Documentation for developing SailfishOS applications

BusyIndicator QML Type

Displayed while waiting for content to load or some process to finish More...

Import Statement: import Sailfish.Silica 1.0

Properties

Detailed Description

The BusyIndicator is a non-interactive display that shows a spinning circle. It should be shown while content is loading or when the UI is waiting for an action to be available.

For example, it could be used while a page is loading its contents:

 import QtQuick 2.2
 import Sailfish.Silica 1.0

 Page {
     BusyIndicator {
         size: BusyIndicatorSize.Large
         anchors.centerIn: parent
         running: model.status == Model.Loading
     }
 }

Or, while an image is loading:

 Image {
     id: image
     source: "http://some/remote/icon.png"
     sourceSize.width: Theme.iconSizeMedium
     sourceSize.height: Theme.iconSizeMedium

     BusyIndicator {
         size: BusyIndicatorSize.Medium
         anchors.centerIn: image
         running: image.status != Image.Ready
     }
 }

Property Documentation

running : bool

Setting running to true starts the animation. The animation keeps playing until the property is set to false or when the application window goes to background.

The default value is false.


size : enumeration

This size property can be used to select one of the following indicator sizes.

  • BusyIndicatorSize.ExtraSmall - displayed when loading small details, matches well with extra small font
  • BusyIndicatorSize.Small - displayed when loading details, matches well with normal size font
  • BusyIndicatorSize.Medium - the standard size for display within a list item
  • BusyIndicatorSize.Large - used for full-screen busy indication

The default value is BusyIndicatorSize.Medium.


We use cookies to improve your user experience and to help us to develop our services. By continuing to browse the site, you approve of our use of cookies.