Apache Adobe Flex TutorialTutoriaux Adobe Flex & AIR en Français

Flex Chart – Les classes de type Axis

Flex supporte les types d'axes suivants:

• CategoryAxis: La classe CategoryAxis assigne un ensemble de valeurs (des mois, des noms d'états, des catégories démographiques…) à un axe. Vous pouvez utiliser le tag <mx:CategoryAxis> pour définir des labels labels sur les axes qui seront groupés par association logique et qui ne seront pas forcement numériques. Par exemple, les noms des mois de l'année peuvent être définis comme une classe CategoryAxis.
• LinearAxis: La classe LinearAxis assigne des valeurs numériques classiques à un axe. Vous pouvez utiliser le tag <mx:LinearAxis> en tant qu'enfant du tag <mx:horizontalAxis> ou <mx:verticalAxis> pour personnaliser l'intervalle de valeurs (range) affiché le long des axes ainsi que l'incrément entre chaque valeur.
• LogAxis: La classe LogAxis assigne des valeurs numériques sur un axe de manière logarithmique. Vous pouvez utiliser le tag <mx:LogAxis> en tant qu'enfant du tag <mx:horizontalAxis> ou <mx:verticalAxis>. Les labels d'un axe logarithmique sont des puissance paire de 10.
• DateTimeAxis: La classe DateTimeAxis permet d'assigner des valeurs de type temps à un axe, comme des heures, des jours, des années …

Les types DateTimeAxis, LogAxis et LinearAxis sont tous des types de NumericAxis, car ils sont utilisés pour représenter des valeurs numériques. Dans de nombreux cas, vous devez définir seulement un axis comme étant un NumericAxis ou un CategoryAxis. Flex assume que tous les axes qui ne sont pas explicitement définis sont de type LinearAxis. Cependant, pour utiliser les "décorations" comme les DataTip ou les Legend, vous devrez peut-être définir explicitement les deux axes.

Il y a des exceptions. Pour un composant PlotChart, les deux axes sont considérés comme des LinearAxis, car le point est l'intersection de deux coordonnées. Donc vous n'êtes pas obligés de spécifier un axe, sauf si vous avez besoin de fournir des paramètres supplémentaires comme les valeurs minimum et maximum. Quand vous créez un composant PieChart, vous ne spécifiez pas non plus chaque axe, car le composant PieChart utilise un simple ensemble de données pour dessiner les tranches en fonction du pourcentage de la totalité. Dans les composants PieChart, vous définissez un "nameField" sur la series du Chart, plutôt qu'un "categoryField" sur les axes pour les labels et les légendes.

Chaque axe peut avoir un ou plusieurs objets AxisRenderer (spécifiés par les propriétés horizontalAxisRenderer et verticalAxisRenderer) qui définissent l'apparence des labels des axes et des ticks (marqueurs d'intervalle). En plus de définir le format, vous pouvez utiliser une classe AxisRenderer pour personnaliser les valeurs des labels des axes.

L'apparence et le contenu des labels des axes sont définis par les tags <mx:horizontalAxis> (axe X) et <mx:verticalAxis> (axe Y) et les renderers de ces tags (tags <mx:AxisRenderer> à l'intérieur des tags <mx:horizontalAxisRenderer> et <mx:verticalAxisRenderer>).

Par défaut, Flex utilise le type de Chart et l'orientation pour calculer les labels qui apparaissent le long des axes X et Y d'un graphique. Les labels d'un Column Chart par exemple, ont les valeurs par défaut suivantes:

• Axe X: Le nombre minimum de labels est 0 et le nombre maximum équivaut au nombre d'items dans la data series
• Axe Y: La valeur minimum pour l'axe Y est plus petite que celle des données du Chart, et la valeur maximale est assez grande pour pouvoir tout afficher.