前言:

最近在学习鸿蒙ArkTS开发,本次作业是简易购物车。一开始只是参考现成代码拼凑,很多逻辑一知半解。在实现“点击按钮添加商品”这个功能时,接连遇到编译报错、界面不更新的问题。于是抛开简写语法,用最基础的for循环实现数组新增,搞懂@State的更新规则,在这里记录下来。

一.功能需求:

1. 定义商品数据接口,规范商品结构

2. 使用@State数组存储商品数据,ForEach渲染列表

3. 列表内商品支持数量增加、减少

4. 悬浮加号按钮,点击后向列表新增一条商品

二.核心代码:

1.定义商品接口:

interface goods {
  image: Resource
  name: string
  size: string
  price: number
  count: number
}

2.状态变量初始化

@State ListGoods: goods[] = [
  {
    image: $r('app.media.putao'),
    name: '新疆紫葡萄',
    size: '规格:500g/盒',
    price: 22.50,
    count: 1
  }
]

3.新增商品按钮:

Button() {
  Text('+')
    .fontSize(28)
    .fontColor(Color.White)
}
.width(52)
.height(52)
.borderRadius(26)
.backgroundColor('#007DFF')
.position({ x: '80%', y: '84%' })
.onClick(() => {
  // 声明新商品对象
  let newGood: goods = {
    image: $r('app.media.putao'),
    name: '新疆紫葡萄',
    size: '规格:500g/盒',
    price: 22.50,
    count: 1
  }
  // 创建空数组
  let newArr: goods[] = []
  // for循环,复制原有全部商品
  for (let i = 0; i < this.ListGoods.length; i++) {
    newArr.push(this.ListGoods[i])
  }
  // 添加新商品
  newArr.push(newGood)
  // 给状态变量赋值新数组,触发页面刷新
  this.ListGoods = newArr
})

4.商品数量加减核心片段

Text('-')
  .onClick(() => {
    if(item.count > 1){
      item.count --
    }
  })
Text('+')
  .onClick(() => {
    item.count ++
  })

三.开发问题复盘:

1. 变量未定义报错:Cannot find name 'newGood'
代码是从上至下顺序执行。如果先写 newArr.push(newGood) ,再去定义 newGood ,编译器识别不到这个变量。
解决办法:变量声明必须放在使用它的代码之前。

2. 直接push追加数据,页面没有变化
如果直接写 this.ListGoods.push(newGood) ,只是修改数组里面的内容,数组本身的引用地址没有改变。@State监听的是引用变化,识别不到数组内部改动,页面不会刷新。
解决办法:新建数组,先复制旧数据,再添加新元素,最后把新数组赋值给状态变量。

3. 接口类型匹配报错
接口定义的字段名称、大小写,和创建对象时必须完全一致。名称不一样就会触发类型检查错误。

四.知识点总结:

@State的本质:监听数据的引用地址是否发生改变。
 
- 修改数组内部对象属性:引用不变,刷新不稳定

- 生成全新数组并赋值:引用改变,UI稳定刷新
for循环实现新增的流程:新建空数组 → 循环遍历旧数组完成拷贝 → 追加新商品 → 替换状态数组。

五.学习小结:

这次作业让我意识到,抄代码和写代码完全是两回事。之前代码能跑起来,但不清楚背后的状态原理。
这次刻意放弃简写语法,用基础循环去实现功能,虽然代码行数更多,但每一步操作都清晰可控。后续写ArkTS列表类功能时,我会优先留意@State数组的更新方式,避免出现页面不刷新这类常见问题。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