En esta página

Animación y transiciones en Qt Quick

Tipos de animación y transiciones

  • Transition - Anima las transiciones durante los cambios de estado
  • SequentialAnimation - Ejecuta las animaciones de forma secuencial
  • ParallelAnimation - Ejecuta las animaciones en paralelo
  • Behavior - Especifica una animación predeterminada para los cambios de propiedad
  • PropertyAction - Establece cambios inmediatos en las propiedades durante la animación
  • PauseAnimation - Introduce una pausa en una animación
  • SmoothedAnimation - Permite que una propiedad siga suavemente un valor
  • SpringAnimation - Permite que una propiedad siga un valor con un movimiento similar al de un resorte
  • ScriptAction - Ejecuta scripts durante una animación

Tipos que animan propiedades en función de los tipos de datos

AnchorAnimation

Anima los cambios en los valores de anclaje

ColorAnimation

Anima los cambios en los valores de color

NumberAnimation

Anima los cambios en los valores de tipo qreal

ParentAnimation

Anima los cambios en los valores de los elementos padres

PathAnimation

Anima un elemento a lo largo de una ruta

PropertyAnimation

Anima los cambios en los valores de las propiedades

RotationAnimation

Anima los cambios en los valores de rotación

Vector3dAnimation

Anima los cambios en los valores de tipo QVector3d

Las animaciones se crean aplicando tipos de animación a los valores de las propiedades. Los tipos de animación interpolan los valores de las propiedades para crear transiciones fluidas. Asimismo, las transiciones de estado pueden asignar animaciones a los cambios de estado.

Para crear una animación, utiliza un tipo de animación adecuado para el tipo de la propiedad que se va a animar y aplica la animación en función del tipo de comportamiento que se requiera.

Activación de animaciones

Existen varias formas de aplicar una animación a un objeto.

Animación directa de propiedades

Las animaciones se crean aplicando objetos de animación a los valores de las propiedades para modificarlas gradualmente a lo largo del tiempo. Estas animaciones de propiedades aplican movimientos fluidos mediante la interpolación de valores entre los cambios de las propiedades. Las animaciones de propiedades ofrecen controles de sincronización y permiten diferentes tipos de interpolación a través de curvas de aceleración y desaceleración.

Rectangle {
    id: flashingblob
    width: 75; height: 75
    color: "blue"
    opacity: 1.0

    MouseArea {
        anchors.fill: parent
        onClicked: {
            animateColor.start()
            animateOpacity.start()
        }
    }

    PropertyAnimation {id: animateColor; target: flashingblob; properties: "color"; to: "green"; duration: 100}

    NumberAnimation {
        id: animateOpacity
        target: flashingblob
        properties: "opacity"
        from: 0.99
        to: 1.0
        loops: Animation.Infinite
        easing {type: Easing.OutBack; overshoot: 500}
   }
}

Los tipos especializados de animación de propiedades tienen implementaciones más eficientes que el tipo « PropertyAnimation ». Sirven para establecer animaciones en diferentes tipos de QML, como « int », « color » y rotaciones. Del mismo modo, « ParentAnimation » puede animar los cambios del elemento padre.

Consulta la sección «Control de animaciones » para obtener más información sobre las diferentes propiedades de animación.

Uso de objetivos y propiedades predefinidos

En el ejemplo anterior, los objetos PropertyAnimation y NumberAnimation tenían que especificar valores concretos para target y properties con el fin de indicar los objetos y las propiedades que debían animarse. Esto puede evitarse utilizando la sintaxis <Animation> on <Property>, que especifica que la animación debe aplicarse como fuente de valor de la propiedad.

A continuación se muestran dos objetos PropertyAnimation que se especifican utilizando esta sintaxis:

import QtQuick 2.0

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

    PropertyAnimation on x { to: 100 }
    PropertyAnimation on y { to: 100 }
}

La animación comienza tan pronto como se carga el rectángulo y se aplicará automáticamente a sus valores x y y. Dado que se ha utilizado la sintaxis <Animation> on <Property>, no es necesario establecer el valor target de los objetos PropertyAnimation en rect, ni tampoco es necesario establecer los valores property en x y y.

Esto también puede utilizarse en animaciones agrupadas para garantizar que todas las animaciones de un grupo se apliquen a la misma propiedad. Por ejemplo, en lugar de ello, el ejemplo anterior podría utilizar SequentialAnimation para animar el color del rectángulo primero a amarillo y luego a azul:

