介绍
本示例介绍通过CustomDialogController类显示自定义日历选择器。
效果图预览
使用说明
- 加载完成后显示主界面,点当前日期后会弹出日历选择器,选择日期后会关闭弹窗,主页面日期会变成选定的日期,应用退出再进入还是显示上次选择的日期。
实现思路
- 获取当前月和下个月的日期信息。
const SATURDAY = 6 // 日历表上周六对应的序列号,从周日开始算起,取值0~6
export function getMonthDate(specifiedMonth: number, specifiedYear: number) {
let currentFirstWeekDay: number = 0; // 初始化指定月的第一天是周几
let currentLastWeekDay: number = 0; // 初始化指定月的最后一天是周几
let currentAllDay: number[] = []; // 初始化指定月的日期排列数组
let totalDays = new Date(specifiedYear, specifiedMonth, 0).getDate(); // 初始化指定月总天数
currentFirstWeekDay = new Date(specifiedYear, specifiedMonth - 1, 1).getDay() // 获取指定月的第一天是周几
currentLastWeekDay = new Date(specifiedYear, specifiedMonth - 1, totalDays).getDay() // 获取指定月的最后一天是周几
// 将月份中显示上个月日期的内容置0
for (let item = 0; item < currentFirstWeekDay; item++) {
currentAllDay[item] = 0;
}
// 将本月日期内容存入数组
for (let item = 1; item <= totalDays; item++) {
currentAllDay.push(item);
}
// 将月份中显示下个月日期的内容置0
for (let item = 0; item < SATURDAY - currentLastWeekDay; item++) {
currentAllDay.push(0);
}
return currentAllDay;
}
- 通过CustomDialogController类初始化自定义日历弹窗。
dialogController: CustomDialogController = new CustomDialogController({
builder: CustomCalendarPickerDialog({
currentMonth: this.currentMonth,
currentDay: this.currentDay,
currentYear: this.currentYear,
cancel: this.onCancel
}),
alignment: DialogAlignment.Bottom, // 自定义弹窗底端对齐
customStyle: true // 弹窗样式自定义
})
- 设置自定义日历选择器界面。
// 每个月的日期
List({initialIndex: this.initialIndex}) {
/**
* 性能知识点:列表中数据较多且不确定的情况下,使用LazyForEach进行数据循环渲染。
* 当组件滑出可视区域外时,框架会进行组件销毁回收以降低内存占用。
* 文档参考链接:https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V2/arkts-rendering-control-lazyforeach-0000001524417213-V2
*/
LazyForEach(this.contentData, (monthItem: Month) => {
// 设置ListItemGroup头部组件,显示年份和月份
ListItemGroup({ header: this.itemHead(monthItem.month) }) {
ListItem() {
Grid() {
// TODO: 高性能知识点: 此处日期固定,使用了ForEach,其他列表数量较多的场景,推荐使用LazyForEach+组件复用+缓存列表项实现
ForEach(monthItem.days, (day: number) => {
GridItem() {
Text(day.toString())
.fontSize($r('app.string.ohos_id_text_size_headline'))
.fontColor(day < this.currentDay && monthItem.num ===
this.currentMonth ? $r('app.color.ohos_id_color_text_secondary') : $r('app.color.ohos_id_color_text_primary'))
}
.borderRadius($r('app.string.ohos_id_corner_radius_default_m'))
.backgroundColor(day === this.dateModel.day && monthItem.num ===
this.dateModel.month ? $r('app.color.ohos_id_color_palette9') : $r('app.color.ohos_id_color_background'))
.opacity(day === 0 ? 0 : 1) // 将日期数组中为0的都设置为不显示,即不显示上个月和下个月的内容
// 点击选定的日期后,关闭日历弹窗,显示日期改变为选择的日期
.onClick(() => {
if (day >= this.currentDay || monthItem.num > this.currentMonth) {
let weekIndex = monthItem.days.indexOf(day) % WEEK_NUMBER; // 将当前日转换成星期显示
this.dateModel.day = day;
this.dateModel.week = weekIndex;
this.dateModel.month = monthItem.num;
DataManager.setDate(getContext(this), this.dateModel, () => {});
this.controller.close(); // 关闭自定义弹窗
}
})
})
}
.backgroundColor($r('app.color.ohos_id_color_background'))
.columnsTemplate('1fr 1fr 1fr 1fr 1fr 1fr 1fr')
// 当前月显示的数组元素个数大于35则显示6行,否则显示5行
.rowsTemplate(monthItem.days.length > MONTH_NUMBER ? '1fr 1fr 1fr 1fr 1fr 1fr' : '1fr 1fr 1fr 1fr 1fr')
.height(monthItem.days.length > MONTH_NUMBER ? GRID_HEIGHT_L : GRID_HEIGHT_M)
}
}
})
}
- 通过用户首选项实现选择的日期数据持久化。
static setDate(context: Context, dateModel: DateModel, callback: () => void) {
try {
// 获取Preferences实例
let promise = dataPreferences.getPreferences(context, 'date')
promise.then((object: dataPreferences.Preferences) => {
try {
// 将数据写入缓存的Preferences实例中
let setPromise = object.put('selectedDate', JSON.stringify(dateModel))
setPromise.then(() => {
// 将缓存的Preferences实例中的数据异步存储到用户首选项的持久化文件中
let flushPromise = object.flush()
flushPromise.then(() => {
// 创建单个AppStorage的键值对
AppStorage.setOrCreate<DateModel>('selectedDate', dateModel)
callback()
}).catch((err: Error) => {
callback()
console.error("LoginMessage: Failed to flush" + err.name + ", message = " + err.message)
})
}).catch((err: Error) => {
callback()
console.error("LoginMessage: Failed to put selectedDate" + err.name + ", message = " + err.message)
})
} catch (err) {
callback()
console.error("LoginMessage: Failed to put selectedDate" + err.name + ", message = " + err.message)
}
}).catch((err: Error) => {
callback()
console.error("LoginMessage: Failed to get preferences" + err.name + ", message = " + err.message)
})
} catch (err) {
callback()
console.error("LoginMessage: Failed to get preferences" + err.name + ", message = " + err.message)
}
}
高性能知识点
本示例使用了LazyForEach进行数据懒加载,List布局时会根据可视区域按需创建ListItem组件,并在ListItem滑出可视区域外时销毁以降低内存占用。
LazyForEach:数据懒加载
工程结构&模块类型
customcalendarpickerdialog // har类型
|---components
| |---DataManager.ets // 持久化方法
| |---DateModel.ets // 数据类型定义
| |---GetDate.ets // 获取日期信息
| |---MonthDataSource.ets // 数据类型定义
|---view
| |---CustomCalendarPickerDialog.ets // 视图层-自定义日历
| |---CalendarView.ets // 视图层-场景主页面
模块依赖
本实例依赖common模块来实现资源的调用。
参考资料
鸿蒙全栈开发全新学习指南
也为了积极培养鸿蒙生态人才,让大家都能学习到鸿蒙开发最新的技术,针对一些在职人员、0基础小白、应届生/计算机专业、鸿蒙爱好者等人群,整理了一套纯血版鸿蒙(HarmonyOS Next)全栈开发技术的学习路线【包含了大APP实战项目开发】。
本路线共分为四个阶段:
第一阶段:鸿蒙初中级开发必备技能
第二阶段:鸿蒙南北双向高工技能基础:gitee.com/MNxiaona/733GH
第三阶段:应用开发中高级就业技术
第四阶段:全网首发-工业级南向设备开发就业技术:https://gitee.com/MNxiaona/733GH
《鸿蒙 (Harmony OS)开发学习手册》(共计892页)
如何快速入门?
1.基本概念
2.构建第一个ArkTS应用
3.……
开发基础知识:gitee.com/MNxiaona/733GH
1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……
基于ArkTS 开发
1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……
鸿蒙开发面试真题(含参考答案):gitee.com/MNxiaona/733GH
鸿蒙入门教学视频:
美团APP实战开发教学:gitee.com/MNxiaona/733GH
写在最后
- 如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:
- 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。
- 关注小编,同时可以期待后续文章ing🚀,不定期分享原创知识。
- 想要获取更多完整鸿蒙最新学习资源,请移步前往小编:
gitee.com/MNxiaona/733GH