华为仓颉鸿蒙HarmonyOS NEXT原生UI基础组件Text

原创

Bison丶 2024-12-23 20:07:33 ©著作权

文章标签 参数类型默认值 Text 文章分类 Android 移动开发

©著作权归作者所有：来自51CTO博客作者Bison丶的原创作品，请联系作者获取转载授权，否则将追究法律责任

显示一段文本的组件。

子组件

可以包含Span子组件。

构造函数

init(String)

public init(content: String)

创建一个Text组件。

参数名	参数类型	必填	默认值	描述
content	String	是	-	文本内容。

init(() -> Unit)

public init(subcomponent: () -> Unit)

创建一个Text组件。

参数名	参数类型	必填	默认值	描述
child	() -> Unit	是	-	Text 的子组件

init(CJResource)

public init(content: CJResource)

创建一个Text组件。

参数名	参数类型	必填	默认值	描述
content	CJResource	是	-	文本内容,引入系统资源或者应用资源中的文本。

init(PluralResource)

public init(content: PluralResource)

创建一个Text组件。

参数名	参数类型	必填	默认值	描述
content	PluralResource	是	-	文本内容,引入系统资源或者应用资源中的文本。

函数

textAlign(textAlign)

public func textAlign(value: textAlign): This

设置文本段落在水平方向的对齐方式。

文本段落宽度占满Text组件宽度。

可通过align属性控制文本段落在垂直方向上的位置，此组件中不可通过align属性控制文本段落在水平方向上的位置，即align属性中Alignment.TopStart、Alignment.Top、Alignment.TopEnd效果相同，控制内容在顶部，Alignment.Start、Alignment.Center、Alignment.End效果相同，控制内容垂直居中，Alignment.BottomStart、Alignment.Bottom、Alignment.BottomEnd效果相同，控制内容在底部。结合TextAlign属性可控制内容在水平方向的位置。

参数名	参数类型	必填	默认值	描述
value	TextAlign	是	-	设置多行文本的文本对齐方式。

textOverflow(TextOverflow)

public func textOverflow(value: TextOverflow): This

设置文本超长时的显示方式。

参数名	参数类型	必填	默认值	描述
value	TextOverflow	是	TextAlign.Start	文本超长时的显示方式, 需配合maxLines使用，单独设置不生效。

maxLines(Int32)

public func maxLines(value: Int32): This

设置文本的最大行数。

参数名	参数类型	必填	默认值	描述
value	Int32	是	-	文本的最大行数。说明：默认情况下，文本是自动折行的，如果指定此参数，则文本最多不会超过指定的行。如果有多余的文本，可以通过textOverflow来指定截断方式。

lineHeight(Length)

public func lineHeight(value: Length): This

根据Length设置文本的文本行高。

参数名	参数类型	必填	默认值	描述
value	Length	是	-	设置文本的文本行高，设置值不大于 0 时，不限制文本行高，自适应字体大小。

lineHeight(Float64)

public func lineHeight(value: Float64): This

根据浮点数设置文本的文本行高。

参数名	参数类型	必填	默认值	描述
value	Float64	是	-	设置文本的文本行高，设置值不大于 0 时，不限制文本行高，自适应字体大小，单位为 fp。

lineHeight(Int64)

public func lineHeight(value: Int64): This

根据整数设置文本的文本行高。

参数名	参数类型	必填	默认值	描述
value	Int64	是	-	设置文本的文本行高，设置值不大于 0 时，不限制文本行高，自适应字体大小，单位为 fp。

decoration(TextDecorationType, Color)

public func decoration(decorationType!: TextDecorationType, color!: Color): This

设置文本装饰线样式及其颜色。

参数名	参数类型	必填	默认值	描述
decorationType	TextDecorationType	是	-	文本装饰线样式。
color	Color	是	-	文本装饰线颜色。

decoration(TextDecorationType, UInt32)

public func decoration(decorationType!: TextDecorationType, color!: UInt32): This

设置文本装饰线样式及其颜色。

参数名	参数类型	必填	默认值	描述
decorationType	TextDecorationType	是	-	文本装饰线样式。
color	UInt32	是	-	文本装饰线颜色。

decoration(TextDecorationType, CJResource)

public func decoration(decorationType!: TextDecorationType, color!: CJResource): This

设置文本装饰线样式及其颜色。

参数名	参数类型	必填	默认值	描述
decorationType	TextDecorationType	是	-	文本装饰线样式。
color	CJResource	是	-	文本装饰线颜色，引入系统资源或者应用资源中的颜色。

baselineOffset(Length)

public func baselineOffset(value: Length): This

根据Length设置文本基线的偏移量。

参数名	参数类型	必填	默认值	描述
value	Length	是	0	文本基线的偏移量。

baselineOffset(Float64)

public func baselineOffset(value: Float64): This

根据浮点数设置文本基线的偏移量。

参数名	参数类型	必填	默认值	描述
value	Float64	是	0	文本基线的偏移量，单位为 fp。

baselineOffset(Int64)

public func baselineOffset(value: Int64): This

根据整数设置文本基线的偏移量。

参数名	参数类型	必填	默认值	描述
value	Int64	是	0	文本基线的偏移量，单位为 fp。

minFontSize(Length)

public func minFontSize(value: Length): This

根据Length设置文本最小显示字号。

