input

组件类型：UniInputElement

输入框

属性

名称	类型	默认值	描述
disabled	boolean	false	是否禁用
value	string		输入框的初始内容
type	string	text	input的类型 type
password	boolean	false	是否是密码类型
placeholder	string		输入框为空时占位符
placeholder-style	string		指定 placeholder 的样式
placeholder-class	string		指定 placeholder 的样式类
maxlength	number	140	最大输入长度，设置为 -1 的时候不限制最大长度
cursor-spacing	number	0	指定光标与键盘的距离，单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离
auto-focus	boolean	false	自动获取焦点
focus	boolean	false	获取焦点
confirm-type	string	done	设置键盘右下角按钮的文字 confirm-type
confirm-hold	boolean	false	点击键盘右下角按钮时是否保持键盘不收起
cursor	number	0	指定focus时的光标位置
selection-start	number	-1	光标起始位置，自动聚集时有效，需与selection-end搭配使用
selection-end	number	-1	光标结束位置，自动聚集时有效，需与selection-satrt搭配使用
adjust-position	boolean	true	键盘弹起时，是否自动上推页面
@input	(event: InputEvent) => void	-	当键盘输入时，触发input事件，event.detail = {value, cursor}，处理函数可以直接 return 一个字符串，将替换输入框的内容。
@focus	(event: InputFocusEvent) => void	-	输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度，在基础库 1.9.90 起支持
@blur	(event: InputBlurEvent) => void	-	输入框失去焦点时触发，event.detail = {value: value}
@keyboardheightchange	(event: InputKeyboardHeightChangeEvent) => void	-	键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration}
@confirm	(event: InputConfirmEvent) => void	-	点击完成按钮时触发，event.detail = {value: value}

type

值名称	描述
text	文本输入键盘
number	数字输入键盘
digit	带小数点数字输入键盘
tel	电话输入键盘

confirm-type

值名称	描述
send	发送
search	搜索
next	下一个
go	前往
done	完成

事件

InputEvent

InputEvent 属性值

名称	类型	必填	默认值	描述
detail	InputEventDetail	是	-	-
type	string	是	-	事件类型
target	Element	是	-	触发事件的组件
currentTarget	Element	是	-	当前组件
timeStamp	number	是	-	事件发生时的时间戳

InputEventDetail 属性值

名称	类型	必备	默认值	描述
value	string	是	-	输入框内容
cursor	number	是	-	光标的位置
keyCode	number	是	-	输入字符的Unicode值

InputEvent 方法

名称	类型	必填	默认值	描述
stopPropagation	() => void	是	-	阻止当前事件的进一步传播
preventDefault	() => void	是	-	阻止当前事件的默认行为

InputFocusEvent

InputFocusEvent 属性值

名称	类型	必填	默认值	描述
detail	InputFocusEventDetail	是	-	-
type	string	是	-	事件类型
target	Element	是	-	触发事件的组件
currentTarget	Element	是	-	当前组件
timeStamp	number	是	-	事件发生时的时间戳

InputFocusEventDetail 属性值

名称	类型	必备	默认值	描述
height	number	是	-	键盘高度
value	string	是	-	输入框内容

InputFocusEvent 方法

名称	类型	必填	默认值	描述
stopPropagation	() => void	是	-	阻止当前事件的进一步传播
preventDefault	() => void	是	-	阻止当前事件的默认行为

InputBlurEvent

InputBlurEvent 属性值

名称	类型	必填	默认值	描述
detail	InputBlurEventDetail	是	-	-
type	string	是	-	事件类型
target	Element	是	-	触发事件的组件
currentTarget	Element	是	-	当前组件
timeStamp	number	是	-	事件发生时的时间戳

InputBlurEventDetail 属性值

名称	类型	必备	默认值	描述
value	string	是	-	输入框内容

InputBlurEvent 方法

名称	类型	必填	默认值	描述
stopPropagation	() => void	是	-	阻止当前事件的进一步传播
preventDefault	() => void	是	-	阻止当前事件的默认行为

InputKeyboardHeightChangeEvent

InputKeyboardHeightChangeEvent 属性值

名称	类型	必填	默认值	描述
detail	InputKeyboardHeightChangeEventDetail	是	-	-
type	string	是	-	事件类型
target	Element	是	-	触发事件的组件
currentTarget	Element	是	-	当前组件
timeStamp	number	是	-	事件发生时的时间戳

InputKeyboardHeightChangeEventDetail 属性值

名称	类型	必备	默认值	描述
height	number	是	-	键盘高度
duration	number	是	-	持续时间

InputKeyboardHeightChangeEvent 方法

