鸿蒙ArkUI实战:让窄窗口下的导航和内容仍然可用

前言
窄窗口不是“宽屏布局缩小后的异常状态”,而是用户真实使用环境。若导航、输入区和列表都依赖宽度,手机或小窗口中就会出现标题消失、按钮不可点、任务卡片被裁切的问题。可用性首先要求所有关键操作仍在可见区域。
这篇文章里,我继续完善 Taskflow 待办面板,重点处理窄窗口下的导航与内容可用性。我会结合当前代码说明自己调整了哪些状态、操作入口和界面反馈,只保留与这个功能直接相关的实现内容。
我先把问题拆成输入、变化和结果
窄窗口下优先保留任务内容和主要动作,减少侧栏占比;搜索与新增输入占满内容宽度;卡片按“状态→标题→元信息→操作”垂直排列;空状态也必须保留创建入口。
开始写窄窗口下的导航与内容可用性之前,我先把输入、状态变化和界面结果分别列清楚。这里真正需要管理的是窄屏模式、导航显隐和输入区排列;操作从窗口缩小时切换布局并保持操作入口进入;用户最终看到的是可折叠导航、纵向输入区和可滚动任务列表。三部分一一对应后,我再开始改代码,避免按钮已经响应但页面结果没有同步。
我没有为窄窗口下的导航与内容可用性另外复制一套任务数据。窄屏模式、导航显隐和输入区排列按照生命周期分别放在任务模型、页面状态或临时草稿中,能由现有数据计算出来的结果就保持派生,不再额外保存。这样切换页面条件或重复操作时,数据来源始终只有一个。
我在当前版本中处理的范围
当前 App 已在 1320×2856 的连接模拟器中安装启动并通过 UI 布局树检查;页面已经将搜索、输入和卡片操作改为更适合窄窗口的纵向结构。模拟器截图与布局核验文件保存在 assets,但当前仍未做自动旋转和动态折叠导航。
我的实现步骤
第一步:梳理窄窗口下的导航与内容可用性需要的状态
第一步我会逐项检查窄屏模式、导航显隐和输入区排列:哪些是长期事实,哪些只在本次操作中有效,哪些可以根据其他字段计算。只有无法可靠推导、并且确实会影响界面的内容才新增状态,这能减少后续同步字段的数量。
第二步:收拢窄窗口下的导航与内容可用性的操作入口
第二步我把窗口缩小时切换布局并保持操作入口收拢到清楚的方法中。组件只传必要参数,方法内部按照“校验—更新—反馈”的顺序执行,避免同一项功能从多个按钮或组件各自修改数据。
第三步:让界面结果跟随状态变化
第三步我让可折叠导航、纵向输入区和可滚动任务列表直接读取更新后的状态。列表、计数、提示或按钮禁用状态都不单独缓存,因此不论操作从哪个入口触发,最终界面都遵循同一套渲染规则。
第四步:检查窄窗口下的导航与内容可用性的边界情况
第四步我专门检查极窄宽度、软键盘弹出、长文本和按钮换行。这些场景一旦出现异常,我会先看输入条件,再看数据写入,最后看界面绑定,按顺序排查而不是同时改动状态、布局和配置。
关键代码或数据协议
// 窄窗口下卡片的结构不依赖横向挤压
Column({ space: 10 }) {
Row() { Checkbox(); Text(priority); Blank(); }
Row() { Text(item.title).layoutWeight(1); }
Row() { Text(category); Text(dueLabel); }
Row() { Button('编辑'); Button('删除'); }
}
.width('100%');
这段代码只保留窄窗口下的导航与内容可用性真正依赖的字段和方法。我省略了周边布局,但没有省略决定行为的状态、参数和写入顺序,读代码时可以直接看出动作怎样影响最终结果。
我的验证方式
打开应用后检查首页布局树,确认 Taskflow、筛选项、搜索输入、任务标题和操作按钮均存在;点击编辑进入保存/取消状态;点击删除后确认撤销按钮仍在可见区域;重启后确认数据不受窗口布局影响。
我验证窄窗口下的导航与内容可用性时,会先准备明确的初始状态,再执行窗口缩小时切换布局并保持操作入口,随后观察可折叠导航、纵向输入区和可滚动任务列表是否符合预期。最后再补充极窄宽度、软键盘弹出、长文本和按钮换行,确保功能不只在最顺利的路径中成立。
当前模拟器画面

