En esta página

PropertyAnimation QML Type

Muestra de forma animada los cambios en los valores de las propiedades. Más...

Propiedades

Descripción detallada

PropertyAnimation ofrece una forma de animar los cambios en el valor de una propiedad.

Se puede utilizar para definir animaciones de diversas formas:

  • En un Transition

    Por ejemplo, para animar cualquier objeto que haya cambiado sus propiedades « x » o « y » como resultado de un cambio de estado, utilizando una curva de aceleración « InOutQuad »:

    Rectangle {
        id: rect
        width: 100; height: 100
        color: "red"
    
        states: State {
            name: "moved"
            PropertyChanges { target: rect; x: 50 }
        }
    
        transitions: Transition {
            PropertyAnimation { properties: "x,y"; easing.type: Easing.InOutQuad }
        }
    }
  • En un Behavior

    Por ejemplo, para animar todos los cambios en la propiedad « x » de un rectángulo:

    Rectangle {
        width: 100; height: 100
        color: "red"
    
        Behavior on x { PropertyAnimation {} }
    
        MouseArea { anchors.fill: parent; onClicked: parent.x = 50 }
    }
  • Como fuente de valor de propiedad

    Por ejemplo, para animar repetidamente la propiedad « x » del rectángulo:

    Rectangle {
        width: 100; height: 100
        color: "red"
    
        SequentialAnimation on x {
            loops: Animation.Infinite
            PropertyAnimation { to: 50 }
            PropertyAnimation { to: 0 }
        }
    }
  • En un controlador de señal

    Por ejemplo, para hacer que « theObject » se desvanezca al hacer clic:

    MouseArea {
        anchors.fill: theObject
        onClicked: PropertyAnimation { target: theObject; property: "opacity"; to: 0 }
    }
  • De forma independiente

    Por ejemplo, para animar la propiedad ` width ` de ` rect` durante 500 ms, desde su ancho actual hasta 30:

    Rectangle {
        id: theRect
        width: 100; height: 100
        color: "red"
    
        // this is a standalone animation, it's not running by default
        PropertyAnimation { id: animation;
                            target: theRect;
                            property: "width";
                            to: 30;
                            duration: 500 }
    
        MouseArea { anchors.fill: parent; onClicked: animation.running = true }
    }

Dependiendo de cómo se utilice la animación, el conjunto de propiedades que se emplean habitualmente variará. Para obtener más información, consulta la documentación de cada propiedad, así como la introducción a «Animación y transiciones en Qt Quick ».

Tenga en cuenta que PropertyAnimation hereda del tipo abstracto Animation. Esto incluye propiedades y métodos adicionales para controlar la animación.

Modificación de animaciones en ejecución

Desde Qt 6.4, es posible establecer las propiedades ` from`, ` to`, ` duration` y ` easing ` en una animación de nivel superior mientras se está ejecutando. La animación tendrá en cuenta los cambios en el siguiente bucle.

Véase también «Animación y transiciones en Qt Quick » y «Ejemplos deQt Quick - Animación».

Documentación de las propiedades

duration : int

Esta propiedad indica la duración de la animación, en milisegundos.

El valor por defecto es 250.

easing group

easing.amplitude : real

easing.bezierCurve : list<real>

easing.overshoot : real

easing.period : real

easing.type : enumeration

Especifica la curva de aceleración utilizada para la animación

Para especificar una curva de aceleración, es necesario indicar al menos el tipo. En el caso de algunas curvas, también se puede especificar la amplitud, el período y/o el sobreimpulso (se ofrecen más detalles tras la tabla). La curva de aceleración predeterminada es Easing.Linear.

PropertyAnimation { properties: "y";
                    easing.type: Easing.InOutElastic;
                    easing.amplitude: 2.0;
                    easing.period: 1.5 }

Los tipos disponibles son:

