Transition QML Type
Define las transiciones animadas que se producen al cambiar de estado. Más información...
| Import Statement: | import QtQuick |
Propiedades
- animations : list<Animation>
- enabled : bool
- from : string
- reversible : bool
- running : bool
- to : string
Descripción detallada
Una transición define las animaciones que se aplicarán cuando se produzca un cambio en State.
Por ejemplo, el siguiente Rectangle tiene dos estados: el estado predeterminado y un estado «moved» añadido. En el estado «moved», la posición del rectángulo cambia a (50, 50). La transición añadida especifica que, cuando el rectángulo cambie del estado predeterminado al estado «moved», cualquier cambio en las propiedades x y y debe animarse utilizando un Easing.InOutQuad.
import QtQuick
Rectangle {
id: rect
width: 100; height: 100
color: "red"
MouseArea {
id: mouseArea
anchors.fill: parent
}
states: State {
name: "moved"; when: mouseArea.pressed
PropertyChanges { target: rect; x: 50; y: 50 }
}
transitions: Transition {
NumberAnimation { properties: "x,y"; easing.type: Easing.InOutQuad }
}
}Obsérvese que el ejemplo no requiere valores de « to » y « from » para « NumberAnimation ». Para mayor comodidad, estas propiedades se establecen automáticamente en los valores de « x » y « y » antes y después del cambio de estado; los valores de « from » se obtienen de los valores actuales de « x » y « y », y los valores de « to » se obtienen del objeto « PropertyChanges ». Si lo desea, puede proporcionar valores de « to » y « from » de todos modos para anular los valores predeterminados.
Por defecto, las animaciones de una transición se aplican ante cualquier cambio de estado en el elemento padre. Los valores « from » y « to » de la transición pueden configurarse para restringir la aplicación de las animaciones únicamente a los cambios de un estado concreto a otro.
Las animaciones de nivel superior dentro de una transición se ejecutan en paralelo. Para ejecutarlas secuencialmente, defínelas dentro de un ` SequentialAnimation`:
transitions: Transition {
to: "brighter"
reversible: true
SequentialAnimation {
PropertyAnimation { property: "x"; duration: 1000 }
ColorAnimation { duration: 1000 }
}
}Para definir varias transiciones, especifica Item::transitions como una lista:
transitions: [
Transition {
from: "*"; to: "middleRight"
NumberAnimation {
properties: "x,y";
easing.type: Easing.InOutQuad;
duration: 2000;
}
},
Transition {
from: "*"; to: "bottomLeft";
NumberAnimation {
properties: "x,y";
easing.type: Easing.InOutQuad;
duration: 200;
}
},
//If any other rectangle is clicked, the icon will return
//to the start position at a slow speed and bounce.
Transition {
from: "*"; to: "*";
NumberAnimation {
easing.type: Easing.OutBounce;
properties: "x,y";
duration: 4000;
}
}
]Si se especifican varias «Transitions», solo se aplicará una única transición (la que mejor se ajuste) para cualquier cambio de estado concreto. En el ejemplo anterior, si el rectángulo entra en un estado distinto de « "middleRight" » o « "bottomLeft" », se llevará a cabo la tercera transición, lo que significa que el icono se moverá al punto de partida.
Si un cambio de estado tiene una transición que coincide con la misma propiedad que un « Behavior », la animación de la transición anula el « Behavior » para ese cambio de estado.
Véase también «Animación y transiciones» en Qt Quick, el ejemplo «Estados», «Qt Quick States» y Qt Qml.
Documentación de propiedades
animations : list<Animation> [default read-only]
Esta propiedad contiene una lista de las animaciones que se ejecutarán para esta transición.
transitions: Transition {
PropertyAnimation { duration: 3000 }
ColorAnimation { duration: 3000 }
}Las animaciones de nivel superior se ejecutan en paralelo. Para ejecutarlas de forma secuencial, defínelas dentro de un « SequentialAnimation »:
transitions: Transition {
to: "brighter"
reversible: true
SequentialAnimation {
PropertyAnimation { property: "x"; duration: 1000 }
ColorAnimation { duration: 1000 }
}
}enabled : bool
Esta propiedad determina si la transición se ejecutará al pasar del estado « from » al estado « to ».
Por defecto, una transición está activada.
Ten en cuenta que, en algunas circunstancias, desactivar una transición puede provocar que se utilice una transición alternativa en su lugar. En el siguiente ejemplo, aunque la primera transición se ha configurado para animar los cambios de «state1» a «state2», esta transición se ha desactivado al establecer enabled en false, por lo que cualquier cambio de estado de este tipo se animará en realidad mediante la segunda transición.
Item {
states: [
State { name: "state1" },
State { name: "state2" }
]
transitions: [
Transition { from: "state1"; to: "state2"; enabled: false },
Transition {
// ...
}
]
}Estas propiedades indican los cambios de estado que activan la transición.
Los valores por defecto de estas propiedades son «*» (es decir, cualquier estado).
Por ejemplo, en la siguiente transición no se han definido las propiedades « to » y « from », por lo que la animación se aplica siempre que se cambia entre los dos estados (es decir, al pulsar y soltar el botón del ratón).
Rectangle {
id: rect
width: 100; height: 100
color: "red"
MouseArea { id: mouseArea; anchors.fill: parent }
states: State {
name: "brighter"; when: mouseArea.pressed
PropertyChanges { target: rect; color: "yellow" }
}
transitions: Transition {
ColorAnimation { duration: 1000 }
}
}Si la transición se modificara de la siguiente manera:
transitions: Transition {
to: "brighter"
ColorAnimation { duration: 1000 }
}La animación solo se aplicaría al pasar del estado por defecto al estado «más brillante» (es decir, al pulsar el botón del ratón, pero no al soltarlo).
Se pueden establecer varios valores de « to » y « from » utilizando una cadena separada por comas.
Véase también reversible.
reversible : bool
Esta propiedad determina si la transición debe invertirse automáticamente cuando se inviertan las condiciones que la activaron.
El valor por defecto es «false».
Por defecto, las transiciones se ejecutan en paralelo y se aplican a todos los cambios de estado si no se han establecido los estados « from » y « to ». En esta situación, la transición se aplica automáticamente cuando se revierte un cambio de estado, y no es necesario establecer esta propiedad para revertir la transición.
Sin embargo, si se utiliza un « SequentialAnimation », o si se han establecido las propiedades « from » o « to », será necesario establecer esta propiedad para invertir una transición cuando se revierta un cambio de estado. Por ejemplo, la siguiente transición aplica una animación secuencial al pulsar el botón del ratón e invierte la secuencia de la animación al soltar el botón:
Rectangle {
id: rect
width: 100; height: 100
color: "steelblue"
TapHandler { id: tapHandler }
states: State {
name: "brighter"
when: tapHandler.pressed
PropertyChanges { target: rect; color: "lightsteelblue"; x: 50 }
}
transitions: Transition {
to: "brighter"
reversible: true
SequentialAnimation {
PropertyAnimation { property: "x"; duration: 1000 }
ColorAnimation { duration: 1000 }
}
}
}Si la transición no hubiera establecido los valores de « to » y « reversible », al soltar el ratón la transición reproduciría « PropertyAnimation » antes que « ColorAnimation », en lugar de invertir la secuencia.
running : bool [read-only]
Esta propiedad indica si la transición se está ejecutando en este momento.
Nota: A diferencia de ` Animation::running`, esta propiedad es de solo lectura y no se puede utilizar para controlar la transició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.