| 属性名称 | 中文描述 | 取值 | 取值说明 | 使用案例 |
| — | — | — | — | — |
| text_size | 文本大小 | float类型 | 表示字体大小的float类型。可以是浮点数值,其默认单位为px;也可以是带px/vp/fp单位的浮点数值;也可以引用float资源。 | ohos:text_size=“30"ohos:text_size=“16fp"ohos:text_size=”$float:size_value” |
代码演示:
<Text
ohos:id="$+id:text"
ohos:height=“match_content”
ohos:width=“match_content”
ohos:text=“150px”
ohos:text_size=“150px”/>
显示效果:
| 属性名称 | 中文描述 | 取值 | 取值说明 | 使用案例 |
| — | — | — | — | — |
| text_color | 文本颜色 | color类型 | 可以直接设置色值,也可以引用color资源。 | ohos:text_color="#A8FFFFFF"ohos:text_color="$color:black" |
代码演示:
<Text
ohos:id="$+id:text"
ohos:height=“match_content”
ohos:width=“match_content”
ohos:text=“blue”
ohos:text_size=“100px”
ohos:text_color=“blue”
/>
演示效果:
使用HEX效果:
| 属性名称 | 中文描述 | 取值 | 取值说明 | 使用案例 |
| — | — | — | — | — |
| text_font | 字体 | sans-serif | 可以设置的字体如表中所列。 | ohos:text_font=“HwChinese-medium” |
| | | sans-serif-medium | | |
| | | HwChinese-medium | | |
| | | sans-serif-condensed | | |
| | | sans-serif-condensed-medium | | |
| | | monospace | | |
代码演示:
<Text
ohos:id="$+id:text"
ohos:height=“match_content”
ohos:width=“match_content”
ohos:text=“李子捌”
ohos:text_size=“100px”
ohos:text_color="#000000"
ohos:text_font=“HwChinese-medium”
/>
演示效果:
| 属性名称 | 中文描述 | 取值 | 取值说明 | 使用案例 |
| — | — | — | — | — |
| italic | 文本是否斜体字体 | boolean类型 | 可以直接设置true/false,也可以引用boolean资源。 | ohos:italic=“true"ohos:italic=”$boolean:true" |
代码演示:
<Text
ohos:id="$+id:text"
ohos:height=“match_content”
ohos:width=“match_content”
ohos:text=“李子捌”
ohos:text_size=“100px”
ohos:text_color="#000000"
ohos:text_font=“sans-serif”
ohos:italic=“true”
/>
演示效果:
| 属性名称 | 中文描述 | 取值 | 取值说明 | 使用案例 |
| — | — | — | — | — |
| text_weight | 字重 | integer类型 | 表示字体大小的integer类型。也可以引用integer资源。 | ohos:text_weight=“100"ohos:text_weight=”$integer:100" |
代码演示:
<Text
ohos:id="$+id:text"
ohos:height=“match_content”
ohos:width=“match_content”
ohos:text=“Liziba”
ohos:text_size=“100px”
ohos:text_color="#0000FF"
ohos:text_font=“serif”
ohos:italic=“true”
ohos:text_weight=“100”
/>
演示效果:
text_weight = 100
text_weight = 600
常用的背景如常见的文本背景、按钮背景,可以采用XML格式放置在graphic目录下。
在Project窗口,打开“entry > src > main > resources > base”,右键点击“graphic”文件夹,选择“New > File”,命名为“background_text.xml”,在background_text.xml中定义文本的背景。
代码演示:
<?xml version="1.0" encoding="UTF-8" ?><shape xmlns:ohos=“http://schemas.huawei.com/res/ohos”
ohos:shape=“rectangle”>
演示效果:
| 属性名称 | 中文描述 | 取值 | 取值说明 | 使用案例 |
| — | — | — | — | — |
| text_alignment | 文本对齐方式 | left | 表示文本靠左对齐。 | 可以设置取值项如表中所列,也可以使用“ |
| | | top | 表示文本靠顶部对齐。 | |
| | | right | 表示文本靠右对齐。 | |
| | | bottom | 表示文本靠底部对齐。 | |
| | | horizontal_center | 表示文本水平居中对齐。 | |
| | | vertical_center | 表示文本垂直居中对齐。 | |
| | | center | 表示文本居中对齐。 | |
| | | start | 表示文本靠起始端对齐。 | |
| | | end | 表示文本靠结尾端对齐。 | |
代码演示:
<Text
ohos:id="$+id:text"
ohos:width=“300vp”
ohos:height=“100vp”
ohos:text=“Liziba”
ohos:text_size=“100px”
ohos:text_color="#0000FF"
ohos:text_font=“serif”
ohos:italic=“true”
ohos:text_weight=“100”
ohos:left_margin=“15vp”
ohos:bottom_margin=“15vp”
ohos:right_padding=“15vp”
ohos:left_padding=“15vp”
ohos:text_alignment=“bottom|horizontal_center”
ohos:background_element="$graphic:background_text"
/>
演示效果:
| 属性名称 | 中文描述 | 取值 | 取值说明 | 使用案例 |
| — | — | — | — | — |
| multiple_lines | 多行模式设置 | boolean类型 | 可以直接设置true/false,也可以引用boolean资源。 | ohos:multiple_lines=“true"ohos:multiple_lines=”$boolean:true" |
代码演示:
<Text
ohos:id="$+id:text"
ohos:width=“300px”
ohos:height=“match_content”
ohos:text=“LizibaLiziba”
ohos:text_size=“100px”
ohos:text_color="#0000FF"
ohos:text_font=“serif”
ohos:italic=“true”
ohos:text_weight=“100”
ohos:max_text_lines=“2”
ohos:multiple_lines=“true”
ohos:background_element="$graphic:background_text"
/>
演示效果:
| 属性名称 | 中文描述 | 取值 | 取值说明 | 使用案例 |
| — | — | — | — | — |
| max_text_lines | 文本最大行数 | integer类型 | 可以直接设置整型数值,也可以引用integer资源。 | ohos:max_text_lines=“2"ohos:max_text_lines=”$integer:two" |
代码演示:
<Text
ohos:id="$+id:text"
ohos:width=“300px”
ohos:height=“match_content”
ohos:text=“LizibaLizibaLiziba”
ohos:text_size=“100px”
ohos:text_color="#0000FF"
ohos:text_font=“serif”
ohos:italic=“true”
ohos:text_weight=“100”
ohos:multiple_lines=“true”
ohos:max_text_lines=“2”
ohos:background_element="$graphic:background_text"
/>
演示效果:
| 属性名称 | 中文描述 | 取值 | 取值说明 | 使用案例 |
| — | — | — | — | — |
| auto_font_size | 是否支持文本自动调整文本字体大小 | boolean类型 | 可以直接设置true/false,也可以引用boolean资源。 | ohos:auto_font_size=“true"ohos:auto_font_size=”$boolean:true" |
代码演示:
方法一:
<Text
ohos:id="$+id:text"
ohos:width=“300px”
ohos:height=“match_content”
ohos:text=“LizibaLizibaLiziba”
ohos:text_size=“100px”
ohos:text_color="#0000FF"
ohos:text_font=“serif”
ohos:italic=“true”
ohos:text_weight=“100”
ohos:max_text_lines=“1”
ohos:auto_font_size=“true”
ohos:background_element="$graphic:background_text"
/>
演示效果:
方法二:
<Text
ohos:id="$+id:text"
ohos:width=“300px”
ohos:height=“match_content”
ohos:text=“L”
ohos:text_size=“100px”
ohos:text_color="#0000FF"
ohos:text_font=“serif”
ohos:italic=“true”
ohos:text_weight=“100”
ohos:max_text_lines=“1”
ohos:auto_font_size=“true”
ohos:background_element="$graphic:background_text"
/>