鸿蒙实践手记:公交出行模板首页资讯列表——List + ForEach 与 showToast 实测

举报
yd_274372260 发表于 2026/11/19 01:24:00 2026/11/19
【摘要】 今天在鸿蒙开发实践中心做了两件实事:先浏览了“用OBS打造个人云相册app”案例,又打开了“公交出行应用模板”案例,重点看它的首页资讯列表是怎么组织的;随后在 AI DevSpace 里请 AI 给了一个 List 资讯列表示例,并逐段核对了关键点。本文把这条链路记下来,方便下次照着做。 一、案例里看到什么公交出行应用模板的代码仓是 harmony-practice-center/Harmo...

今天在鸿蒙开发实践中心做了两件实事:先浏览了“用OBS打造个人云相册app”案例,又打开了“公交出行应用模板”案例,重点看它的首页资讯列表是怎么组织的;随后在 AI DevSpace 里请 AI 给了一个 List 资讯列表示例,并逐段核对了关键点。本文把这条链路记下来,方便下次照着做。

一、案例里看到什么

公交出行应用模板的代码仓是 harmony-practice-center/HarmonyOS-APPTMPL-bustravel,模板覆盖首页、出行、乘车码和个人中心四大模块。首页可以查看新闻热点、开卡与乘车码演示入口;出行模块在 feature/RouteDesign,可以查看附近站点、车辆距离和时间,点击线路打开地图页面;乘车码展示开卡与乘车码演示页面;我的模块登录后可以管理钱包和订单记录。

案例页还写明了两点很关键的约束:资讯数据在 feature/frontpage/src/main/ets/mock/MockData.ets 的 newsData 里;详情页固定读取 newsDetailPiece[0]。所以拓展实践“新增一条公交演示资讯”不能只往列表里加一项,还要同时设计列表 id 到详情的映射和缺失回退,否则新增的资讯点进去可能没有对应详情。工程入口是 entry,构建清单声明 8 个模块,兼容 5.0.0(12),目标 5.0.0(12)。

同一天浏览的云相册案例则是另一条线:用 ArkTS 与 ArkUI 构建页面,接入 OBS 对象存储,并用 Preferences 做数据持久化,适合对照着看“页面 + 云服务 + 本地存储”是怎么拼在一起的。

二、AI DevSpace 里验证的最小示例

我在 AI DevSpace 免费体验版里提的问题是:用 ArkTS 写一个公交出行模板首页资讯列表的简单示例,用 List 展示 3 条资讯标题,点击一条后用 promptAction.showToast 提示该标题,并简要说明关键点。AI 给出的核心代码如下(示例数据,非真实线路信息):

import { promptAction } from '@kit.ArkUI';

@Entry
@Component
struct NewsListPage {
  private newsList: string[] = [
    '3 号线早高峰加车',
    '新开 12 路公交线路',
    '乘车码使用小贴士'
  ];

  build() {
    Column() {
      Text('出行资讯')
        .fontSize(20)
        .fontWeight(FontWeight.Bold)
      List({ space: 12 }) {
        ForEach(this.newsList, (item: string, index: number) => {
          ListItem() {
            Text(item).fontSize(16)
          }
          .onClick(() => {
            promptAction.showToast({ message: item, duration: 2000 })
          })
        }, (item: string) => item)
      }
      .layoutWeight(1)
    }
    .width('100%')
    .height('100%')
    .backgroundColor('#F5F5F5')
    .padding(16)
  }
}

三、逐段说明

第一,数据定义。组件内部用 private 声明一个字符串数组,放 3 条资讯标题。数据写死不变,用 private 就够了;如果资讯从网络加载并且要刷新界面,就要改用 @State。

第二,页面标题。Text 是 ArkUI 最基础的文本组件,链式调用的 .fontSize()、.fontWeight() 是声明式地描述样式,ArkUI 渲染时读取这些描述来绘制界面。

第三,List + ForEach 渲染列表。List 是列表容器,{ space: 12 } 表示列表项之间的间距为 12vp。ForEach 是 ArkUI 的渲染控制语句,根据数组数据重复生成子组件,接收三个参数:数据源数组、子组件生成函数、键值生成函数。这里直接用标题文本作为 key,实际项目建议用唯一 id。

第四,点击事件。ListItem 的 .onClick() 传入回调函数,点击时触发。promptAction.showToast() 是鸿蒙全局提示 API,从 @kit.ArkUI 导入,在屏幕底部弹出轻量提示气泡,message 是提示内容,duration 是显示时长,单位毫秒,范围 1500 到 10000。闭包里的 item 捕获了当前 ForEach 迭代的值,所以每条点击会提示对应的标题。

四、三个容易踩的点

第一,ForEach 第三个参数不能省。键值生成函数用于列表 diff,省略后 ArkUI 可能无法正确识别增删项,导致渲染异常。

第二,ListItem 必须是 List 的直接子组件。不能写成 List、ForEach、Column、ListItem 这样嵌套,中间不能隔其他容器。

第三,promptAction 的导入路径。HarmonyOS 5.0 以上用 @kit.ArkUI,旧版 API 9 用 @ohos.promptAction,两者等价,但推荐新写法。

五、今天的收获和下一步

今天的链路是完整的:浏览案例、给公交出行模板仓点了 Star、再到 AI DevSpace 把示例跑通、最后写成这篇手记。下一步按案例 README 的拓展实践做一次“新增一条公交演示资讯”:先写方案,确认列表 id 到详情的映射和缺失回退,再改代码;改完回归路线搜索和返回,确保原功能不受影响。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。