鸿蒙 ArkTS 实战Home Cleaning Booking 从上门保洁预约到生活服务工具完整解析前言Home Cleaning Booking 是一个基于鸿蒙 ArkTS 与 ArkUI 声明式 UI 实现的生活服务类单页应用核心场景是上门保洁服务排期。它把 维护服务项目、预约时段、地址备注、历史评分和确认预约动作 这类高频生活服务需求拆成状态字段、数组列表、预约选择、工单进度、费用计算和即时反馈。本文基于项目真实的Index.ets结构展开分析它如何使用State管理页面数据如何使用ForEach、Grid、Row、Column、Stack、Flex、Toggle、Button等组件构建移动端服务工具界面以及如何让用户在洗衣、保洁、理发、维修、搬运、跑腿和寄养场景里快速确认服务状态。图示说明配图用于表达鸿蒙应用中状态、组件、条件渲染和事件反馈之间的关系帮助理解本文的代码拆解。阅读时可以结合 HarmonyOS 应用开发文档、ArkTS 语言基础、ArkUI 声明式开发范式、组件参考 等资料快速定位 ArkTS、ArkUI 和组件开发相关知识。生活服务工具的核心不是堆叠复杂流程而是让预约、进度、费用和提醒都能在一屏里被用户看懂。一、项目定位与服务场景1.1 业务定位上门保洁预约 聚焦的场景是维护服务项目、预约时段、地址备注、历史评分和确认预约动作。这类工具适合社区服务、上门服务、维修工单、同城跑腿、搬家协助和宠物寄养等轻量业务。用户打开页面时需要立刻看到当前服务状态并能用最少步骤完成一次选择、确认或记录。1.2 技术定位项目采用鸿蒙 ArkTS 单页写法页面内直接声明状态、数组和交互逻辑。这种实现方式适合服务预约原型、教学案例和轻量业务工具。1.3 使用闭环页面的使用闭环可以概括为四步。查看当前服务对象、阶段或费用。选择服务项目、师傅、课程、设备或阶段。点击按钮触发预约、提醒、完成或费用变化。在当前页面看到状态、数量或费用更新。二、工程结构与入口页面2.1 页面文件项目核心逻辑集中在Index.ets。entry/ src/ main/ ets/ pages/ Index.ets这个入口页面同时承担状态声明、事件处理和 UI 渲染。2.2 组件声明EntryComponentstruct Index{build(){// 声明式页面结构}}这是鸿蒙 ArkUI 页面开发中非常基础的结构。2.3 单页边界当前版本没有引入复杂后端也没有把流程拆成多个页面。它先把单个服务场景做成清晰可用的一屏工具再为后续扩展留下空间。三、状态模型拆解3.1 状态字段总览状态字段初始值页面职责slot1当前服务索引rating5历史评分services日常保洁、深度厨房、玻璃清洁服务项目这些字段共同构成了 上门保洁预约 的最小服务模型。3.2 状态语义slot通常代表页面主状态services则承载列表、结果、开关或当前反馈。字段命名贴近服务场景是这类小工具可维护性的关键。3.3 核心源码片段Stateslot:number1;Staterating:number5;privateservices:string[][日常保洁,深度厨房,玻璃清洁];这段代码展示了项目最核心的数据结构。这一批项目更强调数组渲染、服务选择、阶段切换、费用估算和按钮反馈。四、交互逻辑分析4.1 交互点总览交互点源码行为服务价值ForEach services渲染服务列表并点击更新 slot让预约、工单或服务状态即时可见确认预约rating 小于 5 时递增让预约、工单或服务状态即时可见排期卡片展示预约日期和时间段让预约、工单或服务状态即时可见每个交互点都对应一个真实生活服务动作。4.2 列表选择很多项目使用ForEach渲染数组。ForEach(this.items,(item:string,index:number){Row(){Text(item)}.onClick((){this.selectedindex;})})列表项点击能让用户在多个服务对象之间快速切换。4.3 条件展示页面会根据状态显示不同内容。Text(this.done?已完成:进行中)条件展示能让用户快速理解当前工单状态。五、布局结构分析5.1 页面布局概览左侧服务项目列表右侧展示预约排期、地址备注、历史评分和确认按钮。布局会优先展示核心服务状态然后再提供操作入口。5.2 关键 UI 代码ForEach(this.services,(item:string,index:number){Text(item).fontWeight(FontWeight.Bold).backgroundColor(this.slotindex?#2D6A4F:#D8F3DC).onClick((){this.slotindex})})这段代码体现了项目最有代表性的视觉结构。5.3 Grid、Flex 与 Row 的组合Grid适合多卡片概览Flex适合换行标签Row适合左右分栏或同一行指标。Grid(){GridItem(){Text(服务一)}GridItem(){Text(服务二)}}生活服务页面常用这种组合展示师傅、课程、阶段、设备和状态。六、视觉层级设计6.1 背景与强调色当前页面背景色是#F7FFF7强调色是#2D6A4F。强调色用于突出服务进度、预约状态、费用、师傅选择或完成按钮。6.2 信息分区区域视觉方式作用顶部看板大字号或高对比背景快速识别主状态列表区ForEach 渲染展示服务项目和流程操作区Button、Toggle、Grid完成预约和确认反馈区Text 文案说明当前状态6.3 费用信息突出服务类页面通常需要让费用足够醒目。Text(费用 String(this.fee)).fontSize(34).fontWeight(FontWeight.Bold)费用和阶段状态应该比说明文字更容易扫到。七、数组渲染与状态选择7.1 ForEach 的价值数组渲染让服务对象可以稳定扩展。privateitems:string[][项目一,项目二,项目三];后续新增服务阶段、清单项、师傅、设备、课程或喂养要求时只需要扩展数组。7.2 当前索引Stateselected:number0;索引用来表示当前选中项。它适合订单阶段、服务项目、理发师、维修阶段和设备类型。7.3 条件样式.backgroundColor(indexthis.selected?#0B7285:#FFFFFF)条件样式能让当前选中项一眼可见。八、按钮、开关和服务确认8.1 Button按钮适合明确动作。状态提醒。确认预约。发送提醒。预约清洗。完成确认。追加费用。报名一位。按钮文案要短动作要明确。8.2 ToggleToggle适合表达二元状态。Toggle({type:ToggleType.Checkbox,isOn:this.enabled}).onChange((on:boolean)this.enabledon)用车需求、预约提醒和服务开关都适合它。8.3 费用计算服务类页面经常需要根据数量和选项计算费用。consttotal120this.boxes*8(this.van?80:0);费用计算要足够直观避免用户不理解价格变化。九、组件能力映射9.1 常用组件表组件项目用途特点Text展示标题、费用、状态轻量直接Button触发服务动作行为明确Toggle切换提醒或选项状态直观Grid展示卡片和阶段适合概览ForEach渲染列表和流程扩展方便Stack叠加看板和预览视觉集中9.2 Stack 的使用Stack(){Rect().width(100%).height(220)Text(服务看板)}Stack适合服务封面、课程签到数、维修摘要和设备展示。9.3 Flex 的使用Flex({wrap:FlexWrap.Wrap}){ForEach(this.devices,(name:string){Text(name)})}Flex适合家电清洗这类可换行标签列表。十、可扩展数据模型10.1 服务记录对象interfaceServiceRecord{id:string;title:string;status:string;amount:number;updatedAt:number;}这个对象可以承载一次服务动作。10.2 历史列表Staterecords:ServiceRecord[][];从单条状态扩展为数组后页面就能支持历史预约和工单记录。10.3 追加记录this.records[...this.records,{id:Date.now().toString(),title:this.slot,status:String(this.services),amount:0,updatedAt:Date.now()}];不可变追加方式有利于 UI 刷新。十一、本地存储与提醒能力11.1 为什么需要保存生活服务工具常常涉及预约时间、订单阶段、服务人员、费用和联系方式。洗衣、保洁、理发、维修、清洗、搬运、跑腿、开锁、团课和寄养记录都应该长期保存。11.2 保存结构interfaceSavedServiceState{current:ServiceRecord;history:ServiceRecord[];version:number;}version可以支持后续字段升级。11.3 同步配置示例{module:life-service,reminder:true,retry:3}对服务工具来说预约提醒和状态同步都很关键。十二、调试与验证12.1 验证状态变化Button(Debug).onClick((){console.info(current: this.slot);})先确认状态变化再检查页面展示。12.2 验证边界条件场景风险处理方式索引选择越界数组长度变化时重置索引余位递减低于 0使用条件判断阶段推进超过终点判断最大阶段费用计算不透明把公式拆成可读字段12.3 验证小屏布局小屏设备上要重点观察列表项、按钮和卡片是否拥挤。长文本字段适合放入滚动区域或分栏区域避免遮挡操作按钮。十三、工程化拆分13.1 抽离服务卡片BuilderfunctionServiceCard(label:string,value:string,color:string){Column({space:6}){Text(label).fontSize(14).fontColor(#6B7280)Text(value).fontSize(18).fontWeight(FontWeight.Bold)}.padding(16).backgroundColor(color).borderRadius(8)}服务卡片可以复用到阶段、费用、预约时间、师傅和课程展示。13.2 抽离列表项BuilderfunctionServiceRow(title:string,subtitle:string,active:boolean){Row(){Text(active?✓:•)Column(){Text(title)Text(subtitle)}}}列表项抽离后多个服务页面可以共享一致交互。13.3 抽离主题constTheme{pageBg:#F7FFF7,accent:#2D6A4F,radius:8,padding:20};主题配置能让多个服务页面保持统一。十四、业务扩展方向14.1 预约中心保洁、理发、家电清洗、社区团课和宠物寄养可以组成预约中心。14.2 工单中心洗衣收送、手机维修、跑腿订单和开锁记录可以组成工单中心。14.3 费用中心搬家费用、跑腿费用、开锁费用和寄养费用可以组成费用中心。interfaceServiceModule{name:string;enabled:boolean;orderCount:number;}十五、技术亮点15.1 场景具体上门保洁预约 的字段和组件都围绕 上门保洁服务排期 展开。读者能从源码直接看到真实服务流程。15.2 状态反馈及时点击、切换、选择或确认都会修改一个可见状态。这让移动端服务工具更可信。15.3 扩展自然当前项目可以继续扩展历史记录、本地持久化、提醒通知、费用明细和服务评价。对生活服务工具来说先让预约状态可见、工单流程可控、费用计算可读再扩展复杂系统是更稳的工程路线。十六、总结Home Cleaning Booking 展示了鸿蒙 ArkTS 在 上门保洁服务排期 场景中的单页工具实现方式。它用State保存服务状态用ForEach渲染列表用Button、Toggle或条件展示承载交互再通过卡片、文本和费用数字反馈结果。从技术角度看它覆盖了状态管理、数组渲染、条件渲染、按钮事件、开关控件、费用计算和移动端布局。从产品角度看上门保洁预约 把 维护服务项目、预约时段、地址备注、历史评分和确认预约动作 变成了一个可以直接使用的轻量生活服务工具。相关链接HarmonyOS 应用开发指南ArkTS 快速入门ArkUI 声明式开发