参数名	参数类型	必填	默认值	描述
value	Length	是	-	文本最小显示字号。需配合maxFontSize以及maxLines或布局大小限制使用，单独设置不生效，对子组件不生效。

minFontSize(Float64)

public func minFontSize(value: Float64): This

根据浮点数设置文本最小显示字号。

参数名	参数类型	必填	默认值	描述
value	Float64	是	-	文本最小显示字号。需配合maxFontSize以及maxLines或布局大小限制使用，单独设置不生效，对子组件不生效。

minFontSize(Int64)

public func minFontSize(value: Int64): This

根据整数设置文本最小显示字号。

参数名	参数类型	必填	默认值	描述
value	Int64	是	-	文本最小显示字号。需配合maxFontSize以及maxLines或布局大小限制使用，单独设置不生效，对子组件不生效。

maxFontSize(Length)

public func maxFontSize(value: Length): This

根据Length设置文本最大显示字号。

参数名	参数类型	必填	默认值	描述
value	Length	是	-	文本最大显示字号。需配合minFontSize以及maxLines或布局大小限制使用，单独设置不生效，对子组件不生效。

maxFontSize(Float64)

public func maxFontSize(value: Float64): This

根据浮点数设置文本最大显示字号。

参数名	参数类型	必填	默认值	描述
value	Float64	是	-	文本最小显示字号。需配合minFontSize以及maxLines或布局大小限制使用，单独设置不生效，对子组件不生效。

maxFontSize(Int64)

public func maxFontSize(value: Int64): This

根据整数设置文本最大显示字号。

参数名	参数类型	必填	默认值	描述
value	Int64	是	-	文本最小显示字号。需配合minFontSize以及maxLines或布局大小限制使用，单独设置不生效，对子组件不生效。

textCase(TextCase)

public func textCase(value: TextCase): This

设置文本大小写。

参数名	参数类型	必填	默认值	描述
value	TextCase	是	TextCase.Normal	文本大小写

通用属性/通用事件

通用属性：全部支持。

通用事件：全部支持。

枚举说明

TextAlign

TextAlign 表示文本段落在水平方向的对齐方式。

枚举值	描述
Start	根据文字书写相同的方向对齐。
Center	文本居中对齐。
End	根据文字书写相反的方向对齐。

TextOverflow

TextOverflow 表示文本超长时的显示方式。

枚举值	描述
Clip	文本超长时进行裁剪显示。
Ellipsis	文本超长时显示不下的文本用省略号代替。
None	文本超长时不进行裁剪。

TextDecorationType

TextDecorationType 表示文本装饰线样式。

枚举值	描述
None	不使用文本装饰线。
Underline	文字下划线修饰。
Overline	文字上划线修饰。
LineThrough	穿过文本的修饰线。

TextCase

TextCase 表示文本大小写。

枚举值	描述
Normal	保持文本原有大小写。
LowerCase	文本采用全小写。
UpperCase	文本采用全大写。

示例代码

import ohos.base.*
    import ohos.component.*
    import ohos.state_manage.*
    import ohos.state_macro_manage.*
    
    @Entry
    @Component
    class MyView {
        func build() {
            Flex(FlexParams(direction: FlexDirection.Column, alignItems: ItemAlign.Start, justifyContent: FlexAlign.SpaceBetween)) {
                Text("lineHeight")
                .fontSize(9)
                .fontColor(0xCCCCCC)
                Text("This is the text with the line height set This is the text with the line height set This is the text with the line height set.")
                .lineHeight(25)
                .fontSize(12)
                .border(width: 1.px)
                .padding(10)
    
                Text("TextOverflow")
                .fontSize(9)
                .fontColor(0xCCCCCC)
                Text("This is the setting of textOverflow to none text content This is the setting of textOverflow to none text content.")
                .textOverflow(TextOverflow.None)
                .fontSize(12)
                .border(width: 1.px)
                .padding(10)
                Text("This is the setting of textOverflow to Clip text content This is the setting of textOverflow to Clip text content.")
                .textOverflow(TextOverflow.Clip)
                .maxLines(1)
                .fontSize(12)
                .border(width: 1.px)
                .padding(10)
                Text("'This is set textOverflow to Ellipsis text content This is set textOverflow to Ellipsis text content.")
                .textOverflow(TextOverflow.Ellipsis)
                .maxLines(1)
                .fontSize(12)
                .border(width: 1.px)
                .padding(10)
    
                Text("decoration")
                .fontSize(9)
                .fontColor(0xCCCCCC)
                Text("This is the text content with the decoration set to Underline and the color set to Red.")
                .decoration(decorationType: TextDecorationType.Underline, color: Color.RED)
                .fontSize(12)
                .border(width: 1.px)
                .padding(10)
                Text("This is the text content with the decoration set to LineThrough and the color set to Red.")
                .decoration(decorationType: TextDecorationType.LineThrough, color: Color.RED)
                .fontSize(12)
                .border(width: 1.px)
                .padding(10)
                Text("This is the text content with the decoration set to Overline and the color set to Red.")
                .decoration(decorationType: TextDecorationType.Overline, color: Color.RED)
                .fontSize(12)
                .border(width: 1.px)
                .padding(10)
            }
            .height(600)
            .width(350)
            .padding(left: 35, right: 35, top: 35)
        }
    }

华为仓颉鸿蒙HarmonyOS NEXT原生UI基础组件Text_Text