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="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="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="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="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="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="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="graphic:graphic_src" | | element_selection_left_bubble | 选中文本的左侧气泡图形 | Element类型 | 可直接配置色值，也可引用color资源或引用media/graphic下的图片资源。 | ohos:element_selection_left_bubble="#FFFFFFFF"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="graphic:graphic_src"