Easing.LinearCurva de aceleración para una función lineal (t): la velocidad es constante.Curva de aceleración lineal
Easing.InQuadCurva de aceleración para una función cuadrática (t²): acelera partiendo de una velocidad nula.Curva de atenuación de InQuad
Easing.OutQuadCurva de aceleración/deceleración para una función cuadrática (t²): desaceleración hasta una velocidad nula.Curva de atenuación OutQuad
Easing.InOutQuadCurva de aceleración/deceleración para una función cuadrática (t²): aceleración hasta la mitad del recorrido, seguida de deceleración.Curva de aceleración InOutQuad
Easing.OutInQuadCurva de aceleración/deceleración para una función cuadrática (t²): desaceleración hasta la mitad del recorrido, seguida de aceleración.Curva de aceleración OutInQuad
Easing.InCubicCurva de aceleración/deceleración para una función cúbica (t³): aceleración partiendo de una velocidad nula.Curva de suavizado InCubic
Easing.OutCubicCurva de suavizado para una función cúbica (t³): desaceleración hasta una velocidad nula.Curva de aceleración de OutCubic
Easing.InOutCubicCurva de suavizado para una función cúbica (t^3): aceleración hasta la mitad del recorrido, seguida de desaceleración.Curva de aceleración InOutCubic
Easing.OutInCubicCurva de suavizado para una función cúbica (t³): desaceleración hasta la mitad del recorrido, y luego aceleración.Curva de suavizado OutInCubic
Easing.InQuartCurva de suavizado para una función de cuarto grado (t^4): aceleración partiendo de una velocidad nula.Curva de atenuación de InQuart
Easing.OutQuartCurva de suavizado para una función de cuarto grado (t^4): desaceleración hasta velocidad cero.Curva de atenuación OutQuart
Easing.InOutQuartCurva de suavizado para una función de cuarto grado (t^4): aceleración hasta la mitad del recorrido, seguida de desaceleración.Curva de atenuación InOutQuart
Easing.OutInQuartCurva de suavizado para una función de cuarto grado (t^4): desaceleración hasta la mitad del recorrido, y luego aceleración.Curva de atenuación OutInQuart
Easing.InQuintCurva de suavizado para una función quíntica (t^5): aceleración partiendo de una velocidad nula.Curva de atenuación de InQuint
Easing.OutQuintCurva de suavizado para una función de quinto grado (t^5): desaceleración hasta velocidad cero.Curva de atenuación de OutQuint
Easing.InOutQuintCurva de suavizado para una función quíntica (t^5): aceleración hasta la mitad del recorrido, seguida de desaceleración.Curva de aceleración InOutQuint
Easing.OutInQuintCurva de suavizado para una función quíntica (t^5): desaceleración hasta la mitad del recorrido, seguida de aceleración.Curva de aceleración OutInQuint
Easing.InSineCurva de suavizado para una función sinusoidal (sin(t)): aceleración partiendo de una velocidad nula.Curva de atenuación InSine
Easing.OutSineCurva de suavizado para una función sinusoidal (sin(t)): desaceleración hasta velocidad cero.Curva de atenuación de OutSine
Easing.InOutSineCurva de suavizado para una función sinusoidal (sin(t)): aceleración hasta la mitad del recorrido, seguida de desaceleración.Curva de suavizado InOutSine
Easing.OutInSineCurva de suavizado para una función sinusoidal (sin(t)): desaceleración hasta la mitad del recorrido, seguida de aceleración.Curva de aceleración OutInSine
Easing.InExpoCurva de suavizado para una función exponencial (2^t): aceleración partiendo de una velocidad nula.Curva de relajación de InExpo
Easing.OutExpoCurva de aceleración/deceleración para una función exponencial (2^t): desaceleración hasta la velocidad cero.Curva de relajación de OutExpo
Easing.InOutExpoCurva de aceleración/deceleración para una función exponencial (2^t): aceleración hasta la mitad del recorrido, seguida de deceleración.Curva de relajación de InOutExpo
Easing.OutInExpoCurva de aceleración/deceleración para una función exponencial (2^t): deceleración hasta la mitad del recorrido y, a continuación, aceleración.Curva de adaptación de OutInExpo
Easing.InCircCurva de aceleración/deceleración para una función circular (sqrt(1-t^2)): aceleración partiendo de una velocidad nula.Curva de atenuación InCirc
Easing.OutCircCurva de suavizado para una función circular (sqrt(1-t^2)): desaceleración hasta velocidad cero.Curva de atenuación de OutCirc
Easing.InOutCircCurva de aceleración/deceleración para una función circular (sqrt(1-t^2)): aceleración hasta la mitad del recorrido, seguida de deceleración.Curva de aceleración InOutCirc
Easing.OutInCircCurva de suavizado para una función circular (sqrt(1-t^2)): desaceleración hasta la mitad del recorrido, seguida de aceleración.Curva de aceleración OutInCirc
Easing.InElasticCurva de suavizado para una función elástica (onda sinusoidal con decaimiento exponencial): aceleración partiendo de una velocidad nula.
La amplitud máxima se puede ajustar con el parámetro «amplitude», y el período de decaimiento con el parámetro «period ».
Curva de aceleración inelástica
Easing.OutElasticCurva de aceleración/deceleración para una función elástica (onda sinusoidal con decaimiento exponencial): deceleración hasta velocidad cero.
La amplitud máxima se puede ajustar con el parámetro «amplitude», y el período de decaimiento con el parámetro «period ».
Curva de aceleración OutElastic
Easing.InOutElasticCurva de atenuación para una función elástica (onda sinusoidal con decaimiento exponencial): aceleración hasta la mitad del recorrido, seguida de desaceleración.Curva de aceleración InOutElastic
Easing.OutInElasticCurva de aceleración/deceleración para una función elástica (onda sinusoidal con decaimiento exponencial): desaceleración hasta la mitad del recorrido, seguida de aceleración.Curva de aceleración OutInElastic
Easing.InBackCurva de aceleración/deceleración para una función «back» (función cúbica con sobreimpulso: (s+1)*t^3 - s*t^2) con aceleración inicial: acelerando desde una velocidad nula.Curva de atenuación de InBack
Easing.OutBackCurva de aceleración/deceleración para una función «back» (función cúbica con sobreimpulso: (s+1)*t^3 - s*t^2) en la entrada: desaceleración hasta velocidad cero.Curva de desaceleración de OutBack
Easing.InOutBackCurva de suavizado para una función cúbica con sobreimpulso (s+1)*t^3 - s*t²): entrada y salida: aceleración hasta la mitad del recorrido, seguida de desaceleración.Curva de desaceleración de InOutBack
Easing.OutInBackCurva de aceleración/desaceleración para un retroceso (aceleración/desaceleración cúbica con sobreimpulso: (s+1)*t^3 - s*t^2) con aceleración y desaceleración: desaceleración hasta la mitad y, a continuación, aceleración.Curva de aceleración OutInBack
Easing.InBounceCurva de aceleración/desaceleración para una función de rebote (rebote parabólico con decaimiento exponencial): aceleración partiendo de una velocidad nula.Curva de amortiguación de InBounce
Easing.OutBounceCurva de aceleración/desaceleración para una función de rebote (rebote parabólico con decaimiento exponencial): desaceleración hasta velocidad cero.Curva de atenuación de OutBounce
Easing.InOutBounceCurva de suavizado para una función de rebote (rebote parabólico con decaimiento exponencial) con entrada y salida suaves: aceleración hasta la mitad y, a continuación, desaceleración.Curva de aceleración InOutBounce
Easing.OutInBounceCurva de aceleración/deceleración para una función de rebote (rebote parabólico con decaimiento exponencial): desaceleración hasta la mitad y, a continuación, aceleración.Curva de aceleración OutInBounce
Easing.BezierSplineCurva de suavizado personalizada definida por la propiedad easing.bezierCurve.

