表单
input
单行文本输入控件。
稳定
微信兼容子集
使用示例
<input name="title" value="{{title}}" bindinput="onInput" />
属性说明
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
id | string | 否 | 节点标识,可用于 label.for 或测试定位。 | |
class | string | 否 | 附加样式类名。 | |
style | string | 否 | 受限内联样式。 | |
hidden | boolean | false | 否 | 是否隐藏当前节点。 |
data-* | string | 否 | 事件触发时进入 event.dataset。 | |
name | string | 否 | 表单字段名。 | |
value | string | number | array | 否 | 当前值。 | |
type | string | 否 | 组件类型或输入类型。 | |
placeholder | string | 否 | 输入占位文本。 | |
disabled | boolean | false | 否 | 是否禁用。 |
maxlength | number | 否 | 最大输入长度。 | |
password | string | 否 | 组件支持属性。 | |
confirm-type | string | 否 | 组件支持属性。 | |
confirm-hold | string | 否 | 组件支持属性。 | |
cursor | string | 否 | 组件支持属性。 | |
selection-start | string | 否 | 组件支持属性。 | |
selection-end | string | 否 | 组件支持属性。 | |
focus | string | 否 | 组件支持属性。 |
事件说明
| 事件 | event.detail | 说明 |
|---|---|---|
bindinput | { value } | 组件状态变化时触发。 |
bindchange | { value } | 组件状态变化时触发。 |
bindconfirm | { value } | 组件状态变化时触发。 |
bindfocus | { dataset } | 组件状态变化时触发。 |
bindblur | { dataset } | 组件状态变化时触发。 |
Manifest 声明
能力组件必须声明权限和 API。没有宿主 provider 时,运行时会展示稳定降级态或返回结构化错误。
{
"permissions": [],
"apisUsed": []
}
平台支持
| 平台 | 支持情况 |
|---|---|
| Web | 支持 |
| Android SDK | WebView 运行时支持 |
| iOS SDK | WebView 运行时支持 |
| Flutter SDK | WebView 运行时支持 |
渲染协议
| 字段 | 值 |
|---|---|
| HTML 标签 | input |
| 样式类 | mini-input |
| 是否空元素 | 是 |
| 必填属性 | - |
| 必需 API | - |