鸿蒙5.0实战案例:骨架屏实现案例
本示例介绍通过骨架屏提升加载时用户体验的方法。骨架屏用于在页面数据加载完成前,先给用户展示出页面的大致结构(通常以灰色或其他浅色系的占位图形式呈现),待接口数据加载完成后,再渲染出实际页面内容并替换掉骨架屏。通过网络接口返回的状态改变 loadingCollectedStatus 值,动态切换页面内容:初始显示骨架屏(LoadingView);成功且有数据则显示列表页(ListView);数据为空
·
往期推文全新看点(文中附带全新鸿蒙5.0全栈学习笔录)
✏️ 鸿蒙(HarmonyOS)北向开发知识点记录~
✏️ 鸿蒙(OpenHarmony)南向开发保姆级知识点汇总~
✏️ 鸿蒙应用开发与鸿蒙系统开发哪个更有前景?
✏️ 嵌入式开发适不适合做鸿蒙南向开发?看完这篇你就了解了~
✏️ 对于大前端开发来说,转鸿蒙开发究竟是福还是祸?
✏️ 鸿蒙岗位需求突增!移动端、PC端、IoT到底该怎么选?
✏️ 记录一场鸿蒙开发岗位面试经历~
✏️ 持续更新中……
介绍
本示例介绍通过骨架屏提升加载时用户体验的方法。骨架屏用于在页面数据加载完成前,先给用户展示出页面的大致结构(通常以灰色或其他浅色系的占位图形式呈现),待接口数据加载完成后,再渲染出实际页面内容并替换掉骨架屏。 通过网络接口返回的状态改变 loadingCollectedStatus 值,动态切换页面内容:初始显示骨架屏(LoadingView);成功且有数据则显示列表页(ListView);数据为空显示无数据页(NoneContentView);加载失败则显示失败页(LoadingFailedView)。
效果图预览

使用说明
- 进入页面开始加载,加载完成后显示整个界面。
实现思路
- 为了实现骨架屏的加载效果,首先自行构造一个网络JSON数据供请求使用(此处不详述具体过程)。在aboutToAppear生命周期方法中加载网络数据,并根据返回结果改变状态变量loadingCollectedStatus的值。
aboutToAppear() {
this.loadList();
}
// 加载网络数据
loadList() {
// 正在加载状态
this.loadingCollectedStatus = LoadingStatus.LOADING;
let httpRequest = http.createHttp();
// 设置发起请求可选参数
let options: http.HttpRequestOptions = {
expectDataType: http.HttpDataType.OBJECT, // 可选,指定返回数据的类型
};
httpRequest.request(REQUEST_URL, options,
(err: Error, data: http.HttpResponse) => {
if (!err) {
if (data.responseCode === CommonConstants.SUCCESS) {
// 数据加载成功
this.loadingCollectedStatus = LoadingStatus.SUCCESS;
// 加载数据的处理
this.dataSource.pushArrayData(data.result['data'] as Array<Model>)
} else {
// 数据加载失败
this.loadingCollectedStatus = LoadingStatus.FAILED;
}
} else {
// 数据加载失败
this.loadingCollectedStatus = LoadingStatus.FAILED;
}
});
}
- 根据LoadingStatus的值渲染不同的页面内容:当LoadingStatus为LOADING时,显示骨架屏(LoadingView);若LoadingStatus为SUCCESS且dataSource.totalCount大于零,则显示列表页(ListView);若数据为空,则显示无数据页面(NoneContentView);若LoadingStatus为FAILED,则显示加载失败页面(LoadingFailedView)。
build() {
Column() {
if (this.loadingCollectedStatus === LoadingStatus.LOADING) {
// 加载骨架屏
LoadingView()
} else if (this.loadingCollectedStatus === LoadingStatus.FAILED) {
// 网络请求失败
LoadingFailedView(() => {
this.loadList();
})
} else if (this.dataSource.totalCount() === 0) {
// 获取数据为空
NoneContentView($r("app.media.ic_browse_no"), $r("app.string.ske_to_view"))
} else {
// 加载列表
ListView({ listData: this.dataSource })
}
}
.backgroundColor($r("app.color.ske_list_back_ground_color"))
.height(CommonConstants.FULL_PERCENT)
.width(CommonConstants.FULL_PERCENT)
}
- 实现与真实列表布局一致的骨架屏效果,采用如下步骤:首先,使用Row控件并设置灰色背景还原ListItem上所有的控件位置和大小,通过ForEach循环创建列表项,以此形成骨架屏的基本结构;接着,为骨架屏列表添加animateTo显示动画,这样在加载过程中,骨架屏就会呈现出闪烁的效果,从而提升用户体验。
// 骨架屏的闪烁动画
startAnimation(): void {
animateTo(CommonConstants.SKELETON_ANIMATION, () => {
// 动态修改骨架屏的透明度
this.listOpacity = CommonConstants.HALF_OPACITY;
});
}
build() {
Row() {
List({ space: CommonConstants.SPACE_12 }) {
ForEach(SkeletonData, (item: SkeletonType) => {
ListItem() {
// 骨架屏布局
ArticleLoadingSkeleton(item.isMine)
}
})
}
.layoutWeight(CommonConstants.LAYOUT_WEIGHT)
.scrollBar(BarState.Off)
.padding({
left: $r("app.float.ske_md_padding_margin"),
right: $r("app.float.ske_md_padding_margin")
})
}
.alignItems(VerticalAlign.Top)
.height(CommonConstants.FULL_PERCENT)
.width(CommonConstants.FULL_PERCENT)
.opacity(this.listOpacity)
// 组件挂载显示后触发此回调,调用动画接口给组件添加动画。
.onAppear(() => {
this.startAnimation();
})
}
更多推荐



所有评论(0)