easing.amplitude Solo es aplicable a las curvas de rebote y elásticas (curvas de tipo Easing.InBounce, Easing.OutBounce, Easing.InOutBounce, Easing.OutInBounce, Easing.InElastic, Easing.OutElastic, Easing.InOutElastic o Easing.OutInElastic).

easing.overshoot Solo es aplicable si easing.type es: Easing.InBack, Easing.OutBack, Easing.InOutBack o Easing.OutInBack.

easing.period Solo es aplicable si easing.type es: Easing.InElastic, Easing.OutElastic, Easing.InOutElastic o Easing.OutInElastic.

easing.bezierCurve Solo es aplicable si easing.type es: Easing.BezierSpline. Esta propiedad es una lista<real> que contiene grupos de tres puntos que definen una curva desde 0,0 hasta 1,1 —punto de control 1, punto de control 2, punto final—: [cx1, cy1, cx2, cy2, endx, endy, ...]. El último punto debe ser 1,1.

Consulta las «Curvas de aceleración» para ver una demostración de los diferentes ajustes de aceleración.

exclude : list<QtObject> [read-only]

Esta propiedad indica los elementos que no se verán afectados por esta animación.

Véase también PropertyAnimation::targets.

from : variant

Esta propiedad contiene el valor inicial de la animación.