我的取舍
不要只截取宽屏预览器截图;不要把“模拟器窗口打开”当成“页面操作可用”;不要为了窄屏删掉重要操作;不要用不可见的手势替代唯一的编辑和删除入口。
我最需要避免的误区,是只看到可折叠导航、纵向输入区和可滚动任务列表出现就认为功能已经稳定。极窄宽度、软键盘弹出、长文本和按钮换行往往会暴露隐藏问题,所以我每次只改变一个条件,并记录最先出现的不一致,避免多处修改互相掩盖。
是否继续抽象取决于窄窗口下的导航与内容可用性的实际复杂度。我优先保证核心操作可见,再压缩装饰和次要信息。只要当前结构仍能清楚表达状态、入口和结果,我就不会为了形式增加新的层级。
我接下来还会完善的部分
下一阶段可增加侧栏折叠、返回按钮和横竖屏切换策略,并为每种窗口形态保存独立截图。当前版本先保证窄窗口下核心闭环可走通。
后续继续扩展时,我仍会把功能拆成小步骤:先调整模型或工具函数,再接入页面,最后检查实际交互结果。每一步都保持入口和结果清楚,出现问题时也更容易回退。
我怎样把这项功能接入现有页面
我没有把窄窗口下的导航与内容可用性当成一个孤立页面重新开发,而是先回到现有待办面板中寻找最合适的接入点。页面原来已经有任务数组、筛选条件、输入状态和卡片操作,我先确认新功能应该复用哪些状态,再决定是否真的需要增加字段。这样做可以避免两个功能分别保存同一事实,也能保证已有的筛选、计数和列表渲染继续正常工作。
具体到状态设计,我把窄屏模式、导航显隐和输入区排列逐项列出来,并为每一项写清生命周期:它从哪里产生,什么时候改变,页面关闭或操作结束后是否还需要保留。长期事实进入任务模型或持久化结构,当前操作产生的草稿、提示和选择则留在页面状态中。这个判断看起来简单,却直接决定了后面会不会出现编辑串值、筛选失效或重启后恢复出错误界面的情况。
接入动作时,我先沿着窗口缩小时切换布局并保持操作入口走一遍完整链路。我会确认按钮或输入框传入的参数是否足够,方法内部是否先校验再写入,以及写入后哪些派生结果应该随之变化。只要链路中有一步需要组件自己猜测数据,我就把这一步重新收回页面或 Store,避免展示组件承担不属于它的职责。
完成数据更新后,我再检查可折叠导航、纵向输入区和可滚动任务列表。我不会额外调用一个“刷新页面”的方法,而是让这些区域直接读取最新状态。这样无论动作来自鼠标、键盘、弹窗还是恢复流程,界面都遵循同一套渲染逻辑。对我来说,这比为每种操作分别写一套显示代码更容易维护,也能减少不同入口产生不同结果的问题。
我还会把关键方法按职责分成三类:纯计算方法只接收数据并返回结果;写入方法只完成一次明确的数据变化;反馈方法只负责更新用户可见状态。三类方法彼此组合,但不互相隐藏副作用。这样在检查极窄宽度、软键盘弹出、长文本和按钮换行时,我能够快速判断是输入条件不正确、数据写入失败,还是界面表达不完整。
围绕窄窗口下的导航与内容可用性,我只保留与窄屏模式、导航显隐和输入区排列、窗口缩小时切换布局并保持操作入口和可折叠导航、纵向输入区和可滚动任务列表直接相关的内容。每个段落都对应一个实际问题,避免技术说明被其他流程打断。
最后,我会从维护者视角再看一次这项改动。如果以后新增任务字段、增加第二个页面或替换存储方案,当前代码是否仍有清楚的扩展位置;如果一个新需求必须同时改很多不相关文件,我会优先重新检查边界,而不是继续叠加条件。我优先保证核心操作可见,再压缩装饰和次要信息,这也是我在这个项目里一直坚持的节奏。
我在这一功能上的具体处理
在这项改动里,我主要完善的是窄窗口下的导航与内容可用性。我先把窄屏模式、导航显隐和输入区排列单独梳理出来,区分哪些内容属于任务事实,哪些内容只是当前页面的临时状态。这样页面发生变化时,我能直接追到对应的数据来源,不需要在多个数组或组件之间猜测哪一份才是最新结果。
在交互入口上,我把窗口缩小时切换布局并保持操作入口集中到明确的方法中处理。组件只负责把当前任务、输入值或操作类型交给页面,真正的校验、数组更新和反馈状态由统一入口完成。这样写比直接在按钮回调里改字段多了一层,但新增持久化、撤销或测试时,我不需要到处寻找修改点。
在界面表现上,我重点处理了可折叠导航、纵向输入区和可滚动任务列表。我希望每次操作完成后,用户都能立刻看见状态变化,因此相关列表、计数、提示和按钮状态都会读取最新数据。界面展示不是额外维护的一份结果,而是从任务数据和页面条件实时计算出来的。
我按“准备窄屏模式、导航显隐和输入区排列—执行窗口缩小时切换布局并保持操作入口—检查可折叠导航、纵向输入区和可滚动任务列表”的顺序组织实现。这个顺序既对应用户操作,也对应代码调用链,出现问题时可以从当前步骤直接向前追踪。
我重点检查了极窄宽度、软键盘弹出、长文本和按钮换行。这些情况最容易暴露状态串扰、重复数据、错误覆盖或布局裁切。如果结果不符合预期,我先检查动作是否进入正确方法,再检查源数据是否更新,最后检查组件读取的字段和条件,而不是同时修改多个地方。
为了让窄窗口下的导航与内容可用性便于维护,我让字段名称直接表达状态,让方法名称直接表达动作,并让展示组件只关心可折叠导航、纵向输入区和可滚动任务列表。隔一段时间再回看时,我仍能从命名和调用顺序理解这项功能。
这次我没有为了追求功能数量而一次加入过多结构。我优先保证核心操作可见,再压缩装饰和次要信息。我更看重当前功能能独立讲清楚、代码入口明确、界面反馈直观,后面继续扩展时也能沿用同一套边界。
小结
这篇文章围绕“鸿蒙ArkUI实战:让窄窗口下的导航和内容仍然可用”讨论的不是一个孤立控件,而是一条从用户问题到工程证据的完整路径。当前已实现的部分可以直接在待办项目中复查;尚未实现的部分则给出了状态边界、代码入口和验收条件。保持这种区分,文章才真正有助于读者复现,也能让项目后续进度保持可信。
更多推荐


所有评论(0)