Flex 4 – Différences entre Flex 3 et Flex 4 (4-Nouvelle syntaxe des States)
Traduction de l'article Differences between Flex 3 and Flex 4 beta de Joan Lafferty.
Flex 4 introduit une nouvelle syntaxe MXML pour les States. Celle-ci est plus "inline", permettant de faire des modifications sur les States en fonction du contexte. Voici les grandes différences de la syntaxe Flex 4 par rapport à Flex 3:
- Seuls des states sont définis sans le tableau "states"
- Dans la nouvelle syntaxe des states, vous ne pouvez pas utiliser AddChild ni RemoveChild. A la place, vous devez définissez si un composant fait partie d'un state en utilisant les attributs includeIn et excludeFrom.
Dans l'exemple Flex 3 suivant, les States sont utilisées pour inclure un Button et supprimer un TextInput, seulement quand le "currentState" du document est "submitState". Cette approche peut être très lourde avec des states complexes:
<mx:states>
<mx:State name="submitState" basedOn="">
<mx:AddChild relativeTo="{loginForm}" >
<mx:Button label="submit" bottom="10" right="10"/>
</mx:AddChild>
<mx:RemoveChild target="{firstTextInput}"/>
</mx:State>
</mx:states>
<mx:TextInput id="firstTextInput" />
<mx:Canvas id="loginForm" />
Voici le même exemple en Flex 4 en utilisant includeIn et excludeFrom:
<s:states>
<s:State name="submitState" />
</s:states>
<s:TextInput id="firstTextInput" excludeFrom="submitState" />
<s:Group id="loginForm" >
<s:Button label="submit" bottom="10" right="10" includeIn="submitState"/>
</s:Group>
Les tags SetProperty, SetStyle et SetEventHandler ont été remplacés par la nouvelle syntaxe par point, qui vous permet de préciser un attribut MXML avec un identifiant de State.
Dans le code Flex 3 suivant, le code définit une propriété, un style et un event pour un Button dans l'état submitState:
<mx:states>
<mx:State name="submitState" basedOn="">
<mx:SetProperty target="{submitButton}" name="label" value="submit" />
<mx:SetStyle target="{submitButton}" name="textDecoration" value="underline"/>
<mx:SetEventHandler target="{submitButton}" name="click" handler="trace('done');"/>
</mx:State>
<mx:State name="clearState" basedOn="">
<mx:SetProperty target="{submitButton}" name="label" value="clear" />
<mx:SetEventHandler target="{submitButton}" name="click" handler="emptyDocument()" />
</mx:State>
</mx:states>
<mx:Button id="submitButton" />
Voici à quoi ressemble le même code dans Flex 4:
<s:states>
<s:State name="submitState" />
<s:State name="clearState" />
</s:states>
<s:Button label.submitState="submit" textDecoration.submitState="underline"
click.submitState="trace('done')" click.clearState="emptyDocument()"
label.clearState="clear" textDecoration.clearState="none"/>
Un composant ne peut plus être dans un état undefined ou null. Par défaut, le premier state déclaré est le State initial du composant. La nouvelle syntaxe est disponible quand vous utiliser le namespace MXML 2009. Vous ne pouvez pas mélanger l'ancienne et la nouvelle syntaxe. L'ancienne syntaxe est uniquement disponible avec le namespace MXML 2006.
Flex Item Renderer – Utiliser des States dans un itemRenderer
Cette fois-ci, l'article de Peter Ent porte sur la manière par laquelle vous pouvez changer l'apparence d'un itemRenderer facilement en utilisant des States. Si vous n'avez jamais utilisé les States en Flex, je vous conseille de lire les articles de cette page:
Si vous avez déjà manipulé les states et les transitions Flex, vous savez que cela peut facilement rendre votre application plus agréable. Vous le savez, les itemRenderer servent à afficher une donnée de manière non-classique afin de la présenter de la meilleure manière à votre utilisateur. Parfois, cette communication avec l'utilisateur est assez simple car elle consiste simplement à présenter un nom, mais elle peut parfois utiliser des couleurs ou même être interactive.
Les itemEditors sont de vrais composants interactifs (permettant de modifier la donnée) mais ce n'est pas la portée de cet article. On va ici voir comment un itemRenderer peut changer son apparence suivant la donnée ou une action de l'utilisateur.
Utiliser les States (mx:States)
Le tag <mx:State> est une très bonne manière de changer l'apparence d'un itemRenderer. Les States sont faciles à utiliser et quand ils sont combinés avec des transitions, peuvent donner une réelle expérience utilisateur.
Dans cet exemple, on va créer un nouveau itemRenderer MXML (que vous pouvez bien sûr faire en ActionScript) pour une List. Cet itemRenderer affiche une image, un titre, un auteur, une prix et un Button pour acheter le livre.
Flex Transition: Créer des Transitions en MXML (Move, Resize…), avec exemple
Toutes les applications et les composants ont une propriété states que vous pouvez utiliser pour définir les états à utiliser. De même, toutes les applications et les composants ont une propriété transitions qui est un tableau de toutes les transitions que vous voulez utiliser. Dans le MXML, vous pouvez définir la propriété transitions en utilisant directement dans le premier tag (root tag) d'une appli ou d'un composant:
<mx:transitions> <!-- les transitions entre états apparaitront ici--> </mx:transitions>
Tous les éléments du tableau de transitions, doivent être des object Transition. En MXML, vous créez des instances de Transition en utilisant le tag <mx:Transition>. Tous les objets Transition doivent définir une propriété fromState et toState, et ces propriétés doivent correspondre aux états entre lesquels la transition doit être appliquée.
Par exemple ce code va créer une transition depuis un état appelé A à un état appelé B:
<mx:Transition fromState="A" toState="B"/>
Si vous voulez utiliser une transition depuis ou vers un état en particulier, vous pouvez utiliser l'astérisque comme joker (wild card), ce qui veut dire "tous les états".
L'exemple suivant crée une transition entre tous les états et un état nommé B:
<mx:Transition fromState="*" toState="B"/>
Les objets Transitions doivent avoir une propriété effet qui détermine quel effet sera appliqué pendant le changement d'état. La propriété effet est la propriété par défaut lorsque vous créez un objet Transition en utilisant le MXML.
Flex States: Overrides (AddChild, SetProperty, SetEventHandler) en ActionScript
Ajout et Suppression de Composant en ActionScript
Vous pouvez ajouter et supprimer des composants en MXML grâce aux tages <mx:AddChild> et <mx:RemoveChild>. Ils correspondent aux classes mx.states.AddChild et mx.states.RemoveChild.
Lorsque vous voulez ajouter des composants enfants en utilisant la classe AddChild, vous devez d'abord construire une nouvelle instance:
var addChild:AddChild = new AddChild();
En utilisant le MXML, vous insérez insérez le tag <mx:AddChild> directement. En ActionScript, vous devez assigner une référence au composant à la propriété "target" de l'objet AddChild.
var button:Button = new Button();button.label = "Exemple"; addChild.target = button;
Flex States: Modifier l'écouteur d'événement (Event Handler) d'un composant
Pour changer l'écouteur d'événement d'un composant, on utilise le tag <mx:SetEventHandler>. Ce tag nécessite les 3 attributs suivant pour fonctionner correctement:
- "target": référence vers l'objet auquel vous voulez appliquer la modification d'event handler
- "name": nom du event handler à modifier
- "handler": spécifie la valeur à appliquer à l'écouteur qui sera modifié
L'exemple suivant montre comment utilisez un bouton qui va faire basculer l'état "enabled" d'un champ de saisie. Cela se fait en changeant l'écouteur d'évenement du bouton (et son label) au clic.
Mes projets (Open Source)
Autres
