Electron 鸿蒙笔记应用实战:给每条笔记一个悬浮的删除按钮

删除一条笔记、确认一次操作、把选中态交还给列表——这三个动作在桌面端是"理所当然",在鸿蒙壳工程里却要一条条接回来。这篇文章用一个跑在鸿蒙 PC 上的 Electron 笔记应用,把删除按钮的交互实现、事件冲突的处理、以及删完之后数据怎么落盘这三个问题一次讲透。

欢迎加入开源鸿蒙PC社区:https://harmonypc.csdn.net/
欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper

0. 环境与实测设备

项版本/型号
设备HarmonyOS PC(aarch64)
系统 API26
Electron-OHv40.0.1(libelectron.so 预编译,178MB)
壳工程ohos_hap(electron / web_engine / account_quick_login 三模块)
应用形态HAP 内加载 Chromium + Node,前端跑在 resfile/resources/app/
本次改动范围仅渲染层 renderer.js + index.html + style.css,主进程零改动

先交代改动范围是有原因的:这一轮的删除功能,没有写一行 ArkTS,没有动 IPC 协议。因为账号存储那篇里已经定了"全量保存"模型——notes:save 收的是整个笔记数组——删除只是数组里少一个元素,保存链路原样复用。这个决定省掉的不只是代码量,省掉的是一整类"删了但没删干净"的同步 bug。

1. 列表上没有删除按钮——这个问题是怎么找上我的

应用第一版跑起来之后,我把笔记本给我媳妇用了一天。拿回来的时候她提了一个需求:“写错的笔记怎么删?”

我打开应用看了看,确实没有。第一版做的是"写"的完整闭环:新建、编辑、防抖保存、落盘提示。删除这个动作,我当时在心里排了个优先级:它不产生新数据、不涉及新存储格式、不碰 IPC,是"随时能加"的功能——然后就一直没加。

这里有个开发者很容易犯的排序错误:我把"实现成本低"当成了"优先级低"。对一个笔记应用来说,删除不是锦上添花,是数据生命周期的另一半。只进不出的数据模型,用一周之后列表就会变成垃圾场,用户对"保存"的信任也会跟着贬值——因为没人敢保证写进去的东西能删掉。

所以这个题目的边界很清楚:在渲染层补全删除交互,不动存储格式、不动 IPC 协议、不引入主进程改动,删完的数据通过已有的全量保存落盘。

拆下来是三件事:

  • 列表条目上做一个悬浮出现的删除按钮,不能打扰正常的选择交互;
  • 点击删除要有确认,且确认动作不能误触选中;
  • 删的是当前打开的笔记时,选中态要有明确的去处,编辑器不能留着一个已删除笔记的残影。

下面是干完之后的完整记录,包括我踩的每一个坑。

2. 按老规矩,先给效果再讲原理

请添加图片描述

图1 悬浮态:鼠标停在某条笔记上,右上角的 × 才出现

交互是这样的:鼠标移到列表条目上,右上角浮现一个 ×;点它,弹确认框;确认后这条笔记从列表里消失,数据同步落盘。鼠标不在条目上时,那个 × 完全不可见——列表的日常浏览体验和没有删除按钮时一模一样。

这里每一处都不是装饰:

  • × 默认 opacity: 0:列表是高频浏览区域,二十条笔记就摆二十个删除按钮,等于在每条数据旁边放二十个"危险动作"入口。悬浮才出现,把误触概率压到接近零;
  • 红色高亮:× 本身是灰色,悬浮到按钮上才变红底红字。颜色变化是第二层确认——用户的鼠标在走向删除的路上,视觉一直在提醒"你现在要做的是危险动作";
  • 确认框:弹窗确认看起来老派,但删数据这种不可逆操作,多这一步不吃亏。

请添加图片描述

图2 确认环节:确认框拦在删除动作和数据之间

一个要提前交代的边界:确认框用的是 window.confirm,这是 Chromium 的原生对话框。这个弹窗在鸿蒙壳工程里的具体表现我还没有真机验证过——壳工程的窗口系统是自绘的,原生对话框能不能正常弹出来、弹出来长什么样,要装上机才知道。如果它不弹,备选方案是列表内的两段式确认(点一下 × 变红,再点才真删),不依赖任何原生对话框。这个待验证项在第 5 节的坑里还会出现。

3. 原理:删除难点不在"删",在"删完之后"

朴素的理解是:删除嘛,notes = notes.filter(...) 一行代码的事。

第一版我也真是这么写的,然后马上遇到两个问题。一个是事件层面的:删除按钮嵌在列表条目 <li> 里面,<li> 自己挂了选中监听——点删除按钮,选中事件也跟着触发,表现为"删了这条笔记,编辑器却跳到了另一条":删除先执行,选中后执行,选中拿到的 id 已经不在数组里,于是列表渲染错乱。

另一个是数据层面的,比第一个隐蔽:删除之后保存什么?

