Cette page explique comment styliser le texte de votre paragraphe. Pour définir un style au niveau du paragraphe, vous pouvez configurer des paramètres tels que textAlign et lineHeight, ou définir votre propre ParagraphStyle.
Définir l'alignement du texte
Le paramètre textAlign vous permet de définir l'alignement horizontal du texte dans une surface composable Text.
Par défaut, Text sélectionne l'alignement de texte naturel en fonction de la valeur de son contenu :
- Bord gauche du conteneur
Textpour les alphabets de gauche à droite tels que le latin, le cyrillique ou le hangûl - Bord droit du conteneur
Textpour les alphabets de droite à gauche tels que l'arabe ou l'hébreu
@Composable
fun CenterText() {
Text(
"Hello World", textAlign = TextAlign.Center, modifier = Modifier.width(150.dp)
)
}
Si vous souhaitez définir manuellement l'alignement du texte d'un composable Text, il est préférable d'utiliser TextAlign.Start et TextAlign.End au lieu de TextAlign.Left et TextAlign.Right respectivement, car ils se résolvent vers le bord droit du composable Text en fonction de l'orientation du texte de la langue préférée. Par exemple, TextAlign.End aligne le texte français vers la droite et le texte arabe vers la gauche, mais TextAlign.Right aligne le texte vers la droite, quel que soit l'alphabet utilisé.
Ajouter plusieurs styles dans un paragraphe
Pour ajouter plusieurs styles dans un paragraphe, vous pouvez utiliser ParagraphStyle dans un AnnotatedString, qui peut être annoté avec des styles d'annotations arbitraires.
Une fois qu'une partie de votre texte est marquée d'une valeur ParagraphStyle, elle est séparée du texte restant, comme si elle comportait des sauts de ligne au début et à la fin.
Pour en savoir plus sur l'ajout de plusieurs styles dans un texte, consultez la section Ajouter plusieurs styles dans le texte.
AnnotatedString dispose d'un compilateur de sûreté du typage pour faciliter la création: buildAnnotatedString. L'extrait suivant utilise buildAnnotatedString pour définir ParagraphStyle:
@Composable
fun ParagraphStyle() {
Text(
buildAnnotatedString {
withStyle(style = ParagraphStyle(lineHeight = 30.sp)) {
withStyle(style = SpanStyle(color = Color.Blue)) {
append("Hello\n")
}
withStyle(
style = SpanStyle(
fontWeight = FontWeight.Bold, color = Color.Red
)
) {
append("World\n")
}
append("Compose")
}
}
)
}
Ajuster la hauteur de la ligne et la marge intérieure
includeFontPadding est une ancienne propriété qui ajoute une marge intérieure supplémentaire en fonction des métriques de police, en haut de la première ligne et en bas de la dernière ligne d'un texte.
À partir de la version 2024.01.01 de la nomenclature Compose, includeFontPadding est défini sur false par défaut, ce qui permet d'aligner la mise en page du texte par défaut sur celle des outils de conception courants.
La possibilité de configurer lineHeight n'est pas nouvelle : elle est disponible depuis Android Q. Vous pouvez configurer lineHeight pour Text à l'aide du paramètre lineHeight, qui répartit la hauteur de la ligne dans chaque ligne de texte. Vous pouvez ensuite utiliser le nouveau LineHeightStyle API pour configurer plus précisément l'alignement de ce texte dans l'espace et supprimer les espaces blancs.
Vous pouvez ajuster lineHeight en utilisant l'unité de texte "em" (taille de police relative) au lieu de "sp" (pixels mis à l'échelle) pour une meilleure précision. Pour en savoir plus sur la sélection d'une unité de texte appropriée, consultez TextUnit.
lineHeight défini et supprimer l'espace supplémentaire si nécessaire.
Text(
text = text,
style = LocalTextStyle.current.merge(
TextStyle(
lineHeight = 2.5.em,
platformStyle = PlatformTextStyle(
includeFontPadding = false
),
lineHeightStyle = LineHeightStyle(
alignment = LineHeightStyle.Alignment.Center,
trim = LineHeightStyle.Trim.None
)
)
)
)
En plus d'ajuster lineHeight, vous pouvez désormais centrer et styliser le texte à l'aide de configurations avec l'API expérimentale LineHeightStyle: LineHeightStyle.Alignment et LineHeightStyle.Trim (includeFontPadding doivent être définis sur false pour que l'outil Trim fonctionne). L'alignement et l'outil Couper utilisent l'espace mesuré entre les lignes de texte pour le répartir de manière plus appropriée sur toutes les lignes, y compris sur une seule ligne de texte et la ligne supérieure d'un bloc de texte.
LineHeightStyle.Alignment définit comment aligner la ligne dans l'espace fourni par la hauteur de la ligne. Sur chaque ligne, vous pouvez aligner le texte en haut, en bas, au centre ou proportionnellement. LineHeightStyle.Trim vous permet ensuite de quitter ou de supprimer l'espace supplémentaire en haut de la première ligne et en bas de la dernière ligne de texte, généré à partir des ajustements de lineHeight et d'alignement. Les exemples suivants montrent à quoi ressemble le texte multiligne avec différentes configurations LineHeightStyle.Trim lorsque l'alignement est centré (LineHeightStyle.Alignment.Center).
 |
 |
LineHeightStyle.Trim.None |
LineHeightStyle.Trim.Both |
 |
 |
LineHeightStyle.Trim.FirstLineTop |
LineHeightStyle.Trim.LastLineBottom |
Consultez l'article de blog Corriger la marge intérieure de la police dans le texte Compose pour en savoir plus sur le contexte de cette modification, le fonctionnement de includeFontPadding dans le système de vues, ainsi que les modifications apportées pour Compose et les nouvelles API LineHeightStyle.
Insérer des sauts de ligne
L'API LineBreak définit les critères de répartition du texte sur plusieurs lignes. Vous pouvez spécifier le type de saut de ligne souhaité dans le bloc TextStyle de votre composable Text. Les types de saut de ligne prédéfinis sont les suivants:
Simple: saut de ligne simple et rapide. Option recommandée pour les champs de saisie de texte.Heading: rupture de ligne avec des règles plus strictes. Recommandé pour les textes courts, comme les titres.Paragraph: saut de ligne plus lent et de meilleure qualité pour une meilleure lisibilité. Cette option est recommandée pour les grandes quantités de texte, telles que les paragraphes.
L'extrait de code suivant utilise à la fois Simple et Paragraph pour spécifier le comportement de saut de ligne sur un long bloc de texte:
TextSample(
samples = mapOf(
"Simple" to {
Text(
text = SAMPLE_LONG_TEXT,
modifier = Modifier
.width(130.dp)
.border(BorderStroke(1.dp, Color.Gray)),
fontSize = 14.sp,
style = TextStyle.Default.copy(
lineBreak = LineBreak.Simple
)
)
},
"Paragraph" to {
Text(
text = SAMPLE_LONG_TEXT,
modifier = Modifier
.width(130.dp)
.border(BorderStroke(1.dp, Color.Gray)),
fontSize = 14.sp,
style = TextStyle.Default.copy(
lineBreak = LineBreak.Paragraph
)
)
}
)
)
Dans le résultat ci-dessus, notez que le comportement de saut de ligne Paragraph produit un résultat visuellement plus équilibré que le saut de ligne Simple.
Personnaliser les sauts de ligne
Vous pouvez également créer votre propre configuration LineBreak avec le paramètre Strategy. Le Strategy peut être l'un des éléments suivants:
Balanced: tente d'équilibrer la longueur des lignes du texte, en appliquant également un trait d'union automatique si cette option est activée. Recommandé pour les petits écrans, comme les montres, afin de maximiser la quantité de texte affichée.HighQuality: optimise un paragraphe pour le rendre plus lisible, y compris les traits d'union si cette option est activée. (Cette valeur doit être la valeur par défaut pour tout ce qui n'est pasBalancedniSimple.)Simple: stratégie basique et rapide Si cette option est activée, le trait d'union n'est effectué que pour les mots qui ne tiennent pas sur une ligne entière. Il est utile pour modifier du texte afin d’éviter de changer de position pendant la saisie.
L'extrait de code suivant montre la différence entre un paragraphe avec les paramètres par défaut et un paragraphe optimisé pour les petits écrans avec la stratégie de saut de ligne Balanced:
TextSample(
samples = mapOf(
"Balanced" to {
val smallScreenAdaptedParagraph =
LineBreak.Paragraph.copy(strategy = LineBreak.Strategy.Balanced)
Text(
text = SAMPLE_LONG_TEXT,
modifier = Modifier
.width(200.dp)
.border(BorderStroke(1.dp, Color.Gray)),
fontSize = 14.sp,
style = TextStyle.Default.copy(
lineBreak = smallScreenAdaptedParagraph
)
)
},
"Default" to {
Text(
text = SAMPLE_LONG_TEXT,
modifier = Modifier
.width(200.dp)
.border(BorderStroke(1.dp, Color.Gray)),
fontSize = 14.sp,
style = TextStyle.Default
)
}
)
)
Balanced (en haut) et paragraphe mis en forme sans stratégie de saut de ligne.Considérations relatives à CJK
Vous pouvez également personnaliser LineBreak avec les API Strictness et WordBreak, qui ont été conçues spécifiquement pour les langages CJK.
Il est possible que vous ne voyiez pas toujours les effets de ces API dans des langues autres que le CJK. Dans l'ensemble, les règles de saut de ligne sont définies en fonction des paramètres régionaux.
Strictness décrit la sévérité de la rupture de ligne avec les propriétés suivantes:
Default: règles destructives par défaut pour les paramètres régionaux. Peut correspondre àNormalouStrict.Loose: règles les moins restrictives. (Convient aux lignes courtes).Normal: règles les plus courantes pour les sauts de ligne.Strict: règles les plus strictes pour le saut de ligne.
WordBreak définit la manière dont les sauts de ligne doivent être insérés dans les mots avec les propriétés suivantes:
Default: règles destructives par défaut pour les paramètres régionaux.Phrase: les sauts de ligne s'appuient sur des expressions.
L'extrait de code suivant utilise un paramètre de sévérité Strict et un paramètre de rupture de mot Phrase pour un texte en japonais:
val customTitleLineBreak = LineBreak(
strategy = LineBreak.Strategy.HighQuality,
strictness = LineBreak.Strictness.Strict,
wordBreak = LineBreak.WordBreak.Phrase
)
Text(
text = "あなたに寄り添う最先端のテクノロジー。",
modifier = Modifier.width(250.dp),
fontSize = 14.sp,
style = TextStyle.Default.copy(
lineBreak = customTitleLineBreak
)
)
Strictness et WordBreak (en haut) par rapport au texte formaté uniquement avec LineBreak.Heading (en bas).Trait d'union du texte réparti sur plusieurs lignes
L'API Hyphens vous permet d'ajouter une prise en charge des traits d'union dans votre application. L'abréviation désigne l'insertion d'un signe de ponctuation en forme de tiret pour indiquer qu'un mot est divisé sur plusieurs lignes de texte. Lorsque cette option est activée, un trait d'union est ajouté entre les syllabes d'un mot aux points de trait d'union appropriés.
Par défaut, les traits d'union ne sont pas activés. Pour activer la trait d'union, ajoutez Hyphens.Auto en tant que paramètre dans un bloc TextStyle:
TextSample(
samples = mapOf(
"Hyphens - None" to {
Text(
text = SAMPLE_LONG_TEXT,
modifier = Modifier
.width(130.dp)
.border(BorderStroke(1.dp, Color.Gray)),
fontSize = 14.sp,
style = TextStyle.Default.copy(
lineBreak = LineBreak.Paragraph,
hyphens = Hyphens.None
)
)
},
"Hyphens - Auto" to {
Text(
text = SAMPLE_LONG_TEXT,
modifier = Modifier
.width(130.dp)
.border(BorderStroke(1.dp, Color.Gray)),
fontSize = 14.sp,
style = TextStyle.Default.copy(
lineBreak = LineBreak.Paragraph,
hyphens = Hyphens.Auto
)
)
}
)
)
Lorsque cette option est activée, le trait d'union ne se produit que dans les conditions suivantes:
- Un mot ne tient pas sur une ligne. Si vous utilisez une stratégie de saut de ligne
Simple, le trait d'union ne se produit que si la ligne est plus courte que le mot seul. - Les paramètres régionaux appropriés sont définis sur votre appareil, car le trait d'union approprié est déterminé à l'aide des dictionnaires présents sur le système.
Recommandations personnalisées
- Remarque : Le texte du lien s'affiche lorsque JavaScript est désactivé
- Style de texte
- Principes de base de la mise en page dans Compose
- Mesures intrinsèques dans les mises en page Compose