企业官网建设流程全解析

鸿蒙5.0开发实战系列（一）：黑马云音乐“猜你喜欢”列表布局实现

在鸿蒙5.0应用开发的学习过程中，页面布局是基础且核心的能力。本文将基于ArkTS技术，手把手带大家完成黑马云音乐“猜你喜欢”歌曲列表的布局开发，同时掌握鸿蒙开发中的多个关键组件与属性用法。

一、布局核心思路

在开始代码编写前，先明确鸿蒙页面布局的核心套路——先整体再局部，先布局再内容后美化。

• 先整体再局部：从最外层容器开始，由外到内分层搭建页面结构，避免一上来就陷入细节开发。
• 先布局再内容后美化：先放置布局容器组件确定页面骨架，再填充文本、图片等内容组件，最后通过各类属性调整样式，让页面更美观。

二、整体容器与安全区配置

1. 外层容器搭建

页面整体内容为垂直排列，因此最外层选择column组件作为容器，同时设置宽高为100%，并配置背景色，让容器铺满整个屏幕：

Column(){// 后续内容将写在此处}.width('100%').height('100%').backgroundColor('#你的背景色值')

2. 安全区扩充

默认情况下，组件的背景色无法覆盖手机状态栏和底部导航栏的系统预留区域。此时可通过ExpandSafeArea属性扩充组件安全区，实现背景色全屏覆盖：

Column(){// 页面内容}// 其他属性....expandSafeArea({top:true,bottom:true})

三、标题“猜你喜欢”实现

在column容器内添加text组件实现标题，具体配置如下：

1. 文字与颜色：设置文字为“猜你喜欢”，并将字体颜色改为白色，避免与深色背景融合：fontColor('#FFFFFF')。
2. 左对齐处理：给text组件设置宽度100%，实现文字左对齐：.width('100%')。
3. 间距控制：给外层column添加左右内边距（如10），防止内容紧贴屏幕边缘；同时给标题text设置底部外边距（如10），预留与下方歌曲列表的间距。

核心代码示例：

Text('猜你喜欢').fontColor('#FFFFFF').width('100%').margin({bottom:10})

四、滚动歌曲列表实现

歌曲数量较多时需要支持滚动，鸿蒙中可通过list容器组件实现该效果，搭配listItem承载单首歌的布局。

1. 基础滚动结构

List(){ListItem(){// 单首歌布局内容}}// 关闭滚动条.scrollBar(BarState.Off)

若需要展示多首歌，可复制多个listItem，后续可结合数据实现动态渲染。

2. 单首歌横向布局容器

单首歌的封面、文字、更多按钮为横向排列，因此在listItem内使用row组件作为容器，并设置宽高和临时背景色辅助调试：

ListItem(){Row(){// 封面、文字、更多按钮内容}.width('100%').height(80)// 调试用背景色，完成后可删除.backgroundColor(Color.Pink)}

五、单首歌各区域布局实现

1. 左侧歌曲封面

使用image组件引入封面图，同时设置尺寸、圆角和间距：

Image($r('app.media.cover')).width(80).height(80)// 设置圆角.border({radius:8})// 与中间文字预留间距.margin({right:10})

2. 右侧更多图标

更多图标为SVG格式，可通过fillColor修改颜色，同时设置合适尺寸：

Image($r('app.media.more')).width(24).height(24).fillColor('#你的图标颜色值')

为让图标自动靠右，需给中间文字区域的容器添加layoutWeight(1)，使其占据剩余空间，挤压图标到右侧。

3. 中间文字区域

中间文字包含歌名、VIP标识和歌手名，需嵌套column和row组件实现：

• 歌名：用text组件展示，设置白色、左对齐、加粗样式，并添加底部外边距：

Text('麝香夫人').fontColor('#FFFFFF').width('100%').fontWeight(FontWeight.Bold).margin({bottom:15})

• VIP标识与歌手名：用row组件承载，给VIP标识添加边框、圆角和内边距，同时设置与歌手名的间距：

Row(){Text('VIP').fontColor('#金色值').border({width:1,color:'#金色值',radius:12}).padding({left:5,right:5,top:3,bottom:3}).margin({right:10})Text('凤凰传奇').fontColor('#浅灰色值')}.width('100%')

这是最终的结果，大家可以看一下

六、核心知识点总结

1. list组件：用于实现滚动列表，搭配listItem承载列表项，通过scrollBar(BarState.Off)可关闭滚动条。
2. layoutWeight属性：设置为1时，组件将占据外层容器的剩余空间，常用于实现“左右固定、中间自适应”的布局。
3. ExpandSafeArea属性：可扩充组件安全区，让背景色等样式覆盖系统预留的状态栏和导航栏区域。

本文是鸿蒙5.0开发实战系列的第一篇，后续将继续分享鸿蒙应用开发的更多实战技巧与核心知识点，欢迎持续关注！