【鸿蒙】HarMonyOS之Text组件的常用属性

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

属性名称	中文描述	取值	取值说明	使用案例
text	显示文本	string类型	可以直接设置文本字串，也可以引用string资源。	ohos:text="熄屏时间" ohos:text="$string:test_str"
hint	提示文本	string类型	可以直接设置文本字串，也可以引用string资源。	ohos:hint="联系人" ohos:hint="$string:test_str"
text_font	字体	sans-serif	可以设置的字体如表中所列。	ohos:text_font="HwChinese-medium"
		sans-serif-medium
		HwChinese-medium
		sans-serif-condensed
		sans-serif-condensed-medium
		monospace
truncation_mode	长文本截断方式	none	表示文本超长时无截断。	ohos:truncation_mode="none"
		ellipsis_at_start	表示文本超长时在文本框起始处使用省略号截断。	ohos:truncation_mode="ellipsis_at_start"
		ellipsis_at_middle	表示文本超长时在文本框中间位置使用省略号截断。	ohos:truncation_mode="ellipsis_at_middle"
		ellipsis_at_end	表示文本超长时在文本框结尾处使用省略号截断。	ohos:truncation_mode="ellipsis_at_end"
		auto_scrolling	表示文本超长时滚动显示全部文本。	ohos:truncation_mode="auto_scrolling"
text_size	文本大小	float类型	表示字体大小的float类型。 可以是浮点数值，其默认单位为px；也可以是带px/vp/fp单位的浮点数值；也可以引用float资源。	ohos:text_size="30" ohos:text_size="16fp" ohos:text_size="$float:size_value"
element_padding	文本与图片的边距	float类型	表示间距尺寸的float类型。 可以是浮点数值，其默认单位为px；也可以是带px/vp/fp单位的浮点数值；也可以引用float资源。	ohos:element_padding="20" ohos:element_padding="8vp" ohos:element_padding="$float:size_value"
bubble_width	文本气泡宽度	float类型	表示尺寸的float类型。 可以是浮点数值，其默认单位为px；也可以是带px/vp/fp单位的浮点数值；也可以引用float资源。	ohos:bubble_width="20" ohos:bubble_width="10vp" ohos:bubble_width="$float:size_value"
bubble_height	文本气泡高度	float类型	表示尺寸的float类型。 可以是浮点数值，其默认单位为px；也可以是带px/vp/fp单位的浮点数值；也可以引用float资源。	ohos:bubble_height="20" ohos:bubble_height="10vp" ohos:bubble_height="$float:size_value"
bubble_left_width	文本气泡左宽度	float类型	表示尺寸的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类型	表示尺寸的float类型。 可以是浮点数值，其默认单位为px；也可以是带px/vp/fp单位的浮点数值；也可以引用float资源。	ohos:bubble_left_height="20" ohos:bubble_left_height="10vp" ohos:bubble_left_height="$float:size_value"
bubble_right_width	文本气泡右宽度	float类型	表示尺寸的float类型。 可以是浮点数值，其默认单位为px；也可以是带px/vp/fp单位的浮点数值；也可以引用float资源。	ohos:bubble_right_width="20" ohos:bubble_right_width="10vp" ohos:bubble_right_width="$float:size_value"
bubble_right_height	文本气泡右高度	float类型	表示尺寸的float类型。 可以是浮点数值，其默认单位为px；也可以是带px/vp/fp单位的浮点数值；也可以引用float资源。	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	表示文本靠左对齐。	可以设置取值项如表中所列，也可以使用“|”进行多项组合。 ohos:text_alignment="top" ohos:text_alignment="top|left"
		top	表示文本靠顶部对齐。
		right	表示文本靠右对齐。
		bottom	表示文本靠底部对齐。
		horizontal_center	表示文本水平居中对齐。
		vertical_center	表示文本垂直居中对齐。
		center	表示文本居中对齐。
		start	表示文本靠起始端对齐。
		end	表示文本靠结尾端对齐。
max_text_lines	文本最大行数	integer类型	可以直接设置整型数值，也可以引用integer资源。	ohos:max_text_lines="2" ohos:max_text_lines="$integer:two"
text_input_type	文本输入类型	pattern_null	表示未指定文本输入类型，默认文本输入类型为内容模式。	ohos:text_input_type="pattern_null"
		pattern_text	表示文本输入类型为普通文本模式。	ohos:text_input_type="pattern_text"
		pattern_number	表示文本输入类型为数字。	ohos:text_input_type="pattern_number"
		pattern_password	表示文本输入类型为密码。	ohos:text_input_type="pattern_password"
input_enter_key_type	输入键类型	enter_key_type_unspecified	表示为指定输入键类型，采用默认类型。	ohos:input_enter_key_type="enter_key_type_unspecified"
		enter_key_type_search	表示采用执行“搜索”动作的输入键类型。	ohos:input_enter_key_type="enter_key_type_search"
		enter_key_type_go	表示采用执行“go”动作的输入键类型。	ohos:input_enter_key_type="enter_key_type_go"
		enter_key_type_send	表示采用执行“发送”动作的输入键类型。	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与element_start、element_end属性有冲突，不建议一起使用。在“水平布局方向为从左到右”时，element_left会与element_start属性冲突；在“水平布局方向为从右到左”时，element_left会与element_end属性冲突。 同时配置时，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与element_start、element_end属性有冲突，不建议一起使用。在“水平布局方向为从左到右”时，element_right会与element_end属性冲突；在“水平布局方向为从右到左”时，element_right会与element_start属性冲突。 同时配置时，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与element_left、element_right属性有冲突，不建议一起使用。在“水平布局方向为从左到右”时，element_start会与element_left属性冲突；在“水平布局方向为从右到左”时，element_start会与element_right属性冲突。 同时配置时，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与element_left、element_right属性有冲突，不建议一起使用。在“水平布局方向为从左到右”时，element_end会与element_right属性冲突；在“水平布局方向为从右到左”时，element_end会与element_left属性冲突。 同时配置时，element_end优先级高于element_left、element_right属性。	ohos:element_end="#FFFFFFFF" ohos:element_end="$color:black" 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"

可练习一下【鸿蒙】HarMonyOS的UI组件学习一

下一篇 【鸿蒙】HarMonyOS之Button组件的常用属性