账本状态设计-04:HarmonyOS 编辑草稿与费用提交的分离【共创稿事节】
this.draftAmount = money(this.expense.cents);
这行代码刻意复制的是金额的文本表示,而不是让输入框直接修改费用对象。用户尚未按下保存时,输入中的“四十八元”只是一个候选值;已经确认的午餐费用仍是三十八元。让两者各自存在,取消操作才有明确含义,输入错误也不会污染账本。

一、先定义三个状态,再谈输入框
PocketLedger 前三篇解决了事实归属、组件通信和监听路径。现在加入一个真正的编辑动作:修改午餐名称与金额,保存后写入费用,取消则维持原值。继续使用第一篇的 Expense 模型,编辑页面临时替换首页,不改变费用标识。这里不增加远端保存,提交指当前页面会话中的确认。
页面只有查看、编辑和编辑错误三种可见情况。查看时展示已保存的费用;进入编辑时从事实建立草稿;校验失败时保留草稿与输入框,让用户修正。错误不是另一份业务数据,也不能触发自动提交。保存成功或者取消后才回到查看状态,用户能够明确判断自己处在哪一步。
草稿使用字符串,是因为输入过程并不总能表示为合法金额。例如只输入一个小数点、删除全部字符或者暂时输入三位小数,都是编辑过程中会出现的内容。若每次变化就立刻转为数字,空串可能被转换成零,格式信息也会消失,导致界面替用户做出未经确认的决定。
编辑标记也不是装饰性的开关。它决定哪些操作此时有效,所以保存方法先检查是否处于编辑状态。即使未来事件连接发生变化,意外调用保存也不会拿上一次草稿覆盖费用。界面条件可以减少错误操作,方法本身仍应守住状态前提,两层约束相互配合。
这里沿用 API 12 的状态管理第二版。已确认对象通过 @ObservedV2 与 @Trace 参与显示,草稿文本及编辑标记归页面的 @Local 管理。没有新增权限或外部依赖。输入框与按钮采用系统组件,样式只用于区分已保存区域和待提交区域,不承担业务正确性的保证。
二、解析函数只接受明确的金额格式
先在 entry/src/main/ets/common/AmountInput.ets 中新增解析函数。它接受非负十进制金额,最多两位小数,允许前后空白,最终返回整数分。格式错误或范围不符时返回空值,让调用方明确决定错误提示。
// entry/src/main/ets/common/AmountInput.ets
import { validCents } from './Expense';
export function parseAmount(input: string): number | undefined {
const text: string = input.trim();
if (!/^\d{1,7}(\.\d{1,2})?$/.test(text)) {
return undefined;
}
const parts: string[] = text.split('.');
const whole: number = Number(parts[0]);
const decimal: string = parts.length === 2 ? parts[1] : '';
const cents: number = whole * 100 + Number(decimal.padEnd(2, '0'));
return validCents(cents) ? cents : undefined;
}
这里没有用输入数字乘一百再四舍五入,而是分别解析整数部分与两位以内的小数部分。既然产品已经限制两位小数,就不需要用舍入掩盖超出格式的输入。三位小数应当被拒绝,用户知道哪里需要改,比悄悄保存为另一个金额更容易理解。
正则先约束形态,公共函数再约束业务范围。科学计数法、负号、逗号分组和单独小数点都不属于本例接受的格式;前导零可以接受,因为保存后的金额会统一格式化。如果产品需要本地化货币输入,应重新定义分隔符与地区规则,不能在这条规则后随意添加字符替换。
输入字段采用普通文本键盘,是为了完整示例这些校验分支。若后续切换为带小数点的键盘样式,解析函数仍要保留,因为粘贴、外部赋值和不同输入法都可能带来不同字符串。输入体验可以引导用户,业务入口仍必须独立判断收到的数据。
解析函数没有访问页面状态,因此可以独立检查边界样本。整数输入补足两位小数,一位小数补足末尾零,两位小数保持原意。检查时应直接比较返回的整数分,而不仅比较格式化后的文字;后者可能掩盖内部单位不一致的问题。对金额逻辑而言,内部表示正确比表面显示相似更关键。
三、保存之前不触碰原对象
将下面代码放入 pages/Index.ets。beginEdit 建立草稿,save 完整校验后写入两个属性,cancel 关闭编辑而不修改费用。名称规则为去除首尾空白后非空且长度不超过二十;这里使用字符串长度判断,涉及表情等复杂字符时应另行确定字符计数规则。
// entry/src/main/ets/pages/Index.ets
import { Expense, money } from '../common/Expense';
import { parseAmount } from '../common/AmountInput';
@Entry
@ComponentV2
struct Index {
@Local expense: Expense = new Expense('meal1', '午餐', 3800);
@Local editing: boolean = false;
@Local draftTitle: string = '';
@Local draftAmount: string = '';
@Local message: string = '点击编辑修改费用';
beginEdit(): void {
this.draftTitle = this.expense.title;
this.draftAmount = money(this.expense.cents);
this.message = '草稿只在保存后生效';
this.editing = true;
}
save(): void {
if (!this.editing) {
return;
}
const title: string = this.draftTitle.trim();
const cents: number | undefined = parseAmount(this.draftAmount);
if (title.length === 0 || title.length > 20) {
this.message = '名称须为一至二十个字符';
return;
}
if (cents === undefined) {
this.message = '请输入范围内且最多两位小数的金额';
return;
}
this.expense.title = title;
this.expense.cents = cents;
this.editing = false;
this.message = '费用已保存';
}
cancel(): void {
this.editing = false;
this.message = '已取消,费用保持原值';
}
build() {
Column({ space: 18 }) {
Text('口袋账本').fontSize(28).fontWeight(FontWeight.Bold)
Text('费用编辑').fontSize(16).fontColor('#64748B')
Column({ space: 10 }) {
Text('已保存费用').fontColor('#64748B')
Text(this.expense.title).fontSize(22)
Text(`¥${money(this.expense.cents)}`).fontSize(32)
}.padding(24).width('100%').backgroundColor('#EAF2FF').borderRadius(20)
if (this.editing) {
TextInput({ text: this.draftTitle, placeholder: '费用名称' })
.onChange((value: string) => this.draftTitle = value)
TextInput({ text: this.draftAmount, placeholder: '金额,单位元' })
.type(InputType.Normal)
.onChange((value: string) => this.draftAmount = value)
Row({ space: 12 }) {
Button('保存').onClick(() => this.save())
Button('取消').onClick(() => this.cancel())
}
} else {
Button('编辑费用').onClick(() => this.beginEdit())
}
Text(this.message).fontColor('#64748B')
}.padding(24).width('100%').height('100%').backgroundColor('#F4F7FC')
}
}