名称	类型	必填	默认值	描述
stopPropagation	() => void	是	-	阻止当前事件的进一步传播
preventDefault	() => void	是	-	阻止当前事件的默认行为

InputConfirmEvent

InputConfirmEvent 属性值

名称	类型	必填	默认值	描述
detail	InputConfirmEventDetail	是	-	-
type	string	是	-	事件类型
target	Element	是	-	触发事件的组件
currentTarget	Element	是	-	当前组件
timeStamp	number	是	-	事件发生时的时间戳

InputConfirmEventDetail 属性值

名称	类型	必备	默认值	描述
value	string	是	-	输入框内容

InputConfirmEvent 方法

名称	类型	必填	默认值	描述
stopPropagation	() => void	是	-	阻止当前事件的进一步传播
preventDefault	() => void	是	-	阻止当前事件的默认行为

示例

hello uni-app x

<template>
 <!-- #ifdef APP -->
 <scroll-view style="flex: 1">
 <!-- #endif -->
   <page-head :title="title"></page-head>
   <view class="uni-common-mt uni-padding-wrap">
     <view>
       <view class="uni-title">
         <text class="uni-title-text">设置输入框的初始内容</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-default" value="hello uni-app x" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">type取值（不同输入法表现可能不一致）</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-type-text" type="text" placeholder="文本输入键盘" />
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-type-number" type="number" placeholder="数字输入键盘" />
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-type-digit" type="digit" placeholder="带小数点的数字输入键盘" />
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-type-tel" :type="inputTypeTel" placeholder="电话输入键盘" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">密码输入框</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-password" :password="inputPassword" :value="inputPasswordValue" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">占位符样式</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-placeholder1" :placeholder-style="inputPlaceHolderStyle" placeholder="占位符文字颜色为红色" />
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-placeholder2" :placeholder-class="inputPlaceHolderClass" placeholder="占位符背景色为绿色" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">设置禁用输入框</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-disable" :disabled="true" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">设置最大输入长度</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-maxlength" :maxlength="10" placeholder="最大输入长度为10" :value="inputMaxLengthValue" @input="onMaxLengthInput" :focus="inputMaxLengthFocus" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">设置光标与键盘的距离</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input" :cursor-spacing="1000" placeholder="光标与键盘的距离为1000px" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">自动获取焦点</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-focus" :focus="focus" @keyboardheightchange="inputFocusKeyBoardChange"/>
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">confirm-type取值（不同输入法表现可能不一致）</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-confirm-send" confirmType="send" placeholder="键盘右下角按钮显示为发送" />
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-confirm-search" confirmType="search" placeholder="键盘右下角按钮显示为搜索" />
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-confirm-next" confirmType="next" placeholder="键盘右下角按钮显示为下一个" />
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-confirm-go" confirmType="go" placeholder="键盘右下角按钮显示为前往" />
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input uni-input-confirm-done" confirmType="done" placeholder="键盘右下角按钮显示为完成" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">点击键盘右下角按钮时保持键盘不收起</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input" :confirm-hold="true" />
       </view>
     </view>

     <view>
       <view class="uni-title" @click="setCursor(4)">
         <text class="uni-title-text">设置输入框聚焦时光标的位置（点击生效）</text>
       </view>
       <view class="uni-input-wrapper">
         <input ref="input" class="uni-input" value="0123456789" :cursor="cursor" />
       </view>
     </view>

     <view>
       <view class="uni-title" @click="setSelection(0, 4)">
         <text class="uni-title-text">设置输入框聚焦时光标的起始位置和结束位置（点击生效）</text>
       </view>
       <view class="uni-input-wrapper">
         <input ref="input2" class="uni-input" value="0123456789" :selection-start="selectionStart" :selection-end="selectionEnd" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">键盘弹起时，自动上推页面</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input" :adjust-position="true" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">input事件</text>
         <text class="uni-subtitle-text" v-if="inputEventDetail">{{inputEventDetail}}</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input" @input="onInput" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">focus事件和blur事件</text>
         <text class="uni-subtitle-text" v-if="focusAndBlurEventDetail">{{focusAndBlurEventDetail}}</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input" @focus="onFocus" @blur="onBlur" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">confirm事件</text>
         <text class="uni-subtitle-text" v-if="confirmEventDetail">{{confirmEventDetail}}</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input" @confirm="onConfirm" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">keyboardheightchange事件</text>
         <text class="uni-subtitle-text" v-if="keyboardHeightChangeEventDetail">{{keyboardHeightChangeEventDetail}}</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input" @keyboardheightchange="onKeyborardHeightChange" />
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">带清除按钮的输入框</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input" placeholder="带清除按钮的输入框" :value="inputClearValue" @input="clearInput" />
         <image class="uni-icon" src="/static/icons/clear.png" v-if="showClearIcon" @click="clearIcon">
         </image>
       </view>
     </view>

     <view>
       <view class="uni-title">
         <text class="uni-title-text">可查看密码的输入框</text>
       </view>
       <view class="uni-input-wrapper">
         <input class="uni-input" placeholder="请输入密码" :password="showPassword" />
         <image class="uni-icon" :src="!showPassword ? '/static/icons/eye-active.png' : '/static/icons/eye.png'" @click="changePassword"></image>
       </view>
     </view>
   </view>
 <!-- #ifdef APP -->
 </scroll-view>
 <!-- #endif -->
