首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >家政预约小程序+H5开发:预约时间选择、地址组件复用方案

家政预约小程序+H5开发:预约时间选择、地址组件复用方案

原创
作者头像
码兄科技
发布于 2026-11-18 13:52:47
发布于 2026-11-18 13:52:47
360
举报

家政预约小程序+H5开发:预约时间选择、地址组件复用方案

在家政上门预约场景,预约时段、上门地址是下单的核心信息。如果小程序、H5分开开发两套选择组件,会出现交互不一致、字段格式不统一、后端校验逻辑重复的问题。本文基于UniApp封装通用时间选择组件、地址选择组件,搭配SpringBoot后端统一校验接口,实现一套组件同时支撑小程序和H5,解决多端字段对齐、时段可用校验、地址存储标准化的问题。

一、组件多端适配的痛点

小程序自带picker组件,H5浏览器原生时间控件样式、交互差异大;地址选择涉及省市区选择、定位、地址保存,小程序可以调用微信定位API,H5使用浏览器定位,接口调用方式不同。 如果没有统一组件规范,两端传给后端的时间格式、地址字段命名不一致,容易出现后端校验报错;同时,家政业务需要根据服务范围、档期可用性动态禁用时段,前端硬编码时间列表,无法和后端实时档期数据联动。修改时间规则、地址存储字段时,两端组件需要分别改动,维护成本高。

二、通用组件设计思路

将预约时间选择、地址选择封装为独立的公共组件,放到UniApp组件库中,页面直接引入复用,不重复写业务视图。 组件内部拆分两层:通用渲染层、平台适配层。渲染层负责日历展示、时段列表、地址列表、选中回显;适配层通过条件编译隔离定位、地图、弹窗等平台专属能力。组件对外抛出统一事件,无论小程序还是H5,选中后返回的时间、地址JSON结构完全一致。 时间组件支持配置最小预约时间、最大预约时间、步长、禁用时段列表;地址组件支持新增地址、选择历史地址、定位获取地址、省市区联动,输出包含省、市、区、详细地址、经纬度的标准对象。

三、时间选择组件实现与后端校验

时间组件不写死可选时段,前端向后端请求当前服务可预约时段列表,后端返回已经过滤掉已被占用、不在服务时间内的时段,组件拿到数据后渲染并自动禁用不可选时段。 时间统一使用yyyy-MM-dd HH:mm格式传输,避免前端时间格式差异导致解析异常。后端收到时间后,做档期锁单校验,防止超约。 后端核心Java代码示例:

代码语言:javascript
复制
@Service
public class TimeSlotService {
    @Autowired
    private StringRedisTemplate redisTemplate;
    @Autowired
    private OrderMapper orderMapper;

    // 获取某服务可预约时段
    public ResultDTO<List<TimeSlotDTO>> getAvailableSlot(Long serviceId, LocalDate appointDate) {
        String cacheKey = "house:slot:" + serviceId + ":" + appointDate;
        String cacheStr = redisTemplate.opsForValue().get(cacheKey);
        List<TimeSlotDTO> slotList;
        if (cacheStr != null) {
            slotList = JSON.parseArray(cacheStr, TimeSlotDTO.class);
        } else {
            slotList = buildBaseSlot(serviceId, appointDate);
            // 过滤已占用时段
            List<LocalDateTime> occupiedTime = orderMapper.selectOccupiedTime(serviceId, appointDate);
            for (TimeSlotDTO slot : slotList) {
                if (occupiedTime.contains(slot.getAppointTime())) {
                    slot.setAvailable(false);
                }
            }
            redisTemplate.opsForValue().set(cacheKey, JSON.toJSONString(slotList), 10, TimeUnit.MINUTES);
        }
        return ResultDTO.success(slotList);
    }
}

四、地址选择组件标准化与多端定位适配

地址组件统一数据结构,包含province、city、district、detail、lng、lat、addressId。用户新增地址、选择历史地址,都以这套结构和后端交互。 定位能力使用条件编译封装:小程序调用uni.getLocation,H5使用浏览器navigator.geolocation,定位成功后回调地址解析,失败则提示用户手动选择省市区。 用户地址统一存入后端地址表,同一个账号在小程序、H5可以读取、编辑同一套地址,实现地址数据互通。下单时后端根据经纬度校验地址是否在该服务的配送服务半径内,超出范围直接拦截。

五、条件编译的使用边界

条件编译只用来处理平台独有的API,业务逻辑、字段校验、弹窗交互逻辑全部写在组件通用部分,不分散在平台分支里。 例如:定位失败提示、授权弹窗区分平台;但是时段禁用逻辑、地址必填校验、选中回调事件,全部统一。这样后续迭代,大部分业务修改只需要改一处组件代码,不用分别适配两端。

六、组件传参、事件与表单联动规范

组件使用props接收配置参数,通过emit向外抛出选中事件。预约页面引入组件,监听选中事件拿到标准化数据,再提交下单接口。 组件内置基础校验:时间不能为空、地址不能为空;后端做二次校验,作为兜底,避免前端绕过校验直接提交请求。 同时组件支持回显,用户修改预约订单时,传入已选时间、地址,组件自动回填,适配改单场景。

七、测试与兼容要点

测试重点:小程序和H5打开同一个预约页面,对比组件样式、可选时段、地址列表是否一致;H5不同移动端浏览器测试定位、省市区联动;测试跨端场景:小程序保存地址,H5打开可以看到;H5下单选择的时段,小程序查看该时段标记为已占用。 同时校验边界场景:预约当天、预约多天后、地址超出服务范围、定位授权拒绝手动填写地址。

总结

这套预约时间、地址组件复用方案,核心是组件视图统一、数据结构标准化、平台差异隔离在适配层。基于UniApp封装公共组件,一套代码在小程序、H5两端渲染,后端使用统一接口获取时段、保存地址、校验服务范围,从源头解决多端字段不一致、交互不同步的问题。组件化之后,后续新增预约相关页面、新增其他渠道,都可以直接复用组件,减少重复开发。落地时需要重点做好时间格式统一、地址数据标准化,前端只做基础校验,后端保留强校验逻辑,保障家政预约下单链路稳定。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 家政预约小程序+H5开发:预约时间选择、地址组件复用方案
    • 一、组件多端适配的痛点
    • 二、通用组件设计思路
    • 三、时间选择组件实现与后端校验
    • 四、地址选择组件标准化与多端定位适配
    • 五、条件编译的使用边界
    • 六、组件传参、事件与表单联动规范
    • 七、测试与兼容要点
    • 总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档