文本样式设置
针对包含文本元素的组件,设置文本样式。
从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
属性
名称 | 参数类型 | 描述 |
---|---|---|
fontColor | 设置字体颜色。 从API version 9开始,该接口支持在ArkTS卡片中使用。 | |
fontSize | 设置字体大小,Length为number类型时,使用fp单位。字体默认大小16。不支持设置百分比字符串。 从API version 9开始,该接口支持在ArkTS卡片中使用。 | |
fontStyle | 设置字体样式。 默认值:FontStyle.Normal 从API version 9开始,该接口支持在ArkTS卡片中使用。 | |
fontWeight | number | FontWeight | string | 设置文本的字体粗细,number类型取值[100, 900],取值间隔为100,默认为400,取值越大,字体越粗。string类型仅支持number类型取值的字符串形式,例如"400",以及"bold"、"bolder"、"lighter"、"regular"、"medium",分别对应FontWeight中相应的枚举值。 默认值:FontWeight.Normal 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
fontFamily | string | Resource | 设置字体列表。默认字体'HarmonyOS Sans',当前支持'HarmonyOS Sans'字体和注册自定义字体。 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
lineHeight | string | number | Resource | 设置文本的文本行高,设置值不大于0时,不限制文本行高,自适应字体大小,Length为number类型时单位为fp。 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
decoration | { type: TextDecorationType, color?: ResourceColor } | 设置文本装饰线样式及其颜色。 默认值:{ type: TextDecorationType.None, color:Color.Black } 从API version 9开始,该接口支持在ArkTS卡片中使用。 |
示例
- // xxx.ets
- @Entry
- @Component
- struct TextStyleExample {
- build() {
- Column({ space: 5 }) {
- Text('default text')
- Text('text font color red').fontColor(Color.Red)
- Text('text font default')
- Text('text font size 10').fontSize(10)
- Text('text font size 10fp').fontSize('10fp')
- Text('text font size 20').fontSize(20)
- Text('text font style Italic').fontStyle(FontStyle.Italic)
- Text('text fontWeight bold').fontWeight(700)
- Text('text fontWeight lighter').fontWeight(FontWeight.Lighter)
- Text('red 20 Italic bold text')
- .fontColor(Color.Red)
- .fontSize(20)
- .fontStyle(FontStyle.Italic)
- .fontWeight(FontWeight.Bold)
- Text('Orange 18 Normal text')
- .fontColor(Color.Orange)
- .fontSize(18)
- .fontStyle(FontStyle.Normal)
- }.width('100%')
- }
- }
更多建议: