展会工作人员在宽屏设备上点选“木作体验区”,右侧立刻出现详情;换成窄屏窗口后,点击同一展位,页面自然进入详情。问题从来不只是“详情显示在哪里”,而是在进入、返回、改变窗口尺寸之后,应用究竟记住了哪一个展位。如果列表项和详情页分别持有一份选中对象,返回列表时可能高亮 B-12,详情却还在显示 B-07;如果每次窗口切换都重新创建导航栈,用户还可能陷入重复入栈、返回两次才能离开的困境。

《屏界手记》第一篇为 VenueFlow 建立了四条 Booth 数据和稳定的 selectedId,使用 GridRow 的 600vp 自定义断点实现窄屏单栏、宽屏双栏。本篇保留 Booth{id,title,zone,phase,description},不更改业务实体,也不依赖设备型号;新增的是窄屏导航栈及跨布局的数据归属约束。下面使用 Stage 模型的 Navigation / NavPathStack,而不是把按钮点击伪装成系统返回操作。示例按照公开的 API 10 起提供的导航栈能力设计;实际工程请以安装的 SDK 声明、DevEco Studio 类型检查和设备窗口行为为准。

屏界手记:单一选择态跨越列表与详情的技术封面

一、先画清谁拥有状态:导航栈不等于业务仓库

首篇的列表有 B-12 木作体验区、B-07 光影剧场、B-19 城市花园和 B-23 设计书店,默认选中 B-12。窄屏进入详情时需要记住两个事实:用户点击的是谁,以及当前页面处于哪一层。前者属于业务选择态 selectedId,后者属于 NavPathStack。如果把 Booth 的完整对象复制进路由参数,后续阶段变为“已确认”时,栈里的旧副本仍可能显示“布展中”。因此页面之间传递的最好是稳定 id,展示数据时再从同一数组查询。

本次约定:根页面 VenueIndex 保存 booths 和 selectedId;NavPathStack 只负责小窗口列表到详情的进入、退出;超过 600vp 后把左右栏画在根页面,并清理已经没有显示意义的窄屏详情路径。详情取值使用当前 selectedId,不是另建一个独立 @State currentBooth。这不是使用全局单例的理由,反而是把小项目的状态生命周期限制在父组件里。未来如接入远程数据,可以再抽出 repository,但不要因为页面数增加就复制数据。

具体断点沿用 GridRow({ columns:12, breakpoints:{value:['600vp'], reference:BreakpointsReference.WindowSize}})。这里的 xs 表示不足 600vp 的小窗口,sm 表示其余窗口,与常见 CSS 框架默认的 sm 阈值不是一回事。关键不是“手机小、平板大”,而是窗口拖动后能够依赖当前窗口尺寸重新计算。GridRow 负责按断点排栏,最外层 Navigation.onAreaChange 负责监听始终存在的导航容器宽度。这样即使详情页覆盖根内容,也能在外层尺寸变化时决定是否清除窄屏路径。初始化时保留 xs 作为默认值,首屏宽窗口由外层尺寸回调切换到双栏。

二、把进入详情收束到一个入口函数

文件仍可从 entry/src/main/ets/pages/VenueIndex.ets 进入,模型 model/Booth.ets 与首篇含义相同。以下代码保留四条原始样例,新增导航路径,并明确把选中动作放在调用 pushPath 之前。为避免把版面撑得过长,列表和详情各自封装为 @Builder,构成一个可合并到首篇页面的核心实现。NavDestination 在 Navigation 的 navDestination 构建器中声明,不把它错误地摆到独立的 Column 当普通页面使用。

interface Booth {
  id: string;
  title: string;
  zone: string;
  phase: string;
  description: string;
}

@Entry
@Component
struct VenueIndex {
  @State private selectedId: string = 'B-12';
  @State private breakpoint: string = 'xs';
  @State private booths: Booth[] = [
    { id: 'B-12', title: '木作体验区', zone: '东展厅', phase: '布展中', description: '从材料触感出发,展示手工木作与互动体验。' },
    { id: 'B-07', title: '光影剧场', zone: '西展厅', phase: '待确认', description: '围绕动态光影构建沉浸式演出空间。' },
    { id: 'B-19', title: '城市花园', zone: '中庭', phase: '已确认', description: '以微型花园展示可持续景观设计。' },
    { id: 'B-23', title: '设计书店', zone: '北展厅', phase: '待确认', description: '精选建筑与视觉设计主题读物。' }
  ];
  private pathStack: NavPathStack = new NavPathStack();

  private get selectedBooth(): Booth | undefined {
    return this.booths.find((b: Booth) => b.id === this.selectedId);
  }

  private openBooth(id: string): void {
    this.selectedId = id;
    if (this.breakpoint === 'xs') {
      this.pathStack.pushPath({ name: 'BoothDetail', param: id });
    }
  }

  private onWindowWidth(width: number): void {
    if (width <= 0) { return; }
    const next: string = width < 600 ? 'xs' : 'sm';
    if (next === this.breakpoint) { return; }
    this.breakpoint = next;
    if (next !== 'xs') { this.pathStack.clear(); }
  }

  @Builder
  private boothList() {
    Column({ space: 12 }) {
      Text('全部展位 · 4').fontSize(20).fontWeight(FontWeight.Medium)
      ForEach(this.booths, (b: Booth) => {
        Column({ space: 6 }) {
          Text(`${b.id}  ${b.title}`).fontSize(18).fontWeight(FontWeight.Medium)
          Text(`${b.zone} · ${b.phase}`).fontSize(14).fontColor('#66788A')
        }
        .padding(16).width('100%').borderRadius(14)
        .backgroundColor(this.selectedId === b.id ? '#DDF4EC' : '#FFFFFF')
        .onClick(() => { this.openBooth(b.id); })
      }, (b: Booth) => b.id)
    }.width('100%')
  }

  @Builder
  private boothDetail() {
    if (this.selectedBooth !== undefined) {
      Column({ space: 18 }) {
        Text('场地分区').fontSize(15).fontColor('#32816A')
        Text(this.selectedBooth!.title).fontSize(27).fontWeight(FontWeight.Bold)
        Text(`${this.selectedBooth!.id} · ${this.selectedBooth!.zone}`)
          .fontSize(15).fontColor('#64748B')
        Text(this.selectedBooth!.phase).fontColor('#087F70')
        Text('展位介绍').fontSize(19).fontWeight(FontWeight.Medium)
        Text(this.selectedBooth!.description).fontSize(17)
      }.padding(24).width('100%').alignItems(HorizontalAlign.Start)
    } else {
      Text('展位已不存在,请返回列表重新选择').fontSize(16)
    }
  }

  @Builder
  private destinationBuilder(name: string, param: Object) {
    if (name === 'BoothDetail') {
      NavDestination() { this.boothDetail() }
        .title('展位详情')
    }
  }

  build() {
    Navigation(this.pathStack) {
      Column({ space: 18 }) {
        Text('展位视界').fontSize(30).fontWeight(FontWeight.Bold)
        Text('场地分区与展位详情').fontColor('#64748B')
        GridRow({
          columns: 12, gutter: { x: 16, y: 16 },
          breakpoints: { value: ['600vp'], reference: BreakpointsReference.WindowSize }
        }) {
          GridCol({ span: { xs: 12, sm: 5 } }) { this.boothList() }
          if (this.breakpoint !== 'xs') {
            GridCol({ span: { xs: 12, sm: 7 } }) { this.boothDetail() }
          }
        }
      }.padding(20).width('100%').alignItems(HorizontalAlign.Start)
    }
    .navDestination(this.destinationBuilder)
    .mode(NavigationMode.Stack)
    .width('100%').height('100%')
    .onAreaChange((_old: Area, current: Area) => {
      this.onWindowWidth(Number(current.width));
    })
  }
}

这里刻意把 NavigationMode.Stack 与 GridRow 组合起来:Navigation 管外层页面栈,GridRow 管根页面的分栏,并不是让 Navigation 自己猜测双栏。pathStack 用于导航,不加 @State,避免把可变路由控制器当成业务数组来观察;真正决定高亮的字段仍只有 selectedId。当打开 B-07 时,先更新 id,随后推送详情。返回时系统从栈中弹出详情页,根组件仍在,B-07 的高亮不会因为重建一个子页面而丢失。

窄屏展位详情页:B-07 光影剧场的完整应用界面

三、窄屏、宽屏和“刚好跨过断点”是三种验证条件

第一种条件是普通窄屏。打开应用时列表占全宽,点击 B-07 光影剧场后进入标题为“展位详情”的子页面;界面展示“B-07 · 西展厅”“待确认”及相应说明。点击导航栏返回箭头,回到列表仍应高亮 B-07。不要在详情组件的 aboutToDisappear 中把 selectedId 重置为 B-12,否则每次返回都会忘记用户刚才查看了什么。即使系统回退行为负责弹栈,业务选择态仍由父组件保持。

