![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=1739275333-qMaPQGAnDgw10mp1Re4jahZFSfpcFQs4-0-02f13aaa09cb5ef37c89f0f9a23fcf1f)
续表
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_124_1.jpg?sign=1739275333-XMXDQplYvDey5smjfek8g81KLpUI3k2R-0-186709a0b6bf28f64f9d504fb867524f)
Te x t组件的自有属性非常多,表2-6只列出了一些常用的属性,下面创建一个Te x t组件。
1.指定具体尺寸的Text组件
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_124_2.jpg?sign=1739275333-4i8MfhKGbwbFXy0kSkQtgbVFzIV90Yai-0-0cc835ba1374c863622e3f15792f1765)
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_125_1.jpg?sign=1739275333-MZQ3Tzq6oaOcghM9Z4zCAY50RlCh5Y7D-0-e40d522abe714622abd687a3da842a23)
页面预览效果如图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=1739275333-t48se7xd8d1H3VRMlQJ9HbpK44XQGjeU-0-4237de6d11e18bb0ea4629702f0a4dcc)
页面的预览效果如图2-32所示。
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_125_3.jpg?sign=1739275333-87x5qzBqEkJ97IGbwXzmrhoXrqPXzj3V-0-b91456d729bfdf8b1fcb0c9056068389)
图2-31 指定具体尺寸的Text组件
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_125_4.jpg?sign=1739275333-fbJfVhUwLkX62ok6UpC1zBXmb40GNJEg-0-b11a46d85ed8d466d77a536f2a5f3f84)
图2-32 指定文本位置的Text组件
3.一段超长文本的显示
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_125_5.jpg?sign=1739275333-8EFY398xQIoId49X7vGr3H3fwya1eIFW-0-b4a37869aac613a5ab1c882a7b262e22)
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_126_1.jpg?sign=1739275333-bwWzHhQbB0t748QL9i4JRFI44LcfhR54-0-795a8d93ae87b586224d0582374a95fb)
页面的预览效果如图2-33所示,由于文本太长,超过屏幕的部分无法显示。
4.超长文本的多行显示
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_126_2.jpg?sign=1739275333-0vaNEUKqeOGjpiBifYeqQJGIjaZtCDB3-0-56bfb6272cc5abf661fafcc50b782e25)
页面的预览效果如图 2-34 所示,Text 组件通过设置 ohos:multiple_lines="true",可以将超出部分的文本另起一行显示。
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_126_3.jpg?sign=1739275333-kVKejOugiSFdTGq5GJkpdC4e8Lc7qVlj-0-607a79b5a6626e4f2585ada5ac88a645)
图2-33 超长文本的显示
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_126_4.jpg?sign=1739275333-GmvGQcDcZS2WdIkkStLtf8dvRSwAE6QR-0-a4ae5f6383fa30fb9fc664b4724694e7)
图2-34 超长文本的多行显示
5.超长文本的单行省略显示
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_126_5.jpg?sign=1739275333-GGlMOiwZWW6BpJvHzGuwWhKXWuTwdX4w-0-45ba03e8c112aceae4e694288dd6dc2d)
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_127_1.jpg?sign=1739275333-VbaM12p2bu4yivXM1xJNatrifvwflg70-0-30302d8841132bf8cdeefb9c7f76a794)
页面的预览效果如图2-35所示。
6.改变字体样式
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_127_2.jpg?sign=1739275333-TVE294cG71vPQl8LRJoctTYygdaPgTVs-0-4cbb8af75d2e448d57d32a737d1dfea4)
页面的预览效果如图2-36所示。
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_127_3.jpg?sign=1739275333-VMLD18C754PEgbzAhoQKk26wpXc77tDF-0-747f97ce42edcba408c3edada146a9dc)
图2-35 超长文本的单行省略显示
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_127_4.jpg?sign=1739275333-aIT5Ce9Rt6Xqp8X1IXeUHSAgCydr7KL7-0-401105ba30a15a3948d5351a44b0553e)
图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=1739275333-kzdYXGhaV2OETDCw4OgxZNu5FM22ICYI-0-b308fc8d7436ae950c419a975f29c0d6)
下面来看这个属性的效果。
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_128_2.jpg?sign=1739275333-csDnk37ISXvwR0oT4G7MEyRn6Y2997Vq-0-f466ed8291d28cd7bc576a9b55959116)
![](https://epubservercos.yuewen.com/0FFABF/23020655009774306/epubprivate/OEBPS/Images/42868_129_1.jpg?sign=1739275333-O4P2tHBB82cN19mC07IX4lhz6VgSeJbu-0-407f862b53c7f6dfb14123dfff3a6f60)
图2-37 basement属性演示
上面两种输入框的页面预览效果如图 2-37 所示,可以看到basement其实是输入框下方的一条线,这条线可以标识输入框的尺寸范围,以带来良好的用户体验。