HarmonyOS/OpenHarmony原生应用-ArkTS万能卡片组件Span

作为Text组件的子组件,用于显示行内文本的组件。无子组件

一、接口

Span(value: string | Resource)

从API version 9开始,该接口支持在ArkTS卡片中使用。

参数:

|-------|--------------------|----|-------|
| 参数名 | 参数类型 | 必填 | 参数描述 |
| value | string | Resource | 是 | 文本内容。 |

二、属性

通用属性方法仅支持通用文本样式。

|---------------|-----------------------------------------------------|-----------------------------------------------------------------------------------------------------------|
| 名称 | 参数类型 | 描述 |
| decoration | { type: TextDecorationType, color?: ResourceColor } | 设置文本装饰线样式及其颜色。 默认值:{ type: TextDecorationType.None color:Color.Black } 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| letterSpacing | number | string | 设置文本字符间距。取值小于0,字符聚集重叠,取值大于0且随着数值变大,字符间距越来越大,稀疏分布。 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| textCase | TextCase | 设置文本大小写。 默认值:TextCase.Normal 从API version 9开始,该接口支持在ArkTS卡片中使用。 |

三、事件

通用事件仅支持点击事件。

说明

由于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)

}

// 文本大小写展示设置

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 })

}

}

五、场景

适合做文本特效的各种卡片。

本文根据HarmonyOS官方文档整理

相关推荐
爱写Bug的浮游13 小时前
初识仓颉:5 分钟看懂核心语法
harmonyos·编程语言
羽落•无痕(苏晗默)16 小时前
华为数通IA——14、网络服务与应用:TCP/UDP 传输层协议与 FTP、Telnet、SSH 实践
网络·网络协议·tcp/ip·网络安全·华为·udp·信息与通信
程序猿追1 天前
鸿蒙 PC 的 Ionic 工单有两个错误,按下生成后光标该去哪儿
华为·harmonyos
KevinChaos1 天前
随手备忘录手记 04|HarmonyOS 7.0新特性实验:物品图鉴的加载逻辑
华为·harmonyos
Sirius_Ji2 天前
从硬解基座到字幕与滤镜链:ffmpeg-for-HarmonyOS v0.3.2
harmonyos
用户86194177207412 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
微信·harmonyos
码间留白2 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
GitCode官方2 天前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追2 天前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追2 天前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos