鸿蒙ArkTs购物车开发|@State数组更新实战记录
前言:
最近在学习鸿蒙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数组的更新方式,避免出现页面不刷新这类常见问题。
更多推荐

所有评论(0)