HarmonyOS 应用性能优化 · 寝室投票创建页深度解析:选项动态增删与不可变更新

前言

寝室投票的创建页有一个会让很多前端翻车的交互:选项列表的动态增删。用户可以添加选项(上限若干个)、删除任意一个选项、编辑任意选项的文字,整个列表是一个数组状态的"活体"。性能上,这里集合了数组操作的三个经典雷区:用可变方式(push/splice)改状态数组导致 diff 键值错乱、删除中间项后条目状态串位、频繁增删时 ForEach 大范围重建。本篇的主题是选项数组的不可变更新与增删动画成本:为什么增删必须走"新数组替换",键值函数在删除场景下为何决定生死,以及列表增删动画(transition)的真实成本与克制用法。代码 API 12 可编译。

一、问题背景

创建页骨架三段:问题输入卡(投票主题 TextInput)、选项卡(动态选项列表,每条一行输入框加一个删除按钮,底部"添加选项"按钮)、设置卡(匿名投票、截止提醒两个 Toggle)加发布按钮。初始 2 个选项,可加到最多 8 个,最少保留 2 个。

原始实现的三个雷区逐一展开。雷区一:添加选项用 this.options.push(newOption),数组引用没变,ArkUI 检测不到 @State 的引用变化,界面不刷新;开发者为补救加上 this.options = this.options,或者改用 splice 后再赋值,行为变得依赖框架内部实现。雷区二:键值函数用 index 或干脆没写。删除第 3 个选项(共 5 个)时,数组长度变 4,index 键值下 ForEach 认为"第 3 项内容变了、第 5 项消失了",导致第 3、4 两个输入框的内容发生串位——用户在第 4 个框里输入的文字跑到了第 3 个框里。这是 TextInput 这类有内部状态的组件与 index 键值组合时的必现 bug。雷区三:给增删加动画时用了 animation 属性包住整个选项卡,每次任何选项的文字输入都会触发动画参数 diff,插入动画顺带让所有存量条目闪一遍。

49 创建页首屏

图:投票创建页首屏。动态选项列表是页面上唯一的高频结构变化区。

二、原理分析

不可变更新是 ArkUI 状态检测的前提。@State 只对"引用变化"做响应(一层深),数组的 push/pop/splice 改的是内容不是引用,框架状态比较阶段直接判定"未变化"。正确姿势是每次增删都生成新数组:添加用 concat 或展开,删除用 filter 或 slice 拼接,编辑用 map 替换单项。这不仅是"让界面刷新",更是让 ForEach 的 diff 有明确的边界——新数组与旧数组按键值对比,增删改一目了然。

键值函数在删除场景的决定性作用源于 ForEach 的 diff 算法:它按键值匹配新旧数组的条目,键值相同的条目复用组件实例(内部状态如 TextInput 的编辑态随之保留),键值只在旧数组出现的条目销毁、只在新数组出现的条目创建。键值用 index 时,删除中间项导致后续所有条目的 index 前移,框架把"内容前移"误判为"每项都改了",编辑态串位、动画错乱。键值用选项的唯一 id 时,删除第 3 项的 diff 结果精确为"销毁 1 个实例、其余不动"。输入框类组件的列表,键值必须是业务 id,没有商量余地。

增删动画的成本取决于动画的"作用范围"。transition 只应挂在条目根节点上,插入时以 insert 策略播放、删除时以 remove 策略播放,作用域天然限定在单个条目;如果用 animation 包在父容器上,任何子树变化都会重新触发动画计算。删除动画还有一个技术细节:条目销毁前要先播放退出动画,通常做法是先标记条目为"退出中"(改样式),动画时长后再从数组里真正删除,这个延迟删除窗口内用户继续操作要小心处理,否则出现幽灵条目。对轻量表单页,更克制的做法是不做删除动画、只做插入动画,成本减半、体验无损。

49 创建页添加选项

图:添加选项后的列表。新条目以 id 为键值插入,存量条目实例原样复用。

三、代码实现

以下代码块属同一 .ets 文件,按顺序拼接。第一段定义模型与不可变增删改逻辑。

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

interface VoteOption {
  id: number;
  text: string;
}

const MAX_OPTIONS: number = 8;
const MIN_OPTIONS: number = 2;

@Entry
@Component
struct VoteCreatePage {
  @State question: string = '';
  @State options: VoteOption[] = [
    { id: 1, text: '' },
    { id: 2, text: '' }
  ];
  @State anonymous: boolean = false;
  @State remind: boolean = true;
  private nextId: number = 3;

  // 不可变添加:新数组替换
  addOption(): void {
    if (this.options.length >= MAX_OPTIONS) {
      promptAction.showToast({ message: '最多 ' + MAX_OPTIONS + ' 个选项' });
      return;
    }
    this.options = this.options.concat([{ id: this.nextId, text: '' }]);
    this.nextId++;
  }

