鸿蒙 ArkTS 实战Coupon Distribution 从优惠券发放到店铺经营工具完整解析前言Coupon Distribution 是一个基于鸿蒙 ArkTS 与 ArkUI 声明式 UI 实现的店铺经营类单页应用核心场景是优惠券领取与核销。它把 维护优惠券码、领取数量、使用数量、过期提醒和核销状态 这类高频经营动作拆成可编辑状态、可点击按钮、可视化卡片和即时结果反馈。本文围绕项目真实的Index.ets源码展开分析它如何使用State管理页面数据如何用TextInput、Button、Row、Grid和Scroll组织移动端界面以及如何通过少量业务函数完成经营闭环。图示说明配图用于说明鸿蒙应用里状态、组件和事件反馈之间的关系帮助理解本文的代码拆解。阅读时可以结合 HarmonyOS 应用开发文档、ArkTS 语言基础、ArkUI 声明式开发范式、组件参考 等资料快速定位 ArkTS、ArkUI 和组件开发相关知识。店铺经营工具的质量不只看页面是否好看更要看一次经营动作能否被准确记录、即时反馈并方便继续追踪。一、项目定位与经营场景1.1 业务定位优惠券发放 聚焦的场景是维护优惠券码、领取数量、使用数量、过期提醒和核销状态。这类工具适合小店、摊位、私域运营、批发报价和预售管理等轻量经营场景。用户打开页面时需要立刻看到当前状态并能用最少步骤完成更新。1.2 技术定位项目采用鸿蒙 ArkTS 单页写法页面内直接声明状态和交互函数。这种实现方式非常适合 MVP、教学案例和低成本原型验证。1.3 用户操作闭环页面的操作闭环可以概括为四步。查看当前经营数据。修改商品、客户、价格或计划等字段。点击按钮触发业务动作。在当前页面看到数量、状态或文案变化。二、工程结构与入口页面2.1 页面文件项目核心逻辑集中在Index.ets。entry/ src/ main/ ets/ pages/ Index.ets这个入口页面同时承担状态声明、事件处理和 UI 渲染。2.2 组件声明EntryComponentstruct Index{build(){// 声明式页面结构}}这是鸿蒙 ArkUI 开发中最基础也最直观的页面结构。2.3 单页边界当前版本没有引入本地数据库、远程接口或多页面路由。它先把单个经营动作做完整再为后续扩展留下空间。三、状态模型拆解3.1 状态字段总览状态字段初始值页面职责couponC2026SAVE10优惠券码claimed86领取数量used31使用数量expireExpires in 5 days过期提醒statusTextCoupon pool active.核销状态这些字段共同构成了 优惠券发放 的最小业务模型。3.2 状态语义coupon通常代表页面的主业务对象statusText则承载数量、结果、状态或反馈。字段命名直观是这类小项目可维护性的关键。3.3 核心源码片段Statecoupon:stringC2026SAVE10;Stateclaimed:number86;Stateused:number31;Stateexpire:stringExpires in 5 days;StatestatusText:stringCoupon pool active.;gen():void{this.claimed;this.couponC(20260000this.claimed);}use():void{this.used;this.statusTextCoupon verified: this.coupon;}这段代码展示了项目最核心的数据结构和动作函数。状态变化后页面中引用这些状态的组件会自动刷新。四、交互逻辑分析4.1 交互点总览交互点源码行为业务价值genclaimed 自增并按 claimed 生成新券码让经营动作立即形成可见结果useused 自增并把 coupon 写入核销状态让经营动作立即形成可见结果Generate Code/Verify生成券码与核销优惠券让经营动作立即形成可见结果每个交互点都对应一个真实经营动作。4.2 输入框同步TextInput通过onChange将用户输入同步到状态。TextInput({text:this.coupon,placeholder:优惠券码}).onChange((v:string)this.couponv)这种写法适合字段数量不多、反馈要求快速的页面。4.3 按钮更新状态按钮事件通常只做一个明确动作。Button(Update).width(100%).onClick((){this.statusTextthis.coupon;})动作短反馈明确用户就不容易迷路。五、布局结构分析5.1 页面布局概览顶部券码大卡突出当前 coupon中部并列展示领取和使用数量底部处理生成和核销。布局会优先展示核心经营数据然后再提供编辑和操作入口。5.2 关键 UI 代码Row({space:10}){Text(Claimed\nthis.claimed).layoutWeight(1).padding(16).backgroundColor(#DBEAFE)Text(Used\nthis.used).layoutWeight(1).padding(16).backgroundColor(#DCFCE7)}这段代码体现了项目最有代表性的视觉结构。5.3 Scroll 的必要性经营工具经常包含多个输入字段。Scroll(){Column({space:16}){// 输入区、卡片区、按钮区和结果区}.padding(20).width(100%)}滚动容器能保证小屏设备上的完整可操作性。六、视觉层级设计6.1 背景与强调色当前页面背景色是#FFFFFF强调色是#FEF3C7。强调色用于突出经营指标、核心卡片或状态提醒。6.2 信息分区区域视觉方式作用顶部看板大字号或高对比背景快速识别主状态表单区输入框维护经营字段指标区Row 或 Grid展示数量、金额和状态反馈区说明文本复述操作结果6.3 数字信息突出库存、销售额、领取数、成本、报价、评分和人数都需要更强视觉权重。Text(this.count.toString()).fontSize(54).fontWeight(FontWeight.Bold)这样用户可以在移动端快速扫读关键指标。七、数据计算与边界控制7.1 自增和扣减经营工具常见自增字段包括完成数、发送数、导出数、领取数和预售人数。this.count;库存和天数则需要扣减。this.stockMath.max(0,this.stock-1);7.2 条件判断新品上架、价保申请和批发报价都依赖条件判断。constreadythis.score80Number(this.cost)10;条件要直接表达业务规则避免让页面逻辑变得晦涩。7.3 金额计算成本、报价和建议售价都需要数字转换。constnNumber(this.priceText);constsafeNumber.isNaN(n)?0:n;真实业务中可以进一步处理小数、币种和空值。八、输入体验优化8.1 数字输入价格、成本、退款、数量和定金适合使用数字输入。TextInput({text:this.amount,placeholder:Amount}).type(InputType.Number)数字键盘能降低输入错误。8.2 文本输入任务、模板、原因、物流、素材和批次适合普通文本输入。这些字段更偏说明性质格式不宜限制过死。8.3 反馈文案反馈文案应该包含关键字段。constmessagethis.coupon updated: this.statusText;这样用户能确认操作对应的是哪条记录。九、组件能力映射9.1 常用组件表组件项目用途特点Text展示标题、金额、状态轻量直接TextInput维护业务字段输入灵活Button触发经营动作行为明确Row并列展示指标适合看板Grid展示多个业务卡片适合概览Scroll承载多字段表单适合小屏9.2 layoutWeight 使用Row({space:10}){Text(Main).layoutWeight(2)Text(Count).layoutWeight(1)}通过权重可以让主信息占更多空间。9.3 卡片样式Text(Card).padding(16).backgroundColor(#FEF3C7).borderRadius(8)卡片化让运营信息更容易被理解和比较。十、可扩展数据模型10.1 经营记录对象interfaceBusinessRecord{id:string;title:string;status:string;count:number;updatedAt:number;}这个对象可以承载一次经营动作。10.2 历史列表Staterecords:BusinessRecord[][];从单条状态扩展为数组后页面就能支持历史记录。10.3 追加记录this.records[...this.records,{id:Date.now().toString(),title:this.coupon,status:String(this.statusText),count:1,updatedAt:Date.now()}];不可变追加方式有利于 UI 刷新。十一、本地存储与同步11.1 持久化必要性店铺经营数据通常需要长期保存。拍摄任务、退换记录、价保提醒、报价、收银、优惠券、成本和预售名单都不能只停留在内存中。11.2 保存结构interfaceSavedBusinessState{current:BusinessRecord;history:BusinessRecord[];version:number;}version可以支持后续字段升级。11.3 同步配置示例{module:business,sync:true,retry:3}后续接入后台时可以基于这个思路扩展同步策略。十二、调试与验证12.1 验证状态变化Button(Debug).onClick((){console.info(current: this.coupon);})先确认状态变化再检查页面展示。12.2 验证边界条件场景风险处理方式库存扣减低于 0使用Math.max评分增加过高设置上限成本计算输入为空使用安全数字转换排期倒计时低于 0设置下限12.3 验证小屏布局小屏设备上要重点观察输入框、按钮和卡片是否拥挤。长文本字段适合放入Scroll中避免遮挡操作按钮。十三、工程化拆分13.1 抽离指标卡BuilderfunctionMetricCard(label:string,value:string,color:string){Column({space:6}){Text(label).fontSize(14).fontColor(#6B7280)Text(value).fontSize(20).fontWeight(FontWeight.Bold)}.padding(16).backgroundColor(color).borderRadius(8)}指标卡可以复用到数量、金额、库存、评分和状态展示。13.2 抽离计算函数exportfunctiontoSafeNumber(value:string):number{constnNumber(value);returnNumber.isNaN(n)?0:n;}报价、成本和退款计算都可以复用它。13.3 抽离主题constTheme{pageBg:#FFFFFF,accent:#FEF3C7,radius:8,padding:20};主题配置能让多个经营页面保持统一。十四、业务扩展方向14.1 商品素材中心商品拍摄、修图和详情页素材可以扩展成素材中心。14.2 订单服务中心退换货、价保、优惠券和预售可以组成订单服务中心。14.3 经营分析中心收银、报价、成本和群发效果可以扩展为经营分析中心。interfaceBusinessModule{name:string;enabled:boolean;count:number;}十五、发布级技术亮点15.1 场景具体优惠券发放 的字段和按钮都围绕 优惠券领取与核销 展开。读者能从源码直接看到真实经营流程。15.2 反馈及时每次点击都会修改一个可见状态。这让移动端操作更安心。15.3 扩展自然当前项目可以继续扩展历史记录、本地持久化、接口同步、数据统计和权限控制。对店铺经营工具来说先让一次操作可见、可控、可追踪再扩展复杂系统是更稳的工程路线。十六、总结Coupon Distribution 展示了鸿蒙 ArkTS 在 优惠券领取与核销 场景中的单页工具实现方式。它用State保存经营数据用TextInput接收输入用Button触发业务动作再通过卡片、数字和文本反馈结果。从技术角度看它覆盖了状态管理、输入绑定、按钮事件、条件判断、数字计算和移动端布局。从产品角度看优惠券发放 把 维护优惠券码、领取数量、使用数量、过期提醒和核销状态 变成了一个可以直接使用的轻量经营工具。相关资源HarmonyOS 应用开发文档ArkTS 语言基础ArkUI 声明式开发范式