> For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt.

# input

单行文本输入组件，支持多种输入类型（文本、数字、密码等）及受控/非受控模式。

<iframe src="https://developer.doubao.com/docs-preview/component-simulator/?caseId=input"
  title="组件示例 input"
  width="100%"
  height="700"
  loading="lazy"
  style="width:100%;height:700px;border:0;border-radius:16px;overflow:hidden;"
></iframe>

## 扫码预览

![扫码预览 input](https://api.qrserver.com/v1/create-qr-code/?size=200x200\&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fcomponent%252Finput%252Findex)

## Props

<table>
<thead>
<tr><th width="140">属性名</th><th width="240">类型</th><th width="120">默认值</th><th width="80">必填</th><th width="360">说明</th></tr>
</thead>
<tbody>
<tr><td>className</td><td><code>string</code></td><td>-</td><td>否</td><td>组件类名</td></tr>
<tr><td>confirmType</td><td><code>&quot;search&quot; | &quot;next&quot; | &quot;send&quot; | &quot;go&quot; | &quot;done&quot;</code></td><td>'send'</td><td>否</td><td>键盘右下角确认按钮的类型</td></tr>
<tr><td>defaultValue</td><td><code>string</code></td><td>-</td><td>否</td><td>输入框的默认值，用于非受控组件</td></tr>
<tr><td>disabled</td><td><code>boolean</code></td><td>false</td><td>否</td><td>是否禁用</td></tr>
<tr><td>id</td><td><code>string</code></td><td>-</td><td>否</td><td>元素的唯一标识</td></tr>
<tr><td>key</td><td><code>string | number | null</code></td><td>-</td><td>否</td><td>React key 属性</td></tr>
<tr><td>maxlength</td><td><code>number</code></td><td>140</td><td>否</td><td>最大输入长度</td></tr>
<tr><td>onBlur</td><td><code>(event: BaseEvent&lt;&quot;bindblur&quot;, InputBlurEvent&gt;) =&gt; void</code></td><td>-</td><td>否</td><td>失焦时触发</td></tr>
<tr><td>onConfirm</td><td><code>(event: BaseEvent&lt;&quot;bindconfirm&quot;, InputConfirmEvent&gt;) =&gt; void</code></td><td>-</td><td>否</td><td>点击键盘确认按钮时触发</td></tr>
<tr><td>onFocus</td><td><code>(event: BaseEvent&lt;&quot;bindfocus&quot;, InputFocusEvent&gt;) =&gt; void</code></td><td>-</td><td>否</td><td>聚焦时触发</td></tr>
<tr><td>onInput</td><td><code>(event: BaseEvent&lt;&quot;bindinput&quot;, InputInputEvent&gt;) =&gt; void</code></td><td>-</td><td>否</td><td>输入内容变化时触发</td></tr>
<tr><td>onSelectionChange</td><td><code>(event: BaseEvent&lt;&quot;bindselection&quot;, InputSelectionEvent&gt;) =&gt; void</code></td><td>-</td><td>否</td><td>选择区域变化时触发</td></tr>
<tr><td>placeholder</td><td><code>string</code></td><td>-</td><td>否</td><td>占位符文本</td></tr>
<tr><td>readonly</td><td><code>boolean</code></td><td>false</td><td>否</td><td>是否只读</td></tr>
<tr><td>ref</td><td><code>Ref&lt;InputRef&gt;</code></td><td>-</td><td>否</td><td>用于获取组件实例的 ref</td></tr>
<tr><td>showSoftInputOnFocus</td><td><code>boolean</code></td><td>true</td><td>否</td><td>聚焦时是否显示软键盘</td></tr>
<tr><td>style</td><td><code>CSSProperties</code></td><td>-</td><td>否</td><td>组件样式</td></tr>
<tr><td>type</td><td><code>&quot;number&quot; | &quot;text&quot; | &quot;digit&quot; | &quot;password&quot; | &quot;tel&quot; | &quot;email&quot;</code></td><td>'text'</td><td>否</td><td>输入类型</td></tr>
<tr><td>value</td><td><code>string</code></td><td>-</td><td>否</td><td>输入框的当前值，用于受控组件</td></tr>
</tbody>
</table>

## Ref 方法

<table>
<thead>
<tr><th width="180">方法名</th><th width="260">类型</th><th width="360">说明</th></tr>
</thead>
<tbody>
<tr><td>blur</td><td><code>() =&gt; Promise&lt;void&gt;</code></td><td>失焦输入框</td></tr>
<tr><td>focus</td><td><code>() =&gt; Promise&lt;void&gt;</code></td><td>聚焦输入框</td></tr>
<tr><td>getValue</td><td><code>() =&gt; Promise&lt;{ selectionEnd: number; selectionStart: number; value: string }&gt;</code></td><td>获取输入框的值和选区起止位置，返回 <code>{ value, selectionStart, selectionEnd }</code>。</td></tr>
<tr><td>setSelectionRange</td><td><code>(selectionStart: number, selectionEnd: number) =&gt; Promise&lt;void&gt;</code></td><td>设置选择区域</td></tr>
<tr><td>setValue</td><td><code>(value: string) =&gt; Promise&lt;void&gt;</code></td><td>设置输入框的值</td></tr>
</tbody>
</table>
