HarmonyOS_Text组件

2023-12-20 11:06:07 浏览数 (2)

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

0 人点赞