Span
作為Text組件的子組件,用于顯示行內(nèi)文本的組件。
說明:
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
該組件從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。該組件從API Version 10開始支持繼承父組件Text的屬性,即如果子組件未設(shè)置屬性且父組件設(shè)置屬性,則繼承父組件設(shè)置的屬性。支持繼承的屬性僅包括:fontColor、fontSize、fontStyle、fontWeight、decoration、letterSpacing、textCase、fontfamily。
子組件
無
接口
Span(value: string | Resource)
從API version 9開始,該接口支持在ArkTS卡片中使用。
參數(shù)名 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
---|---|---|---|
value | string | [Resource] | 是 |
屬性
通用屬性方法僅支持除lineHeight以外的[通用文本樣式]。
名稱 | 參數(shù)類型 | 描述 |
---|---|---|
decoration | { type: [TextDecorationType], color?: [ResourceColor]} | 設(shè)置文本裝飾線樣式及其顏色。 默認(rèn)值:{ type: TextDecorationType.None color:Color.Black } 從API version 9開始,該接口支持在ArkTS卡片中使用。 |
letterSpacing | number | string |
textCase | [TextCase] | 設(shè)置文本大小寫。 默認(rèn)值:TextCase.Normal 從API version 9開始,該接口支持在ArkTS卡片中使用。 |
font10+ | [Font] | 設(shè)置文本樣式。包括字體大小、字體粗細(xì)、字體族和字體風(fēng)格。 |
事件
通用事件僅支持[點(diǎn)擊事件]。
說明:
HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿
由于Span組件無尺寸信息,因此點(diǎn)擊事件返回的ClickEvent對象的target屬性無效。
示例
// xxx.ets
@Entry
@Component
struct SpanExample {
build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Start, justifyContent: FlexAlign.SpaceBetween }) {
Text('Basic Usage').fontSize(9).fontColor(0xCCCCCC)
Text() {
Span('In Line')
Span(' Component')
Span(' !')
}
Text() {
Span('This is the Span component').fontSize(12).textCase(TextCase.Normal)
.decoration({ type: TextDecorationType.None, color: Color.Red })
}
// 文本橫線添加
Text('Text Decoration').fontSize(9).fontColor(0xCCCCCC)
Text() {
Span('I am Underline-span').decoration({ type: TextDecorationType.Underline, color: Color.Red }).fontSize(12)
}
Text() {
Span('I am LineThrough-span')
.decoration({ type: TextDecorationType.LineThrough, color: Color.Red })
.fontSize(12)
}
Text() {
Span('I am Overline-span').decoration({ type: TextDecorationType.Overline, color: Color.Red }).fontSize(12)
}
// 文本字符間距
Text('LetterSpacing').fontSize(9).fontColor(0xCCCCCC)
Text() {
Span('span letter spacing')
.letterSpacing(0)
.fontSize(12)
}
Text() {
Span('span letter spacing')
.letterSpacing(-2)
.fontSize(12)
}
Text() {
Span('span letter spacing')
.letterSpacing(3)
.fontSize(12)
}
// 文本大小寫展示設(shè)置
Text('Text Case').fontSize(9).fontColor(0xCCCCCC)
Text() {
Span('I am Lower-span').fontSize(12)
.textCase(TextCase.LowerCase)
.decoration({ type: TextDecorationType.None })
}
Text() {
Span('I am Upper-span').fontSize(12)
.textCase(TextCase.UpperCase)
.decoration({ type: TextDecorationType.None })
}
}.width('100%').height(250).padding({ left: 35, right: 35, top: 35 })
}
}
審核編輯 黃宇
-
鴻蒙
+關(guān)注
關(guān)注
57文章
2302瀏覽量
42689
發(fā)布評論請先 登錄
相關(guān)推薦
評論