鸿蒙 ArkTS 实战Spice Encyclopedia 从香料百科到餐厨体验工具完整解析前言Spice Encyclopedia 是一个用鸿蒙 ArkTS 实现的餐厨体验工具主题聚焦香料名称、菜系匹配、用量建议、库存克数和低库存提醒。它把家庭厨房、饮食记录、外出就餐和口味管理中的一个小问题拆成输入、按钮动作、指标和反馈文案。本文直接基于项目Index.ets源码展开分析状态字段、输入组件、业务函数、反馈设计和后续扩展方式形成一篇可以直接发布的技术文章。餐厨类工具很适合做成单页应用一个场景、几个输入、一个关键动作加上一句明确反馈就能解决真实生活里的小麻烦。配图可用于文章首屏。正式发布时可以替换为项目真机截图展示输入区域、指标展示和操作反馈。一、项目定位与业务场景1.1 应用定位用户记录香料适配菜系、推荐用量和库存使用香料后扣减库存并提示是否需要补货。这个项目的优点是目标很集中没有复杂页面跳转所有核心动作都可以在一个页面内完成。1.2 使用价值价值说明页面体现快速记录把饮品、菜品、技能、偏好写下来TextInput即时反馈点击按钮后马上看到结果状态文案指标沉淀用次数、评分、库存、照片表达进度Stock grams后续复用支持再次查看和调整状态字段二、源码入口与结构2.1 入口组件项目入口是标准 ArkTS 页面。EntryComponentstruct Index{build(){Scroll(){Column({space:16}){Text(Spice Encyclopedia)}}}}2.2 页面结构页面主要分为标题区展示Spice Encyclopedia。输入区承接用户填写。指标区展示Stock grams。按钮区触发保存、记录、推荐或计时。反馈区显示最终说明。三、状态模型抽象3.1 模型设计从源码可以抽象出SpiceProfileState。typeSpiceProfileState{name:string;detail:string;metric:string|number;message:string;};3.2 实际状态代码项目真实状态如下。Statespice:stringCumin;Statecuisine:stringGrill, noodles;Stateamount:string1 tsp per 500g;Statestock:string25;3.3 状态职责表状态类型职责spice状态字段支撑香料百科的输入、记录或反馈cuisine状态字段支撑香料百科的输入、记录或反馈amount状态字段支撑香料百科的输入、记录或反馈stock状态字段支撑香料百科的输入、记录或反馈note状态字段支撑香料百科的输入、记录或反馈状态字段与页面控件一一对应方便从 UI 反查逻辑也方便从逻辑定位页面表现。四、默认数据与首屏体验4.1 默认内容默认项字段含义Cuminspice默认香料Grill, noodlescuisine默认适配菜系4.2 默认值意义默认值不是随便填的占位符。它让用户一打开页面就知道工具在做什么也让开发者能立刻验证按钮动作。默认输入提示业务格式。默认指标让页面更完整。默认反馈引导用户下一步。五、核心业务函数5.1 主函数代码项目核心业务函数如下。useSpice():void{letleftMath.max(0,Number(this.stock)-2);this.stockleft.toString();this.noteleft8?Low stock for this.spice:this.spice fits this.cuisine;}5.2 操作流程输入香料名称记录适配菜系填写用量建议使用后更新库存和提示这条路径完成了从用户输入到页面反馈的核心闭环。六、辅助动作与反馈6.1 辅助代码项目还包含辅助动作或展示逻辑。Text(this.amount).fontSize(15).fontColor(#6B7280)6.2 辅助动作价值动作类型价值对应体验保存保留配方、档案、记录便于复用追加增加照片、次数、分数形成积累提醒生成风险或低库存提示降低遗漏推荐根据偏好生成菜单辅助决策七、输入组件分析7.1 文本输入输入框用onChange同步状态。TextInput({text:this.spice,placeholder:Input value}).onChange((value:string)this.spicevalue)7.2 数字输入对于成本、库存、温度、评分、分钟等字段常见处理是字符串转数字。constvalueNumber(text);if(Number.isNaN(value)){// keep previous result or show a friendly message}数字输入在这类工具里很关键因为它直接影响指标可信度。八、指标展示策略8.1 核心指标当前页面的关键指标是Stock grams。Text(Stock grams value).fontSize(24).fontWeight(FontWeight.Bold)8.2 指标类型类型示例作用次数photos、practices、reuseCount表达积累评分score、dishScore支持复盘库存stock、minutes管理资源文案showCard、menu、note输出决策九、反馈文案设计9.1 文案更新页面通过状态字段更新反馈。this.noteAction saved.;this.statusResult updated.;9.2 文案标准标准说明包含对象说清楚记录的是哪一个饮品、菜品或成员包含结果说清楚次数、评分或提示发生了什么变化短而明确适合移动端快速扫读可继续行动让用户知道下一步可以做什么十、布局与视觉层次10.1 页面容器页面使用Scroll适合内容较多的表单工具。Scroll(){Column({space:16}){Text(Spice Encyclopedia)// form// metric// buttons// message}.padding(20).width(100%)}10.2 视觉顺序顺序内容目的1标题建立语境2输入框收集数据3指标呈现结果4按钮触发动作5文案解释状态十一、运行验证流程11.1 手工验证可以按下面流程验证打开页面确认标题为Spice Encyclopedia。查看默认输入是否正确显示。修改第一个输入框。点击主按钮。检查指标或反馈文案是否更新。// 手工验证伪代码constbeforedefault state;constactiontap main button;constaftermessage or metric updated;console.info(before - action - after);11.2 验证重点验证点预期输入同步状态随输入变化主函数执行按钮能触发逻辑指标更新数字或文案变化多次点击累计逻辑稳定文案可读结果清楚十二、边界情况处理12.1 常见边界餐厨工具常见边界包括库存小于 0、评分超过 5、联系人为空、成本不是数字等。constsafeScoreMath.min(5,Math.max(1,score));constsafeStockMath.max(0,Number(stock));12.2 业务边界场景风险处理方向过敏卡信息缺失外出展示不完整提醒补全联系人库存不足继续使用不合理显示低库存评分溢出数据不可信限制 1 到 5计时归零继续扣减无意义使用Math.max菜单推荐忌口遗漏优先过滤限制十三、扩展为完整应用13.1 业务扩展后续可以加入香料分类、风味标签、库存提醒、菜谱联动和采购清单。13.2 工程抽象可以抽象统一餐厨记录模型。interfaceFoodToolRecord{title:string;category:string;value:number;note:string;createdAt:number;}functioncreateFoodToolRecord(title:string,category:string,value:number,note:string):FoodToolRecord{return{title,category,value,note,createdAt:Date.now()};}十四、维护与优化14.1 状态集中当前项目规模适合把状态集中在页面组件里。后续如果加入历史记录或多个页面再拆分数据服务。14.2 函数职责函数应该保持单一动作保存、提交、计时、推荐、加分或扣减。functionformatResult(name:string,detail:string):string{returnname: detail;}14.3 用户体验反馈信息要放在按钮下方用户点击后能立刻看到变化。十五、工程复盘15.1 当前实现亮点状态字段与业务强相关。交互路径短。指标和文案反馈明确。代码适合继续扩展。适合作为 ArkTS 单页实践案例。15.2 可复用经验Spice Encyclopedia的实现思路可以复用到饮品、菜谱、探店、课程、库存、过敏卡和家庭口味管理等多个场景。关键是把复杂生活信息拆成几个稳定状态。总结Spice Encyclopedia用鸿蒙 ArkTS 实现了一个围绕香料百科的餐厨体验工具。它通过State管理输入和结果通过TextInput收集用户内容通过按钮触发业务函数再用指标和文案完成即时反馈。从工程角度看这个项目已经具备单页工具的完整闭环。继续加入历史记录、图片、模板、提醒或本地存储都可以沿着当前结构自然扩展。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。补充说明后续持久化时可以优先保存输入值、指标值、备注和创建时间。补充说明当前页面把餐厨场景拆成了清晰的状态、动作和反馈。补充说明指标展示让用户能快速判断一次操作是否已经记录完成。补充说明反馈文案是移动端体验的重要部分能减少用户反复确认。相关资源HarmonyOS 开发者官网ArkTS 语言基础ArkUI 组件开发