在鸿蒙（HarmonyOS）应用开发中，骨架屏（Skeleton Screen）是提升用户体验、消除页面加载时“白屏”感的关键组件。构建一个通用的骨架屏库，通常有“基于原生组件封装”和“引入成熟第三方库”两种主流方案。

方案一：基于原生组件快速封装

利用鸿蒙的ShimmerEffect闪光效果和@BuilderParam装饰器，可以快速封装一个不耦合具体业务的通用骨架屏组件。

核心原理：
通过@BuilderParam让外部传入任意需要占位的 UI 结构，组件内部根据isLoading状态决定是显示骨架屏还是真实内容。

@Component export struct GenericSkeleton { @Prop isLoading: boolean = true; @BuilderParam content: () => void; build() { if (this.isLoading) { // 骨架屏占位区域 Column() { this.content() } .width('100%') .height('100%') .backgroundColor('#F5F5F5') .borderRadius(8) .shimmerEffect({ direction: ShimmerDirection.LeftToRight, duration: 1500, color: '#E0E0E0' }) } else { // 加载完成，显示真实内容 this.content() } } }

使用示例：

@Entry @Component struct ProductPage { @State isLoading: boolean = true; @State product: Product = new Product(); aboutToAppear() { // 模拟网络请求 setTimeout(() => { this.product = fetchProductData(); this.isLoading = false; }, 2000); } build() { GenericSkeleton({ isLoading: this.isLoading }) { // 定义需要占位的UI结构 Column({ space: 10 }) { Rectangle().width(100).height(100).fillColor('#DDD') // 图片占位 Text(this.product.name).fontSize(20) // 文本占位 Text(this.product.price).fontSize(16) // 文本占位 } .padding(16) } } }

方案二：引入成熟的第三方组件库

如果希望获得更丰富的功能和更稳定的表现，可以引入鸿蒙生态市场中已有的优秀组件库。

• 功能丰富：这些库通常提供了多种预设的骨架屏模板（如列表、网格、详情页），并支持自定义颜色、圆角、动画时长等属性。
• 开箱即用：通过简单的配置即可快速集成，无需从零开始编写和调试动画逻辑，能极大缩短开发周期。
• 社区维护：成熟的第三方库经过社区广泛测试，稳定性和兼容性更有保障，并能及时修复已知问题。

进阶优化与工程化建议

1. 精细化占位：避免使用单一颜色的矩形占位。可以根据真实内容的布局，使用不同宽度的Rectangle来模拟标题、段落和图片，使骨架屏的轮廓更接近最终页面，提升视觉流畅度。
2. 动画性能优化：ShimmerEffect的动画频率和颜色对比度需要仔细调优。过快或过强的闪光效果可能会让用户感到不适。建议使用柔和的渐变色和适中的动画时长（如1.5秒）。
3. 与数据状态联动：将骨架屏的显示状态与数据获取的生命周期（如aboutToAppear）紧密结合。确保在数据请求开始时显示骨架屏，在数据返回并成功渲染后立即隐藏，避免不必要的闪烁。
4. 支持懒加载：对于长列表中的骨架屏，应结合LazyForEach实现懒加载。只有当列表项即将进入可视区域时，才渲染其对应的骨架屏，以节省系统资源，提升滚动性能。