Input 输入框

2024-07-16 08:14| 来源: 网络整理| 查看: 265

# Input 输入框

✈

组件名：uv-input

点击下载&安装 (opens new window)

此组件为一个输入框，默认没有边框和样式，是专门为配合表单组件uv-form而设计的，利用它可以快速实现表单验证，输入内容，下拉选择等功能。

应该在uv-form中嵌套uv-form-item，再嵌套uv-input去实现。

# 平台兼容性 App（vue） App（nvue） H5 小程序 VUE2 VUE3 √ √ √ √ √ √ # 基本使用通过type设置输入框的类型，默认text 通过placeholder设置输入框为空时的占位符通过border配置是否显示输入框的边框绑定@change事件 export default { data() { return { value: '' } }, methods: { change(e) { console.log('change', e); } } } # 可清空字符

将clearable设置为true，会在输入框后方增加一个清空按钮。

# 下划线

通过设置属性border为bottom即可变成一个下划线

# 前后图标前后置图标可自由设置样式信息。 # 前后插槽

通过设置slot为prefix或suffix来指定前后插槽

import { toast } from '@/uni_modules/uv-ui-tools/libs/function/index.js'; export default { data() { return { tips: '', value: '内容' } }, methods: { codeChange(text) { this.tips = text; }, getCode() { if (this.$refs.uCode.canGetCode) { // 模拟向后端请求验证码 uni.showLoading({ title: '正在获取验证码' }) setTimeout(() => { uni.hideLoading(); // 这里此提示会被this.start()方法中的提示覆盖 toast('验证码已发送'); // 通知验证码组件内部开始倒计时 this.$refs.uCode.start(); }, 2000); } else { toast('倒计时结束后再发送'); } }, change(e) { console.log('change', e); } } } # 完整示例

完整示例下载地址

https://ext.dcloud.net.cn/plugin?name=uv-ui (opens new window)

# API # Input Props 参数说明类型默认值可选值 value / v-model 输入的值 Number | String - - type 输入框类型，见Type Options String text text | number | idcard | digit | password disabled 是否禁用输入框 Boolean false true | false disabledColor 禁用状态时的背景色 String #f5f7fa - clearable 是否显示清除控件 Boolean false true | false password 是否密码类型 Boolean false true | false maxlength 最大输入长度，设置为 -1 的时候不限制最大长度。（注意：maxlength都是小写） String | Number -1 - placeholder 输入框为空时的占位符 String - - placeholderClass 指定placeholder的样式类，注意页面或组件的style中写了scoped时，需要在类名前写/deep/ String input-placeholder - placeholderStyle 指定placeholder的样式，字符串/对象形式，如"color: red;" String | Object color: #c0c4cc - confirmType 设置右下角按钮的文字，兼容性详见uni-app文档 String done done | send | search | next | go | done confirmHold 点击键盘右下角按钮时是否保持键盘不收起，H5无效 Boolean false true | false holdKeyboard focus时，点击页面的时候不收起键盘，微信小程序有效 Boolean false true | false focus 自动获取焦点，在 H5 平台能否聚焦以及软键盘是否跟随弹出，取决于当前浏览器本身的实现。nvue 页面不支持，需使用组件的 focus()、blur() 方法控制焦点 Boolean false true | false autoBlur 键盘收起时，是否自动失去焦点，目前仅App3.0.0+有效 Boolean false true | false ignoreCompositionEvent 是否忽略组件内对文本合成系统事件的处理。为 false 时将触发 compositionstart、compositionend、compositionupdate 事件，且在文本合成期间会触发 input 事件 Boolean true true | false cursor 指定focus时光标的位置 String | Number -1 - cursorSpacing 输入框聚焦时底部与键盘的距离 String | Number 30 - selectionStart 光标起始位置，自动聚集时有效，需与selection-end搭配使用 String | Number -1 - selectionEnd 光标结束位置，自动聚集时有效，需与selection-start搭配使用 String | Number -1 - adjustPosition 键盘弹起时，是否自动上推页面 Boolean true true | false inputAlign 输入框内容对齐方式 String left left | center | right fontSize 输入框字体的大小 String | Number 15px - color 输入框字体颜色 String #303133 - prefixIcon 输入框前置图标 String - - prefixIconStyle 前置图标样式，对象或字符串 String | Object - - suffixIcon 输入框后置图标 String - - suffixIconStyle 后置图标样式，对象或字符串 String | Object - - border 边框类型，surround-四周边框，bottom-底部边框，none-无边框 String surround surround | bottom | none readonly 是否只读，与disabled不同之处在于disabled会置灰组件，而readonly则不会 Boolean false true | false shape 输入框形状，circle-圆形，square-方形 String square square | circle formatter 输入过滤或格式化函数(如需兼容微信小程序，则只能通过setFormatter方法) Function null - customStyle 自定义外部样式 Object - - # Type Options 属性名说明 text 文本输入键盘 number 数字输入键盘，app-vue下可以输入浮点数，app-nvue和小程序平台下只能输入整数 idcard 身份证输入键盘，微信、支付宝、百度、QQ小程序 digit 带小数点的数字键盘，App的nvue页面、微信、支付宝、百度、头条、QQ小程序 password 等同于设置password为true的效果 # Input Methods 方法名说明 setFormatter 为兼容微信小程序而暴露的内部方法，见上方说明 # Input Events 事件名说明回调参数版本 @blur 输入框失去焦点时触发 value：内容值 - @focus 输入框聚焦时触发 - - @confirm 点击完成按钮时触发 value：内容值 - @keyboardheightchange 键盘高度发生变化的时候触发此事件 - 微信小程序2.7.0+、App 3.1.0+ @input 内容发生变化触发此事件 value：内容值 - @clear 点击清空内容 - - # Input Slots 名称说明 prefix 输入框前置内容 suffix 输入框后置内容

← Form 表单 Textarea 文本域 →

感谢支持我们

【本文地址】

公司简介

联系我们