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下的图片资源。 说明
| 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下的图片资源。 说明
| 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下的图片资源。 说明
| 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下的图片资源。 说明
| 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" |