![Hello HarmonyOS!:鸿蒙应用开发从入门到精通](https://wfqqreader-1252317822.image.myqcloud.com/cover/437/43738437/b_43738437.jpg)
2.3.2 Text和TextField
文本框通过Text组件来实现,用来显示文本字符信息,是HarmonyOS中最常用的一个组件。编辑框通过TextField组件来实现,它继承自Text类,与Text组件的属性和用法一样,只不过它允许改变其中的内容,所以这里把Text组件和 TextField 组件放到一起来讲解。Text 组件的属性较多,开发者可以通过设置这些属性来改变文本内容、字号、颜色、样式等。下面介绍Te x t组件的具体用法。
Text组件和 TextField组件除了有 Component的通用属性,还有一些自有属性,常用的自有属性见表2-6。
表2-6 Text组件与TextField组件的自有属性
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_123_1.jpg?sign=1738989708-DvFF7BEVlMaonbPQYqqtD8qyPg9Xp67j-0-5f8e359d063dc7e6c8db1c871fdeaec7)
续表
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_124_1.jpg?sign=1738989708-spGVjaZ7RE1QzTCKXIBNtAjfb7S6Ve2x-0-cb1ce1cfb99edbc24936315f59a4e6c6)
Te x t组件的自有属性非常多,表2-6只列出了一些常用的属性,下面创建一个Te x t组件。
1.指定具体尺寸的Text组件
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_124_2.jpg?sign=1738989708-U99gZuvFGTqkxTywaQzPdiZjipYdY4kt-0-48c79271c0b78a2723fad20b4124a831)
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_125_1.jpg?sign=1738989708-dTbFePnVaJ2us0CZAO8kmNPAfGpVI1jR-0-34bdd13199eb421709cf4a722c6dc154)
页面预览效果如图2-31所示。
这里为 Te x t 组件添加了背景颜色以方便观察,在其中写入了一行文本信息:“1.hello world!”,字号设置为12vp,并且设置了底部外边距bottom_margin为12vp。
2.指定文本位置
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_125_2.jpg?sign=1738989708-vFfGnaZZeZwsFozAayB98wpCp9tE6alE-0-806ceef5c524bc2246b6ee9c01bca223)
页面的预览效果如图2-32所示。
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_125_3.jpg?sign=1738989708-GCOJWnTi3pKlTzB0PKVXZ33mTd3TYt8n-0-7dde1aee7bcd7b4360a7cce7c86f5495)
图2-31 指定具体尺寸的Text组件
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_125_4.jpg?sign=1738989708-RBRxOjghZauAKppYG9jFuyZGqvuAfQ6b-0-25557698923c60ab0e2c3b8060d9868d)
图2-32 指定文本位置的Text组件
3.一段超长文本的显示
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_125_5.jpg?sign=1738989708-rKikMFui0uizjCFGPJFd7VKXSnTItW5v-0-42fd5af732d4d8b58bf1b6321bb7e173)
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_126_1.jpg?sign=1738989708-pyfdSSgtJ09an4yqxGxrC8TjnzQWZLCl-0-3e56593c04b562c0c1cc9a9d2bf4d9ee)
页面的预览效果如图2-33所示,由于文本太长,超过屏幕的部分无法显示。
4.超长文本的多行显示
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_126_2.jpg?sign=1738989708-VI40em8ihjsoRTnu3ar5eLOP4OHYbkM9-0-29ea08e9a88d56135c33eb4250455cb4)
页面的预览效果如图 2-34 所示,Text 组件通过设置 ohos:multiple_lines="true",可以将超出部分的文本另起一行显示。
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_126_3.jpg?sign=1738989708-213RKY7fSOelbpNOx9LvlAgrKX0xaSQG-0-a5092cd1445d5f1f6f88b4e70ea98537)
图2-33 超长文本的显示
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_126_4.jpg?sign=1738989708-ZpOlPkzcMIqvOR9NTdOCJyG4VdU0wJPf-0-627d9ed5ce8ae30c5a5be49e81f79d55)
图2-34 超长文本的多行显示
5.超长文本的单行省略显示
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_126_5.jpg?sign=1738989708-2rKPu2tP2gs7ptb3fS3mJQd00iqjQzMf-0-7c4b59a98edffd538f7403f797220efd)
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_127_1.jpg?sign=1738989708-cQ6v1Deq7IvWn0bpjfwsKuNf14fOgyF1-0-3023a0353997729970bbb209b8f6c49e)
页面的预览效果如图2-35所示。
6.改变字体样式
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_127_2.jpg?sign=1738989708-QjlXri9UV70i8ZQT7SMenI0imLinaTV4-0-31d03bd985e5c2ed2d6d2431b78022da)
页面的预览效果如图2-36所示。
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_127_3.jpg?sign=1738989708-yTlwO8IK52h0p8kUkOAAyDce8bAO9VLs-0-6c78b43b47dfa51ba97cca9c93235a7d)
图2-35 超长文本的单行省略显示
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_127_4.jpg?sign=1738989708-JAq7JIRaMfODeWJj6thAYiLVBqw49W16-0-1828760b9bfb7f2b17ac066fc88fe412)
图2-36 改变字体样式
Te x t组件的属性非常多,由于篇幅有限,只能列举这些常用的属性。在上面的案例中,涉及文本框大小、字号、文本位置和长文本处理。在实际应用中,为了避免出现文本长度超过Text组件宽度而导致信息被截断的情况,在对Text组件进行处理时都要考虑这些情况,可以多行显示,那么需要限制最大行数,也可以单行显示,则需要考虑在末尾处用省略号给出提示,以免文本显示不全。当然,具体的处理方式要根据业务特点来决定。
输入框的特点是,如果点击输入框,就会弹出输入法框,可以对其中的文本信息进行修改。
下面来介绍 TextField 组件。TextField 组件与 Text 组件的区别就在于TextField 组件中的文本信息是可编辑的。与 Text 组件相比,TextField 组件的自有属性如表2-7所示。
表2-7 TextField组件的自有属性
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_128_1.jpg?sign=1738989708-ciqD6O2S1V1lkyVz4aLa24VZ8n0HP3dE-0-ff170c6585944dac7dbd3555f7c567a6)
下面来看这个属性的效果。
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_128_2.jpg?sign=1738989708-xci9MrFw54E0NEBGtSxP6f2BbGgtUCdd-0-d368d7f2e256bc6c71eb70a8d7429b70)
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_129_1.jpg?sign=1738989708-lNjPNzHlSfj2XvwBHXrwTlRbUG2WSgH5-0-27d05ad713e06049718a5c66da0fe2fb)
图2-37 basement属性演示
上面两种输入框的页面预览效果如图 2-37 所示,可以看到basement其实是输入框下方的一条线,这条线可以标识输入框的尺寸范围,以带来良好的用户体验。