En esta página

Las animaciones

Qt Quick permite animar propiedades. La animación de propiedades permite que los valores de las mismas pasen por valores intermedios en lugar de cambiar inmediatamente al valor de destino. Para animar la posición de un elemento, puedes animar las propiedades que controlan su posición, como x e y, por ejemplo, de modo que la posición del elemento cambie en cada fotograma hasta alcanzar la posición de destino.

Interfaces de usuario fluidas

QML se diseñó para facilitar la creación de interfaces de usuario fluidas. Se trata de interfaces de usuario en las que los componentes se animan en lugar de aparecer, desaparecer o saltar bruscamente. Qt Quick ofrece dos formas sencillas de hacer que los componentes de la interfaz de usuario se desplacen con animación en lugar de aparecer instantáneamente en su nueva ubicación.

Estados y transiciones

Qt Quick te permite declarar diversos estados de interfaz de usuario en objetos de « State ». Estos estados se componen de cambios en las propiedades con respecto a un estado base y pueden ser una forma útil de organizar la lógica de tu interfaz de usuario. Las transiciones son objetos que puedes asociar a un elemento para definir cómo se animarán sus propiedades cuando cambien debido a un cambio de estado.

Los estados y las transiciones de un elemento se pueden declarar mediante las propiedades « Item::states » y « Item::transitions ». Los estados se declaran dentro de la propiedad «states list» de un elemento, normalmente el elemento raíz del componente. Las transiciones definidas en el mismo elemento se utilizan para animar los cambios de estado. A continuación se muestra un ejemplo.

Item {
    id: container
    width: 320
    height: 120

    Rectangle {
        id: rect
        color: "red"
        width: 120
        height: 120

        TapHandler {
            onTapped: container.state === '' ? container.state = 'other' : container.state = ''
        }
    }
    states: [
        // This adds a second state to the container where the rectangle is farther to the right

        State { name: "other"

            PropertyChanges {
                target: rect
                x: 200
            }
        }
    ]
    transitions: [
        // This adds a transition that defaults to applying to all state changes

        Transition {

            // This applies a default NumberAnimation to any changes a state change makes to x or y properties
            NumberAnimation { properties: "x,y" }
        }
    ]
}

Animación de cambios en las propiedades.

Los comportamientos se pueden utilizar para especificar una animación que se aplicará a una propiedad cuando esta cambie. Esta animación se aplica entonces a todos los cambios, independientemente de su origen. El siguiente ejemplo anima el movimiento de un botón por la pantalla mediante comportamientos.

Item {
    width: 320
    height: 120

    Rectangle {
        color: "green"
        width: 120
        height: 120

        // This is the behavior, and it applies a NumberAnimation to any attempt to set the x property
        Behavior on x {

            NumberAnimation {
                //This specifies how long the animation takes
                duration: 600
                //This selects an easing curve to interpolate with, the default is Easing.Linear
                easing.type: Easing.OutBounce
            }
        }

        TapHandler {
            onTapped: parent.x == 0 ? parent.x = 200 : parent.x = 0
        }
    }
}

Otras animaciones

No todas las animaciones tienen que estar vinculadas a una propiedad o un estado específicos. También se pueden crear animaciones de forma más general y especificar los elementos y propiedades de destino dentro de la animación. A continuación se muestran algunos ejemplos de diferentes formas de hacerlo:

Item {
    width: 320
    height: 120

    Rectangle {
        color: "blue"
        width: 120
        height: 120

        // By setting this SequentialAnimation on x, it and animations within it will automatically animate
        // the x property of this element
        SequentialAnimation on x {
            id: xAnim
            // Animations on properties start running by default
            running: false
            loops: Animation.Infinite // The animation is set to loop indefinitely
            NumberAnimation { from: 0; to: 200; duration: 500; easing.type: Easing.InOutQuad }
            NumberAnimation { from: 200; to: 0; duration: 500; easing.type: Easing.InOutQuad }
            PauseAnimation { duration: 250 } // This puts a bit of time between the loop
        }

        TapHandler {
            // The animation starts running when you click within the rectangle
            onTapped: xAnim.running = true
        }
    }
}
Item {
    width: 320
    height: 120

    Rectangle {
        id: rectangle
        color: "yellow"
        width: 120
        height: 120

        TapHandler {
            // The animation starts running when you click within the rectangle
            onTapped: anim.running = true;
        }
    }

    // This animation specifically targets the Rectangle's properties to animate
    SequentialAnimation {
        id: anim
        // Animations on their own are not running by default
        // The default number of loops is one, restart the animation to see it again

        NumberAnimation { target: rectangle; property: "x"; from: 0; to: 200; duration: 500 }

        NumberAnimation { target: rectangle; property: "x"; from: 200; to: 0; duration: 500 }
    }
}

Cuadrados rojos, verdes, azules y amarillos dispuestos de forma escalonada

Se puede encontrar más información sobre animaciones en la página «Conceptos importantes de Qt Quick: estados, transiciones y animaciones ».

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