RichText  - AS3 Flex

Package	spark.components
Classe	public class RichText
Héritage	RichText TextBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

Adobe recommande de ne pas utiliser ce composant dans une application qui fait appel au profil mobileDevice.

Pour des raisons de performances, il ne prend pas en charge défilement, la sélection, la modification, les hyperliens cliquables ou les images chargées à partir d’URL. Si vous avez besoin de ces fonctionnalités, consultez la classe RichEditableText.

RichText utilise la bibliothèque Text Layout Framework (TLF), qui repose elle-même sur le nouveau moteur Flash Text Engine (FTE) de Flash Player 10. Associés, ils assurent la mise en forme de texte enrichi à l’aide d’une typographie internationale haute qualité.

L’architecture Spark fournit trois « primitives » de texte : Label, RichText et RichEditableText. Label est la plus rapide et la plus légère, car elle utilise uniquement FTE, et pas TLF. Mais elle est limitée dans ses capacités : aucun texte enrichi, aucun défilement, aucune sélection et aucune modification. RichText ajoute la possibilité de lire du texte à la présentation complexe, mais n’est absolument pas interactive. RichEditableText est la plus lourde, mais tire le meilleur parti de la technologie TLF. Vous devez utiliser la primitive la plus légère adaptée à vos besoins.

RichText est similaire à la classe control mx.controls.Text MX. Le contrôle Text utilise l’ancienne classe TextField, au lieu de TLF, pour afficher du texte.

Les principales différences entre RichText et Text sont les suivantes :

• RichText offre des fonctionnalités typographiques et de présentation de texte optimisées, ainsi qu’une meilleure prise en charge des langues internationales.
• RichText a un modèle d’affichage orienté objet, ce qui n’est pas le cas de Text.
• Text est sélectionnable, alors que RichText ne prend pas en charge la sélection.

RichText utilise le modèle de texte enrichi orienté objet TLF, dans lequel les éléments de présentation de texte, tels que les divisions, les paragraphes, les étendues, les hyperliens, et les images sont représentés à l’exécution par des objets ActionScript. TextFlow est l’objet central de TLF permettant de représenter le texte enrichi. Vous pouvez spécifier l’affichage du texte enrichi dans RichText en définissant sa propriété textFlow sur une instance TextFlow. (Consultez la description de la propriété textFlow pour plus d’informations sur sa création.) Vous pouvez également définir la propriété text qui est héritée de TextBase, mais si vous n’avez pas besoin de la richesse de TextFlow, envisagez l’utilisation de Label.

Lors de la compilation, vous pouvez placer des balises de marquage TLF dans la balise RichText, comme l’illustre l’exemple suivant :

  <s:RichText>Hello <s:span fontWeight="bold">World!</s:span></s:RichText>
  

Le formatage de texte par défaut est déterminé par des styles CSS, par exemple fontFamily et fontSize. Les informations de formatage de l’objet TextFlow remplacent le formatage par défaut fourni par les styles CSS.

Vous pouvez contrôler l’espacement entre les lignes l’aide du style lineHeight et l’espacement entre les paragraphes avec les styles paragraphSpaceBefore et paragraphSpaceAfter. Vous pouvez aligner ou justifier le texte à l’aide des styles textAlign et textAlignLast. Vous pouvez mettre le texte en retrait à partir des bords du composant de l’aide des styles paddingLeft, paddingTop, paddingRight et paddingBottom.

Si vous ne spécifiez aucun type de largeur pour RichText, la ligne la plus longue, tel que déterminée par ces sauts de ligne explicites, détermine la largeur de Label.

Lorsque vous spécifiez une largeur, le texte revient à la ligne sur le bord droit du composant et le texte est écrêté s’il dépasse du conteneur. Si vous définissez le style lineBreak sur explicit, les nouvelles lignes commencent uniquement aux sauts de lignes explicites, si vous utilisez CR (\r), LF (\n) ou CR+LF (\r\n) dans text ou si vous utilisez <p> et <br /> dans le marquage TLF. Dans ce cas, les lignes plus larges que le contrôle sont écrêtées.

Si votre texte dépasse l’espace d’affichage, RichText permet de le tronquer. La troncature de texte signifie le remplacement du texte superflu à l’aide d’un indicateur de troncature, tel que « ... ». Consultez les propriétés héritées maxDisplayedLines et isTruncated.

Par défaut, RichText n’a aucun arrière-plan, mais vous pouvez en tracer un en utilisant les styles backgroundColor et backgroundAlpha. Bordures non prises en charge. Si vous avez besoin d’une bordure ou d’un arrière-plan plus complexe, utilisez un autre élément graphique, tel qu’un Rect, derrière le RichText.

Etant donné que RichText utilise TLF, il prend en charge l’affichage du texte rédigé de gauche à droite (LTR), par exemple, en français, de droite à gauche (RTL), comme en arabe, et du texte bidirectionnel, par exemple une phrase française au sein d’une phrase arabe. Si le sens du texte prédominant est de droite à gauche, définissez le style direction sur rtl. Par défaut, le style textAlign pour la valeur "start", ce qui aligne le texte à gauche lorsque direction est définie sur ltr et à droite lorsque direction est définie sur rtl. Pour obtenir l’alignement inverse, définissez textAlign sur end.

RichText utilise les classes TextFlowTextLineFactory et StringTextFlowFactory de TLF pour créer un ou plusieurs objets TextLine pour afficher statiquement son texte. Pour des performances accrues, ses objets TextLines créés ne contiennent pas d’informations sur les différents glyphes. Pour plus d’informations, consultez la classe TextLineValidity.

Pour utiliser ce composant d’un composant à base de listes (par exemple List ou DataGrid) créez une option de rendu d’élément. Pour plus d’informations sur la création d’une option de rendu d’élément, consultez la section Options personnalisées de rendu d’élément Spark.

Afficher la syntaxe MXML

Masquer la syntaxe MXML

  <s:RichText
    Properties
    fontContext="IFlexModuleFactory"
    luminosityClip="false"
    luminosityInvert="false"
    maskType="MaskType.CLIP"
    textFlow="TextFlow"
  />
  

Propriété MXML par défautcontent

Consulter les exemples

Eléments de l’API associés