第二种条件是大于断点的宽窗口。此时列表与详情同时可见,选择 B-19 城市花园只更新右侧内容,不向栈里添加“BoothDetail”。根页面只有一个展示入口,既不会出现堆积的详情页,也不需要写一套额外的宽屏导航动画。这里用固定 5/7 的十二列比例,足够容纳四个简短展位;如果增加设备操作、详情图片等模块,应重新验算宽屏最小内容宽度,不是盲目加大字体和卡片留白。

第三种条件容易漏掉:用户在窄屏已经进入 B-07 详情,随后拖宽应用窗口。按当前策略,一旦外层导航容器宽度达到 600vp,onAreaChange 就更新为 sm 并清空窄屏子页面路径,显示同一 B-07 的双栏详情;再次缩小则回到根列表,用户可以点选详情重新进入。它保证界面不会同时保留“宽屏右栏”和“隐藏在栈中的旧详情”。注意 clear() 是这里刻意选择的返回策略,不是所有项目都必须这么做:表单编辑尚未保存时,直接清理栈可能丢掉草稿,必须先设计草稿持久化或阻止模式切换。这一版详情只读,所以策略成立。

尺寸可能在实际组件测量完成前由 xs 过渡到 sm;不要把 onAreaChange 当作“每次进入页面的数据初始化函数”,更不要在里面发网络请求。若需要数据加载,应在独立的数据层触发,并把断点回调保持为轻量视图状态更新。对于长文本和系统文字缩放,窄屏详情应允许向下滚动。示例的数据很短,换成真实文案后可用 Scroll 包裹详情,但不要一边在固定高容器中嵌套多个滚动组件,一边指望系统自动处理冲突。

四、删除当前展位、数据延迟与返回路径的异常分支

首篇的兜底写法是在找不到 id 时退回数组第一项,这适用于静态示例,却可能掩盖真实的删除。此次 selectedBooth 返回 Booth | undefined,详情缺失时直接显示提示,而不是悄悄把 B-07 变成 B-12。示例里使用非空断言是为了在同一个条件分支中缩短展示代码;实际团队代码可先保存为局部快照再传给详情子组件,避免反复 getter 查询。booths 改为 @State,让后续编辑或删除时界面具备可观察的数据变化入口,稳定 id 仍作为 ForEach 的 key。

对于快速连点,应避免在进入详情动画尚未结束时无限 pushPath。一个实用约束是:只有根列表可触发进入详情,进入后用户的点击目标已经切换到详情页;如果项目把多个快捷入口也绑定到 openBooth,可通过栈顶路径名称或自定义导航忙碌状态限制重复入栈。不能简单用“等待 300ms”代替状态校验,因为动画时长与用户操作不具有确定关系。对于数据加载,路由参数虽然携带 id,但本示例的画面取父组件的 selectedId;未来如果实现“从搜索结果直接打开某个展位”,应在路由解析后通过 id 更新同一状态,而不是使栈参数和业务 id 两份数据独立变化。

可以在 DevEco Studio 中用固定的四条样例做一份手工验证记录:初始选中 B-12;窄屏点 B-07;返回;点 B-19;拉宽;拉窄;删除当前展位;重新选择。这一串动作覆盖的是路由和业务状态的接力,不是单纯看页面是否能缩放。在验证时同时关注系统标题栏和安全区:NavDestination 对不同 API 版本的默认安全区处理可能不同,不能用视觉设计稿代替目标设备核对。

窄屏入栈、返回与跨断点清栈的状态流转图

五、工程边界:这不是把所有导航都塞进响应式容器

本篇的技术结论是稳定的业务身份应该比页面形态活得更久,而导航栈应该比业务数据活得更短。四个展位仍来自同一数据集合,selectedId 仍决定唯一高亮;小屏把详情放在 NavDestination 中,宽屏把同一详情放在根页右栏。用户无论从哪里返回,只有一种解释:当前选中的就是那个 id。这个约束比“点击后切换页面”本身更值得保留。

这里没有加入数据库同步、后台保活或跨进程恢复,也没有把窗口切换表现写成特定机型的实测结论。生产项目还要验证 Navigation 的栈恢复策略、应用被系统回收后的数据来源、异步删除、无障碍焦点与大字模式。下一篇将接着处理展位数据刷新、已删除 id 的一致性维护与分组筛选,但不会重新发明 Booth 或另造一套与本篇相冲突的选择态。

对应公开文档可参阅华为开发者 Navigation / NavPathStack、NavDestination 与 GridRow。其中,Navigation 绑定 NavPathStack 的能力从 API 10 开始,GridRow 断点规则和容器 onAreaChange 均有公开资料;具体构建仍应以项目实际 SDK、应用窗口和交互回归为准。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