LicensePlate 车牌号键盘 VIP专属

概述

LicensePlate 车牌号键盘,用于车牌号的输入。

# 支持平台

App-vue App-Nvue 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序 H5 PC 快手小程序 钉钉小程序

温馨提示

  • 组件内部使用了 fui-icon(字体图标)组件,非 easycom 组件模式下需要手动引入组件(打开组件内部注释的引入内容,引入路径按实际调整)。

  • 一般来说我们会通过 z-index + position 来进行层级的设置,但是 weex (Nvue)不支持 z-index 设置层级关系,默认越靠后的元素层级越高。

# 引入

以下介绍两种常用的引入方式。
第一种:在页面中引用、注册
import fuiLicensePlate from "@/components/firstui/fui-license-plate/fui-license-plate.vue"
export default {
	components:{
		fuiLicensePlate
	}
}
1
2
3
4
5
6
第二种:easycom组件规范
传统vue组件,需要安装、引用、注册,三个步骤后才能使用组件。easycom将其精简为一步。

First UI easycom配置请查看 快速上手

如果不了解easycom,可先查看 官网文档 (opens new window)

# 代码演示

部分示例演示,完整使用请参考示例程序以及文档API(以下示例写于.vue页面中)。
基础使用

通过 show 属性控制键盘显示隐藏,theme 属性设置键盘的主题,toolbar 属性设置是否显示工具栏。

<fui-license-plate :show="show" :theme="theme" :toolbar="toolbar" @click="keyClick" @backspace="backspace" @complete="complete"></fui-license-plate>
1
data() {
	return {
		show: false,
		value: '',
		theme: 'light',
		toolbar: true
	}
},
methods: {
	keyClick(e) {
		//按键点击事件
		console.log(e)
		//输入的值
		let val = e.value;
		//判断
		//...
		this.value += val
	},
	backspace(){
		//退格键事件
	},
	complete(){
		//完成按钮事件//退格键事件
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# Slots

插槽名称 说明
default 键盘上方自定义显示内容。

# Props

属性名 类型 说明 默认值 平台差异说明
show Boolean 是否显示键盘 false -
toolbar Boolean 是否显示工具栏(完成按钮) false -
text String 完成按钮文本 完成 -
color String 完成按钮字体颜色 #465CFF 非Nvue端默认为空,可通过css变量(--fui-color-primary)来改变颜色值
size Number, String 完成按钮字体大小,单位rpx 30 -
fontWeight Number, String 完成按钮字重 500 -
name String 退格键字体图标名称,可选值: backspace-fill、backspace ,具体可参考组件 fui-icon backspace-fill -
theme String 键盘主题,可选值:light、dark light -
zIndex Number, String 键盘的层级z-index值 1001 Nvue端不支持,默认越靠后的元素层级越高
safeArea V1.5.0+ Boolean 是否适配底部安全区 true -

# Events

事件名 说明 回调参数
@click 点击键盘按键时触发(仅车牌号可选值按键) {
  value:按键值
}
@backspace 点击退格键时触发 -
@complete 点击完成按钮时触发 -

# Methods

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

方法名 说明 传入参数 返回参数
changeKeyboard V1.7.0+ 切换键盘默认显示 changeKeyboard(type),type可选值:cn、en -

示例预览

# 示例代码地址

VIP内容代码请查看订单页下载的组件库示例源码。

# 特别说明

该组件为付费组件,UNI-APP版VIP用户可免费使用 。

开通会员 (opens new window)

Last Updated: 8/18/2023, 5:05:05 PM