前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >HarmonyOS_Text组件

HarmonyOS_Text组件

作者头像
酒楼
发布2023-12-20 11:06:07
1310
发布2023-12-20 11:06:07
举报
文章被收录于专栏:酒楼酒楼

HarmonyOS_Text组件

Text

Text是用来显示字符串的组件,在界面上显示为一块文本区域。Text座位一个基本组件,有很多扩展,常见的有按钮组件Button,文本编辑组件

TextField。

支持的XML属性

Text的共有XML属性继承自:Component

Text的自由XML属性见下表:

表一,Text的自有XML属性

属性名称

中文描述

取值说明

使用案例

text

显示文本

string类型。可以直接设置文本字串,也可以引用string资源(推荐使用)。

ohos:text=”熄屏时间”ohos:text =”$string.test_str”

hint

提示文本

string类型。可以直接设置文本字串,也可以应用string资源(推荐使用)。

ohos:hint=”联系人”ohos:hint=”$string:test_str”

text_font

字体

可设置值包括:sans-serif,sans-serif-medium,HwChinese-medium,sans-serif-condensed,sans-serif-condensed-medium,monospace

ohos:text_font=”HwChinese-medium”

trunaction_mode

长文本截断方式

1.none:表示文本超长时无截断。2.ellipsis_at_start:表示文本超长时在文本框起始处使用省略号截断3.ellipsis_at_middle:表示文本超长时在文本框结尾处使用省略号截断4.ellipsis_at_end:表示文本超长时在文本框结尾处使用省略号截断。5.auto_scrolling:表示文本超长时滚动显示全部文本。

1.ohos:truncation_mode=”none”2.ohos:truncation_mode=”ellipsis_at_start”3.ohos:truncation_mode=”ellipsis_at_middle”4.ohos:truncation_mode=”ellipsis_at_end”5.ohos:truncation_mode=”auto_scrolling”

text_size

文本大小

float类型。可以是浮点数值,其默认单位为px;也可以是带px/vp/fp单位的浮点数值;也可以引用float资源。

ohos:element_padding=”20”ohos:element_padding=”8vp”ohos:element_padding=”$float:size_value”

bubble_width

文本气泡宽度

float类型。可以是浮点数值,其默认单位为px;也可以是带px/vp/fp单位的浮点数值;也可以引用float资源。

ohos:bubble_width=”20”ohos:bubble_width=”10vp”ohos:bubble_width=”$float:size_value”

bubble_height

文本气泡高度

float类型。可以是浮点数值,其默认单位为px;也可以是带px/vp/fp单位的浮点数值;也可以引用float资源。

ohos:bubble_height=”20”ohos:bubble_height=”10vp”ohos:bubble_height=”$float:size_value”

bubble_left_width

文本气泡左宽度

float类型。可以是浮点数值,其默认单位为px;也可以是带px/vp/fp的单位的浮点数值;也可以引用float资源。

ohos:bubble_left_width=”20”ohos:bubble_left_width=”10vp”ohos:bubble_left_width=”$float:size_value”

bubble_left_height

文本气泡左高度

float类型。可以是浮点数值,其默认单位是px;也可以是带px/vp/fp的的单位的浮点数值;也可以引用float资源。

ohos:bubble_left_height=”20”ohos:bubble_right_width=”10vp”ohos:bubble_right_width=”$float:size_value”

bubble_right_height

文本气泡右高度

float类型。额可以是浮点数值,其默认单位是px;也可以是带px/vp/fp的单位的浮点数值;也可以引用color资源。

ohos:bubble_right_height=”20”ohos:bubble_right_height=”10vp”ohos:bubble_right_height=”$float:size_value”

text_color

文本颜色

color类型。可以直接设置色值,也可以引用color资源。

ohos:text_color=”#A8FFFFFF”ohos:text_color=”$color:black”

hint_color

提示文本颜色

color类型。可以直接设置色值,也可以引用color资源。

ohos:hint_color=”#A8FFFFFF”ohos:hint_color=”$color:black”

selection_color

