LicensePlate 车牌号键盘 
概述
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
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
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 | - |