校验全部完成后才开始赋值,避免出现名称已经更新、金额却被拒绝的半提交结果。对于这段同步页面逻辑,两个事实字段由同一保存入口处理;这不应被扩大解释为数据库事务或者跨线程原子性。未来增加持久化时,还需要明确存储失败后的恢复策略。
取消操作没有把草稿写回原对象,也不需要拿一个旧金额去“恢复”。因为原对象从未被草稿修改,取消只改变交互状态即可。重新进入编辑时,再从当前费用建立新的草稿,避免上一次未提交的文本意外出现。这个过程比先改原值、取消时再回滚更容易验证。
名称与金额同时提交,也意味着错误提示需要有稳定顺序。本例先检查名称,再检查金额,每次给出第一个阻塞问题。也可以一次显示多个字段错误,但应该使用独立的错误结构,而不是把不同错误挤进一段难以定位的长文字。校验反馈的组织方式可以调整,全部通过前不写事实这一原则应保持。
当前草稿不包含费用标识。标识来自正在编辑的费用对象,不允许通过普通输入框修改。否则用户改名时还可能顺手改变列表键、关联关系和撤销目标,编辑行为就超出了当前页面的职责。把业务身份与可编辑字段分开,能够让之后的保存和恢复都围绕同一笔记录展开。
四、逐条检查格式、提交与取消
先进入编辑,把金额从三十八改为四十八,不点击保存。上方已保存卡片应继续显示三十八元,输入框显示四十八。点击取消后,页面回到查看,费用仍是三十八。再次进入编辑,输入框应重新取到三十八,而不是残留被放弃的四十八。
然后输入合法名称与四十八元并保存,已保存卡片应显示新的值,输入区域关闭。再次编辑时,应从刚刚确认的值建立草稿。这个检查同时验证写入路径和下一次初始化路径,不能只看到一次保存成功就认为草稿生命周期完整。
错误路径至少覆盖空名称、仅空白名称、空金额、小数点结尾、三位小数、负数和超范围整数。发生错误后,输入区应保留,已保存卡片不变,提示说明拒绝原因。用户修正后应能直接再次保存,不需要退出页面或重新进入编辑。
金额为零也需要明确验证。本例允许零,所以输入零或零点零零都应得到零分。若业务要求费用必须大于零,应在保存入口增加条件,而不是利用真假判断拒绝所有等于零的数字。空值表示解析失败,零表示合法数值,二者不能混用。

验证过程中还要观察提示内容的生命周期。进入编辑会替换上一次结果提示,校验失败会给出具体原因,取消和保存会分别给出结果。提示并不决定费用是否已经写入,真实状态由对象与编辑标记共同表达。不要反过来通过判断提示字符串决定接下来允许什么操作。
另一个有用的检查是只修改名称而不修改金额,然后保存。费用金额必须保持原值,名称按去空白规则确认。再只修改金额,名称也应维持正确值。这两组检查能够发现草稿建立时漏复制字段、或者保存时从错误来源取值的问题,尤其适合在后续增加更多编辑字段时重复执行。
五、草稿隔离的价值在边界场景中体现
当编辑字段更多时,可以把草稿整理成专门的数据结构,但不要直接令草稿变量引用原对象。浅拷贝也并非通用解法:若费用以后包含嵌套分类或附件对象,浅拷贝后的内部引用仍可能共享。需要按字段语义建立独立草稿,并让提交过程显式提取需要确认的数据。
如果原费用可能在编辑期间被其他入口修改,当前实现还需要增加版本检查。本例没有这样的并发入口,因此不会假装已经解决冲突。实际产品可以在开始编辑时记录版本,保存时比较版本是否变化,再决定拒绝覆盖、重新载入或让用户选择。草稿隔离解决的是未提交修改,不会自动解决并发更新。
返回键与页面离开也是独立的产品选择。当前示例通过明确的取消按钮示例放弃草稿;若接入导航,需要决定有修改时是否确认离开,并把同一套清理规则连接到导航生命周期。不能只给保存按钮做对,却让其他退出路径悄悄提交或保留过期草稿。
如果希望显示“有未保存修改”,应比较草稿与进入编辑时的基准,而不是只要触发过输入事件就永久标脏。用户把四十八改回三十八时,数据可能已经回到基准。这个提示属于派生信息,不应再次成为需要各处同步的独立事实;复杂表单可以为它定义统一比较规则。
这个页面最终保留了两种合理的副本:已确认的事实与尚未确认的输入。它们拥有不同生命周期和修改规则,因此并不违反单一事实源的原则。真正需要避免的是让两份数据都声称自己已经代表最终费用。下一篇继续处理另一类值:从费用推导出来的总额与排序结果,什么时候值得缓存,什么时候应该保持普通计算。
官方参考
更多推荐

所有评论(0)