wlyyui 文档 wlyyui 文档
首页
  • 介绍
  • 快速上手
  • 自定义主题
  • 基础组件

    • Color 色彩
    • Text 文本
    • Icon 图标
    • Button 按钮
    • Animation 动画
  • 布局组件

    • GridLayout 栅格布局
    • Grid 宫格
    • Panel 面板
    • Preview 表单预览
    • List 列表
    • Card 卡片
  • 表单组件

    • Calendar 日历
    • Cascader 级联选择器
    • Picker 选择器
    • DatePicker 日期时间选择器
    • Slider 滑块选择器
    • Form 表单校验
    • FormItem 表单项
    • Select 选择器
    • Input 输入框
    • InputNumber 数字输入框
    • Label 标签
    • Radio 单选框
    • Checkbox 复选框
    • Switch 开关
    • Textarea 多行输入框
    • Rate 评分
    • Upload 图片上传
    • UploadVideo 视频上传
    • SearchBar 搜索栏
  • 反馈类型组件

    • ActionSheet 上拉菜单
    • Toast 轻提示
    • Backdrop 遮罩层
    • Dialog 对话框
    • DropdownMenu 下拉菜单
    • Modal 模态框
    • Gallery 画廊
    • Landscape 压屏窗
    • LoadAni 加载动画
    • Spin 旋转动画
    • Message 消息提示
  • 导航类型组件

    • NavBar 导航栏
    • BubbleBox 气泡框
    • Seg_tab 分段器
    • Tabbar 标签栏
    • BottomNavbar 底部导航栏
    • Tabs 标签页
    • IndexList 索引列表
    • NoticeBar 通告栏
    • Sticky 吸顶容器
    • Steps 步骤条
    • Fab 浮动按钮
    • Drawer 抽屉
    • BottomPopup 底部弹出层
    • TopPopup 顶部弹出层
    • TimeAxis 时间轴
    • SideMenu 纵向选项卡
  • 展示组件

    • Badge 徽章
    • Alert 警告框
    • Avatar 头像
    • Tag 标签
    • Tag 标签
    • Progress 进度条
    • Circle 圆形进度条
    • CountDown 倒计时
    • Divider 分割线
    • LoadMore 加载更多
    • Empty 缺省页
    • Skeleton 骨架屏
    • Parse 富文本
  • 拓展组件

    • ShareSheet 分享面板
    • Result 结果页
    • FilterBar 筛选栏
    • SingleInput 单输入框
    • DigitalRoller 数字滚轮
    • DigitalKeyboard 数字键盘
    • LicensePlate 车牌号键盘
    • SwiperDot 轮播图指示点
    • CopyText 长按复制
    • CubicBezier 贝塞尔曲线
    • ImageCropper 图片裁剪
    • Drag 拖拽排序
    • RotateVerify 旋转验证码
    • SliderCaptcha 滑块拼图验证
资源
案例
GitHub (opens new window)
首页
  • 介绍
  • 快速上手
  • 自定义主题
  • 基础组件

    • Color 色彩
    • Text 文本
    • Icon 图标
    • Button 按钮
    • Animation 动画
  • 布局组件

    • GridLayout 栅格布局
    • Grid 宫格
    • Panel 面板
    • Preview 表单预览
    • List 列表
    • Card 卡片
  • 表单组件

    • Calendar 日历
    • Cascader 级联选择器
    • Picker 选择器
    • DatePicker 日期时间选择器
    • Slider 滑块选择器
    • Form 表单校验
    • FormItem 表单项
    • Select 选择器
    • Input 输入框
    • InputNumber 数字输入框
    • Label 标签
    • Radio 单选框
    • Checkbox 复选框
    • Switch 开关
    • Textarea 多行输入框
    • Rate 评分
    • Upload 图片上传
    • UploadVideo 视频上传
    • SearchBar 搜索栏
  • 反馈类型组件

    • ActionSheet 上拉菜单
    • Toast 轻提示
    • Backdrop 遮罩层
    • Dialog 对话框
    • DropdownMenu 下拉菜单
    • Modal 模态框
    • Gallery 画廊
    • Landscape 压屏窗
    • LoadAni 加载动画
    • Spin 旋转动画
    • Message 消息提示
  • 导航类型组件

    • NavBar 导航栏
    • BubbleBox 气泡框
    • Seg_tab 分段器
    • Tabbar 标签栏
    • BottomNavbar 底部导航栏
    • Tabs 标签页
    • IndexList 索引列表
    • NoticeBar 通告栏
    • Sticky 吸顶容器
    • Steps 步骤条
    • Fab 浮动按钮
    • Drawer 抽屉
    • BottomPopup 底部弹出层
    • TopPopup 顶部弹出层
    • TimeAxis 时间轴
    • SideMenu 纵向选项卡
  • 展示组件

    • Badge 徽章
    • Alert 警告框
    • Avatar 头像
    • Tag 标签
    • Tag 标签
    • Progress 进度条
    • Circle 圆形进度条
    • CountDown 倒计时
    • Divider 分割线
    • LoadMore 加载更多
    • Empty 缺省页
    • Skeleton 骨架屏
    • Parse 富文本
  • 拓展组件

    • ShareSheet 分享面板
    • Result 结果页
    • FilterBar 筛选栏
    • SingleInput 单输入框
    • DigitalRoller 数字滚轮
    • DigitalKeyboard 数字键盘
    • LicensePlate 车牌号键盘
    • SwiperDot 轮播图指示点
    • CopyText 长按复制
    • CubicBezier 贝塞尔曲线
    • ImageCropper 图片裁剪
    • Drag 拖拽排序
    • RotateVerify 旋转验证码
    • SliderCaptcha 滑块拼图验证
