表单

picker

单列选择器，基于 range 数据选择值。

稳定微信兼容子集

使用示例

<picker name="city" range="{{cities}}" value="{{cityIndex}}" bindchange="onCity" />

属性说明

属性	类型	默认值	必填	说明
`id`	`string`		否	节点标识，可用于 label.for 或测试定位。
`class`	`string`		否	附加样式类名。
`style`	`string`		否	受限内联样式。
`hidden`	`boolean`	false	否	是否隐藏当前节点。
`data-*`	`string`		否	事件触发时进入 event.dataset。
`name`	`string`		否	表单字段名。
`range`	`array`	[]	否	picker 可选项列表。
`range-key`	`string`		否	对象数组中用于展示的字段名。
`value`	`string \| number \| array`		否	当前值。
`disabled`	`boolean`	false	否	是否禁用。
`mode`	`string`		否	资源展示模式。
`start`	`string`		否	组件支持属性。
`end`	`string`		否	组件支持属性。
`fields`	`string`		否	组件支持属性。

事件说明

事件	event.detail	说明
`bindchange`	`{ value, index }`	组件状态变化时触发。

Manifest 声明

能力组件必须声明权限和 API。没有宿主 provider 时，运行时会展示稳定降级态或返回结构化错误。

{
  "permissions": [],
  "apisUsed": []
}

平台支持

平台	支持情况
Web	支持
Android SDK	WebView 运行时支持
iOS SDK	WebView 运行时支持
Flutter SDK	WebView 运行时支持

渲染协议

字段	值
HTML 标签	`select`
样式类	`mini-picker`
是否空元素	否
必填属性	-
必需 API	-