# 4.7 输入框（Input）

输入框组件，用于文本输入

<template>
  <dof-input placeholder="请输入" v-model="inputValue"></dof-input>
</template>

1
2
3

Prop	Type	Required	Default	Description
`value`	`String`	N	`''`	输入框值，支持 `v-model`
`placeholder`	`String`	N	`''`	占位文本
`type`	`String`	N	`'text'`	输入框类型
`autofocus`	`Boolean`	N	`false`	是否自动聚焦
`maxlength`	`Number`	N	-	最大输入长度
`return-key-type`	`String`	N	-	回车键类型
`singleline`	`Boolean`	N	`true`	是否单行
`max`	`String`	N	-	最大值
`min`	`String`	N	-	最小值
`uprise-offset`	`Number`	N	-	键盘顶起偏移量
`hide-done-button`	`Boolean`	N	`false`	是否隐藏完成按钮
`bg-color`	`String`	N	`''`	背景颜色
`height`	`Number`	N	`0`	输入框高度
`is-show-clear`	`Boolean`	N	`false`	是否显示清除按钮
`is-show-p-w-d-icon`	`Boolean`	N	`false`	是否显示密码显示切换图标
`icon`	`Object`	N	`{}`	预留图标配置，当前模板未使用
`input-style`	`Object`	N	`{}`	输入框样式
`input-box-style`	`Object`	N	`{}`	输入框容器样式
`border-radius`	`String`	N	`''`	容器圆角
`need-dark-mode`	`Boolean`	N	`false`	是否启用 M-dark/T-dark 内置暗黑适配
`text-color`	`String`	N	`''`	文字颜色
`placeholder-color`	`String`	N	`''`	输入占位文字颜色
`isRTL`	`Boolean`	`N`	`false`	是否启用 RTL（从右到左）布局；默认关闭 ^2.5.10

RTL 下默认输入文字右对齐；业务通过 input-style 显式设置的水平样式按逻辑方向镜像，绑定值保持不变。

设置 :need-dark-mode="true" 可启用内置暗黑配色，主题初始化与构建配置见接入说明。

颜色属性为空时使用内置配色；业务显式颜色和样式覆盖优先于默认配色，关闭暗黑适配后仍有效。

inputStyle 中的业务样式优先，支持 background-color、placeholder-color 等颜色别名。

事件名	说明	回调参数
`input`	输入事件	`value`
`iconClick`	预留事件；当前模板未绑定触发入口	-

插槽名	说明
`right`	输入框右侧内容；传入后会显示右侧容器