Astryx 0.7.15更新:日期输入错误回调与组件升级方法
Astryx 0.7.15为DateInput和DateTimeInput增加输入错误回调,便于应用给出更清楚的日期校验提示。这个基于React 19+和StyleX的MIT开源设计系统仍处于Beta,升级时应让使用的Astryx包保持同一版本。
Astryx 0.7.15为DateInput和DateTimeInput增加输入错误回调,便于应用给出更清楚的日期校验提示。这个基于React 19+和StyleX的MIT开源设计系统仍处于Beta,升级时应让使用的Astryx包保持同一版本。
先统一包版本,再运行官方升级工具
官方发布说明要求所有用到的@astryxdesign/*包统一到0.7.15。先保存代码与锁文件,在可回退的分支执行,例如当前Core为0.7.14时:
OLD_VERSION=0.7.14
npm install @astryxdesign/core@0.7.15 @astryxdesign/cli@0.7.15
npx @astryxdesign/cli upgrade --from "$OLD_VERSION" --apply --path .将OLD_VERSION改为项目实际使用的Core版本,并同步列出其他Astryx包。升级工具使用--apply会修改项目文件,完成后应查看差异、运行项目原有检查,再提交变更。

日期输入错误怎样交给应用处理
onEntryErrorChange会在字段拒绝键入文本时报告原因,回调接收DateInputEntryError。其kind不依赖界面语言,可区分unreadable、incomplete、nonexistent、outOfRange和unavailable,并提供原始text;部分错误还包含公历ISO日期。
应用可以按kind映射自己的提示文案,再把需要展示的信息交给字段状态。错误结束时会收到null,应同步清理已经失效的提示,避免用户改正输入后仍看到旧错误。
怎样检查日期边界与交互结果
- 分别输入不完整日期、无法解析文本和不存在的日期。
- 设置项目真实使用的min、max与dateConstraints,检查越界及不可用日期的提示。
- 通过键入、日历选择、Enter和失焦等路径验证提示更新。
- 在项目支持的语言、桌面与触屏入口中检查错误结束后是否恢复正常状态。
回调便于应用控制文案,但不会自动决定业务允许哪些日期。业务约束仍应由项目自己的范围与规则提供。
Safari已知问题与Beta使用范围
0.7.15说明记录了Safari/WebKit下的已知问题:默认动效中,较高的tooltip在进入的第一帧可能短暂覆盖触发器,随后移动到旁边,交互不受影响。使用相关浮层的页面,应在目标浏览器检查真实效果。
Astryx提供文档、Storybook与Sandbox入口,适合先验证组件行为再集成业务界面。Beta阶段不宜仅因为一次安装成功就省略跨浏览器与可访问性检查。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。
















