QML NumberAnimation Element

Detailed Description

NumberAnimation is a specialized PropertyAnimation that defines an animation to be applied when a numerical value changes.

Here is a NumberAnimation applied to the x property of a Rectangle as a property value source. It animates the x value from its current value to a value of 50, over 1000 milliseconds:

 import QtQuick 1.0

 Rectangle {
     width: 100; height: 100
     color: "red"

     NumberAnimation on x { to: 50; duration: 1000 }
 }

Like any other animation element, a NumberAnimation can be applied in a number of ways, including transitions, behaviors and property value sources. The QML Animation and Transitions documentation shows a variety of methods for creating animations.

Note that NumberAnimation may not animate smoothly if there are irregular changes in the number value that it is tracking. If this is the case, use SmoothedAnimation instead.

See also QML Animation and Transitions and Animation basics example.

Property Documentation

 Item {
     states: [
         // ...
     ]

     transition: Transition {
         NumberAnimation { properties: "x"; from: 100; duration: 200 }
     }
 }