场景介绍
应用在不同屏幕大小的设备上运行时,往往有不同的UI适配,以聊天应用举例:
- 在窄屏设备上,联系人和聊天区在多窗口中体现。
- 在宽屏设备上,联系人和聊天区在同一窗口体现。
要做好适配,往往需要开发者开发多套代码,以便运行在不同设备上。但是这样耗时耗力,于是ArkUI针对这种场景提供了分栏组件,可以通过一套代码完成不同设别的适配,本例简单介绍下如何使用分栏组件实现上述场景。
效果呈现
效果图如下所示:
窄屏设备效果图:
宽屏设备效果图:
运行环境
本例基于以下环境开发,开发者也可以基于其它适配的版本进行开发: - IDE:DevEco Studio 3.1 Release - SDK: Ohos_sdk_public 3.2.12.5(API Version 9 Release)
实现思路
想要实现一多效果,所有的页面元素必须在Navigation的容器中展示,Navigation一般作为页面的根容器,包括单页面、分栏和自适应三种显示模式,可通过mode属性设置页面的显示模式。
导航区中使用NavRouter子组件实现导航栏功能,内容页主要显示NavDestination子组件中的内容。
NavRouter是和Navigation搭配使用的特殊子组件,默认提供点击响应处理,不需要开发者自定义点击事件逻辑。NavRouter有且仅有两个根节点,第二个根节点是NavDestination。NavDestination用于显示Navigation组件的内容页。当开发者点击NavRouter组件时,会跳转到对应的NavDestination内容区。
本例涉及一些关键特性以及实现方法如下: - 创建Navigation组件,同时通过设置mode属性为auto来控制页面显示效果。 - Navigation通过与NavRouter组件搭配使用,实现页面分栏效果。
NavRouter必须包含两个子组件,其子组件即为实现分栏效果的组件,其中第二个子组件必须为NavDestination(第一个即可理解为为导航栏,第二个组件可理解为内容区)。
- 通过向父组件NavRouter添加子组件NavDestination,创建导航内容区并添加文本。
- 内容区域的补充:根据应用的场景,添加TextArea组件完善内容区。
开发步骤
-
创建Navigation组件,同时通过设置mode属性为auto来控制页面显示(自适应模式下,当设备宽度大于520vp时,Navigation组件采用分栏模式,反之采用单页面模式)。 具体代码如下:
ts build() { Column() { Navigation() { ... } // Navigation组件mode属性设置为auto。自适应模式下,当设备宽度大于520vp时,Navigation组件采用分栏模式,反之采用单页面模式。 .mode(NavigationMode.Auto) } .height('100%') }
-
通过NavRouter组件创建导航栏:Navigation通过与NavRouter组件搭配实现页面分栏效果。
-
自定义导航栏NavigationTitle。
-
添加Navigation子组件NavRoute,创建导航栏。
-
通过ForEach循环渲染导航栏内容,且导航栏内容通过List组件显示。 具体代码如下:
-
// 自定义导航栏title
@Builder NavigationTitle(index) {
Column() {
Row() {
Text('互动交流' + index + '群')
.fontColor('#182431')
.fontSize(20)
}
}
.width($r("app.float.titHeightFloat"))
}
build() {
Column() {
Navigation() {
Text('联系人(' + this.arr.length + ')')
.fontWeight(500)
.margin({ top: 10, right: 10, left: 19 })
.fontSize(17)
List({ initialIndex: 0 }) {
// 通过ForEach循环渲染导航栏内容
ForEach(this.arr, (item: number, index: number) => {
ListItem() {
// 导航组件,默认提供点击响应处理
NavRouter() {
// 导航区内容
Column() {