文本组件是我们最常用的组件之一,它是用来在UI界面上显示字符串。作为基本组件,有很多扩展,常见的有按钮组件Button、文本编辑组件TextFiled、计时器组件TickTimer,它们都是Text组件的扩展(也称为Text的子类)。
Text(文本组件)是Component类的子类之一,所以它能够使用Component类的所有公开的属性和方法(后面章节会详细介绍该类),Text类自身也提供了一些特殊的属性、方法、内部类和接口。
1、从源代码入手
阅读官方的Java API文档看结构不是很清晰,所以我们在DevEco中查看源代码。
/** * 继承Component类 */public class Text extends Component {}
这里我们说一下如何查看类的继承关系,由于DevEco是基于开源的社区版,它是没有Diagrams功能的,我们可以使用第二种方法Navigate --> Type Hierarchy(或者F4)来查看关系图。
我们可以点击DevEco界面左侧选项卡Structure查看类中详细结构,我们可以看到Text自身提供了很多属性和方法,同时也继承父类的很多属性和方法。
/** * 默认构造函数 * 用于使用默认属性和样式创建文本实例 * @param context */public Text(Context context) {}/** * 提供了用于在XML解析后使用指定的属性集合和默认样式创建文本实例的构造函数 * @param context * @param attrSet */public Text(Context context, AttrSet attrSet) {}/** * 提供了用于在XML解析后使用指定的属性集和指定的样式创建文本实例的构造函数 * @param context * @param attrSet * @param styleName */public Text(Context context, AttrSet attrSet, String styleName) {}
我们在代码中要给布局添加组件时,需要先创建组件对象。使用默认的构造函数创建Text对象,后面两种构造函数我们这里不做过多说明,这两种是用于自定义组件时使用的,后面自定义组件小节中会详细介绍,期待吧。
//创建Text对象Text text = new Text(this);
我们可以在Structure中看到Text类有很多属性,比如设置文本内容的text属性、设置文本内容颜色的textColor属性、设置文本内容字体大小的textSize属性,及设置文本内容字体的font属性等。也有继承自父类的属性,比如设置文本宽度的width属性、设置文本高度的height属性等。
//1. 创建Text对象Text text = new Text(this);//2. 设置文本内容宽高text.setWidth(ComponentContainer.LayoutConfig.MATCH_PARENT);text.setHeight(ComponentContainer.LayoutConfig.MATCH_PARENT);//3. 设置显示内容text.setText("我是在代码创建的Text。");//4. 设置文字大小text.setTextSize(50, Text.TextSizeType.FP);//5. 设置文字颜色text.setTextColor(Color.BLUE);//6. 添加组件到布局中layout.addComponent(text);
我们可以启动一下我们的模拟器,查看是不是在界面中显示了我们设置的文本内容。
当然组件不仅仅是做显示使用的,我们还可以在组件上添加监听事件,来实现交互效果,比如我们点击界面中的文字内容,让它显示成其他的内容。
我们现在使用的是代码中构建UI界面,当然官方也给我们提供了在XML中声明布局,添加组件,在代码中设置界面入口只需要指定它在内存中的地址。如果我们要对组件进行监听,需要指定其在内存中的地址,然后创建对象完成监听操作。
在resources --> base目录下创建layout目录(目录下的文件就是布局资源),然后在该目录下创建布局资源文件(后缀为.xml),然后在XML中声明布局和组件。
<?xml version="1.0" encoding="utf-8"?>
//在AbilitySlice的onStart方法中设置界面入口,这里指定页面在内存中的地址super.setUIContent(ResourceTable.Layout_ability_text_xml);
2、常用属性和方法
到这里我们已经对Text有了大致的了解,对两种编写布局的方式也有了大致的了解。Text有很多属性和方法,我们在这里给大家列出常用的几个属性和方法。
Text常用属性
Java XML 描述
autoFontSize ohos:auto_font_size 设置是否自动调整字体大小以填充组件。
font ohos:text_font 设置文本字体
maxTextLines ohos:max_text_lines 设置文本视图中允许的最大行数
multipleLine ohos:multiple_line 设置文本是否在文本视图中多行显示
scrollable ohos:scrollable 设置文本是否可滚动
text ohos:text 设置文本内容
textAlignment ohos:text_alignment 设置文本视图中文本的对齐方式
textColor ohos:text_color 设置文本视图中文本的颜色
textSize ohos:text_size 设置文本视图中文本字体大小
truncationMode ohos:truncation_mode 当文本内容超过组件的宽度时,设置截断模式
Text常用方法
方法名称 描述
append(String str) 将字符串追加到文本视图中的现有文本
//2. 自动调整字体大小Text text_auto_font_size = (Text) findComponentById(ResourceTable.Id_text_auto_font_size);text_auto_font_size.setClickedListener(l -> { text_auto_font_size.append("T");});