</template>
<script lang="uts">
 export default {
   data() {
     return {
       title: 'input',
       showClearIcon: false,
       inputClearValue: '',
       showPassword: true,
       cursor: -1,
       selectionStart: -1,
       selectionEnd: -1,
       inputEventDetail: '',
       focusAndBlurEventDetail: '',
       confirmEventDetail: '',
       keyboardHeightChangeEventDetail: '',
       focus: true,
       inputPassword: true,
       inputTypeTel: "tel",
       inputPlaceHolderStyle: "color:red",
       inputPlaceHolderClass: "uni-input-placeholder-class",
       inputMaxLengthValue:"",
       onMaxLengthInputValue:"",
       inputMaxLengthFocus:false,
       inputPasswordValue:"",
       inputFocusKeyBoardChangeValue:true
     }
   },
   methods: {
     inputFocusKeyBoardChange(e:InputKeyboardHeightChangeEvent) {
       this.inputFocusKeyBoardChangeValue = e.detail.height > 50
     },
     onMaxLengthInput(event:InputEvent) {
       this.onMaxLengthInputValue = event.detail.value
     },
     setCursor: function (cursor : number) {
       (this.$refs['input'] as Element).focus();
       this.cursor = cursor;
     },
     setSelection: function (selectionStart : number, selectionEnd : number) {
       (this.$refs['input2'] as Element).focus();
       this.selectionStart = selectionStart;
       this.selectionEnd = selectionEnd;
     },
     clearInput: function (event : InputEvent) {
       this.inputClearValue = event.detail.value
       if (event.detail.value.length > 0) {
         this.showClearIcon = true
       } else {
         this.showClearIcon = false
       }
     },
     clearIcon: function () {
       this.inputClearValue = ''
       this.showClearIcon = false
     },
     changePassword: function () {
       this.showPassword = !this.showPassword
     },
     onInput: function (event : InputEvent) {
       console.log("键盘输入", JSON.stringify(event.detail));
       this.inputEventDetail = JSON.stringify(event.detail)
     },
     onFocus: function (event : InputFocusEvent) {
       console.log("输入框聚焦", JSON.stringify(event.detail));
       this.focusAndBlurEventDetail = JSON.stringify(event.detail);
     },
     onBlur: function (event : InputBlurEvent) {
       console.log("输入框失去焦点", JSON.stringify(event.detail));
       this.focusAndBlurEventDetail = JSON.stringify(event.detail);
     },
     onConfirm: function (event : InputConfirmEvent) {
       console.log("点击完成按钮", JSON.stringify(event.detail));
       this.confirmEventDetail = JSON.stringify(event.detail);
     },
     onKeyborardHeightChange: function (event : InputKeyboardHeightChangeEvent) {
       console.log("键盘高度发生变化", JSON.stringify(event.detail));
       this.keyboardHeightChangeEventDetail = JSON.stringify(event.detail);
     },
     test_check_input_value():number {
       return this.onMaxLengthInputValue.length
     }
   }
 }
</script>

<style scoped>
 .uni-input-wrapper {
   display: flex;
   padding: 8px 13px;
   margin: 10rpx 0;
   flex-direction: row;
   flex-wrap: nowrap;
   background-color: #ffffff;
 }

 .uni-input {
   height: 28px;
   font-size: 15px;
   padding: 0px;
   flex: 1;
   background-color: #ffffff;
 }

 .uni-icon {
   width: 24px;
   height: 24px;
 }

 .uni-input-placeholder-class {
   background-color: green;
 }
 .uni-input-placeholder-class-ts {
   background-color: orange;
 }
</style>

兼容性

	安卓系统版本	安卓 uni-app	安卓 uni-app-x	iOS 系统版本	iOS uni-app	iOS uni-app-x
input	5.0	√	3.9+	9.0	√	-

子组件

不可以嵌套组件

参见

• Reference