企业官网建设流程全解析

HarmonyOS应用开发实战：萌宠日记 - 疫苗/驱虫/体检记录卡片设计

前言

在萌宠日记的健康记录页中，疫苗、驱虫、体检三个分类的记录卡片是用户管理宠物健康的核心视图。每个分类的卡片具有统一的布局结构（标题 + 日期 + 状态），但根据业务特点又有差异化的字段展示（如疫苗有医生信息、驱虫有药品信息、体检有医院信息）。

本文将从萌宠日记中各分类记录卡片的实现出发，深入解析卡片设计的统一性与差异化，以及如何通过组件化设计实现分类卡片的复用。

一、卡片设计总览

1.1 各分类卡片结构

1.2 疫苗卡片实现

@Builder VaccineCard(record: VaccineRecord) { Row() { // 图标 Column() { Text('💉').fontSize(24) } .width(44).height(44) .backgroundColor('#E3F2FD') .borderRadius(12) .justifyContent(FlexAlign.Center) // 信息 Column({ space: 4 }) { Text(record.name).fontSize(15).fontWeight(FontWeight.Medium) Text(record.doctor).fontSize(12).fontColor('#999999') } .alignItems(HorizontalAlign.Start) .layoutWeight(1) .margin({ left: 12 }) // 日期 Column({ space: 2 }) { Text(record.date).fontSize(12).fontColor('#666666') Text(`下次: ${record.nextDate}`).fontSize(11).fontColor('#F5A623') } .alignItems(HorizontalAlign.End) } .width('100%').padding(16) .backgroundColor('#FFFFFF').borderRadius(12) }

二、卡片组件化

2.1 通用卡片模板

@Component export struct HealthRecordCard { @Prop icon: string = '' @Prop bgColor: string = '#F5F5F5' @Prop title: string = '' @Prop subtitle: string = '' @Prop date: string = '' @Prop nextDate: string = '' build() { Row() { Column() { Text(this.icon).fontSize(24) } .width(44).height(44) .backgroundColor(this.bgColor) .borderRadius(12) .justifyContent(FlexAlign.Center) Column({ space: 4 }) { Text(this.title).fontSize(15).fontWeight(FontWeight.Medium) Text(this.subtitle).fontSize(12).fontColor('#999999') } .layoutWeight(1).margin({ left: 12 }) .alignItems(HorizontalAlign.Start) Column({ space: 2 }) { Text(this.date).fontSize(12).fontColor('#666666') Text(`下次: ${this.nextDate}`).fontSize(11).fontColor('#F5A623') } .alignItems(HorizontalAlign.End) } .width('100%').padding(16) .backgroundColor('#FFFFFF').borderRadius(12) } }

三、各分类卡片使用

// 疫苗卡片 HealthRecordCard({ icon: '💉', bgColor: '#E3F2FD', title: record.name, subtitle: record.doctor, date: record.date, nextDate: record.nextDate }) // 驱虫卡片 HealthRecordCard({ icon: '️', bgColor: '#E8F5E9', title: record.type, subtitle: record.product, date: record.date, nextDate: record.nextDate }) // 体检卡片 HealthRecordCard({ icon: '🏥', bgColor: '#FCE4EC', title: record.hospital, subtitle: record.result, date: record.date, nextDate: '—' })

四、总结

本文从萌宠日记的疫苗/驱虫/体检记录卡片实现出发，深入解析了分类卡片设计的完整方案：

1. 卡片结构：图标 + 信息 + 日期三列布局
2. 组件化设计：通用 HealthRecordCard 组件
3. 差异化配置：通过参数控制图标、背景色、内容
4. 统一风格：44×44 图标、15fp 标题、12fp 副标题

通过组件化设计，各分类卡片在保持统一视觉风格的同时，又能灵活展示不同的业务数据。

如果这篇文章对你有帮助，欢迎点赞👍、收藏⭐、关注🔔，你的支持是我持续创作的动力！

相关资源：

• @Component 组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-create-custom-components
• @Prop 装饰器：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-prop
• Row 组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-row

7.1 属性对比

7.2 布局属性对比

5、常见问题与解决方案

5.1 布局问题

在实际开发中，开发者经常会遇到布局相关的常见问题：

• 组件不显示：检查是否设置了正确的宽高，或父容器是否限制了子组件大小
• 布局错乱：检查alignItems和justifyContent设置是否正确
• 滚动失效：确认 Scroll 组件的高度是否被正确限制

提示：布局问题通常可以通过borderWidth: 1临时添加边框来定位问题区域。

5.2 性能问题

• 列表卡顿：使用 LazyForEach 替代 ForEach 实现懒加载
• 频繁刷新：合理使用状态管理装饰器，避免不必要的组件重绘
• 内存泄漏：在页面销毁时及时释放资源和取消订阅

// 懒加载示例 LazyForEach(this.dataSource, (item: DataItem) => { ListItem() { Text(item.name).fontSize(16) } }, (item: DataItem) => item.id.toString())

6、最佳实践建议

6.1 代码组织

良好的代码组织可以显著提升项目的可维护性：

1. 组件化设计：将可复用的 UI 部分抽取为独立组件
2. 样式分离：将常量和样式定义集中管理
3. 类型安全：使用 interface 定义数据模型，避免 any 类型

6.2 性能优化

1. 减少不必要的重绘：使用@State时只声明需要响应式更新的变量
2. 合理使用布局：避免过深的嵌套层级
3. 图片优化：使用适当的图片格式和尺寸

提示：HarmonyOS 提供了一系列性能分析工具，建议在开发过程中持续关注应用性能。

7、与其他方案的对比

7.1 方案对比

7.2 适用场景

• 适合：需要快速实现相关功能的场景
• 不适合：对性能有极致要求的场景（需考虑其他方案）

8、实际开发建议

8.1 工程化实践

在实际项目中，建议遵循以下工程化实践：

1. 组件化设计：将可复用的 UI 部分抽取为独立组件，提高代码复用率
2. 类型安全：使用 interface 定义数据模型，避免使用 any 类型
3. 样式统一：将颜色、字体、间距等常量集中管理

// 类型定义示例 export interface DataModel {{ id: string name: string icon: string color: string }}

提示：良好的工程化实践可以显著提升项目的可维护性和团队协作效率。

8.2 性能优化建议

• 减少组件嵌套：避免过深的布局层级，建议不超过 5 层
• 合理使用状态管理：只在需要响应式更新的变量上使用 @State
• 懒加载数据：使用 LazyForEach 替代 ForEach 处理大量数据

8.3 调试技巧

1. 日志输出：使用hilog输出关键信息，便于定位问题
2. 布局调试：临时添加borderWidth: 1查看组件边界
3. 性能分析：使用 DevEco Studio 的 Profiler 工具分析性能瓶颈

// 日志输出示例 import {{ hilog }} from '@kit.PerformanceAnalysisKit' const DOMAIN = 0xFF00 const TAG = 'Demo' hilog.info(DOMAIN, TAG, '调试信息: %{{public}}s', JSON.stringify(data))

在开发过程中，建议持续使用调试工具定位和解决问题，而非等到最后统一排查。

总结

本文从萌宠日记的实际开发案例出发，深入解析了疫苗驱虫体检记录卡片设计的实现方案。

通过本文的学习，读者可以掌握以下核心知识点：

1. 组件用法：理解相关 ArkUI 组件的核心属性和使用场景
2. 布局技巧：掌握常见的布局模式及其适用范围
3. 交互实现：学习点击事件、状态管理等交互设计方案
4. 最佳实践：了解实际项目中的工程化实践和性能考量

在实际开发中，建议根据具体业务需求灵活调整组件参数和布局结构，以达到最佳的用户体验效果。

如果这篇文章对你有帮助，欢迎点赞👍、收藏⭐、关注🔔，你的支持是我持续创作的动力！

相关资源：

• Text 组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text
• Column 容器：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-column
• Row 容器：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-row
• Scroll 组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-scroll
• Tabs 组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-tabs
• Navigation 组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-navigation
• Grid 组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-grid
• List 组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list
• TextInput 组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textinput
• TextArea 组件：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textarea

6.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 }) } }