#v0.1.0 内置字段

稳定版提供 10 个基础字段。JSON Schema 负责值类型和校验，UI 节点通过 widget 选择控件。所有示例都使用真实 FormRenderer，下方 JSON 是控件回传的受控值。

#通用属性

必填状态来自父对象 Schema 的 required 数组。minimum、maximum、minLength、maxLength 和 pattern 等约束只在 Schema 中声明。

#单行文本 text

适合名称、标识和短标题。长度和格式限制由 Schema 处理。

{
  "value": "同步客户数据"
}

#多行文本 textarea

适合备注、说明和其他需要保留换行的内容。

{
  "value": "失败时保留现场，并通知流程负责人。"
}

#数字 number

输入为空时回传 null，有值时回传 JavaScript number。

{
  "value": 3
}

#邮箱 email

使用原生邮箱输入，并通过 Schema format: "email" 校验。

{
  "value": "ops@a3s.dev"
}

#密码 password

密码控件只遮挡输入，不提供加密、传输保护或安全存储。

{
  "value": ""
}

#日期 date

表示不带时区的日历日期。

{
  "value": "2026-08-09"
}

#下拉选择 select

适合选项较多、只允许选择一项的场景。options 值必须与 Schema enum 保持一致。

{
  "value": "staging"
}

#单选项 radio

适合选项较少、需要直接比较的单选场景。

{
  "value": "review"
}

#复选框 checkbox

用于确认一个独立布尔状态。

{
  "value": true
}

#开关 switch

用于表达启用或关闭状态，控件语义为 role="switch"。

{
  "value": true
}

#React 用法

import { assertCompiled } from '@a3s-lab/form/core';
import { FormRenderer } from '@a3s-lab/form/react';
import '@a3s-lab/form/styles.css';

const plan = assertCompiled(document);

<FormRenderer plan={plan} value={value} onChange={setValue} />;

宿主保管完整表单值，并通过 onChange 接收下一份值。字段组件不负责持久化、权限、网络请求或业务副作用。

开发版新增字段及其完整协议见 next 内置字段组件。