下文将从UX设计、工程管理、移动端页面和电脑端页面四个方面,系统介绍新闻阅读应用在实际开发中的最佳实践,为开发者提供可借鉴的实现思路。
新闻阅读应用的UX设计可参考新闻阅读类设计指南。应用在直板机上采用单列纵向布局,在折叠屏和平板上以双列栅格展示,在电脑上采用侧边栏加内容区的分栏布局。多设备新闻阅读界面在不同设备形态下的效果如下所示:

考虑到“一多”工程代码的复用性和可维护性,推荐开发者使用分层架构组织代码工程。分层架构将项目工程划分为产品定制层(products)、基础特性层(features)和公共能力层(common)三个层级,各层级权责清晰、各司其职,为开发者提供了一套清晰、高效且可扩展的设计架构。关于分层架构的具体设计细节,可参考分层架构设计。
在创建“一多”工程时,开发者会面临工程结构目录的划分问题。考虑到复用性和可维护性,本文以新闻阅读应用为例,提供推荐的参考方案。
HarmonyOS的分层架构主要包括三个层次:产品定制层、基础特性层和公共能力层,为开发者构建了一个清晰、高效、可扩展的设计架构。更多详情请参考分层架构设计的逻辑设计。
新闻阅读应用根据一多推荐的products、features、common的“三层工程架构”划分目录。各层级设计如下:
工程结构如下:
├──common // 公共能力层
│ └──src/main/ets
│ ├──components // 公共 UI 组件(NewsCard 等)
│ ├──constants // 公共常量(断点等)
│ ├──types // 数据契约接口
│ └──utils // 窗口、断点、日志等工具
├──features // 基础特性层
│ ├──recommendation // 首页推荐
│ │ └──src/main/ets
│ │ ├──constants // 推荐常量
│ │ ├──model // 推荐数据
│ │ ├──view // 首页 UI 组件
│ │ └──viewmodel // 首页状态
│ └──newsdetail // 新闻详情
│ └──src/main/ets
│ ├──constants // 详情常量
│ ├──model // 详情数据
│ ├──view // 详情页 UI 组件
│ └──viewmodel // 详情页状态
└──products // 产品定制层
├──default // 默认(直板机/折叠屏/平板)产品
│ └──src/main/ets
│ ├──defaultability // 默认入口 Ability
│ └──pages // 页面(首页、详情等)
└──pc // 电脑端产品
└──src/main/ets
├──pages // 电脑页面
├──pcability // 电脑入口 Ability
├──view // 电脑标题栏组件
├──viewmodel // 电脑视图模型
└──window // 电脑窗口管理 本章介绍如何针对直板机、阔折叠、双折叠、三折叠和平板设备,使用“一多”布局能力,实现新闻阅读应用页面层级“一套代码、多端适配”。同时,介绍上述设备的窗口适配方案,以及各页面的交互开发和功能开发方案。
多设备新闻阅读示例,根据适配的设备,涉及全屏模式、分屏模式、悬浮窗模式、自由窗口模式,可参考窗口模式。其中分屏模式与悬浮窗通常无特殊设计,可通过系统方式进入。应用监听窗口尺寸变化,通过断点刷新UI,将自动适配全屏、分屏、悬浮窗、自由窗口模式下的布局。
通过设置setPreferredOrientation()设置应用窗口方向,在新闻阅读应用中,Orientation参数设置为FOLLOW_DESKTOP,使应用跟随桌面的旋转策略。在该旋转策略下,在直板机上推荐仅竖屏显示,在双折叠展开态、三折叠展开态、平板等大屏幕场景下推荐四方向旋转并受控制中心的旋转开关控制。具体说明可参考为应用配置旋转策略。
为获得统一的视觉观感,新闻阅读应用通常将顶部状态栏设置为全局沉浸。根据UX设计,需要实现不同窗口模式(全屏、分屏、悬浮窗)下窗口的沉浸式,可参考窗口沉浸式。全屏、分屏和悬浮窗的沉浸式均可通过setWindowLayoutFullScreen()实现,并进行动态安全区避让。
首页推荐页包含热点要闻、大图轮播、上文下图卡片和新闻列表等多个内容区块。在直板机上这些区块纵向单列排列,在折叠屏展开态和平板上需要以双列栅格展示并控制摘要内容的显隐,同时顶部搜索栏和子Tab栏的排列方式也需随横向断点切换。
设备效果图如下:
横向(/纵向)断点 | sm/md | sm/lg | md | lg、xl |
首页推荐页 |
|
|
|
|
界面开发
移动端首页推荐页各区域介绍及实现方案如下表所示:
区域编号 | 简介 | 实现方案 |
|---|---|---|
1 | 顶部页签及搜索框 | 使用GridRow栅格组件实现,在不同横向断点下,通过设置GridCol的span和order,实现搜索框和页签的上下或左右布局:直板机设备搜索框占满整行在上、页签在下;PuraX外屏或横向断点为md及以上时页签居左、搜索框居右。 |
2 | 热点要闻 | 使用List组件实现,通过lanes属性按断点分栏:横向断点为sm时1列、md时2列、lg/xl时3列。 |
3 | 大图轮播 | 使用Swiper组件实现,通过displayCount按断点切换显示数量(横向断点下sm为1,md为2,lg/xl为3)。 |
4 | 上文下图卡片 | 使用Column纵向排布标题和多张图片实现上文下图卡片。横向断点为sm/md时展示1条,lg/xl断点下通过Row并排展示2条。 |
5 | 新闻列表 | 横向断点为sm时单列展示,md及以上断点使用GridRow双列栅格展示。 |
6 | 底部/侧边页签 | 使用Tabs组件实现,配置barFloatingStyle悬浮样式和沉浸光感材质(通过uiMaterial (系统材质)创建),API 26及以上设备生效,低版本降级为经典底部页签栏。 |
新闻详情页包含文章正文和评论区两部分。在直板机设备上,正文与评论区需纵向排列;在大屏设备上,二者并排展示,评论区作为侧栏可独立滚动。底部悬浮工具栏使用背景模糊材质悬浮展示。
横向(/纵向)断点 | sm/md | sm/lg | md | lg、xl |
新闻详情页 |
|
|
|
|
界面开发
移动端新闻详情页各区域介绍及实现方案如下表所示:
区域编号 | 简介 | 实现方案 |
|---|---|---|
1 | 新闻标题和作者区 | 使用Column纵向排布新闻标题和作者行,作者行使用Row横排头像、名称、发布时间和关注按钮,内边距按断点调整。 |
2 | 内容区 | 正文图文使用Scroll承载滚动展示。小屏下与标题、评论区纵向堆叠统一滚动。 |
3 | 评论区 | 使用List展示评论列表。横向断点为md及以上时置于SideBarContainer右侧侧栏独立滚动;横向断点为sm时堆叠于正文下方。 |
4 | 底部悬浮工具栏 | 使用Stack悬浮于内容上方,通过backgroundBlurStyle()应用背景模糊材质。 |
新闻阅读应用在电脑端上支持全屏和自由窗口两种模式,具体实现可参考窗口模式。应用内使用响应式组件,即可根据窗口大小,自动适配全屏和自由窗口模式下的布局。
根据UX设计规范,需要实现全屏和自由窗口下的沉浸式效果,具体实现可参考窗口沉浸式。全屏模式下,通过window.setWindowLayoutFullScreen()实现沉浸式。自由窗口模式下,通过window.setWindowDecorVisible()隐藏标题栏,仅保留右上角三键,使页面内容延伸至标题栏区域,实现沉浸式显示效果。
电脑端首页推荐页的页签栏展示在左侧,右侧承载内容区。效果图如下所示:

界面开发
电脑端首页推荐页与移动端大屏布局基本一致,主要包含以下区域:
区域编号 | 简介 | 实现方案 |
|---|---|---|
1 | 沉浸式标题栏 | 通过window.setWindowLayoutFullscreen()让内容占据标题栏区域,window.setWindowDecorVisible()隐藏默认装饰。页面由标准Navigation/NavDestination承载,标题栏置于NavDestination的title槽位并设置BarStyle.STACK沉浸模式。左侧展示应用图标和名称,右侧依次放置顶部页签、加号按钮和搜索框,同时避让三键区。 |
2 | 左侧tab栏 | 左侧Tabs组件设置vertical(true)使页签栏竖向展示。 |
3 | 内容区 | 与xl断点下的移动端布局一致,实现方案可参考移动端首页推荐页。 |