HarmonyOS基本UI封装——全局弹窗、日志工具类、注解功能封装(八)

前言

• BasicLibrary是一个基于API 12封装的基本库

• 未来的计划是将其打造成一个通用的UI组件+基本工具组件，目前正在完善UI组件，大家如果组件有什么需求，可以尽管提哦

• BasicLibrary项目地址

• BasicLibrary的openHarmony三方库中心仓

文章系列

• HarmonyOS基本工具封装——BasicLibrary的基本使用(一)
• HarmonyOS基本UI封装——标题栏组件NavBar封装与使用(二)
• HarmonyOS基本UI封装——Cell单元格组件封装与使用(三)
• HarmonyOS基本UI封装——Dialog 弹出框、loading加载和List下拉刷新加载更多（四）
• HarmonyOS基本UI封装——ImageLoader 图片上传(五)
• HarmonyOS基本UI封装——顶部Toast、骨架屏(六)
• HarmonyOS基本UI封装——日历选择器(七)

简介

鸿蒙基本库封装，提升鸿蒙开发效率

安装

ohpm install @peakmain/library

一、功能优化

日历选择器优化

• SelectCalendarPage新增参数isShowMaxUseSelectDateCallback和isBefore6AM

参数名	类型	必填	说明
title	string	否	标题，默认文案是选择日期
selectedBackgroundColor	ResourceString	否	选中开始或者结束日期时的背景颜色，默认值是#A78461
selectedBetweenBackgroundColor	ResourceString	否	选中开始和结束日期之间日期的背景颜色，默认值是#1AA78461
isShowMaxUseSelectDateCallback	boolean	否	超过30天是否显示弹窗，默认是true
isBefore6AM	boolean	否	六点之前，前一天是否可用，默认是true

NavBar优化

• 新增showLeftClose参数

二、全局弹窗

导入依赖

import { DialogManager} from '@peakmain/library';

构造参数

参数名	参数类型	名称
uiContext	UIContext	上下文
duration	number	动画加载时长

方法

setBodyMessage

参数

参数	参数类型	默认值	说明
title	string	""	标题
message	string	""	内容
leftText	string	返回	左边按钮文案
leftTextColor	ResourceColor	$r("app.color.color_272a2b")	左边按钮字体颜色
leftTextClick	() => void	() => {}	左边按钮事件
rightText	string	返回	右边按钮文案
rightTextColor	ResourceColor	$r("app.color.color_272a2b")	右边按钮字体颜色
rightTextClick	() => void	() => {}	右边按钮事件
rightTextBold	boolean	true	右边按钮字体是否加粗，默认是

示例代码

 let manager=new DialogManager(this.getUIContext())
          manager.setBodyMessage("自定义全局弹窗","我是自定义全局弹窗内容","返回",$r("app.color.color_272a2b"),()=>{
            manager.close()
          },"确认",$r("app.color.color_194d53"),()=>{
            new ToastManager(this.getUIContext()).showNormalMessage("确认")
          })

关闭弹窗

close() :void

示例代码

manager.close()

显示弹窗

open(options?: promptAction.BaseDialogOptions):void

参数不可为空，一定不可为空

示例代码

manager.open({ alignment:DialogAlignment.Center })

三、日志工具类

导入依赖

import { LogUtils } from '@peakmain/library'

参数

参数	参数类型	参数说明
tag	string	tag标识默认是BasicLibrary
domain	number	日志输出级别,默认是 0x00AB
close	boolean	是否关闭日志，默认是false
isHilog	boolean	是否用hilog进行打印，默认是
showLogLocation	boolean	是否展示点击的位置， 默认是
logSize	number	打印的最大长度，默认是800

方法

方法名	参数	参数说明	说明
init	LogOptions	初始化传递参数	初始化 tag、domain 等属性
isLoggable	hilog.LogLevel	日志级别	检查指定领域标识、日志标识和级别的日志是否可以打印
debug	message: string | object, tag?: string	message: 日志信息 | tag: 设置TAG，可为空	debug 日志
info	message: string | object, tag?: string	message: 日志信息 | tag: 设置TAG，可为空	info 日志
warn	message: string | object, tag?: string	message: 日志信息 | tag: 设置TAG，可为空	warn 日志
error	message: string | object, tag?: string	message: 日志信息 | tag: 设置TAG，可为空	error 日志
fatal	message: string | object, tag?: string	message: 日志信息 | tag: 设置TAG，可为空	fatal 日志

示例代码

  LogUtils.error("日志打印工具类打印错误日志")

四、注解功能封装

1. 防抖点击事件

导入依赖

import { Debounce } from '@peakmain/library';

方法上添加@Debounce

参数

参数	参数类型	必填	说明
period	number	是	抖动间隔时间

示例代码

@Debounce(2000)
test(){
}

2. 监听某个方法的耗时

导入依赖

import { MonitorCostTime } from '@peakmain/library';

方法上添加@MonitorCostTime

示例代码

@MonitorCostTime()
test(){
}