HarmonyOS 折叠菜单架构·第1篇:GridRow 双栏断点编排【共创稿事节】
菜谱编排在窄窗口只呈现菜品列表,展开后增加食材详情栏;断点基于可用宽度而非设备型号。这类功能不会因为用上更复杂的框架就自动正确,关键仍是边界设置在了哪一层。
具体到「菜单编排」这个页面,折叠屏的本质是可用宽度变化,只用折叠与展开两个枚举不足以覆盖分屏窗口。本文把讨论范围限定在「GridRow 双栏断点编排」,不把界面能显示和数据已经被正确处理混为一谈。

菜单编排的输入与状态
在菜单编排里,「折叠屏的本质是可用宽度变化」会影响后续操作。风险是:只用折叠与展开两个枚举不足以覆盖分屏窗口。处理办法是按照vp宽度断点组织栅格层级。若要确认「同一设备缩放窗口也能采用合适结构」,可以安排「宽度接近840vp」作为回归用例,结果须符合核对卡片间距、标题换行和按钮区域。
先明确「主从区域需分清」为什么会失败:所有内容都按比例缩放会让菜单卡片变窄。这不是简单刷新界面就能解决的问题,需要主区域保留选择列表,详情在宽窗口独立出现。验收时不仅要看到「窄屏仍能完成核心任务」,还要确认本次操作没有改动其他不相关的数据。
「栅格列数不可混用」与「断点要覆盖中间态」实际上相互制约。前一条风险表现为不同断点下span和columns不匹配会出现异常换行;相应的处理是按sm四列、md八列、lg十二列分别设置跨度。增加新的操作入口之后,也应该继续满足「宽度变化时布局保持可计算」,不能为新页面单独复制一份规则。

从输入与输出看「详情并不是复制一页」:输入环节的风险是窄屏进入详情与宽屏选中详情应共享业务身份,因此先落实以稳定菜品id维护选择而非组件实例;输出环节则应验证「窗口变化后仍显示同一道菜」。结合「没有任何菜品」这一操作,预期结果为主列表呈空态,宽屏详情区域不出现旧菜品,能够帮助定位发生偏差的阶段。
最后审查「食材文本长度不可控」这条约束:配料名加单位可能比视觉稿长得多,因此应当对标题截断、正文换行分别施加策略。只有业务侧明确承担这项责任,不发生按钮被挤出可点击区域才能成为可以长期复核的标准,而不是某次页面渲染的巧合。
核心函数与调用上下文
对于FoldRecipe这个工程,下面的片段把「折叠屏的本质是可用宽度变化」所需的行为收敛到可以定位的代码上。主要涉及GridRow、GridCol。在RecipeBoard.ets或对应common模块接入时,应明确调用方传入什么,尤其要防止「窄屏进入详情与宽屏选中详情应共享业务身份」这一风险继续影响后续处理。对应的工程措施是「以稳定菜品id维护选择而非组件实例」,不能只靠页面文字来表示处理成功。
@Entry
@Component
struct RecipeBoard {
@State private chosen: string = '番茄炖牛腩';
build() {
GridRow({ columns: { sm: 4, md: 8, lg: 12 }, gutter: 16 }) {
GridCol({ span: { sm: 4, md: 3, lg: 4 } }) {
Text('今日菜单').fontSize(24)
}
GridCol({ span: { sm: 4, md: 5, lg: 8 } }) {
Text(this.chosen).fontSize(22)
}
}
.width('100%')
.padding(20)
}
}
这段实现适合先用静态数据检查「主从区域需分清」和「安全区影响真实宽度」两条路径。前者要解决所有内容都按比例缩放会让菜单卡片变窄,后者要求在容器里分配可用空间并预留内边距。代码层只承诺得到可解释的状态,真正的展示和持久化要在调用位置按菜单编排的业务流程串起来;这样才不会把界面点击当作仓储提交。
还要注意「滚动归属应明确」:两个区域都无约束滚动时手势与定位容易混乱。由列表和详情采用明确的独立滚动容器承担这一职责后,其他入口调用相同函数可以得到一致处理。最后用「宽度接近840vp」观察核对卡片间距、标题换行和按钮区域,检查异常路径是否仍遵守同一语义。
如果计划在此基础上增加新功能,先确认「首版优先可解释结构」是否仍成立。先用官方GridRow和GridCol完成尺寸响应带来的变化必须被单独验证,而不是假设新增页面会自然继承既有保障。
跨页面和生命周期的关联
先确定「安全区影响真实宽度」的处理界限。把设备物理宽度当内容宽度忽略边距与系统区域;具体做法是在容器里分配可用空间并预留内边距。验收应观察「左右卡片边缘不会贴住屏幕」,而不只判断界面是否响应。转到「首版优先可解释结构」的路径,也必须遵守同样的数据约束。
把「断点要覆盖中间态」单独列为检查条件,问题更容易识别:只测手机和全展平会漏掉中间窗口。实施上建议加入接近600vp与840vp的临界宽度检查,目标是布局切换没有跳跃闪烁。还要补测「宽度接近840vp」,其结果应满足核对卡片间距、标题换行和按钮区域,不能只看首次进入的画面。
对「滚动归属应明确」而言,先确定谁负责作出判断。因为两个区域都无约束滚动时手势与定位容易混乱,处理时需要列表和详情采用明确的独立滚动容器。这样才有机会得到「选菜不会拉动不相关区域」的结果;与之关联的「主从区域需分清」也应采用一致的责任划分。

