• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# input
2
3
4交互式组件，提供单选框功能。
5
6> **说明：**
7>
8> 从API Version 8 开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
9
10## 属性
11
12除支持[通用属性](js-service-widget-common-attributes.md)外，还支持如下属性：
13
14| 名称      | 类型      | 默认值   | 必填   | 描述                                       |
15| ------- | ------- | ----- | ---- | ---------------------------------------- |
16| type    | string  | radio | 是    | input组件类型，当前仅支持radio类型：<br/>-&nbsp;"radio"：定义单选按钮，允许在多个拥有相同name值的选项中选中其中一个； |
17| checked | boolean | false | 否    | 当前组件是否选中。                                |
18| name    | string  | -     | 否    | input组件的名称。                              |
19| value   | string  | -     | 否    | input组件的value值，类型为radio时必填且相同name值的选项该值唯一。 |
20
21
22## 样式
23
24支持[通用样式](js-service-widget-common-styles.md)。
25
26
27## 事件
28
29| 名称     | 参数                 | 描述                                       |
30| ------ | ------------------ | ---------------------------------------- |
31| change | $event.checkedItem | radio单选框的checked状态发生变化时触发该事件，返回选中的组件value值。 |
32| click  | -                  | 点击动作触发该事件。                               |
33
34
35## 示例
36
37
38```html
39<!-- xxx.hml -->
40<div class="content">
41  <input type="radio" checked='true' name="radioSample" value="radio1" onchange="onRadioChange"></input>
42  <input type="radio" checked='false' name="radioSample" value="radio2" onchange="onRadioChange"></input>
43  <input type="radio" checked='false' name="radioSample" value="radio3" onchange="onRadioChange"></input>
44</div>
45```
46
47
48```css
49/* xxx.css */
50.content{
51  width: 100%;
52  height: 200px;
53  justify-content: center;
54  align-items: center;
55}
56```
57
58
59```json
60{
61  "actions": {
62    "onRadioChange":{
63      "action": "message",
64      "params": {
65        "checkedRadio": "$event.checkedItem"
66      }
67    }
68  }
69}
70```
71**4*4卡片**
72
73![卡片input](figures/input.gif)
74
75