选中文本颜色

color类型。可以直接设置色值,也可以引用color资源。

ohos:selection_color=”#A8FFFFFF”ohos:selection_color=”$color:black”

text_alignment

文本对齐方式

left:表示文本靠左对齐。top:表示文本靠顶部对齐。right:表示文本靠右部对齐。bottom:表示文本靠底部对齐。horizontal_center:表示文本水平居中对齐vertical_center:表示文本垂直居中对齐center:表示文本居中对齐。start:表示文本靠起始段对齐。end:表示文本靠结尾段对齐。

可以设置取值项如表中所列,也可以使用“|”进行多项组合。ohos:text_alignment=”top”ohos:text_alignment=”topleft”

max_text_lines

文本最大行数

integer类型。可以直接设置整型数值,也可以引用integer资源。

ohos:max_text_lines=”2”ohos:max_text_lines=”$integer:two”

text_input_type

文本输入类型

pattern_null:表示未指定文本输入类型,默认文本输入类型为内容模式。pattern_text:表示文本输入类型为普通文本模式。pattern_number:表示文本输入类型为数字。pattern_password:表示文本输入类型为密码。

ohos:text_input_type=”pattern_null”ohos:text_input_type=”pattern_text”ohos:text_input_type=”pattern_number”ohos:text_input_type=”pattern_password”

input_enter_key_type

输入键类型

enter_key_type_unspecified:表示未指定输入键类型,采用默认类型。enter_key_type_search:表示采用执行“搜索”动作的输入键类型。enter_key_type_go:表示采用执行”go”动作的输入键类型。enter_key_type_send:表示采用执行”发送“动作的输入键类型。

ohos:input_enter_key_type=”enter_key_type_unspecified”ohos:input_enter_key_type=”enter_key_type_searchohos:input_enter_key_type=”enter_key_type_go”ohos:input_enter_key_type=”enter_key_type_send”

auto_scrolling_duration

自动滚动时长

integer类型:可以直接设置整型数值,也可以引用integer资源。表示时间的值不可小于0,单位为ms。

ohos:auto_scrolling_duration=”1000”ohos:auto_scrolling_duration=”$integer:during”

multiple_lines

多行模式设置

boolean类型。可以直接设置true/false,也可以引用boolean资源

ohos:multiple_lines=”true”ohos:multiple_lines=”$boolean:true”

auto_font_size

是否支持文本自动调整文本字体大小

boolean类型。可以直接设置true/false,也可以引用boolean资源。

ohos:auto_font_size=”true”ohos:auto_font_size=”$boolean:true”

scrollable

文本是否可滚动

boolean类型。可以直接设置true/false,也可以引用boolean资源。

ohos:scrollable=”true”ohos:scrollable=”$boolean:true”

text_cursor_visible

文本光标是否可见。只有在可编辑的组件上可配置,否则该值始终为false。

boolean类型。可以直接设置true/false,也可以引用boolean资源。

ohos:text_cursor_visible=”true”ohos:text_cursor_visible=”$boolean:true”

italic

文本是否斜体字体

boolean类型。可以直接设置true/false,也可以引用boolean资源。

ohos:italic=”true”ohos:italic=”$boolean:true”

padding_for_text

设置文本顶部与底部是否默认留白。默认值为true,true表示保留默认留白,false表示顶部与底部不留白

boolean类型。可以直接设置true/false,也可以引用boolean资源。

ohos:padding_for_text=”true”ohos:padding_for_text=”$boolean:true”

additional_line_spacing

需增加的行间距

float类型。可以直接设置浮点数值,也可以引用float资源。

ohos:additional_line_spacing=”2”ohos:additional_line_spacing=”$float:line_spacing_add”

line_height_num

行间距倍数

float类型。可以直接设置浮点数值,也可以引用float资源。

ohos:line_height_num=”1.5”ohos:line_height_num=”$float:line_spacing_multi”

element_left

文本左侧图标