「内容状态独立于布局」容易被顺利路径掩盖。问题在于重新进入断点时重建数据会丢失编辑状态,所以应当把菜品选择保存在页面稳定状态源。正常结果是窄宽切换只更换排列方式;一旦失败,还需保留足以复现的操作状态,特别是「菜名超过一行」这类边界场景。
讨论「首版优先可解释结构」时应先识别具体风险:引入复杂设备识别会放大维护成本。采取「先用官方GridRow和GridCol完成尺寸响应」后,预期达到UI行为由少量断点配置决定。与此同时,「详情并不是复制一页」也可能改变执行条件,不能只用一种固定输入判断是否正确。
回归方案与失败处理
本节把「菜单编排」的验证条件具体化。验证应该以官方接口语义、可见的页面状态与可读取的数据为依据,不能把没有在设备上执行的逻辑检查写成性能实测;需要编译、权限或设备支持的步骤,应在对应开发环境中按项目配置完成。
完成「宽度低于600vp」之后,直接检查主列表可独立浏览,详情可通过导航进入。如果失败,不要只保存一张截图,而应记录内容状态独立于布局的触发顺序,以及「把菜品选择保存在页面稳定状态源」是否被绕过,这些信息才足以支持修正。
先复现「宽度跨过600vp」。此时的通过条件应写成「列表与详情按约定的列数重新排列」,并对照「首版优先可解释结构」的约束确认状态来源。如果结果偏离,先检查先用官方GridRow和GridCol完成尺寸响应是否真正执行,而不是立即更换页面布局。
针对「宽度接近840vp」,观察点不仅是操作能否完成,还包括核对卡片间距、标题换行和按钮区域。建议保留触发前后的业务标识,尤其在「折叠屏的本质是可用宽度变化」存在时,核对同一设备缩放窗口也能采用合适结构,才能排除旧状态干扰。

把「选中菜品后改变窗口」独立成一条回归记录:预期选中id不丢失,详情数据没有无端变更。若出现异常,沿主从区域需分清对应的处理逻辑往回定位,检查是否满足「主区域保留选择列表,详情在宽窗口独立出现」这一前置条件。
「菜名超过一行」不应被正常路径的检查覆盖。这里必须验证采用合理截断或换行,不挤压操作按钮,并且确认「栅格列数不可混用」相关字段没有出现旁路修改;否则当前页面看似完成了操作,实际数据却仍可能不一致。
对「没有任何菜品」做一次中断后重试,记录最后的可见结果是否符合主列表呈空态,宽屏详情区域不出现旧菜品。这一用例能同时观察「详情并不是复制一页」的边界,重点看窗口变化后仍显示同一道菜,不必预设任何未经采样的性能指标。
结论与适用范围
菜单编排的可靠性不取决于控件数量。面对「只用折叠与展开两个枚举不足以覆盖分屏窗口」的风险,选择按照vp宽度断点组织栅格层级;而「首版优先可解释结构」这项约束,还要求先用官方GridRow和GridCol完成尺寸响应。
若新需求改变了「首版优先可解释结构」的业务含义,应先检查既有措施「先用官方GridRow和GridCol完成尺寸响应」是否仍适用,而不是在按钮里临时加分支。此前的「宽度低于600vp」也需要重新验证。
在资源、路由和权限问题上,建议以项目实际 target SDK 和设备 API 能力为准。本例围绕 HarmonyOS API 26.0.0 Release 可查证的公共机制组织,代码片段应放入完整 Stage 工程中按开发者文档补齐工程声明和对应资源。页面与技术图使用的示例状态一致,涉及数据写入及生命周期的部分应在 DevEco Studio 中分别执行编译与交互核查。
官方参考
更多推荐


所有评论(0)