鸿蒙 ArkTS 实战：Class Score Average 从成绩平均计算到成绩统计应用完整解析

鸿蒙 ArkTS 实战Class Score Average 从成绩平均计算到成绩统计应用完整解析前言成绩平均计算 是一个典型的鸿蒙 ArkTS 轻量工具页面。它围绕“维护一组成绩数组选择单项调整分数并实时计算平均分还可以新增 90 分记录。”这个明确需求把参数输入、公式计算、状态反馈和结果展示集中在同一屏。本文基于 Class Score Average 的真实源码展开重点分析State 状态建模、Slider 数值输入、Toggle 开关状态、ForEach 列表渲染、方法封装公式和条件样式反馈。工具型应用的关键不是页面复杂而是输入变化后结果足够清楚、足够及时。图示说明页面由标题摘要、参数控制、结果展示和业务说明组成适合学习 ArkTS 单页工具的状态流。一、项目场景1.1 业务目标维护一组成绩数组选择单项调整分数并实时计算平均分还可以新增 90 分记录。1.2 用户路径查看默认参数和初始结果。通过滑杆、按钮、开关或列表调整输入。页面立即重新计算并展示结果。用户根据结果完成估算、计划或记录。1.3 技术目标目标页面体现ArkTS 实现参数输入数字、开关、选项Slider / Toggle / ForEach状态保存当前数值和选择State公式计算税额、重量、费用、平均值方法封装结果反馈大数字和状态文案Text / Stack / 条件样式二、页面入口2.1 组件骨架EntryComponentstruct Index{build(){Column(){Text(成绩平均计算)}}}2.2 单页结构价值成绩平均计算 的主要状态是 scores、selected。这些字段都直接影响界面输出集中在一个组件中更利于理解数据流。2.3 页面分区区域作用常见组件顶部标题和核心结果Row、Text中部图形结果或列表Stack、Circle、ForEach底部参数和说明Slider、Button、Toggle三、状态建模3.1 State 字段字段类型说明scoresnumber[]成绩数组默认 92、88、95、79、84selectednumber当前选中的成绩索引3.2 状态声明EntryComponentstruct Index{Statescores:number[][92,88,95,79,84];// 成绩数组默认 92、88、95、79、84Stateselected:number0;// 当前选中的成绩索引}3.3 状态边界这些字段都贴近业务语言。数值字段用于计算布尔字段用于开关索引字段用于选择数组字段用于可变列表。状态字段越接近用户看到的业务概念后续调试就越轻松。四、业务数据4.1 静态配置scores92、88、95、79、844.2 列表渲染ForEach(this.items,(item:string,index:number){Text(item).fontSize(16).fontWeight(FontWeight.Bold).onClick((){this.selectedindex})})4.3 选中态表达.backgroundColor(this.selectedindex?#2563EB:#FFFFFF).fontColor(this.selectedindex?#FFFFFF:#2563EB)这种写法可以让当前选择、详情内容和视觉高亮保持同步。五、输入控件5.1 Slider 数值输入Slider 适合调节金额、天数、宽度、体重、分钟、比例、株距和成绩等范围参数。Slider({value:this.value,min:0,max:100,step:1}).onChange((value:number){this.valueMath.round(value)})5.2 Toggle 开关Toggle 用于含税、提醒、专注模式等二值状态。Toggle({type:ToggleType.Switch,isOn:this.enabled}).onChange((on:boolean){this.enabledon})5.3 Button 操作Button 用于新增、确认、重置或推进离散动作。Button(执行).backgroundColor(#2563EB).onClick((){this.count1})六、交互行为6.1 动作列表ForEach 渲染成绩列表点击行切换 selectedSlider 调整当前成绩avg 方法遍历数组求平均按钮向 scores 追加 90 分6.2 关键源码avg():number{letsum:number0for(leti0;ithis.scores.length;i){sumthis.scores[i]}returnMath.round(sum/this.scores.length)}6.3 反馈闭环ForEach 渲染成绩列表点击行切换 selectedSlider 调整当前成绩avg 方法遍历数组求平均按钮向 scores 追加 90 分交互闭环很简单用户改变输入状态字段更新公式重新计算Text 和颜色同步刷新。七、公式解析7.1 核心公式avground(sum(scores)/scores.length)7.2 方法封装当公式包含判断、循环或取整时用方法封装更清楚。privatecalc():number{returnMath.round(1)}7.3 结果渲染Text(结果String(value)).fontSize(40).fontWeight(FontWeight.Bold).fontColor(#2563EB)结果必须配合单位展示避免用户误解数字含义。八、视觉设计8.1 大数字税额、天数、码数、克数、金额、分钟、毫升、厘米、公里、分数等都适合用大字号强调。8.2 图形容器Stack、Circle、Rect 能让结果区域更集中。Stack(){Circle().width(200).height(200).fill(#F8FAFC)Text(核心结果)}8.3 条件颜色.fontColor(this.warning?#DC2626:#2563EB)8.4 文案提示Text(this.done?已完成:待处理)九、布局策略9.1 上下结构上下结构适合先展示标题和结果再展示参数控制。9.2 左右结构左右结构适合左侧大结果、右侧参数列表的工具页面。9.3 信息层级层级内容目的一级核心结果直接判断二级输入参数明确来源三级说明文案解释规则十、调试路径10.1 手动验证检查默认状态是否与源码一致。调整每个 Slider 或 Toggle。确认公式结果即时刷新。测试最小值、最大值和开关状态。10.2 日志辅助Button(调试).onClick((){console.info(state changed)})10.3 问题定位问题原因处理方式结果不变状态未写回检查 onChange数字异常公式边界未处理增加取整或限制文案不对条件分支错误单独验证布尔值列表错位index 映射错误对齐数组顺序十一、工程扩展11.1 历史记录可以保存每一次估算、换算、计划或统计结果方便后续对比。interfaceHistoryItem{title:stringinput:stringresult:stringcreatedAt:string}11.2 本地缓存用户经常重复使用同一组参数适合把最近一次状态缓存起来。11.3 分享结果{tool:成绩平均计算,state:scores、selected,result:calculated}十二、体验优化12.1 单位清晰元、天、码、克、分钟、毫升、厘米、公里、分数等单位必须紧跟结果。12.2 范围合理Slider 的 min、max、step 要符合真实使用场景。12.3 反馈直接工具页面不应该等提交后再展示结果输入变化后就应立即刷新。十三、完整片段13.1 状态骨架EntryComponentstruct Index{Statescores:number[][92,88,95,79,84];// 成绩数组默认 92、88、95、79、84Stateselected:number0;// 当前选中的成绩索引}13.2 数据配置// scores92、88、95、79、84privateprimaryColor:string#2563EB13.3 交互代码avg():number{letsum:number0for(leti0;ithis.scores.length;i){sumthis.scores[i]}returnMath.round(sum/this.scores.length)}13.4 样式代码Text(核心结果).fontSize(28).fontWeight(FontWeight.Bold).fontColor(#2563EB)十四、复用价值14.1 状态复用number 用于金额、天数、重量、比例和分数。boolean 用于提醒、含税和专注等开关。number[] 可用于成绩、清单和多项统计。14.2 公式复用成绩平均计算 的公式写法可以迁移到更多换算、预算、规划和统计页面。14.3 组件复用结果卡片、参数滑杆、选择标签和说明文案都可以抽成通用组件。十五、发布级拆解15.1 场景先行文章开头先说清楚 成绩平均计算 解决什么问题再进入 ArkTS 代码读者更容易理解公式意义。15.2 状态为线索围绕 scores、selected 展开讲解可以把页面输入、计算和结果串起来。15.3 公式落地公式avg round(sum(scores) / scores.length)是本项目的核心技术点应同时解释输入来源、计算过程和输出展示。15.4 边界意识工具页要关注极值、开关变化、数组索引和除法取整避免用户调整参数后出现异常结果。十六、总结Class Score Average 用简洁的 ArkTS 页面完成了 成绩统计 场景。它围绕 scores、selected 建模结合 scores92、88、95、79、84 组织输入并通过avg round(sum(scores) / scores.length)把业务规则转换成即时可见的结果。这类鸿蒙小工具的关键在于状态清楚、公式透明、反馈及时、边界稳定。理解这个项目后再开发税额计算、倒计日、尺寸换算、喂食计算、费用估算或成绩统计等页面都会更顺手。相关资源HarmonyOS 开发者官网ArkTS 语言指南ArkUI 开发框架