| Package | mx.states |
| Classe | public class Transition |
| Héritage | Transition  Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Pour définir une transition, définissez la propriété transitions d’une application sur un tableau d’objets Transition.
Les propriétés toState et fromState de la classe Transition permettent de spécifier les modifications d’état qui déclenchent la transition. Par défaut, les propriétés fromState et toState sont définies sur la valeur « * », qui permet d’appliquer la transition à toutes les modifications apportées à l’état d’affichage.
Vous pouvez utiliser la propriété fromState pour spécifier explicitement l’état d’affichage que vous remplacez et la propriété toState pour spécifier explicitement un état d’affichage auquel vous passez. Si une modification de l’état correspond à deux transitions, la propriététoState est prioritaire par rapport à la propriété fromState. Si plusieurs transitions correspondent, Flex utilise la première définition du tableau de transition.
La propriété effect permet de spécifier l’objet Effect à lancer lors de l’application de la transition. En règle générale, il s’agit d’un objet Effect composite, tel qu’un effet Parallel ou Sequence, qui contient plusieurs effets, comme l’illustre l’exemple suivant :
<mx:Transition id="myTransition" fromState="*" toState="*">
<mx:Parallel>
...
</mx:Parallel>
</mx:Transition>
Syntaxe MXML
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:Transition> tag
defines the following attributes:
<mx:Transition
Properties
id="ID"
effect=""
fromState="*"
toState="*"
autoReverse="false"
/>
Propriété MXML par défauteffect
Eléments de l’API associés
mx.effects.RemoveChildAction
mx.effects.SetPropertyAction
mx.effects.SetStyleAction
| Propriété | Défini par | ||
|---|---|---|---|
| autoReverse : Boolean = false
Affectez la valeur true pour spécifier que cette transition s’applique à la fois aux changements d’état d’affichage avant et inverse. | Transition | ||
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| effect : IEffect
Objet IEffect à lancer lors de l’application de la transition. | Transition | ||
| fromState : String = "*"
Chaîne indiquant l’état d’affichage en cours de modification lors de l’application de la transition. | Transition | ||
| interruptionBehavior : String = "end"
Flex ne prend pas en charge la lecture simultanée de plusieurs transitions. | Transition | ||
| toState : String = "*"
Chaîne indiquant l’état d’affichage auquel vous passez lors de l’application de la transition. | Transition | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | Transition | ||
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
autoReverse | propriété |
public var autoReverse:Boolean = false| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Affectez la valeur true pour spécifier que cette transition s’applique à la fois aux changements d’état d’affichage avant et inverse. Par conséquent, utilisez cette transition lors d’un changement de l’état d’affichage A à l’état d’affichage B, et lors du changement de B vers A.
Lorsque la transition de l’état d’affichage A vers l’état d’affichage B est en cours, la transition inverse peut se produire pour interrompre la transition actuelle. La transition inverse interrompt toujours la transition actuelle à son emplacement actuel. Ainsi, la transition inverse s’effectue toujours comme si la propriété interruptionBehavior était définie sur stop, quelle que soit la valeur réelle de interruptionBehavior.
Cette propriété est vérifiée uniquement si la nouvelle transition s’effectue dans la direction exactement opposée de celle qui est en cours. En d’autres termes, si une transition est en cours entre les états A et B, puis qu’une transition revenant vers A est démarrée.
Si une transition utilise les propriétés toState et fromState pour gérer explicitement la transition à partir de l’état d’affichage B vers A, Flex ignore la propriété autoReverse
La valeur par défaut est false.
Eléments de l’API associés
effect | propriété |
public var effect:IEffect| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Objet IEffect à lancer lors de l’application de la transition. En règle générale, il s’agit d’un objet Effect composite, tel qu’un effet Parallel ou Sequence, contenant plusieurs effets.
La propriété effect est la propriété par défaut de la classe Transition. Vous pouvez omettre la balise <mx:effect> si vous utilisez la syntaxe de balise MXML.
fromState | propriété |
public var fromState:String = "*"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Chaîne indiquant l’état d’affichage en cours de remplacement lors de l’application de la transition. La valeur par défaut est « * », qui représente n’importe quel état d’affichage.
Vous pouvez définir cette propriété sur une chaîne vide, "", qui correspond à l’état d’affichage de base.
La valeur par défaut est "*".
interruptionBehavior | propriété |
public var interruptionBehavior:String = "end"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10.2, AIR 2.5 |
Flex ne prend pas en charge la lecture simultanée de plusieurs transitions. Si une transition est en cours de lecture lorsqu’une nouvelle transition se produit, la transition en cours est interrompue. Cette propriété contrôle la façon dont la transition en cours se comporte lorsqu’elle est interrompue.
Par défaut, la transition en cours se termine, ce qui aligne tous les effets dans la transition vers leurs valeurs finales. Cela correspond à la valeur de propriété end. Si la valeur de cette propriété est stop, la transition en cours s’interrompt à son emplacement actuel. La nouvelle transition démarre à l’emplacement d’arrêt de la précédente transition.
La valeur de stop peut lisser l’apparence d’une transition interrompue. La raison en est que l’utilisateur ne voit pas la transition en cours s’aligner sur son état final avant que la nouvelle transition commence.
Dans certains cas, la transition d’interruption peut être l’inverse de la transition en cours. Par exemple, lorsque la transition de l’état d’affichage A vers l’état d’affichage B est en cours, la transition inverse peut se produire pour interrompre la transition en cours. Si vous définissez la propriété autoReverse d’une instance de transition sur true, vous pouvez utiliser la même transition pour gérer à la fois les transitions vers l’avant et inverses. Lorsque la transition d’interruption est la transition inverse de la transition en cours et que son paramètre autoReverse a la valeur true, la transition d’interruption s’exécute comme si la propriété interruptionBehavior avait la valeur stop, quelle que soit la valeur réelle du paramètre interruptionBehavior.
La classe mx.states.InterruptionBehavior définit les valeurs possibles de cette propriété.
La valeur par défaut est end.
Eléments de l’API associés
toState | propriété |
public var toState:String = "*"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Chaîne indiquant l’état d’affichage auquel vous passez lors de l’application de la transition. La valeur par défaut est « * », qui représente n’importe quel état d’affichage.
Vous pouvez définir cette propriété sur une chaîne vide, "", qui correspond à l’état d’affichage de base.
La valeur par défaut est "*".
Transition | () | Constructeur |
public function Transition()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
<?xml version="1.0" ?>
<!-- Simple example to demonstrate the Transition class. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx" currentState="Login">
<!-- Define the view states -->
<s:states>
<s:State name="Login" />
<s:State name="Register" />
</s:states>
<s:transitions>
<!-- Define the transition from the base state to the Register state.-->
<s:Transition id="toRegister" fromState="*" toState="Register">
<s:Sequence targets="{[loginPanel, registerLink, confirm, loginLink]}">
<s:RemoveAction />
<s:Fade />
<s:SetAction target="{loginPanel}" property="title" />
<s:SetAction target="{loginButton}" property="label" />
<s:SetAction target="{loginButton}" property="color" />
<s:Resize target="{loginPanel}"/>
<s:AddAction />
<s:Fade />
</s:Sequence>
</s:Transition>
<!-- Define the transition from the Register state to the base state.-->
<s:Transition id="toDefault" fromState="Register" toState="*">
<s:Sequence targets="{[loginPanel, registerLink,
confirm, loginLink]}">
<s:RemoveAction/>
<s:SetAction target="{loginPanel}" property="title"/>
<s:SetAction target="{loginButton}" property="label"/>
<s:SetAction target="{loginButton}" property="color"/>
<s:Resize target="{loginPanel}"/>
<s:AddAction/>
</s:Sequence>
</s:Transition>
</s:transitions>
<!-- Define a Panel container that defines the login form. The title of the Panel
changes depending on the state. -->
<s:Panel title="Login" title.Register="Register" id="loginPanel"
width="75%" horizontalCenter="0" verticalCenter="0">
<s:controlBarLayout >
<s:BasicLayout />
</s:controlBarLayout>
<s:layout>
<s:VerticalLayout paddingTop="10" paddingBottom="10" paddingRight="10" paddingLeft="10" />
</s:layout>
<s:Label color="blue" width="100%"
text="Click the 'Need to Register?' link to change state. Click the 'Return to Login' link to return to the base state."/>
<!-- The following form has two TextInputs in the Login state and three TextInputs
in the Register state. -->
<s:Form id="loginForm" >
<s:FormItem label="Username:">
<s:TextInput/>
</s:FormItem>
<s:FormItem label="Password:">
<s:TextInput/>
</s:FormItem>
<s:FormItem id="confirm" label="Confirm:" includeIn="Register" includeInLayout="false" includeInLayout.Register="true">
<s:TextInput/>
</s:FormItem>
</s:Form>
<!-- The controlBar includes two visible items in each state. Which LinkButton is visible is determined
by the state -->
<s:controlBarContent>
<mx:LinkButton id="registerLink" label="Need to Register?" top="10" bottom="10"
click="currentState='Register'" left="10" includeIn="Login" />
<mx:LinkButton id="loginLink" label="Return to Login" click="currentState=''" includeIn="Register" left="10" top="10" bottom="10"/>
<s:Button label="Login" label.Register="Register" id="loginButton" right="10" color.Register="0x0000FF" top="10" bottom="10"/>
</s:controlBarContent>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z