import QtQuick 2.0

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

    SequentialAnimation on color {
        ColorAnimation { to: "yellow"; duration: 1000 }
        ColorAnimation { to: "blue"; duration: 1000 }
    }
}

Dado que el objeto ` SequentialAnimation ` se ha especificado en la propiedad ` color ` utilizando la sintaxis `<Animation> on <Property>`, sus objetos hijos ` ColorAnimation ` también se aplican automáticamente a esta propiedad y no es necesario especificar valores de animación ` target ` o ` property `.

Transiciones durante los cambios de estado

Qt Quick States son configuraciones de propiedades en las que una propiedad puede tener diferentes valores para reflejar distintos estados. Los cambios de estado provocan cambios bruscos en las propiedades; las animaciones suavizan las transiciones para producir cambios de estado visualmente atractivos.

El tipo « Transition » puede contener tipos de animación para interpolar los cambios en las propiedades provocados por los cambios de estado. Para asignar la transición a un objeto, vincúlala a la propiedad « transitions ».

Un botón puede tener dos estados: el estado « pressed » cuando el usuario hace clic en el botón y el estado « released » cuando el usuario suelta el botón. Podemos asignar diferentes configuraciones de propiedades para cada estado. Una transición animaría el cambio del estado « pressed » al estado « released ». Del mismo modo, habría una animación durante el cambio del estado « released » al estado « pressed ».

Rectangle {
    width: 75; height: 75
    id: button
    state: "RELEASED"

    MouseArea {
        anchors.fill: parent
        onPressed: button.state = "PRESSED"
        onReleased: button.state = "RELEASED"
    }

    states: [
        State {
            name: "PRESSED"
            PropertyChanges { target: button; color: "lightblue"}
        },
        State {
            name: "RELEASED"
            PropertyChanges { target: button; color: "lightsteelblue"}
        }
    ]

    transitions: [
        Transition {
            from: "PRESSED"
            to: "RELEASED"
            ColorAnimation { target: button; duration: 100}
        },
        Transition {
            from: "RELEASED"
            to: "PRESSED"
            ColorAnimation { target: button; duration: 100}
        }
    ]
}

Al vincular las propiedades to y from al nombre del estado, se asignará esa transición concreta al cambio de estado. En el caso de transiciones simples o simétricas, al establecer la propiedad to to con el símbolo comodín «* », se indica que la transición se aplica a cualquier cambio de estado.

    transitions:
        Transition {
            to: "*"
            ColorAnimation { target: button; duration: 100}
        }

Animación predeterminada como comportamientos

Las animaciones predeterminadas de las propiedades se configuran mediante animaciones de comportamiento. Las animaciones declaradas en los tipos « Behavior » se aplican a la propiedad y animan cualquier cambio en el valor de la misma. Sin embargo, los tipos de comportamiento disponen de una propiedad « enabled » para habilitar o deshabilitar de forma deliberada las animaciones de comportamiento.

Un componente de bola podría tener una animación de comportamiento asignada a sus propiedades « x », « y » y « color ». La animación de comportamiento podría configurarse para simular un efecto elástico. En la práctica, esta animación de comportamiento aplicaría el efecto elástico a las propiedades cada vez que la bola se mueva.

Rectangle {
    width: 75; height: 75; radius: width
    id: ball
    color: "salmon"

    component BounceAnimation : NumberAnimation {
       easing {
          type: Easing.OutElastic
          amplitude: 1.0
          period: 0.5
       }
    }

    Behavior on x {
        BounceAnimation {}
    }
    Behavior on y {
        BounceAnimation {}
    }
    Behavior on color {
        ColorAnimation { target: ball; duration: 100 }
    }
}

Existen varios métodos para asignar animaciones de comportamiento a las propiedades. La declaración Behavior on <property> es una forma práctica de asignar una animación de comportamiento a una propiedad.

Consulta los «Ejemplos deQt Quick: Animación» para ver una demostración de las animaciones de comportamiento.

Reproducción de animaciones en paralelo o en secuencia

Las animaciones pueden ejecutarse en paralelo o en secuencia. Las animaciones en paralelo reproducen un grupo de animaciones al mismo tiempo, mientras que las animaciones secuenciales reproducen un grupo de animaciones en orden: una tras otra. Al agrupar animaciones en SequentialAnimation y ParallelAnimation, estas se reproducirán en secuencia o en paralelo.

