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)單獨標(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ù)類型 | 必填 | 參數(shù)描述 | 
|---|---|---|---|
| value | string | [Resource] | 是 | 
屬性
通用屬性方法僅支持除lineHeight以外的[通用文本樣式]。
| 名稱 | 參數(shù)類型 | 描述 | 
|---|---|---|
| decoration | { type: [TextDecorationType], color?: [ResourceColor]} | 設(shè)置文本裝飾線樣式及其顏色。 默認值:{ type: TextDecorationType.None color:Color.Black } 從API version 9開始,該接口支持在ArkTS卡片中使用。 | 
| letterSpacing | number | string | 
| textCase | [TextCase] | 設(shè)置文本大小寫。 默認值:TextCase.Normal 從API version 9開始,該接口支持在ArkTS卡片中使用。 | 
| font10+ | [Font] | 設(shè)置文本樣式。包括字體大小、字體粗細、字體族和字體風(fēng)格。 | 
事件
通用事件僅支持[點擊事件]。
說明:
HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿
由于Span組件無尺寸信息,因此點擊事件返回的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)注
60文章
2772瀏覽量
45192 
發(fā)布評論請先 登錄
HarmonyOS/OpenHarmony應(yīng)用開發(fā)-ArkTS的聲明式開發(fā)范式
HarmonyOS/OpenHarmony原生應(yīng)用-ArkTS萬能卡片組件Span
鴻蒙ArkTS聲明式組件:PatternLock
    
          
        
        
鴻蒙ArkTS聲明式組件:Span
                
 
    
    
    
    
    
           
            
            
                
            
評論