文档 / 表单控件
表单控件
控件返回 DOM 节点，通过属性读取值，通过原生事件响应编辑。为每个字段提供清楚的文字标签，不要只依赖 placeholder。
| 方法 | 返回值与参数 |
|---|---|
field(input) | 包装一个节点的 div 容器，提供输入区域样式。 |
input(attrs = {}) | HTMLInputElement；attrs 赋给 DOM 属性，例如 type、value、placeholder、disabled。 |
textarea(attrs = {}) | HTMLTextAreaElement；未指定行数时通常使用浏览器默认行数，可显式提供 rows。 |
select(options = [], attrs = {}) | HTMLSelectElement；选项是字符串或 { value, label }。 |
checkbox(label, attrs = {}) | HTMLLabelElement，内部包含 checkbox input。通过 querySelector("input") 读取 checked。 |
switch(checked, onChange) | button，带 switch 角色。点击切换状态，并将新的 boolean 传给回调。 |
选择与事件
select 先创建选择框，再添加选项。需要可靠的初始选中值时，在返回节点上设置 select.value，例如上面的示例。
input 和 textarea 可以监听 input；select 和 checkbox 可以监听 change。日期输入使用 input({ type: "date" })，读取金额后使用 Number(input.value) 转换为数字，再写入数据库。
switch 自己切换视觉状态，但不会保存数据。需要持久化时，在 onChange 中调用数据 API，并处理写入失败。