鸿蒙开发:自定义一个车牌省份简称键盘

程序员一鸣
• 阅读 4

前言

本文基于Api12

之前针对车牌省份简称键盘,在Android系统中搞过一个,当时使用的是组合View的形式,考虑到最后一个删除按钮单独占两个格子,做了特殊处理,单独设置了权重weight和单独设置了宽度width,既然鸿蒙系统的应用开发了,于是比葫芦画瓢,把Android版的车牌键盘,用鸿蒙再封装一下。

鸿蒙开发:自定义一个车牌省份简称键盘

鸿蒙搞起来就比较的简单,直接一个Grid组件便可以搞定,最后的删除按钮,使用布局选项GridLayoutOptions便可轻松实现。

本篇文章大致如下:

1、设置GridLayoutOptions,规划键盘摆放

2、设置属性和方法,制定可扩展效果

3、开源后的简单使用

4、使用总结

一、设置GridLayoutOptions,规划键盘摆放

我们最主要的是最后一行的删除按钮,让删除按钮独占两列,我们就可以这样设置GridLayoutOptions。

layoutOptions: GridLayoutOptions = {
   regularSize: [1, 1],
   irregularIndexes: [this.mLicensePlateList.length - 1],
   onGetIrregularSizeByIndex: (_: number) => {
     return [1, 4]
   }
 }

regularSize:大小规则的GridItem在Grid中占的行数和列数,只支持占1行1列即[1, 1]。

最重要的参数是irregularIndexes和onGetIrregularSizeByIndex,irregularIndexes表示的是指定的GridItem索引在Grid中的大小是不规则的,比如我们设置的是最后一个格子,那么就把最后一个格子的索引设置上即可,当然,它是一个数组,在实际的开发中,可以动态的设置;onGetIrregularSizeByIndex是配合irregularIndexes使用,设置不规则GridItem占用的行数和列数,由于我们一行10个,最后一行时,最后是空出了4列,当然,这里我的处理是,直接最后一个占4列,然后在判断索引,设置删除按钮即可,当然,还有其它的处理方式。

首先,定义数据时,需要给数据增加一个空数据,用于最后一个元素的单独设置。

private mLicensePlateList = ["京", "津", "渝", "沪", "冀", "晋", "辽", "吉", "黑", "苏",
    "浙", "皖", "闽", "赣", "鲁", "豫", "鄂", "湘", "粤", "琼",
    "川", "贵", "云", "陕", "甘", "青", "蒙", "桂", "宁", "新",
    "藏", "使", "领", "学", "港", "澳", ""]

然后在ForEach遍历的时候,针对最后一个索引,单独设置删除按钮,非最后一个元素正常展示即可。

if (index == this.mLicensePlateList.length - 1) {
              Row() {
                Column() {
                  Image(this.deleteIconSrc)
                    .width(this.deleteIconWidth)
                }
                .width(this.deleteWidth)
                .height("100%")
                .backgroundColor(Color.White)
                .borderRadius(2)
                .justifyContent(FlexAlign.Center)
              }
              .width("100%")
              .height("100%")
              .justifyContent(FlexAlign.End)
              .onAreaChange((_: Area, newValue: Area) => {
                this.deleteWidth = Number(newValue.width) / 2 - Number(this.columnsGap) / 2
              })
            }

二、设置属性和方法,制定可扩展效果

如果仅仅只是自己使用,大可不必扩展,只适配自身应用即可,但是如果想要其他人或者其他应用进行使用,那么属性的扩展是很有必要的,毕竟每行展示几个,每个格子的背景,颜色、大小等等都是不一样的,我们可以把必须的这些因素,通过属性的形式暴露出去,尽量满足多需求的保障。

具体的各个属性,直接看第三项中的描述即可。

三、开源后的简单使用

1、远程依赖

方式一:在Terminal窗口中,执行如下命令安装三方包,DevEco Studio会自动在工程的oh-package.json5中自动添加三方包依赖。

建议:在使用的模块路径下进行执行命令。

ohpm install @abner/keyboard

方式二:在工程的oh-package.json5中设置三方包依赖,配置示例如下:

"dependencies": { "@abner/keyboard": "^1.0.0"}

鸿蒙开发:自定义一个车牌省份简称键盘

查看是否引用成功

无论使用哪种方式进行依赖,最终都会在使用的模块中,生成一个oh_modules文件,并创建源代码文件,有则成功,无则失败,如下:

鸿蒙开发:自定义一个车牌省份简称键盘

2、快速使用

LicensePlateView({
  onItemClick: (item: string, index: number) => {
    //点击事件
    console.log("=====点击内容:" + item + "===点击索引:" + index)
  },
  onDelete: () => {
    //点击删除
    console.log("=====点击删除")
  }
})

属性介绍


