En esta página

SpringAnimation QML Type

Permite que una propiedad siga un valor con un movimiento similar al de un muelle. Más...

Import Statement: import QtQuick
Inherits:

NumberAnimation

Propiedades

Descripción detallada

SpringAnimation imita el comportamiento oscilatorio de un muelle, con la constante « spring » adecuada para controlar la aceleración y la « damping » para controlar la rapidez con la que el efecto se desvanece.

También puedes limitar el valor máximo de ` velocity ` de la animación.

El siguiente Rectangle se desplaza a la posición del ratón utilizando una SpringAnimation al hacer clic con el ratón. El uso de la Behavior en los valores x y y indica que, cada vez que se modifiquen estos valores, se debe aplicar una SpringAnimation.

import QtQuick

Item {
    width: 300; height: 300

    Rectangle {
        id: rect
        width: 50; height: 50
        color: "red"

        Behavior on x { SpringAnimation { spring: 2; damping: 0.2 } }
        Behavior on y { SpringAnimation { spring: 2; damping: 0.2 } }
    }

    MouseArea {
        anchors.fill: parent
        onClicked: (mouse)=> {
            rect.x = mouse.x - rect.width/2
            rect.y = mouse.y - rect.height/2
        }
    }
}

Al igual que cualquier otro tipo de animación, una SpringAnimation puede aplicarse de diversas formas, incluyendo transiciones, comportamientos y fuentes de valores de propiedad. La documentación «Animación y transiciones» en Qt Quick muestra diversos métodos para crear animaciones.

Véase también SmoothedAnimation, «Animación y transiciones» en Qt Quick, «Ejemplos deQt Quick: Animación» y «Demostración deQt Quick: Relojes».

Documentación de propiedades

damping : real

Esta propiedad contiene el valor de amortiguación del muelle.

Este valor describe la rapidez con la que se detiene el movimiento elástico. El valor por defecto es 0.

El rango de valores válido es de 0 a 1,0. Cuanto menor sea el valor, más rápido se detendrá el movimiento.

epsilon : real

Esta propiedad contiene el valor epsilon de la elasticidad.

El épsilon es la tasa y la magnitud del cambio en el valor, que es lo suficientemente cercano a 0 como para considerarse igual a cero. Esto dependerá del uso que se le dé al valor. Para las posiciones de píxeles, bastaría con 0,25. Para la escala, bastaría con 0,005.

El valor predeterminado es 0,01. Ajustar este valor puede aportar pequeñas mejoras en el rendimiento.

mass : real

Esta propiedad contiene la «masa» de la propiedad que se está moviendo.

El valor predeterminado es 1,0.

Una masa mayor provoca un movimiento más lento y un movimiento más elástico cuando un objeto se detiene.

modulus : real

Esta propiedad contiene el valor del módulo. El valor por defecto es 0.

Al establecer un « modulus », se obliga al valor de destino a «volver al principio» en el módulo. Por ejemplo, si se establece el módulo en 360, un valor de 370 volverá al principio y se convertirá en 10.

spring : real

Esta propiedad describe la intensidad con la que el destino es atraído hacia la fuente. El valor por defecto es 0 (es decir, el movimiento elástico está desactivado).

El rango de valores válido es de 0 a 5,0.

Cuando se configura esta propiedad y el valor de « velocity » es mayor que 0, « velocity » limita la velocidad máxima.

velocity : real

Esta propiedad establece la velocidad máxima permitida al seguir a la fuente.

El valor por defecto es 0 (sin velocidad máxima).

© 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.