Un componente de banner puede tener varios iconos o eslóganes que mostrar, uno tras otro. La propiedad opacity podría transformarse en 1.0, lo que indica un objeto opaco. Al utilizar el tipo SequentialAnimation, las animaciones de opacidad se reproducirán una vez finalizada la animación anterior. El tipo ParallelAnimation reproducirá las animaciones al mismo tiempo.

Rectangle {
    id: banner
    width: 150; height: 100; border.color: "black"

    Column {
        anchors.centerIn: parent
        Text {
            id: code
            text: "Code less."
            opacity: 0.01
        }
        Text {
            id: create
            text: "Create more."
            opacity: 0.01
        }
        Text {
            id: deploy
            text: "Deploy everywhere."
            opacity: 0.01
        }
    }

    MouseArea {
        anchors.fill: parent
        onPressed: playbanner.start()
    }

    SequentialAnimation {
        id: playbanner
        running: false
        NumberAnimation { target: code; property: "opacity"; to: 1.0; duration: 200}
        NumberAnimation { target: create; property: "opacity"; to: 1.0; duration: 200}
        NumberAnimation { target: deploy; property: "opacity"; to: 1.0; duration: 200}
    }
}

Una vez que las animaciones individuales se colocan en un « SequentialAnimation » o un « ParallelAnimation », ya no se pueden iniciar ni detener de forma independiente. La animación secuencial o paralela debe iniciarse y detenerse como un grupo.

El tipo « SequentialAnimation » también resulta útil para reproducir animaciones de transición, ya que las animaciones se reproducen en paralelo dentro de las transiciones.

Control de animaciones

Existen diferentes métodos para controlar las animaciones.

Reproducción de animaciones

Todos los tipos de animación heredan del tipo « Animation ». No es posible crear objetos « Animation »; en su lugar, este tipo proporciona las propiedades y métodos esenciales para los tipos de animación. Los tipos de animación cuentan con « start() », « stop() », « resume() », « pause() », « restart() » y « complete() »; todos estos métodos controlan la ejecución de las animaciones.

Suavizado

Las curvas de aceleración definen cómo se interpolará la animación entre el valor inicial y el valor final. Es posible que algunas curvas de aceleración superen el rango de interpolación definido. Las curvas de aceleración simplifican la creación de efectos de animación, como los rebotes, la aceleración, la desaceleración y las animaciones cíclicas.

Un objeto QML puede tener una curva de aceleración diferente para cada animación de propiedad. También hay diferentes parámetros para controlar la curva, algunos de los cuales son exclusivos de una curva concreta. Para obtener más información sobre las curvas de aceleración, consulta la documentación de easing.

El ejemplo de suavizado muestra gráficamente cada uno de los diferentes tipos de suavizado.

Otros tipos de animación

Además, QML ofrece otros tipos útiles para la animación:

  • PauseAnimation: permite introducir pausas durante las animaciones
  • ScriptAction: permite ejecutar código JavaScript durante una animación y puede utilizarse junto con ` StateChangeScript ` para reutilizar scripts existentes
  • PropertyAction: cambia una propiedad de forma inmediata durante una animación, sin animar el cambio de la propiedad

Se trata de tipos de animación especializados que animan diferentes tipos de propiedades

Compartir instancias de animación

No se admite compartir instancias de animación entre transiciones o comportamientos, y ello puede dar lugar a un comportamiento indefinido. En el siguiente ejemplo, es muy probable que los cambios en la posición del rectángulo no se animen correctamente.

Rectangle {
    // NOT SUPPORTED: this will not work correctly as both Behaviors
    // try to control a single animation instance
    NumberAnimation { id: anim; duration: 300; easing.type: Easing.InBack }
    Behavior on x { animation: anim }
    Behavior on y { animation: anim }
}

La solución más sencilla es repetir la animación « NumberAnimation » en ambos comportamientos. Si la animación repetida es bastante compleja, también puedes plantearte crear un componente de animación personalizado y asignar una instancia a cada comportamiento, por ejemplo:

Rectangle {
    component MyNumberAnimation : NumberAnimation {
        duration: 300; easing.type: Easing.InBack
    }
    Behavior on x { MyNumberAnimation {} }
    Behavior on y { MyNumberAnimation {} }
}

Véase también Ejemplos de «Qt Quick » - Animación.

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