属性 类型 概述
onItemClick (item: string, index: number) => void 点击条目回调
onDelete () => void 点击删除回调
onComplete (item: string) => void 点击完成回调
rowsGap Length 行间距
columnsGap Length 列间距
columnSize number 展示几列,默认是10列
bgColor ResourceColor 背景颜色
marginLeft Length 距离左边
marginRight Length 距离右边
rectHeight Length 每个格子高度
titleHeight Length 标题栏高度
rootHeight Length 键盘整体的高度
gridMarginTop Length 网格距离顶部
gridMarginBottom Length 网格距离底部
completeTextColor ResourceColor 完成按钮的颜色
completeFontSize number/string/ Resource 完成文字大小
isShowComplete boolean 是否显示完成按钮
rectBgColor ResourceColor 格子背景
rectSelectBgColor ResourceColor 格子选中背景
rectBorderWidth Length 格子边框宽度
rectBorderRadius Length 格子圆角
rectBorderColor ResourceColor 格子边框颜色
rectBorderSelectColor ResourceColor 格子选中边框颜色
rectTextSize Length 格子的文字大小
rectTextColor Length 格子文字的默认颜色
rectSelectTextColor ResourceColor 格子文字的选中颜色
prohibit boolean 是否禁止后面的车牌简称
deleteIconWidth Length 删除图片宽度
deleteIconSrc PixelMap/ResourceStr/ DrawableDescriptor 删除icon资源

四、使用总结

目前的LicensePlateView只是一个组件,也就是一个View,你可以把它放到任何的UI布局中,比如自定义的页面,自定义的弹窗等等,当然了,后续,我也会扩展出类似于软键盘形式的弹出方式,可以关注下一个版本。

点赞
收藏
评论区
推荐文章
Stella981 Stella981
3年前
HarmonyOS应用开发项目实战
鸿蒙2.0已经发布了有段时间了,目前网上也有些小demo了,但是缺乏稍微大点的项目代码。我准备计划开发一个稍微正式点的项目,我写了个初略的项目需求清单,来体验鸿蒙应用开发。目前我已经着手实现了其中的一些重要功能,某些功能发现鸿蒙暂时不支持,但是还是先写上吧,后面慢慢摸索。我会陆续更新连载此贴,一步步从0基础讲解项目开发过程,然后巩固鸿蒙应用开发知识点。有错误
京东云开发者 京东云开发者
8个月前
Taro 鸿蒙技术内幕系列(一):如何将 React 代码跑在 ArkUI 上
作者:京东零售朱鸣辉基于Taro打造的京东鸿蒙APP已跟随鸿蒙Next系统公测,本系列文章将深入解析Taro如何实现使用React开发高性能鸿蒙应用的技术内幕背景随着鸿蒙操作系统的快速发展,开发者们期待将现有跨平台应用迁移到鸿蒙平台。Taro作为一个流行的
京东云开发者 京东云开发者
7个月前
Taro 鸿蒙技术内幕系列(二):如何让 W3C 标准的 CSS跑在鸿蒙上
作者:京东零售马银涛基于Taro打造的京东鸿蒙APP已跟随鸿蒙Next系统公测,本系列文章将深入解析Taro如何实现使用React开发高性能鸿蒙应用的技术内幕背景HarmonyOS采用自研的ArkUI框架作为原生UI开发方案,这套方案有完善的布局系统和样式
少湖说 少湖说
7个月前
鸿蒙Flutter实战:06-使用ArkTs开发Flutter鸿蒙插件
使用ArkTs开发Flutter鸿蒙平台插件本文讲述如何开发一个Flutter鸿蒙插件,如何实现Flutter与鸿蒙的混合开发,以及双端消息通信。Flutter侧,编写MethodChanneldartconstMethodChannelmethodCha
京东云开发者 京东云开发者
7个月前
Taro 鸿蒙技术内幕系列(三) - 多语言场景下的通用事件系统设计
作者:京东零售朱天健基于Taro打造的京东鸿蒙APP已跟随鸿蒙Next系统公测,本系列文章将深入解析Taro如何实现使用React开发高性能鸿蒙应用的技术内幕背景在鸿蒙生态系统中,虽然原生应用通常基于ArkTS实现,但在实际研发过程中发现,使用C可以显
飞龙AI 飞龙AI
1个月前
DevEcoStudio 中使用模拟器时如何过滤日志
DevEcoStudio中使用模拟器时如何过滤日志鸿蒙核心技术鸿蒙开发者工具DevEcoStudio在HilogSettingsFilter设置Logmessage:A03d00/JSAPP当你看到不断更新的日志时,你会不会崩溃因为Nofilters模式下
陈杨 陈杨
4星期前
鸿蒙5开发宝藏案例分享---一多开发实例(图片美化)
🌟【鸿蒙开发宝藏案例分享】一次搞定多端适配的图片美化应用开发思路!🌟Hey小伙伴们今天在翻鸿蒙文档时挖到一个超实用的大宝藏!原来官方早就悄悄提供了超多"一多开发"的实战案例,特别是这个图片美化应用的完整实现方案,必须立刻分享给大家!(搓手手.gif)🀀
陈杨 陈杨
1天前
鸿蒙5开发宝藏案例分享---Grid性能优化案例
发现鸿蒙宝藏:优化Grid组件性能的实战技巧!大家好呀!最近在鸿蒙开发者社区挖到一个超实用的性能优化案例——​​解决Grid组件加载慢、滚动卡顿的问题​​。官方其实藏了不少宝藏案例,但很多人可能没注意到。今天我就带大家拆解这个案例,加上详细讲解和代码分析,