Element类型。可直接配置色值,也可以引用color资源或引用media/graphic下的图片资源。element_left属性冲突说明:1.element_left与element_start,element_end属性有冲突,不建议一起使用。在”水平布局方向为从左到右“时,element_left会与element_start属性冲突;在”水平布局方向为从右到左时,element_left会与element_end属性冲突。2.同时配置时,element_start,element_end优先级高于element_left属性。

ohos:element_left=”#FFFFFFFF”ohos:element_left=”$color:black”ohos:element_left=”$media:media_src”ohos:element_left=”$graphic:graphic_src”

element_top

文本上方图标

Element类型。可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。

ohos:element_top=”#FFFFFFFF”ohos:element_top=”$color:black”ohos:element_top=”$media:media_src”ohos:element_top=”$graphic:graphic_src”

element_right

文本右侧图标

Element类型。可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。element_right属性冲突说明:1.element_right与element_start,element_end属性有冲突,不建议一起使用。在“水平布局方向为从左到右”时,element_right会与element_end属性冲突;在“水平布局方向为从右到左”时,element_right会与element_start属性冲突。2.同时配置时,element_start,element_end优先级高于element_right属性。

ohos:element_right=”#FFFFFFFF”ohos:element_right=”$color:black”ohos:element_right=”$media:media_src”ohos:element_right=”$graphic:graphic_src”

element_bottom

文本下方图标

Element类型。可直接配置色值,也可引用color资源或引用media/graphic下的图片资源

ohos:element_bottom=”#FFFFFFFF”ohos:element_bottom=”$color:black”ohos:element_bottom=”$media:media_src”ohos:element_bottom=”$graphic:graphic_src”

element_start

文本开始方向图标

Element类型。可直接配置色值,也可引用color资源或引用media、graphic下的图片资源。element_start属性冲突说明1.element_start与element_left,element_right属性有冲突,不建议一起使用。在“水平布局方向为从左到右”时,element_start会与element_left属性冲突;在“水平布局方向为从右到左”时,element_start会与element_right属性冲突。2.同时配置时,element_start优先级高于element_left,element_right属性。

ohos:element_start=”#FFFFFFFF”ohos:element_start=”$color:black”ohos:element_start=”$media:media_src”ohos:element_start=”$graphic:graphic_src”

element_end

文本结束方向图标

Element类型。可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。element_end属性冲突说明1.element_end与element_left,element_right属性有冲突,不建议一起使用。在“水平布局方向为从左到右”时,element_end会与element_left属性冲突。2.同时配置时,element_end优先级高于element_left,element_right属性

ohos:element_end=”#FFFFFFFF”ohos:element_end=”$color:block”ohos:element_end=”$media:media_src”ohos:element_end=”$graphic:graphic_src”

element_cursor_bubble

文本的光标气泡图形只有在可编辑的组件上可配置

Element类型。可直接配置色值,也可引用color资源或引用media/graphic下的图片资源

ohos:element_cursor_bubble=”#FFFFFFFF”ohos:element_cursor_bubble=”$color:black”ohos:element_cursor_bubble=”$media:media_src”ohos:element_cursor_bubble=”$graphic:graphic_src”

element_selection_left_bubble

选中文本的左侧气泡图形

Element类型。可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。

ohos:element_selection_left_bubble=”#FFFFFFFF”ohos:element_selection_left_bubble=”$color:black”ohos:element_selection_left_bubble=”$media:media_src”ohos:element_selection_left_bubble=”$graphic:graphic_src”

element_selection_right_bubble

选中文本的右侧气泡图形

Element类型。可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。

ohos:element_selection_right_bubble=”$FFFFFFFF”ohos:element_selection_right_bubble=”$color:black”ohos:element_selection_right_bubble=”$media:media_src”ohos:element_selection_right_bubble=”$graphic:graphic_src”

官方文档:https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-component-text-0000001050729534?spm=a2c6h.12873639.article-detail.7.40317ec3RXS4JE

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2023-12-14,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • HarmonyOS_Text组件
    • Text
      • 支持的XML属性
        • 表一,Text的自有XML属性
    领券
    问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档