環(huán)境
添加依賴：
def compose_version = "0.1.0-dev03"
kapt("androidx.compose:compose-compiler:$compose_version")
implementation("androidx.compose:compose-runtime:$compose_version")
implementation("androidx.ui:ui-core:$compose_version")
implementation "androidx.ui:ui-tooling:$compose_version"
implementation("androidx.ui:ui-layout:$compose_version")
implementation("androidx.ui:ui-framework:$compose_version")
implementation("androidx.ui:ui-material:$compose_version")
implementation("androidx.ui:ui-foundation:$compose_version")
implementation("androidx.ui:ui-text:$compose_version")
androidx.ui.core中的Composable Text組件為我們提供了一系列的屬性來(lái)控制文本的外觀矾克。
@Composable
fun Text(
text: String,
modifier: Modifier = Modifier.None,
style: TextStyle? = null,
paragraphStyle: ParagraphStyle? = null,
softWrap: Boolean = DefaultSoftWrap,
overflow: TextOverflow = DefaultOverflow,
maxLines: Int? = DefaultMaxLines
) {
Text(
text = AnnotatedString(text),
modifier = modifier,
style = style,
paragraphStyle = paragraphStyle,
softWrap = softWrap,
overflow = overflow,
maxLines = maxLines
)
}
基本屬性
softWrap
聲明是否應(yīng)在換行符處斷開文本
overflow
組件中溢出文本
省略號(hào)
image
淡入淡出
image
@Preview
@Composable
fun initLayout() {
// 定義一個(gè)有寬度的容器
Container (
width = Dp(80f)
){
Text(
text = "1234567890asdfgh",
softWrap = false,
maxLines = 1,
overflow = TextOverflow.Fade
)
}
}
文本樣式
在定義文本組件的樣式屬性時(shí)萨蚕，我們需要使用TextStyle類的實(shí)例
@Immutable
data class TextStyle(
// 文本顏色
val color: Color? = null,
// Sp 字體大小
val fontSize: TextUnit = TextUnit.Inherit,
// 文本粗細(xì)
val fontWeight: FontWeight? = null,
// 文本樣式 Normal或Italic
val fontStyle: FontStyle? = null,
// 文本字體手動(dòng)合成粗體/斜體樣式
val fontSynthesis: FontSynthesis? = null,
// 文本字體
val fontFamily: FontFamily? = null,
// 字體的高級(jí)排版設(shè)置
val fontFeatureSettings: String? = null,
// 字符之間的間距
val letterSpacing: TextUnit = TextUnit.Inherit,
// 從文本基線開始使用的垂直移位
val baselineShift: BaselineShift? = null,
// 文本幾何變換
val textGeometricTransform: TextGeometricTransform? = null,
// 特定語(yǔ)言環(huán)境的文本
val localeList: LocaleList? = null,
// 文本背景色
val background: Color? = null,
// 在文本的某處繪制水平線 None Underline LineThrough
val decoration: TextDecoration? = null,
// 要在文本上繪制的陰影
val shadow: Shadow? = null
)
段落樣式
ParagraphStyle類
data class ParagraphStyle constructor(
// 文本對(duì)齊方式 LEFT否过、START锹淌、RIGHT传趾、END、CENTER绎橘、JUSTIFY
val textAlign: TextAlign? = null,
// 枚舉類設(shè)置文本顯示方向
val textDirectionAlgorithm: TextDirectionAlgorithm? = null,
// 文本行高
val lineHeight: Sp? = null,
// 文本縮進(jìn)
val textIndent: TextIndent? = null
)
多樣化文本
/**
* The basic data structure of text with multiple styles. To construct an [AnnotatedString] you
* can use [Builder].
*/
data class AnnotatedString(
val text: String,
val textStyles: List<Item<TextStyle>> = listOf(),
val paragraphStyles: List<Item<ParagraphStyle>> = listOf()
)
例如：
@Composable
fun initLayout() {
// 定義一個(gè)有寬度的容器
Container (
width = Dp(80f)
){
val annotatedString = AnnotatedString.Builder("1234567890asdfgh")
.apply {
addStyle(TextStyle(color = Color.Red), 0, 3)
}
Text(
text = annotatedString.toAnnotatedString(),
softWrap = false,
maxLines = 1,
overflow = TextOverflow.Fade
)
}
}
添加和刪除樣式
- pushStyle：將TextStyle添加到AnnotatedText中，該樣式將應(yīng)用于推入樣式后附加的任何文本返回樣式的索引捺氢。
- pushStyle: 將ParagraphStyle添加到AnnotatedText中
- popStyle: 從AnnotatedText中刪除以前添加的樣式
- popStyle: 從AnnotatedText中刪除指定索引處的樣式
@Preview
@Composable
fun initLayout() {
// 定義一個(gè)有寬度的容器
Container (
width = Dp(150f),
alignment = Alignment.CenterLeft
){
val style = TextStyle(color = Color.Red,background = Color.White)
val annotatedString = AnnotatedString.Builder("123456")
annotatedString.pushStyle(style)
annotatedString.append(", aaaaaa")
// 去掉樣式
annotatedString.popStyle()
annotatedString.append("cccccc.")
Text(text = annotatedString.toAnnotatedString(), maxLines = 1)
}
}
image