这个应用的保存链路是"全量保存":notes:save 把整个 notes 数组序列化后发给主进程,主进程整文件覆盖写。这个模型当初是为了绕开 hmdfs 不支持 SQLite 文件锁的问题定的(那次的排查在账号存储那篇里),它有一个直接推论:任何数据变更的最终形态都必须体现为一次全量保存。删除也不例外。如果删除后不保存,下次启动笔记又回来了——“删了但没删掉"这种 bug,用户报告上来的时候只会说"应用有鬼”。

所以删除的完整链路是四步,缺一不可:

确认 → 从数组移除 → 处理选中态 → 全量保存

删除是一个四步的事务,不是一个 filter 调用。 这是这个功能给我最大的认知修正。

还有一个设计决策值得单独说:删除当前笔记时,选中态自动交给列表里的下一条。不能让编辑器悬空——用户刚删完,界面上必须马上有"接下来在哪"的答案。如果删完那条之后这个分类下没有别的笔记了,就自动新建一条空的。这个"接住"动作看起来不起眼,它决定了删除是"流畅的操作"还是"一次小事故"。

4. 把代码讲透

4.1 悬浮按钮:三层样式的接力

/* style.css - 列表条目上的删除按钮 */

.note-del {
  position: absolute;
  top: 8px;
  right: 8px;
  width: 22px;
  height: 22px;
  border: none;
  border-radius: 6px;
  background: transparent;
  color: #7d8699;
  opacity: 0;                      /* 关键:默认完全不可见 */
  transition: opacity 0.12s ease;
}

#note-list li {
  position: relative;              /* 关键:为按钮提供定位上下文 */
}

#note-list li:hover .note-del {
  opacity: 1;                      /* 悬浮条目才亮出来 */
}

.note-del:hover {
  background: rgba(217, 48, 38, 0.18);
  color: #ff8a80;                  /* 悬浮按钮本身:红色警告 */
}

三个细节值得单独说。

第一,position: absolute 的锚点是 <li> 自己。 所以必须给 #note-list li 加 position: relative,否则按钮会向上找到最近的定位祖先——那可能是整个侧栏,× 会飞到列表区域外。这是 CSS 里最经典的"差一行定位上下文"事故,按钮不报错、不警告,只是出现在错误的位置。

第二,用 opacity 而不是 display: none。 两者都能让按钮消失,但 display: none 的元素不占布局空间,悬浮时按钮突然出现会把条目内容挤一下;opacity: 0 保留占位,出现和消失都是淡入淡出,不带动周围内容。视觉稳定性就是从这里来的。

第三,红色只在按钮自己的 hover 上。 条目 hover 是浅灰,按钮 hover 是红。用户的鼠标轨迹会依次经过这两种状态,颜色变化本身就是一条提示链:想删 → 提醒 → 执行。

4.2 事件冲突:stopPropagation 不是可选项

// renderer.js - renderList()(节选)

const del = document.createElement('button');
del.className = 'note-del';
del.textContent = '×';
del.title = '删除笔记';
del.addEventListener('click', (e) => {
  e.stopPropagation();             // 关键:别让删除触发选中
  if (!window.confirm('删除这条笔记?')) return;
  notes = notes.filter(x => x.id !== n.id);
  // ……选中态处理,见 4.3
});
li.appendChild(del);
li.addEventListener('click', () => selectNote(n.id));

请添加图片描述

<button> 嵌在 <li> 里,点击按钮时事件按 DOM 树向上冒泡,<li> 的选中监听必然收到。不加 stopPropagation(),每次删除都附带一次无效选中。

这里有一个容易想当然的地方:我以为把删除逻辑写在前面就能"抢先"处理。没用。冒泡的顺序由 DOM 结构决定,不由代码书写顺序决定——子元素的监听器永远先跑,父元素后跑,这是事件模型的物理规律,不归我排程。唯一的正规解法是在子元素里把冒泡掐断。

return 那一行也值得说:confirm 返回 false(用户点了取消)时直接返回,数组还没被改。删除的"确认"必须拦在数据变更之前,而不是删完再问"要撤销吗"。前者是设计,后者是补丁。

4.3 选中态的流转:删完之后光标去哪

// renderer.js - 删除按钮的 click 监听(节选)

notes = notes.filter(x => x.id !== n.id);
if (currentId === n.id) {
  const rest = visibleNotes();
  if (rest.length > 0) {
    selectNote(rest[0].id);        // 还有别的笔记:交给下一条
  } else {
    newNote();                     // 删空了:自动补一条新的
  }
}
api.save(notes).then(ok => updateStatus(ok)).catch(() => updateStatus(false));
renderList();

三个分支,每个都对应一种真实的用户场景:

场景处理用户看到什么
删的是别的笔记currentId 不变编辑器纹丝不动
删的是当前笔记,列表还有selectNote(rest[0].id)编辑器无缝切到下一条
删的是当前笔记,列表空了newNote()编辑器变成一张干净的空笔记

注意第 2 行用的不是 notes,是 visibleNotes()——带分类筛选后的可见列表。这是我差点踩错的地方:如果用户正筛着"工作"分类,删掉当前笔记后应该跳到"工作"的下一条,而不是"全部"列表的第一条(那条可能属于别的分类,跳过去等于替用户做了一次筛选项变更)。选中态的流转要尊重用户当前的视野。

