--- title: 'input' description: '提供可交互的界面，接收用户的输入，默认为单行' lastUpdated: 2024-03-08T07:41:38.000Z --- 提供可交互的界面，接收用户的输入，默认为单行 ### 子组件 不支持 ### 属性 支持[通用属性](/7f1027fb1f5bbd82dc6e706045e05803/common-attributes.md) | 名称 | 类型 | 默认值 | 必填 | 描述 | | --- | --- | --- | --- | --- | | type | button | checkbox | radio | text | date | speak | text | 否 | 支持动态修改，`text` 为输入法录入， `speak` 为语音录入 | | checked | `` | false | 否 | 当前组件的 checked 状态，可触发 checked 伪类，type 为 checkbox 时生效 | | name | `` | \- | 否 | input 组件名称 | | value | `` | \- | 否 | input 组件的值 | | placeholder | `` | \- | 否 | 提示文本的内容，type 为 text | date | speak 时生效 | ### 样式 支持[通用样式](/765adcab7a96981138e6554a6888befc/common-styles.md) | 名称 | 类型 | 默认值 | 必填 | 描述 | | --- | --- | --- | --- | --- | | color | `` | #000 | 否 | 文本颜色 | | caret-color | `` | #000 | 否 | 光标颜色 | | font-size | `` | 43.2px | 否 | 文本尺寸 | | text-decoration | `` | underline | 否 | 文本下划线，目前只支持 underline | | placeholder-color | `` | #000 | 否 | 提示文本的颜色，type 为 text | date | speak 时生效 | | width | `` | `` | \- | 否 | 组件宽度 | | height | `` | `` | \- | 否 | 组件高度 | ### 事件 支持[通用事件](/9e6c0f774490d9ce4167d66873f59361/common-events.md) | 名称 | 参数 | 描述 | | --- | --- | --- | | change | 不同 type 参数不同，具体见下方 change 事件参数 | input 组件的值、状态发生改变时触发，type 为 button 时无 change 事件 | | focus | index | 获取光标返回的下标值 | #### change 事件参数 | 参数 | text | speak | checkbox | radio | 备注 | | --- | --- | --- | --- | --- | | name | | √ | √ | | | value | √ | √ | √ | | | checked | | √ | | | ### 方法 | 名称 | 参数 | 描述 | | --- | --- | --- | | setSpan | Object | 动态设置文字样式，方法的入参不是必填项 目前只支持设置 color 和 text-decoration | | focus | 无 | type 为 text | speak 时 生效。speak 可拉起语音输入，text 可拉起文字输入法 | setSpan 参数说明如下: | 属性 | 类型 | 默认值 | 描述 | | --- | --- | --- | --- | | start | Number | \- | 指定开始的位置 | | end | Number | \- | 指定结束的位置 | | style | Object | \- | 设置文字样式 ，不设置样式默认组件本身的样式 | ### 示例 ```html ``` ### 示例 修改 checkbox 组件的颜色 ```html ``` ### 示例 修改 radio 组件的颜色 ```html ```