KY开元·(中国)集团

1 新建旅行页要收集哪些字段

2026-06-27 21:22

  第 01 篇把旅行行李管家的首页做出来了。首页里有“当前旅行摘要”,也有“新建旅行”的入口,但入口暂时只是一个结构占位。第 02 篇开始补第一条真正的数据链路:用户创建一趟旅行,填写目的地、出发日期、天数、同行人数和旅行类型,保存后回到首页展示。

  新建旅行页表面上是一个表单页面,但它不应该只是几个输入框的堆叠。旅行清单的质量,很大程度取决于旅行信息是否清楚。去深圳三天出差、去云南七天旅行、带老人孩子回老家,这几种行李清单完全不同。新建旅行页要把这些差异记录下来,为后面的清单生成、分类推荐和出发检查提供依据。

  这一篇会完成一个 HarmonyOS NEXT 风格的新建旅行页面。页面包含基础信息卡、时间与天数、同行人数、旅行类型、备注和底部保存按钮。代码会重点处理表单状态、校验、保存结果和路由返回。为了保持连载节奏,本篇仍然使用内存数据模拟保存,第 20 篇再接本地数据模块。

  第二类是目的地。目的地会影响清单建议,至少可以作为标题摘要使用。后面如果扩展天气、城市常用模板,也会依赖这个字段。

  第四类是同行人数。一个人出差和一家三口出行差别很大。第 15 篇多人分工功能会继续使用这个字段。

  第五类是旅行类型。这里不做复杂枚举,先提供“出差”“短途”“长途”“探亲”“露营”五个标签。标签可以为第 18 篇常用模板功能服务。

  第六类是备注。备注不参与计算,但能保存一些临时上下文,比如“带电脑演示”“有一天正式会议”“返程较晚”。清单应用不应该强迫所有信息都结构化,有些内容适合放在备注里。

  自动带出不同模板。第 19 篇清单生成逻辑制作时,也可以把它作为规则入口。

  BasicTripCard({ draft: this.draft })

  这种写法在实际项目里要留意对象引用更新。ArkUI 对状态更新有自己的响应式规则,复杂表单建议用更细粒度的

  或回调更新。为了让文章重点集中,本篇先采用直接改草稿字段的方式展示逻辑,后面做表单校验与本地数据时再继续收敛。

  4. 顶部栏:保持返回和标题清楚新建页面需要明确的返回入口。标题也不需要花哨,就叫“新建旅行”。副标题提示用户这一步的意义。

  只解决当前页面需要的问题:标签、输入框、错误提示。不要提前塞入前缀图标、右侧按钮、说明文案、字数统计。真要扩展时再加,不然基础组件会很快变成参数怪物。

  里强行过滤字符。很多项目会在输入时拦截,但拦截过重容易带来体验问题,比如用户粘贴内容、输入法组合态、删除到空值时异常。这里采用更稳的方式:输入阶段尽量不打断,保存时统一校验,字段下方展示错误。

  7. 旅行类型卡:用标签表达清单倾向旅行类型不是为了好看,而是为了后续清单生成有依据。这里做成可选标签,每个标签都有一句短描述。

  旅行类型一旦选中,保存时会进入旅行对象。首页暂时不展示类型,但行李模板和清单生成会用到。

  这里的保存只是模拟。真实项目会写入本地数据,再返回首页。第 20 篇会把这条链路接上。现在先把“校验—构建对象—返回首页”的结构做出来。

  入口配置里的新建旅行 route 维持为pages/NewTripPage。这样首页不需要知道新建页内部字段,也不需要传一堆参数。首页只负责打开页面。

  这里也能看出第 01 篇控制入口数量的好处。现在接新建页时,不需要从一堆入口里寻找真正的主链路。首页第一个入口就是最重要的动作。13. 保存后首页如何感知新旅行

  这不是最终方案。最终应该是:新建页保存到本地数据模块,首页从数据模块读取当前旅行。第 20 篇会把这部分改掉。现在这样写,是为了让第 02 篇的页面跳转和保存行为形成闭环。连载型项目不需要第一天就把存储、同步、异常、恢复全部写完。更重要的是每篇文章都能留下可替换的边界。这里的边界就是:新建页负责构建并保存旅行,首页负责读取当前旅行摘要,中间通过数据模块衔接。

  提示文案方面,输入框 placeholder 要写例子,不要只写“请输入”。比如“例如 深圳三天出差”“例如 深圳”。例子越贴近场景,用户越容易理解字段用途。

  错误位置方面,错误提示放在字段下方,而不是保存后统一 toast。统一 toast 只能告诉用户有问题,却不能告诉用户问题在哪里。字段下方提示更适合表单页。按钮反馈方面,saving状态先保留。即使现在保存很快,也应该让结构具备禁用按钮的能力。以后接本地写入、图片处理或同步时,不会出现重复点击导致多条旅行的问题。

  第 02 篇完成了新建旅行页制作。这个页面不是简单堆输入框,而是为后续清单逻辑准备旅行背景:旅行名称、目的地、日期、天数、人数、旅行类型和备注都会影响后面的行李分类、模板生成、出发检查和复盘。

  本篇代码重点放在四件事上:使用草稿模型承载表单状态;把输入展示、错误提示和字段更新拆成组件;保存前统一校验并给出具体错误;构建正式旅行对象后通过路由回到首页。到这里,旅行行李管家已经有了第一条主链路:从首页进入新建旅行页,再保存旅行返回首页。第 03 篇会继续做“行李分类页制作”,把证件票据、数码物品、衣物、药品、日用品这些类别整理成可点击、可统计、可扩展的分类页。

  证书有效期墙:HarmonyOS 日期归一、分层展示与到期草稿的开发手记

  露营行李卡片的最后一公里:HarmonyOS ComponentSnapshot 与 Share Kit 的截图分享链路

  弹幕滑过屏幕之前:HarmonyOS 直播聊天室的消息缓冲、滚动锚点与弱网提示

  一条班前提醒从草稿到响铃:HarmonyOS 代理提醒的权限、去重与恢复

  一份 PDF 批注从哪儿开始:HarmonyOS 文档阅读页的预览、标记与最近记录治理

 谷歌地图 百度地图