鸿蒙 ArkTS 实战City Guide Schedule 从同城导游日程到本地旅行应用完整解析前言同城导游日程 是一个典型的鸿蒙 ArkTS 小型业务应用页面体量不大但覆盖了状态驱动界面、列表渲染、条件文案、按钮事件和业务数据即时反馈这些移动端开发中最常见的能力。这篇文章围绕 City Guide Schedule 的真实项目内容展开重点分析它如何把“本地导游记录老街入口、博物馆、江边夜景、本地餐馆四个停靠点并按服务过程追加费用。”落成一个可交互页面。小型业务应用的价值不在于页面数量而在于是否把状态、数据和用户动作串成稳定闭环。图示说明本文以项目中的 ArkTS 页面为基础将界面拆成顶部信息、业务选择、详情反馈和动作按钮四层。一、项目定位与业务场景1.1 应用解决的问题本地导游记录老街入口、博物馆、江边夜景、本地餐馆四个停靠点并按服务过程追加费用。这个场景非常适合用鸿蒙声明式 UI 来实现因为页面状态集中、业务反馈明确、用户动作路径短。1.2 页面面向的用户主要用户包括三类需要快速登记服务信息的一线工作人员。需要查看当前状态和费用变化的服务对象。需要复用轻量业务页面结构的 ArkTS 开发者。1.3 核心业务对象对象在页面中的作用技术承载当前选择决定高亮卡片和详情内容State业务数组提供列表、标签或流程节点string[] / number[]操作按钮推动状态变化onClick / onChange反馈区域展示当前结果Text / Row / Column二、源码结构与页面入口2.1 页面文件位置该应用的主要页面位于 entry 模块的 pages 目录核心逻辑集中在 Index 页面中。对于这种单页工具将展示、状态和事件放在同一个组件中便于阅读和调试。EntryComponentstruct Index{build(){Column(){Text(同城导游日程)}}}2.2 组件职责拆分区域职责典型组件顶部标题区显示业务主题和摘要信息Row、Column、Text选择区切换套餐、科目、节点或物品ForEach、Grid、Toggle详情区展示当前选择后的解释Text、Stack操作区完成确认、追加、计费等动作Button2.3 为什么适合单组件实现同城导游日程 的业务状态只有 2 个主要字段stop、fee。状态数量少跨页面共享需求不强采用单组件实现可以降低样板代码让读者把注意力放在 ArkTS 状态绑定本身。三、状态建模3.1 State 字段说明字段类型说明stopnumber当前行程停靠点索引feenumber导游服务费用默认 360这些字段都直接参与 UI 渲染只要值发生变化相关 Text、颜色、按钮文案或费用结果就会自动刷新。3.2 状态声明代码EntryComponentstruct Index{Statestop:number0;// 当前行程停靠点索引Statefee:number360;// 导游服务费用默认 360}3.3 状态粒度控制状态字段保持简短有两个好处页面变化来源清楚排查问题时可以直接定位到对应字段。渲染表达式更直观不需要在多个对象之间频繁跳转。后续扩展持久化时可以把这些字段直接映射到缓存或服务端参数。对小工具而言状态字段越贴近用户动作页面越容易维护。四、业务数据数组设计4.1 数组内容stops老街入口、博物馆、江边夜景、本地餐馆项目中没有把所有展示内容写死在多个 Text 里而是通过数组配合 ForEach 渲染。这种方式让选项增加、顺序调整和文案替换都更自然。4.2 数组渲染示例ForEach(this.items,(item:string,index:number){Text(item).fontSize(16).fontWeight(FontWeight.Bold).onClick((){this.currentindex})})4.3 数据与索引绑定当状态字段保存的是索引时页面可以用items[current]取得当前内容也可以用index current判断是否高亮。Text(this.items[this.current]).fontColor(this.currentindex?#FFFFFF:#0F766E)这种写法在 同城导游日程 中非常常见既能表达当前选择也能减少额外对象结构。五、界面布局实现5.1 主布局思路页面以 Column 或 Row 作为主容器根据业务主题选择不同的信息密度。同城导游日程 的布局重点是让用户第一眼看到当前状态再完成一次明确操作。Column(){this.Header()this.BusinessArea()this.ActionArea()}.width(100%).height(100%).backgroundColor(#FFFFFF)5.2 视觉层次层级设计目标实现方式一级信息告诉用户当前是什么业务大字号标题二级信息展示对象、时间、备注中性灰色 Text关键状态突出选择、金额、阶段主题色与加粗操作按钮推动状态变化Button 绑定事件5.3 主题色使用该项目使用#0F766E作为业务主色。主题色主要出现在按钮、高亮卡片、流程节点或重要金额上避免把所有文本都涂成同一种颜色。Text(当前状态).fontSize(18).fontWeight(FontWeight.Bold).fontColor(#0F766E)六、交互行为解析6.1 用户动作列表点击时间线节点切换 stop记录费用按钮让 fee 增加 30Circle 与 Rect 组合成纵向行程线6.2 事件绑定代码Button(记录费用).onClick((){this.fee30})Row().onClick((){this.stopindex})6.3 交互反馈闭环点击时间线节点切换 stop记录费用按钮让 fee 增加 30Circle 与 Rect 组合成纵向行程线这些动作都不会跳转页面而是在当前页面即时反馈结果。对于服务登记类应用这种即时反馈可以减少误操作也能让用户清楚地知道操作是否生效。七、关键业务计算7.1 计算表达式本项目最核心的业务表达式可以概括为feefee307.2 为什么直接在页面展示计算结果同城导游日程 属于轻量业务工具计算逻辑短、依赖字段少把计算结果直接展示在页面中可以减少额外方法和中间状态。7.3 可扩展计算封装如果后续加入更多规则可以把计算封装成方法privategetDisplayResult():string{constvaluefee fee 30returnString(value)}在真实业务中费用、阶段和状态文本通常会继续扩展因此保留清晰的计算入口很重要。八、ArkTS 组件细节8.1 Text 的信息表达Text 在页面中承担标题、说明、状态和金额展示。不同字号和颜色让用户自然区分内容优先级。Text(同城导游日程).fontSize(26).fontWeight(FontWeight.Bold).fontColor(#0F766E)8.2 Button 的动作表达Button 只绑定一个清晰动作不在一次点击中混入过多业务副作用。Button(确认).backgroundColor(#0F766E).onClick((){// 更新当前页面状态})8.3 条件样式条件样式让选中态更明显.backgroundColor(this.currentindex?#0F766E:#FFFFFF).fontColor(this.currentindex?#FFFFFF:#111827)8.4 列表循环ForEach 适合处理选项、流程和服务清单ForEach(this.items,(item:string,index:number){Row(){Text(item)Text(String(index1))}})九、页面可维护性9.1 命名可读性stop、fee 这些字段都与业务动作直接对应阅读源码时可以快速判断每个字段控制哪一块页面。9.2 数据集中管理数组字段统一放在组件顶部避免在 build 中散落大量重复文案。privateitems:string[][选项一,选项二,选项三]9.3 样式边界当前项目直接链式调用样式方法适合页面较短的场景。如果页面继续增长可以按区域拆成 builder 方法。BuilderprivateSectionTitle(title:string){Text(title).fontSize(18).fontWeight(FontWeight.Bold)}十、调试与验证10.1 状态变化验证调试时可以按以下顺序确认初始状态是否与默认 UI 一致。点击选项后高亮是否移动。按钮点击后数字、状态或文案是否刷新。边界条件是否保持稳定。10.2 日志辅助Button(调试动作).onClick((){console.info(current state changed)})10.3 常见问题定位问题可能原因处理方式点击后无变化修改的不是 State 字段确认字段声明位置高亮错位index 与数组顺序不一致检查 ForEach 数据源文案异常条件表达式分支错误单独验证布尔值费用不更新表达式未依赖状态检查 copies、fee 等字段十一、同类业务扩展11.1 接入本地缓存可以把当前选择和操作结果保存到 Preferences让页面重启后恢复上次状态。interfaceSavedState{current:numberupdatedAt:string}11.2 接入远端接口如果 同城导游日程 需要和后台系统同步可以把页面状态作为请求参数{business:同城导游日程,selected:1,status:confirmed}11.3 表单化改造业务字段继续增加时可以把顶部信息、选项列表和备注区域拆成更细的组件形成可复用的服务登记模板。十二、性能与体验细节12.1 减少不必要状态只有会影响界面的字段才需要使用 State。静态数组使用 private 字段即可避免把每个展示文本都变成响应式数据。12.2 保持点击目标清晰按钮、卡片和标签都要有足够 padding尤其是服务预约类页面经常在门店或外勤场景中使用点击目标太小会影响效率。12.3 色彩反馈一致同一业务动作使用同一主题色#0F766E可以帮助用户把“可操作区域”和“当前结果”联系起来。十三、完整实现片段13.1 页面骨架EntryComponentstruct Index{Statestop:number;Statefee:number;build(){Column(){Text(同城导游日程)Text(业务主题本地旅行)}}}13.2 业务配置// stops老街入口、博物馆、江边夜景、本地餐馆privateprimaryColor:string#0F766E13.3 事件处理Button(记录费用).onClick((){this.fee30})Row().onClick((){this.stopindex})13.4 结果展示Text(当前业务结果).fontSize(20).fontWeight(FontWeight.Bold).fontColor(#0F766E)十四、技术讲解要点14.1 技术亮点使用 ArkTS 声明式语法组织单页业务。使用 State 驱动用户选择和结果反馈。使用 ForEach 渲染业务数组减少重复代码。使用条件样式表达选中态、阶段态和完成态。14.2 业务亮点本地导游记录老街入口、博物馆、江边夜景、本地餐馆四个停靠点并按服务过程追加费用。页面路径短用户可以在一个屏幕内完成主要动作。关键字段有即时反馈适合真实服务登记场景。14.3 可复用价值同城导游日程 的结构可以迁移到更多生活服务、社区服务、教育预约和门店登记类应用中。只要替换数组内容、状态字段和按钮动作就能形成新的业务页面。十五、学习路线15.1 初学者关注点先理解 State 与 UI 刷新的关系再观察 ForEach 如何把数组变成可点击列表。15.2 进阶开发者关注点重点关注状态字段是否足够少、事件逻辑是否可预测、业务计算是否能被独立测试。15.3 工程化关注点当页面进入多人维护阶段可以把配置、样式、组件和服务请求拆分出来形成更清晰的工程边界。总结City Guide Schedule 展示了鸿蒙 ArkTS 在轻量业务应用中的实用价值。它用少量状态字段承载 本地旅行 场景用数组渲染减少重复 UI用按钮事件完成业务推进并通过条件样式让用户立即感知当前结果。从工程角度看同城导游日程 的重点不是复杂算法而是把真实业务动作翻译成稳定的界面状态。这种能力对于服务预约、订单登记、社区管理和本地生活工具都非常关键。相关链接HarmonyOS 应用开发指南ArkTS 快速入门ArkUI 声明式开发
)
