用途:在 Astro 页面中集成表单,处理字段、标签、提交端点、服务端校验以及无障碍提示,并核实提交目标是否属于获授权环境。
主要能力:读取字段、标签、端点、服务端校验配置与获授权环境;把每个 label 关联到字段 ID,用 aria-describedby 关联说明与错误,校验不通过时使用 aria-invalid;在服务端校验必填项、格式与长度限制,客户端 HTML 或 JavaScript 校验不能替代该步骤;提交过程中阻止重复提交,遇到 HTTP、网络或校验错误时保留已填写内容并允许重试,把结果播报在无障碍区域,必要时将焦点移至错误;不把收到的消息作为任意 HTML 渲染;区分外部服务商、端点和 Astro Action,并确认部署后由哪个运行时处理;保留重复字段、未勾选复选框与文件,按约定构造请求体后再禁用控件;区分输入错误、授权错误与服务不可用,即使页面隐藏表单也要在 handler 中确认权限;测试成功、4xx、5xx 与超时场景,无法重复外部效果时确认幂等性,并把返回 ID 与测试目标中记录的操作对应。
使用方式:若 .astrofy/config/paths.json 中的路径与示例不同,使用其中定义的路径;应用在线文档 API 前,先核对 lockfile 与 node_modules 中的已安装版本。提交前确认测试目标。在获授权测试中确认端点已收到请求,仅界面显示成功不算完成验证。修改已有实现时保留服务商约定与字段名,视觉改动不构成更换端点或发送真实消息的理由。可用 astrofy check --category forms 检查。
限制与暂未提供:资料未说明支持的 Astro 版本范围、具体服务商、价格与部署平台;示例配置、完整代码与安装命令暂未提供。