HarmonyOS应用开发实战:萌宠日记 - 提醒完成状态切换

发布时间:2026/7/22 14:50:51
HarmonyOS应用开发实战:萌宠日记 - 提醒完成状态切换 HarmonyOS应用开发实战萌宠日记 - 提醒完成状态切换前言完成状态切换是提醒事项中标记任务已完成/待完成的核心交互。在萌宠日记的ReminderPage中用户可以通过点击 Checkbox或滑动操作来切换提醒的完成状态已完成的事项会以灰色文字 删除线样式展示与未完成事项形成视觉区分。本文将从萌宠日记中提醒完成状态切换的实现出发深入解析 Checkbox 组件使用、状态管理、已完成样式设计以及筛选联动。一、完成状态数据模型interface ReminderItem { icon: string title: string date: string daysLeft: string iconBg: string isCompleted: boolean // 完成状态 }二、状态切换实现// 点击切换完成状态 ListItem() { Row({ space: 12 }) { Checkbox() .select(item.isCompleted) .onChange((value: boolean) { item.isCompleted value // State 驱动 UI 更新 }) // 图标和标题 Column({ space: 4 }) { Text(item.title) .fontSize(15) .fontColor(item.isCompleted ? #CCCCCC : #333333) .decoration(item.isCompleted ? { type: TextDecorationType.LineThrough } : undefined) Text(item.date) .fontSize(12) .fontColor(item.isCompleted ? #CCCCCC : #999999) } } }三、已完成样式状态文字颜色文字装饰视觉效果未完成#333333深灰无正常显示已完成#CCCCCC浅灰删除线淡化标识四、筛选联动// 筛选状态与完成状态联动 get filteredReminders(): ReminderItem[] { if (this.selectedFilter 0) return this.reminders if (this.selectedFilter 1) return this.reminders.filter(r !r.isCompleted) return this.reminders.filter(r r.isCompleted) }五、总结本文从萌宠日记的提醒完成状态切换实现出发深入解析了状态切换的完整方案Checkbox 组件切换完成状态已完成样式灰色文字 删除线筛选联动完成状态与筛选标签联动至此模块九提醒事项的 6 篇文章全部完成。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源Checkbox 组件https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-checkboxTextDecorationTypehttps://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text7.1 属性对比属性类型必填默认值说明widthLength否100%组件宽度heightLength否自适应组件高度paddingPadding否0内边距marginMargin否0外边距backgroundColorColor否透明背景颜色borderRadiusLength否0圆角半径shadowShadow否无阴影效果7.2 布局属性对比布局方式适用场景主轴方向交叉轴对齐自动换行Column垂直排列竖直alignItems不支持Row水平排列水平alignItems不支持Flex灵活布局可配置alignItems支持Stack层叠布局无alignContent不支持Grid网格布局行列行列间距支持6、常见问题与解决方案6.1 布局问题在实际开发中开发者经常会遇到布局相关的常见问题组件不显示检查是否设置了正确的宽高或父容器是否限制了子组件大小布局错乱检查alignItems和justifyContent设置是否正确滚动失效确认 Scroll 组件的高度是否被正确限制提示布局问题通常可以通过borderWidth: 1临时添加边框来定位问题区域。6.2 性能问题列表卡顿使用 LazyForEach 替代 ForEach 实现懒加载频繁刷新合理使用状态管理装饰器避免不必要的组件重绘内存泄漏在页面销毁时及时释放资源和取消订阅// 懒加载示例 LazyForEach(this.dataSource, (item: DataItem) { ListItem() { Text(item.name).fontSize(16) } }, (item: DataItem) item.id.toString())7、最佳实践建议7.1 代码组织良好的代码组织可以显著提升项目的可维护性组件化设计将可复用的 UI 部分抽取为独立组件样式分离将常量和样式定义集中管理类型安全使用 interface 定义数据模型避免 any 类型7.2 性能优化减少不必要的重绘使用State时只声明需要响应式更新的变量合理使用布局避免过深的嵌套层级图片优化使用适当的图片格式和尺寸提示HarmonyOS 提供了一系列性能分析工具建议在开发过程中持续关注应用性能。8、与其他方案的对比8.1 方案对比对比维度本方案传统方案优势实现复杂度低中等更简洁维护成本低高更易维护扩展性好一般更灵活性能优秀良好更高效8.2 适用场景适合需要快速实现相关功能的场景不适合对性能有极致要求的场景需考虑其他方案总结本文从萌宠日记的实际开发案例出发深入解析了提醒完成状态切换的实现方案。通过本文的学习读者可以掌握以下核心知识点组件用法理解相关 ArkUI 组件的核心属性和使用场景布局技巧掌握常见的布局模式及其适用范围交互实现学习点击事件、状态管理等交互设计方案最佳实践了解实际项目中的工程化实践和性能考量在实际开发中建议根据具体业务需求灵活调整组件参数和布局结构以达到最佳的用户体验效果。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源Text 组件https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textColumn 容器https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-columnRow 容器https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-rowScroll 组件https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-scrollTabs 组件https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-tabsNavigation 组件https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-navigationGrid 组件https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-gridList 组件https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-listTextInput 组件https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textinputTextArea 组件https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textarea6.1 完整示例代码以下是一个完整的实际应用示例展示了相关组件的综合使用// 完整的组件使用示例 Component export struct DemoComponent { State message: string Hello HarmonyOS State count: number 0 build() { Column({ space: 16 }) { Text(this.message) .fontSize(24) .fontWeight(FontWeight.Bold) .fontColor(#333333) Text(点击次数: ${this.count}) .fontSize(16) .fontColor(#666666) Button(点击增加) .fontSize(16) .fontColor(Color.White) .backgroundColor(#F5A623) .borderRadius(20) .onClick(() { this.count }) } .width(100%) .height(100%) .padding(24) .backgroundColor(#FFF8F0) } }6.2 状态管理代码// 状态管理示例 State isActive: boolean false Prop title: string Link sharedValue: number build() { Column() { Text(this.title) .fontSize(18) .fontColor(this.isActive ? #F5A623 : #999999) Button(this.isActive ? 取消 : 激活) .onClick(() { this.isActive !this.isActive }) } }