1# input 2<!--Kit: ArkUI--> 3<!--Subsystem: ArkUI--> 4<!--Owner: @kangshihui--> 5<!--Designer: @pssea--> 6<!--Tester: @jiaoaozihao--> 7<!--Adviser: @HelloCrease--> 8 9交互式组件，包括单选框，多选框，按钮。 10 11> **说明：** 12> 13> 该组件从API version 4 开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 14 15 16## 子组件 17 18不支持。 19 20 21## 属性 22 23| 名称 | 类型 | 默认值 | 必填 | 描述 | 24| -------- | -------- | -------- | -------- | -------- | 25| type | string | <br/>button | 否 | input组件类型，可选值为button，checkbox，radio。<br/>button，checkbox，radio不支持动态修改。可选值定义如下：<br/>- button：定义可点击的按钮。<br/>- checkbox：定义多选框。<br/>- radio：定义单选按钮，允许在多个拥有相同name值的选项中选中其中一个。 | 26| checked | boolean | false | 否 | 当前组件是否选中，true表示选中，false表示未选中。仅type为checkbox和radio生效。 | 27| name | string | - | 否 | input组件的名称。 | 28| value | string | - | 否 | input组件的value值，当类型为radio时必填且相同name值的选项该值唯一。 | 29| id | string | - | 否 | 组件的唯一标识。 | 30| style | string | - | 否 | 组件的样式声明。 | 31| class | string | - | 否 | 组件的样式类，用于引用样式表。 | 32| ref | string | - | 否 | 用来指定指向子元素的引用信息，该引用将注册到父组件的$refs 属性对象上。 | 33 34 35## 事件 36 37- 当input类型为checkbox、radio时，支持如下事件： 38 | 名称 | 参数 | 描述 | 39 | -------- | -------- | -------- | 40 | change | { checked:true \| false } | checkbox多选框或radio单选框的checked状态发生变化时触发该事件。 | 41 | click | - | 点击动作触发该事件。 | 42 | longpress | - | 长按动作触发该事件。 | 43 | swipe<sup>5+</sup> | [SwipeEvent](js-lite-common-events.md) | 组件上快速滑动后触发。 | 44 45- 当input类型为button时，支持如下事件： 46 | 名称 | 参数 | 描述 | 47 | -------- | -------- | -------- | 48 | click | - | 点击动作触发该事件。 | 49 | longpress | - | 长按动作触发该事件。 | 50 | swipe<sup>5+</sup> | [SwipeEvent](js-lite-common-events.md) | 组件上快速滑动后触发。 | 51 52 53## 样式 54 55| 名称 | 类型 | 默认值 | 必填 | 描述 | 56| -------- | -------- | -------- | -------- | -------- | 57| color | <color> | \#ffffff | 否 | 按钮的文本颜色。 | 58| font-size | <length> | 30px | 否 | 按钮的文本尺寸。 | 59| width | <length> | - | 否 | type为button时，默认值为100px。 | 60| height | <length> | - | 否 | type为button时，默认值为50px。 | 61| font-family | string | SourceHanSansSC-Regular | 否 | 字体。目前仅支持SourceHanSansSC-Regular 字体。 | 62| padding | <length> | 0 | 否 | 使用简写属性设置所有的内边距属性。<br/> 该属性可以有1到4个值：<br/>- 指定一个值时，该值指定四个边的内边距。<br/>- 指定两个值时，第一个值指定上下两边的内边距，第二个指定左右两边的内边距。<br/>- 指定三个值时，第一个指定上边的内边距，第二个指定左右两边的内边距，第三个指定下边的内边距。<br/>- 指定四个值时分别为上、右、下、左边的内边距（顺时针顺序）。 | 63| padding-[left\|top\|right\|bottom] | <length> | 0 | 否 | 设置左、上、右、下内边距属性。 | 64| margin | <length> \| <percentage><sup>5+</sup> | 0 | 否 | 使用简写属性设置所有的外边距属性，该属性可以有1到4个值。<br/>- 只有一个值时，这个值会被指定给全部的四个边。<br/>- 两个值时，第一个值被匹配给上和下，第二个值被匹配给左和右。<br/>- 三个值时，第一个值被匹配给上, 第二个值被匹配给左和右，第三个值被匹配给下。<br/>- 四个值时，会依次按上、右、下、左的顺序匹配 (即顺时针顺序)。 | 65| margin-[left\|top\|right\|bottom] | <length> \| <percentage><sup>5+</sup> | 0 | 否 | 设置左、上、右、下外边距属性。 | 66| border-width | <length> | 0 | 否 | 使用简写属性设置元素的所有边框宽度。 | 67| border-color | <color> | black | 否 | 使用简写属性设置元素的所有边框颜色。 | 68| border-radius | <length> | - | 否 | border-radius属性是设置元素的外边框圆角半径。 | 69| background-color | <color> | - | 否 | 设置背景颜色。 | 70| display | string | flex | 否 | 确定一个元素所产生的框的类型，可选值为：<br/>- flex：弹性布局。<br/>- none：不渲染此元素。 | 71| [left\|top] | <length> \| <percentage><sup>6+</sup> | - | 否 | left\|top确定元素的偏移位置。<br/>- left属性规定元素的左边缘。该属性定义了定位元素左外边距边界与其包含块左边界之间的偏移。<br/>- top属性规定元素的顶部边缘。该属性定义了一个定位元素的上外边距边界与其包含块上边界之间的偏移。 | 72 73## 示例 74 751. type为button 76 77 ```html 78 <!-- xxx.hml --> 79 <div class="div-button"> 80 <input class="button" type="button" value="Input-Button"></input> 81 </div> 82 ``` 83 84 ```css 85 /* xxx.css */ 86 .div-button { 87 flex-direction: column; 88 align-items: center; 89 width: 100%; 90 height: 100%; 91 } 92 .button { 93 margin-top: 30px; 94 width: 280px; 95 } 96 ``` 97 98  99 100 101 1022. type为checkbox 103 104 ```html 105 <!-- xxx.hml --> 106 <div class="content"> 107 <input onchange="checkboxOnChange" checked="true" type="checkbox"></input> 108 <text class="text">{{text}}</text> 109 </div> 110 ``` 111 112 ```css 113 /* xxx.css */ 114 .content{ 115 width: 100%; 116 height: 100%; 117 flex-direction: column; 118 align-items: center; 119 justify-content: center; 120 } 121 .text{ 122 font-size: 30px; 123 text-align: center; 124 width: 200px; 125 margin-top: 20px; 126 height: 100px; 127 } 128 ``` 129 130 ```javascript 131 // xxx.js 132 export default { 133 data: { 134 text: "text" 135 }, 136 checkboxOnChange(e) { 137 this.text = e.checked; 138 } 139 } 140 ``` 141 142  143 1443. type为radio 145 146 ```html 147 <!-- xxx.hml --> 148 <div class="container"> 149 <div class="item"> 150 <input type="radio" checked="true" name="radioSample" value="radio1" onchange="onRadioChange"></input> 151 <text class="text">radio1</text> 152 </div> 153 <div class="item"> 154 <input type="radio" checked="false" name="radioSample" value="radio2" onchange="onRadioChange"></input> 155 <text class="text">radio2</text> 156 </div> 157 <div class="item"> 158 <input type="radio" checked="false" name="radioSample" value="radio3" onchange="onRadioChange"></input> 159 <text class="text">radio3</text> 160 </div> 161 </div> 162 ``` 163 164 ```css 165 /* xxx.css */ 166 .container { 167 width: 100%; 168 height: 100%; 169 justify-content: center; 170 align-items: center; 171 flex-direction: column; 172 } 173 .item { 174 width: 50%; 175 height: 30%; 176 justify-content: center; 177 } 178 .text { 179 margin-top: 25%; 180 font-size: 30px; 181 text-align: center; 182 width: 200px; 183 height: 100px; 184 } 185 ``` 186 187 