资源
案例
GitHub (opens new window)
  • 基础组件

    • Color 色彩
    • Text 文本
    • Icon 图标
    • Button 按钮
    • Animation 动画
  • 布局组件

    • GridLayout 栅格布局
    • Grid 宫格
    • Panel 面板
    • Preview 表单预览
    • List 列表
    • Card 卡片
  • 表单组件

    • Calendar 日历
    • Cascader 级联选择器
    • Picker 选择器
    • DatePicker 日期时间选择器
    • Slider 滑块选择器
    • Form 表单校验
    • FormItem 表单项
    • Select 选择器
    • Input 输入框
    • InputNumber 数字输入框
    • Label 标签
    • Radio 单选框
    • Checkbox 复选框
    • Switch 开关
    • Textarea 多行输入框
    • Rate 评分
    • Upload 图片上传
    • UploadVideo 视频上传
    • SearchBar 搜索栏
  • 反馈类型组件

    • ActionSheet 上拉菜单
    • Toast 轻提示
    • Backdrop 遮罩层
    • Dialog 对话框
    • DropdownMenu 下拉菜单
    • Modal 模态框
    • Gallery 画廊
    • Landscape 压屏窗
    • Loading 加载
    • LoadAni 加载动画
    • Spin 旋转动画
    • Message 消息提示
    • SwipeAction 滑动菜单
  • 导航类型组件

    • NavBar 导航栏
    • BubbleBox 气泡框
    • Seg_tab 分段器
    • Tabbar 标签栏
    • BottomNavbar 底部导航栏
    • Tabs 标签页
    • IndexList 索引列表
    • NoticeBar 通告栏
    • Sticky 吸顶容器
    • Steps 步骤条
    • Fab 浮动按钮
    • Drawer 抽屉
    • BottomPopup 底部弹出层
    • TopPopup 顶部弹出层
    • TimeAxis 时间轴
    • SideMenu 纵向选项卡
  • 展示组件

    • Badge 徽章
    • Alert 警告框
    • Avatar 头像
    • Tag 标签
    • DataTag 标签选择
    • Progress 进度条
    • Collapse 折叠面板
    • Circle 圆形进度条
    • CountDown 倒计时
    • Divider 分割线
    • LoadMore 加载更多
    • Empty 缺省页
    • Skeleton 骨架屏
    • Parse 富文本
  • 拓展组件

    • ShareSheet 分享面板
    • Result 结果页
    • FilterBar 筛选栏
    • SingleInput 单输入框
      • DigitalRoller 数字滚轮
      • DigitalKeyboard 数字键盘
      • LicensePlate 车牌号键盘
      • SwiperDot 轮播图指示点
      • CopyText 长按复制
      • CubicBezier 贝塞尔曲线
      • ImageCropper 图片裁剪
      • Drag 拖拽排序
      • SlideVerify 滑动验证码
      • RotateVerify 旋转验证码
      • SliderCaptcha 滑块拼图验证
    • 组件
    • 拓展组件
    Mr zhang
    2023-08-14
    目录

    SingleInput 单输入框

    SingleInput 单输入框,每个输入框只允许输入一个字符,主要用于验证码、密码输入框等。

    # 支持平台

    App(vue) App(nvue) H5 小程序
    ✓ ✓ ✓ ✓

    # 基础使用

    通过 type 属性设置输入框类型,同input组件type属性,isFocus 属性设置是否默认获取焦点,@input 为键盘输入时触发事件,@complete 为输入完成时触发事件。

    <wui-single-input type="number" isFocus @input="onInput" @complete="onComplete"></wui-single-input>
    

    # 密码框/设置长度/调整样式

    通过 border 属性设置边框类型,borderWidth 属性设置边框宽度,radius 属性设置圆角值,activeColor 属性设置边框高亮颜色,cursorHeight 属性设置光标高度,cursorColor 属性设置光标颜色,length 属性设置输入框/输入内容长度,width 属性设置输入框宽度,height 属性设置输入框高度,size 属性设置输入框字体大小,password 属性设置是否是密码类型。

    <wui-single-input border="1" borderWidth="1" radius="16" activeColor="#FFB703" cursorHeight="40" cursorColor="#FFB703" :length="6" width="80" height="80"  size="24" password isFocus  @input="onInput" @complete="onComplete"></wui-single-input>
    

    # Slots

    插槽名称 说明
    - -

    # Props

    属性名 类型 说明 默认值 平台差异说明
    padding Number, String 组件外层左右padding值,单位rpx 88 -
    marginTop Number, String margin-top值,单位rpx 0 -
    marginBottom Number, String margin-bottom值,单位rpx 0 -
    value String native为false时,自定义键盘时输入的值;native为true时初始值。 - -
    type String 输入框类型,参考官方input (opens new window)组件type属性,native为true时有效 text H5暂未支持动态切换,请使用 v-if 进行整体切换
    password Boolean 是否是密码类型 false H5和App写此属性时,type失效;部分平台失焦后再次聚焦输入时会重置之前输入的内容:百度小程序等。
    disabled Boolean 是否禁用输入框 false -
    isFocus Boolean 获取焦点 false 在 H5 平台能否聚焦以及软键盘是否跟随弹出,取决于当前浏览器本身的实现。
    native Boolean 是否弹起原生键盘,设为false,则自行结合自定义键盘使用 true -
    cursor Boolean 是否显示光标 true -
    cursorColor String 光标颜色 #465CFF 非Nvue端默认值为空,可通过css变量(--wui-color-primary)修改颜色
    cursorHeight Number, String 光标高度,单位rpx 60 -
    length Number 内容长度/输入框个数,一般4~6个字符,请控制在6个或以下 4 -
    width Number, String 输入框宽度,单位rpx 112 -
    height Number, String 输入框高度,单位rpx 112 -
    background String 输入框背景颜色 transparent -
    border Number, String 边框类型,可选值:1-显示所有边框 2-只显示底部边框,3-无边框 2 -
    borderColor String 边框颜色 #eee 非Nvue端默认值为空,可通过css变量(--wui-color-border)修改颜色
    activeColor String 边框高亮颜色 #465CFF 非Nvue端默认值为空,可通过css变量(--wui-color-primary)修改颜色
    borderWidth Number, String 边框宽度,单位rpx 4 -
    radius Number, String 输入框圆角值,单位rpx 0 -
    size Number, String 输入框字体大小,单位rpx 48 -
    color String 输入框字体颜色 #181818 非Nvue端默认值为空,可通过css变量(--wui-color-titl)修改颜色
    fontWeight Number, String 输入框字重 600 -

    # Events

    事件名 说明 回调参数
    @complete 输入完成时触发 event.detail = {value}
    @focus 获取焦点时触发 -
    @input 键盘输入时触发,native为true时生效 event.detail = {value}
    @blur 失去焦点时触发,native为true时生效 event.detail = {value}
    @confirm 点击键盘完成按钮时触发,native为true时生效 event.detail = {value}

    # Methods

    通过 ref 属性来注册组件引用信息。注册完成后,通过this.$refs.XXX访问到对应的组件实例,并调用上面的实例方法。

    方法名 说明 传入参数
    clear 清空输入值,重置输入框 -
    FilterBar 筛选栏
    DigitalRoller 数字滚轮

    ← FilterBar 筛选栏 DigitalRoller 数字滚轮→

    Theme by Vdoing | Copyright © 2023-2023 Mr zhang | MIT License
    • 跟随系统
    • 浅色模式
    • 深色模式
    • 阅读模式