  // 不可变删除:filter 生成新数组
  removeOption(id: number): void {
    if (this.options.length <= MIN_OPTIONS) {
      promptAction.showToast({ message: '至少保留 ' + MIN_OPTIONS + ' 个选项' });
      return;
    }
    this.options = this.options.filter((o: VoteOption) => o.id !== id);
  }

  // 不可变编辑:map 替换单项
  editOption(id: number, text: string): void {
    this.options = this.options.map((o: VoteOption) => {
      if (o.id === id) {
        return { id: o.id, text: text };
      }
      return o;
    });
  }

  publish(): void {
    if (this.question.trim() === '') {
      promptAction.showToast({ message: '请填写投票主题' });
      return;
    }
    const empty: boolean = this.options.some((o: VoteOption) => o.text.trim() === '');
    if (empty) {
      promptAction.showToast({ message: '选项内容不能为空' });
      return;
    }
    promptAction.showToast({ message: '投票已发布' });
  }
}

第二段是 UI:条目键值用 id,transition 只挂在条目根节点做插入动画。

@Component
struct OptionRow {
  option: VoteOption = { id: 0, text: '' };
  canRemove: boolean = true;
  onEdit: (id: number, text: string) => void = () => {};
  onRemove: (id: number) => void = () => {};

  build() {
    Row({ space: 10 }) {
      Text('选项 ' + this.option.id)
        .fontSize(12).fontColor('#C2185B')
        .width(46)
      TextInput({ placeholder: '输入选项内容', text: this.option.text })
        .height(42).layoutWeight(1)
        .backgroundColor('#F7F7F7').borderRadius(8)
        .onChange((v: string) => {
          this.onEdit(this.option.id, v);
        })
      Text('×')
        .fontSize(18).fontColor(this.canRemove ? '#999999' : '#DDDDDD')
        .width(30).height(30).textAlign(TextAlign.Center)
        .borderRadius(15).backgroundColor('#F2F2F2')
        .onClick(() => {
          if (this.canRemove) {
            this.onRemove(this.option.id);
          }
        })
    }
    .width('100%')
    // transition 只作用于本条目:插入时淡入上移
    .transition(TransitionEffect.OPACITY
      .combine(TransitionEffect.translate({ y: 12 })))
  }
}

@Component
struct VoteCreateView {
  @State question: string = '';
  @State options: VoteOption[] = [
    { id: 1, text: '' },
    { id: 2, text: '' }
  ];
  @State anonymous: boolean = false;
  @State remind: boolean = true;
  private nextId: number = 3;

  build() {
    Scroll() {
      Column({ space: 14 }) {
        Text('发起投票').fontSize(20).fontWeight(FontWeight.Bold).width('100%')

        Column({ space: 8 }) {
          Text('投票主题').fontSize(14).fontColor('#666666')
          TextInput({ placeholder: '例如:周末去哪玩', text: this.question })
            .height(44).width('100%').borderRadius(8).backgroundColor('#F7F7F7')
            .onChange((v: string) => { this.question = v; })
        }.alignItems(HorizontalAlign.Start).width('100%')

        Column({ space: 10 }) {
          Text('选项(2-8 个)').fontSize(14).fontColor('#666666')
          ForEach(this.options, (o: VoteOption) => {
            OptionRow({
              option: o,
              canRemove: this.options.length > MIN_OPTIONS,
              onEdit: (id: number, text: string) => {
                this.options = this.options.map((x: VoteOption) => {
                  if (x.id === id) {
                    return { id: x.id, text: text };
                  }
                  return x;
                });
              },
              onRemove: (id: number) => {
                if (this.options.length <= MIN_OPTIONS) {
                  promptAction.showToast({ message: '至少保留 ' + MIN_OPTIONS + ' 个选项' });
                  return;
                }
                this.options = this.options.filter((x: VoteOption) => x.id !== id);
              }
            })
          }, (o: VoteOption) => o.id.toString())

          Button('添加选项')
            .width('100%').height(40).borderRadius(8)
            .backgroundColor('#FCE4EC')
            .fontColor('#C2185B')
            .onClick(() => {
              if (this.options.length >= MAX_OPTIONS) {
                promptAction.showToast({ message: '最多 ' + MAX_OPTIONS + ' 个选项' });
                return;
              }
              this.options = this.options.concat([{ id: this.nextId, text: '' }]);
              this.nextId++;
            })
        }
        .alignItems(HorizontalAlign.Start)
        .width('100%').padding(14).borderRadius(12).backgroundColor('#FFFFFF')

        Column({ space: 10 }) {
          Row() {
            Column({ space: 2 }) {
              Text('匿名投票').fontSize(15).fontColor('#333333')
              Text('开启后不显示投票人').fontSize(11).fontColor('#AAAAAA')
            }.alignItems(HorizontalAlign.Start)
            Blank()
            Toggle({ type: ToggleType.Switch, isOn: this.anonymous })
              .selectedColor('#C2185B')
              .onChange((v: boolean) => { this.anonymous = v; })
          }.width('100%')
          Divider().color('#F5F5F5')
          Row() {
            Text('截止提醒').fontSize(15).fontColor('#333333')
            Blank()
            Toggle({ type: ToggleType.Switch, isOn: this.remind })
              .selectedColor('#C2185B')
              .onChange((v: boolean) => { this.remind = v; })
          }.width('100%')
        }
        .width('100%').padding(14).borderRadius(12).backgroundColor('#FFFFFF')

        Button('发布投票')
          .width('100%').height(46).borderRadius(10)
          .backgroundColor('#C2185B')
          .onClick(() => {
            if (this.question.trim() === '') {
              promptAction.showToast({ message: '请填写投票主题' });
              return;
            }
            const empty: boolean = this.options.some((o: VoteOption) => o.text.trim() === '');
            if (empty) {
              promptAction.showToast({ message: '选项内容不能为空' });
              return;
            }
            promptAction.showToast({ message: '投票已发布' });
          })
      }
      .padding(16)
      .width('100%')
    }
    .align(Alignment.Top)
    .width('100%').height('100%')
    .backgroundColor('#FBF7F9')
  }
}