api.save(notes) 这里没有走 flushSave(),是直接调用。原因:flushSave 会把当前编辑器内容写回"当前笔记",而此刻当前笔记可能刚被删掉,这个写回没有意义,甚至可能在极端时序下把编辑器的残影写回数组。删除后的保存必须是"保存这个数组本身",而不是"保存编辑器状态"。 这是全量保存模型下删除和编辑的一个本质区别:编辑是"改当前笔记再存",删除是"改数组再存"。

4.4 数据怎么落盘:一条复用的链路

// main.js - notes:save(未改动,此处列出只为说明删除如何复用它)

ipcMain.handle('notes:save', (_event, notes) => {
  if (!currentUser) throw new Error('未登录');
  if (!Array.isArray(notes)) {
    return false;
  }
  saveNotes(notes);
  return true;
});

请添加图片描述

主进程不知道"删除"这件事发生过。它收到的只是一个少了某个元素的数组,和一次普通的编辑保存没有任何区别。

这正是当初把保存模型定为"全量数组"的回报时刻:存储层不理解操作语义,只接收最终状态。删除、编辑、未来可能加的归档、拖拽排序,全都是同一个 IPC 通道、同一种落盘方式。新增一种数据操作的成本,被压到了渲染层的几行 JS。

代价也如实说:全量保存意味着每次保存都重写整个文件。笔记多了之后(几百条以上),每次防抖保存的序列化和写盘成本都会涨。当前规模下这不是问题,等哪天单用户笔记过千,这个模型就要换成增量或分文件——到时候删除功能一行代码都不用改,这就是"存储不理解语义"的另一个回报。

5. 我踩过的坑(每一条都有真实出处)

这一节可能是全文最值钱的部分。以下坑全部来自这次开发的真实记录。

坑一:删除按钮出现在列表区域外。 现象是 × 不在条目右上角,而是贴在侧栏的右上边缘。报错没有——CSS 不报错,按钮只是安静地站在错的位置。原因是 position: absolute 向上找定位祖先时,<li> 没有 position: relative,一路找到了外层容器。给 <li> 补上 relative 就归位了。absolute 定位的第一个问题永远是"锚点是谁",不是"样式对不对"。

坑二:点删除,编辑器却跳到了另一条笔记。 现象稳定复现:每次删除,编辑器都切走。排查时我盯着删除逻辑看了十分钟,没发现问题——因为问题根本不在删除逻辑里,在事件冒泡上。<li> 的选中监听在删除之后照常触发,拿着一个已删除的 id 去找笔记,列表渲染于是错乱。加一行 e.stopPropagation() 了事。嵌套交互元素时,先画一遍事件冒泡图,再写监听器。

坑三:删完重启,笔记又回来了。 现象是删除操作当场生效,重启应用后笔记完好如初。原因是我第一版只在"编辑内容"时挂了保存,删除分支只改了内存数组。全量保存模型下,任何不改数组的"删除"都是内存幻觉。补上删除后的 api.save(notes) 才真正闭环。

坑四:差点把编辑器残影写回数组。 这个坑没来得及变成事故,是代码评审时自己发现的:删除当前笔记后如果走 flushSave(),它会拿编辑器里残留的旧内容去写"当前笔记"——而当前笔记已经不在数组里了,currentNote() 返回 null,侥幸没写进去。但这个链路是靠 null 检查兜底的,不是靠设计。改成直接 api.save(notes) 之后,才把这条侥幸链路拆掉。靠兜底活着的代码,和没写的代码只差一次重构。

坑五:window.confirm 在鸿蒙壳工程里的表现待验证。 这条不是已发生的事故,是一个诚实的不确定项:Chromium 的原生对话框在标准 Electron 里没问题,但鸿蒙壳工程的窗口系统是自绘的,confirm 弹出来会是什么形态(系统弹层?自绘浮层?还是根本不弹),我没有真机证据。备选方案已经想好——两段式确认,不依赖原生对话框。没验证过的平台行为,在文章里就写"待验证",不写成"没问题"。

6. 现在怎么用:边界与收尾

删除功能全部在渲染层,接入到自己的项目里就是三段代码:style.css 里的按钮样式、renderList() 里的按钮构建、和那段四步的删除事务。前提只有一个——你的保存链路得能接收"最终状态"。如果你的应用是增量保存(每条笔记一个文件),删除要额外处理存储层的文件删除,那段逻辑在主进程里,不在渲染层。

硬限制列一下,免得读者踩到同一堵墙:

  • position: relative 必须挂在列表条目上,否则 absolute 按钮会飞;
  • 删除按钮必须 stopPropagation(),否则必然误触选中;
  • 删除当前笔记后,选中态要给"当前筛选视野内的下一条",不是全列表第一条;
  • 删除后的保存走 api.save(notes),不要走 flushSave();
  • window.confirm 在鸿蒙壳工程的表现待真机验证,要有不依赖原生弹窗的备选方案;
  • 删除是不可逆操作,确认拦在数据变更之前,不是事后撤销。
Logo

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

更多推荐