做课堂签到模块的时候,我被时间录入狠狠教育了一顿。原本以为不就是两个日期选择器加两个时间选择器,顶多再做点校验,结果业务方提了一堆规则:签到可以提前几天设置、每天几点开始几点结束、单次签到有效时长是多少、周末要不要开放、要不要提前N分钟推送提醒……这些规则全要落到一套录入界面上。项目又是React Native写的,还刚适配了鸿蒙跨平台,原生的DatePicker在三端上的表现和样式各不相同,强行用原生组件反而会增加维护成本。最后我干脆放弃纯日期组件,用inputRow按分组布局重做了整个字段区,把日期、时间分门别类录入,再在提交时合成结构化时间规则。这篇就把完整思路和踩坑记录写下来,给同样被“花式时间需求”折磨的同学一个参考。
1. 业务背景与需求拆解:时间录入为什么值得较真
1.1 课堂签到对时间规则的硬性要求
课堂签到和普通活动报名的时间字段完全是两个量级。普通场景只需要“活动开始时间”一个字段,课堂签到基本都会有这样一套规则组合:签到周期(从哪天开始到哪天结束)、每日签到窗口(比如只在08:30到18:00之间开放签到)、单次签到时长的上限(超过15分钟就算迟到或失效)、可签到的重复天数(周一到周五,还是每天)。
这些规则不是简单的枚举值,而是一组互相约束的时间条件。如果录入界面只放一排平铺的输入项,老师根本看不出哪个字段和哪个字段是有关系的。负责签到的老师不是技术人员,她们需要的是一眼能看懂的分组:日期归日期,时间归时间,规则归规则。这也是整个组件设计的出发点。
1.2 为什么最终选了React Native + 鸿蒙跨平台
选择React Native开发这套签到录入组件,不是因为“流行”,而是因为它确实符合当时项目的部署条件。团队已经有一整套基于React Native的业务组件库,表单、列表、状态管理都沉淀过了,签到模块不可能单独用原生语言重写一套。鸿蒙端则通过react-native-harmony方案接进来,三端共用同一份业务代码,inputRow这类基础组件只需维护一份实现。
跨平台真正的收益在于:签到模块的录入规则、校验逻辑、结构化时间的转换全部集中在JavaScript层实现,Android、iOS、鸿蒙三端的行为天然一致。原生方案最头疼的问题就是“三端UI差异大,改一个样式要同步改三份代码”,而React Native把样式层也统一了,只要不依赖太多原生模块,适配成本可控。鸿蒙端接入时核心精力只需要放在打包配置、原生依赖补齐和性能适配这三件事上。
1.3 结构化时间规则最终要落成什么样
所谓“结构化时间”,核心就是让录入结果从零散的字符串变成一套可以被后端直接消费、可以被前端直接计算的统一结构。不能提交“下周一早上8点半到9点签到”这种自然语言,得落成明确的机器可读数据。
ts复制export type SignTimeRule = {
dateStart: string; // 签到周期开始日期,YYYY-MM-DD
dateEnd: string; // 签到周期结束日期,YYYY-MM-DD
timeStart: string; // 每日签到窗口开始时间,HH:mm
timeEnd: string; // 每日签到窗口结束时间,HH:mm
validMinutes: number; // 单次签到有效时长(分钟)
advanceMinutes: number; // 签到开放前提前提醒分钟数
repeatDays: number[]; // 循环星期,1=周一,7=周日
};
这套结构的好处是:后端拿到之后可以直接做判断,前端也可以在任何时候把它解析回界面。日期用本地日期字符串而不是时间戳,是为了避开时区问题——课堂签到按学校本地时间走,时间戳换算反而容易出错。这个数据结构的成型,决定了inputRow分组要分哪几组、每个字段的输入约束是什么。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 分组布局与组件拆分:inputRow的设计内核
2.1 inputRow在表单里的定位
inputRow本质上是表单里的一行输入单元,用来承载“左侧标签 + 右侧输入”这个最常见的布局。React Native没有内置Row组件,但通过View的flexDirection: 'row'可以很轻松实现一个复用性极高的基础行组件。
tsx复制type InputRowProps = {
label: string;
value: string;
onChangeText: (text: string) => void;
placeholder?: string;
keyboardType?: KeyboardTypeOptions;
maxLength?: number;
};
const InputRow = ({
label,
value,
onChangeText,
placeholder,
keyboardType,
maxLength,
}: InputRowProps) => (
<View style={styles.row}>
<Text style={styles.rowLabel}>{label}</Text>
<TextInput
style={styles.rowInput}
value={value}
onChangeText={onChangeText}
placeholder={placeholder}
placeholderTextColor