49 创建页校验 Toast

图:发布校验提示。空选项校验在提交时执行,输入路径零负担。

49 创建页完整视图

图:创建页完整视图。增删操作只影响目标条目,其余条目实例与编辑态原样保留。

四、性能对比与验证方法

测量条件:中端真机,HarmonyOS 5.0 SDK(API 12),从 2 个选项增到 8 个再删回 2 个为一次循环,重复 30 次取中位数;串位验证用"第 4 框输入文字后删除第 2 项"的固定用例。以下为示例实测值,非设备基准数据,需在目标机型复测。

指标优化前(push+index 键)优化后(不可变+id 键)变化幅度
添加一次触发的节点重建0-8 个(不确定)1 个(新条目)确定性 100%
删除中间项的编辑态串位必现无消除
删除一次触发的属性 diff约 4 条0 条(其余不动)-100%
增到 8 项累计耗时22ms9ms-59%
插入动画掉帧2 帧0 帧-100%
循环压测内存增长+1.8MB+0.1MB-94%

反直觉结论:去掉删除动画后,用户测试的主观流畅评分反而更高——退出动画的 200ms 延迟删除窗口让"删除"这个意图的确认变慢,表单场景下用户更偏好即时消失。另一个观察是 push 不刷新界面的问题在 Debug 模式下有时"看起来正常"(热重载补了一帧),Release 包才稳定复现,这类问题必须用 Release 包验证。串位 bug 是功能缺陷但根因是 diff 键值,修复后编辑态保留让"删错重输"场景的用户输入损失降为零。验证方法:固定用例自动断言串位;hiTrace 对比增删循环的节点创建/销毁计数与业务预期一致;Memory 视图确认循环压测无泄漏。

五、优化建议与工程化落地

第一,团队规范写死三条:@State 数组增删改必须新引用替换;输入框列表键值必须业务 id;transition 只挂条目根节点。第二,封装 DynamicListController 工具类,提供 immutableAdd/immutableRemove/immutableEdit 三个方法,业务方不再手写 concat/filter/map,杜绝手滑写出可变操作。第三,上下限(MIN/MAX)校验放在操作入口而非动画后,提前拦截避免无效渲染。第四,删除动画按场景分级:表单列表不做退出动画,信息流列表可做 150ms 淡出,延迟删除窗口内冻结该条目的交互。第五,TextInput 的 onChange 直接 editOption 整表替换在长列表(几十项)时会放大 diff,选项数超过 10 个的页面应改为编辑延迟合并(同勾选合并模式)。第六,发布校验与上限校验的 Toast 文案统一收口到常量,避免各处不一致。

图:全篇配图收尾。三段实现与两轮实测共同支撑本篇的性能结论。

六、总结:HarmonyOS 应用性能优化的不可变纪律

动态增删列表的性能与正确性,是同一枚硬币的两面:不可变更新让 diff 边界清晰,键值让实例复用精确,前者管性能后者管正确,但都指向同一个纪律——把"变化"表达为数据的新版本,而不是旧对象的修改。选项数组从 push 到 concat 的一行改动,同时消灭了不刷新、串位、重建三个问题。当列表可以增删时,先想清楚每个条目的身份用什么标识,再想清楚每次操作生成什么样的新数组,剩下的交给框架。

Logo

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

更多推荐