首页布局重构——从课程列表到英语学习首页一、首页的定位与模块概览首页是用户打开应用后看到的第一个界面。在英语学习 App 中首页需要同时满足快速开始学习和了解学习进展两个核心诉求。本项目的首页MainPage.ets位于features/homePage/src/main/ets/pages/MainPage.ets由 6 个 Builder 模块组成MainPage (Column) ├── topBarBuilder() → 顶部搜索栏 ├── todayStudyBuilder() → 今日学习卡 ├── swiperBuilder() → 轮播图 ├── functionBarBuilder() → 5 宫格功能入口 ├── practiceModeBuilder() → 2x2 练习模式 └── subjectPracticeBuilder() → 学习进度区二、模块详细分析2.1 顶部搜索栏topBarBuilderBuildertopBarBuilder(){Row(){// Logo 或标题Text(英语学习).fontSize(22).fontWeight(FontWeight.Bold);Blank();// 搜索图标Image($r(app.media.ic_search)).width(24).height(24);// 消息图标Image($r(app.media.ic_mic)).width(24).height(24);}.width(100%).padding({top:12,bottom:8});}搜索栏布局为 “标题 Blank 图标” 的左中右结构。Blank()组件自动填充中间空白区域将图标推到右侧。2.2 今日学习卡todayStudyBuilder今日学习卡展示用户当日的学习进展是本页最核心的信息模块BuildertodayStudyBuilder(){Column(){Row(){Column(){Text(今日学习).fontSize(16).fontWeight(FontWeight.Bold);Text(坚持学习成为更好的自己).fontSize(12).fontColor(Color.Gray);}.alignItems(HorizontalAlign.Start);Blank();// 学习进度圆环Progress({value:65,total:100,type:ProgressType.Ring}).width(50).height(50).color(#165DFF).style({strokeWidth:4});}.width(100%);// 今日目标进度条Progress({value:13,total:30,type:ProgressType.Linear}).width(100%).height(6).color(#165DFF);Text(今日已学 13/30 词).fontSize(11).fontColor(Color.Gray);}.padding(16).borderRadius(16).backgroundColor(Color.White);}学习卡使用Progress组件来可视化目标完成度环形进度展示总体完成率线性进度条显示具体的单词学习进度。2.3 轮播图swiperBuilder使用 ArkUI 的 Swiper 组件实现广告或功能推荐轮播BuilderswiperBuilder(){Swiper(){ForEach(this.bannerList,(item:BannerItem){Image(item.image).width(100%).aspectRatio(2.2).borderRadius(12);});}.autoPlay(true).interval(3000).indicator(true).loop(true);}Swiper 通过autoPlay开启自动轮播interval设置 3 秒切换间隔indicator显示底部导航点。2.4 5 宫格功能入口functionBarBuilder将核心功能以网格形式展示每个入口由图标 文字组成Localfunctions:CourseCoreBar[][newCourseCoreBar($r(app.media.ic_practice_camera),搜单词),newCourseCoreBar($r(app.media.ic__practice_wrong_question),易错词),newCourseCoreBar($r(app.media.ic_practice_star),生词本),newCourseCoreBar($r(app.media.ic_practice_notes),笔记),newCourseCoreBar($r(app.media.ic_chart_report),学习报告)];BuilderfunctionBarBuilder(){Grid(){ForEach(this.functions,(item:CourseCoreBar){GridItem(){Column(){Image(item.icon).width(32).height(32);Text(item.label).fontSize(12).margin({top:4});}}});}.columnsTemplate(1fr 1fr 1fr 1fr 1fr).rowsTemplate(1fr).columnsGap(8);}columnsTemplate(1fr 1fr 1fr 1fr 1fr)将 Grid 分为 5 等份每个 GridItem 占据一格形成经典的 5 宫格布局。2.5 2x2 练习模式practiceModeBuilder用 Grid 的 2 行 2 列展示练习模式入口比 5 宫格更开阔BuilderpracticeModeBuilder(){Grid(){ForEach(this.practiceModes,(item:PracticeMode){GridItem(){Column(){Text(item.title).fontSize(16).fontWeight(FontWeight.Bold);Text(item.desc).fontSize(12).fontColor(Color.Gray);}.padding(20).borderRadius(16).backgroundColor(item.color);}});}.columnsTemplate(1fr 1fr).rowsTemplate(1fr 1fr).rowsGap(12).columnsGap(12);}每个 GridItem 是一张带有背景色的卡片展示 CET-4 核心词汇、听力训练、阅读理解、语法练习四个入口。2.6 学习进度区subjectPracticeBuilder展示按学科分类的详细学习进度LocalcoursePractice:CourseQuestions[][newCourseQuestions(CET-4 核心词汇,120,300,85,2025-01-15 14:30),newCourseQuestions(CET-6 高频词汇,1024,3411,85,2025-01-15 14:30),// ...];每项展示已学题数/总题数、正确率、最后学习时间。三、整体布局分析build(){Column(){Flex({direction:FlexDirection.Column}){this.topBarBuilder();Scroll(){Column({space:10}){this.todayStudyBuilder();this.swiperBuilder();this.functionBarBuilder();this.practiceModeBuilder();this.subjectPracticeBuilder();Blank().layoutWeight(1);}}.scrollBar(BarState.Off).layoutWeight(1);};}.padding({left:16,right:16}).backgroundColor($r(sys.color.background_secondary)).width(100%).height(100%);}布局要点顶部搜索栏固定在顶部不随滚动移动内容区域用Scroll包裹处理内容超长时的滚动layoutWeight(1)让 Scroll 填充剩余高度统一使用space: 10控制模块间距整体使用Flex垂直布局固定顶部 滚动区域四、与课程列表首页的区别从课程列表到英语学习首页的本质变化对比维度课程列表首页英语学习首页核心目标浏览课程快速学习 查看进展布局结构列表 (List)卡片组合 (Card Grid)数据展示课程名称、价格学习进度、功能入口用户状态浏览者学习者有学习历史交互重心点击进入详情直接开始学习首页不再是商店货架式的课程陈列而是围绕今日学习展开的进度中心。每个模块都在引导用户进入学习状态这是英语学习 App 与教育 App 在设计理念上的关键区别。五、总结MainPage 的 6 个 Builder 模块展示了 ArkTS 强大的组件化能力。通过Builder装饰器将首页拆分为独立模块每个模块聚焦一个功能点既便于阅读和维护也为后续的个性化配置如用户自定义首页模块的排序奠定了基础。
