【HarmonyOS 专题】03 简单了解 Text 文本属性

    小菜在之前尝试通过 XML 构建一个最基础的【登录】页面，其中使用了 Image / Button / Text / TextField 等几个最常用的小控件；小菜逐一进行学习尝试；

Text

    Text 文本件在大部分语言编程中都是最常见且使用频率最高的控件；HarmonyOS 中的 Text 继承自 Component；小菜理解为 Android 中的 TextView 与 View 的关系；因此 Component 中的属性，在 Text 中基本都可以使用；

    小菜主要尝试一些相较于 Component 而言 Text 文本所特有的属性；

案例尝试

1. text & hint

    text 和 hint 很容易理解，分别为文本内容和默认提示文本内容；

 

ohos:hint="阿策小和尚 hint"

2. text_color & hint_color

    text_color 和 hint_color 分别对应文本字体颜色和默认提示文本字体颜色；

3. text_size & text_font

    text_size 对应文本字号，同样适用默认提示文本；text_font 对应文本字体，例如 sans-serif / sans-serif-medium / HwChinese-medium 等；

4. italic & text_alignment

    italic 为文字是否为斜体；text_alignment 为文本对齐方式，添加一个背景图更容易看到效果，对齐属性也很容易理解；

5. element_left & element_top & element_right & element_bottom & element_start & element_end & element_padding

    element_left 等为文本中添加图标的为止，即 左侧 / 右侧 / 顶部 / 底部 / 开始为止 / 结束为止；element_padding 为文本图标与文本之间的变局；

    Tips: 注意 element_right 与 element_start / element_end 属性有冲突，不建议一起使用；在 水平布局方向为从左到右 时，element_right 会与 element_end 属性冲突；在 水平布局方向为从右到左 时，element_right 会与 element_start 属性冲突；同时配置时，element_start / element_end 优先级高于 element_right / element_left 属性；

6. truncation_mode & scrollable & auto_scrolling_duration & auto_scrolling_count

    truncation_mode 为文本的截取方式，当文本内容超过设置宽度范围时，HarmonyOS 提供了多种截断方式；none 为无截断，ellipsis_at_start/middle/end 为在文本框起始/中间/结束处使用省略号截断，auto_scrolling 为滚动显示；

    scrollable 为文本是否可滚动；auto_scrolling_duration 对应自动滚动时长；auto_scrolling_count 对应滚动次数，默认为无限次；小菜在测试过程中，单纯的 XML 文件调整并不会实现跑马灯效果，需要在 Java 端使用 startAutoScrolling() 启动跑马灯效果；

    


Text text1 =(Text) findComponentById(ResourceTable.Id_test_tv1);
text1.startAutoScrolling();

7. max_text_lines & multiple_lines

    max_text_lines 为文本设置的最大行数；multiple_lines 为多行模式，只有为 true 时才允许换行；

8. additional_line_spacing & line_height_num

    additional_line_spacing 对应文本行间距，取值为 float 类型，为具体的值；而 line_height_num 对应行间距倍数，包括设置的 additional_line_spacing 文本行间距；

9. auto_font_size & padding_for_text

    auto_font_size 为是否支持文本自动调整文本字体大小；padding_for_text 对应设置文本顶部与底部是否默认留白，默认为 true，但小菜尝试过程中效果并不明显；

    在使用 auto_font_size 过程中需要在 Java 端设置字号变化规则，及最大最小字号等；

    
Text text2 =(Text) findComponentById(ResourceTable.Id_test_tv2);
text2.setAutoFontSizeRule(20, 50, 1);
text2.setClickedListener(new Component.ClickedListener() {
    @Override
    public void onClick(Component component) {
        text2.setText(text2.getText() + " HarmonyOS");
    }
});

    Text 中还有很多是在可编辑状态下的属性，小菜暂时仅研究静态属性，与 Android / Flutter 有很多相似的用法，使用难度较简单；对于 HarmonyOS 是刚起步状态，如有错误，请多多指导！

来源： 阿策小和尚