Si la propiedad « PropertyAnimation » se define dentro de un « Transition » o « Behavior », este valor toma por defecto el valor definido en el estado inicial del « Transition », o el valor actual de la propiedad en el momento en que se activa el « Behavior ».

Véase también «Animación y transiciones» en Qt Quick.

properties : string

property : string

target : QtObject

targets : list<QtObject> [read-only]

Estas propiedades se utilizan como conjunto para determinar qué propiedades deben animarse. Las formas en singular y en plural son funcionalmente idénticas; por ejemplo,

NumberAnimation { target: theItem; property: "x"; to: 500 }

tiene el mismo significado que

NumberAnimation { targets: theItem; properties: "x"; to: 500 }

Las formas en singular están ligeramente optimizadas, por lo que, si solo tienes un único objetivo o propiedad que animar, deberías intentar utilizarlas.

La propiedad « targets » permite establecer varios objetivos. Por ejemplo, esto anima la propiedad « x » tanto de itemA como de itemB:

NumberAnimation { targets: [itemA, itemB]; properties: "x"; to: 500 }

En muchos casos, no es necesario especificar estas propiedades de forma explícita, ya que el marco de animación puede deducirlas:

Fuente de valor / ComportamientoCuando se utiliza una animación como fuente de valor o en un comportamiento, tanto el destino predeterminado como el nombre de la propiedad que se va a animar pueden deducirse.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    NumberAnimation on x { to: 500; loops: Animation.Infinite } //animate theRect's x property
    Behavior on y { NumberAnimation {} } //animate theRect's y property
}
TransiciónCuando se utiliza en una transición, se supone que una animación de propiedad coincide con todos los destinos, pero con ninguna propiedad. En la práctica, eso significa que es necesario especificar al menos las propiedades para que la animación surta efecto.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    Item { id: uselessItem }
    states: State {
        name: "state1"
        PropertyChanges {
            theRect {
                x: 200
                y: 200
                z: 4
            }
            uselessItem {
                x: 10
                y: 10
                z: 2
            }
        }
    }
    transitions: Transition {
        //animate both theRect's and uselessItem's x and y to their final values
        NumberAnimation { properties: "x,y" }

        //animate theRect's z to its final value
        NumberAnimation { target: theRect; property: "z" }
    }
}
De forma independienteCuando una animación se utiliza de forma independiente, es necesario especificar explícitamente tanto el objetivo como la propiedad.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    //need to explicitly specify target and property
    NumberAnimation { id: theAnim; target: theRect; property: "x"; to: 500 }
    MouseArea {
        anchors.fill: parent
        onClicked: theAnim.start()
    }
}

Como se ve en el ejemplo anterior, las propiedades se especifican como una cadena de nombres de propiedades, separados por comas, que se van a animar.

Véase también « exclude » y «Animación y transiciones» en Qt Quick.

to : variant

Esta propiedad contiene el valor final de la animación.

Si la propiedad « PropertyAnimation » se define dentro de un « Transition » o un « Behavior », este valor toma por defecto el valor definido en el estado final del « Transition », o el valor del cambio de propiedad que desencadenó la « Behavior ».

Véase también «Animaciones y transiciones» en Qt Quick.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.