HarmonyOS菜谱——首页架构与搜索分类实现详解

发布时间:2026/9/14 22:55:47

HarmonyOS菜谱——首页架构与搜索分类实现详解 菜谱 App 是一个结构清晰的三页面应用——首页展示所有菜谱分类页按类别筛选详情页展示做法步骤。首页作为入口承担了搜索、分类导航、菜谱列表三个核心功能。从截图看页面从上到下依次是标题区“美味菜谱” 渐变头像、搜索栏、6 个分类图标、8 道菜谱卡片列表。完整效果一、数据层设计接口与查询函数exportinterfaceRecipe{id:number;name:string;icon:string;category:string;time:string;difficulty:stringservings:string;desc:string;ingredients:Ingredient[];steps:string[];tips:string}exportinterfaceIngredient{name:string;amount:string}exportinterfaceCategory{name:string;icon:string;color:string}三个接口定义了三种数据结构。Recipe接口有 12 个字段是三个 App 里字段最多的接口——涵盖了菜谱的所有信息基本信息name/icon/category、属性time/difficulty/servings、详细内容ingredients/steps/tips。ingredients是嵌套数组——每个食材是一个{ name, amount }对象。这种数组里套对象的结构在详情页需要遍历展示。steps是字符串数组——每步是一个完整的操作说明不需要额外的结构。Category接口只有 3 个字段——name分类名、iconemoji 图标、color主题色。每个分类有独立的颜色用于分类图标的背景色和分类页的强调色。数据查询函数exportfunctiongetRecipeById(id:number):Recipe|undefined{for(leti:number0;iRECIPES.length;i){if(RECIPES[i].idid)returnRECIPES[i]}returnundefined}exportfunctiongetRecipesByCat(cat:string):Recipe[]{constr:Recipe[][]for(leti:number0;iRECIPES.length;i){if(RECIPES[i].categorycat)r.push(RECIPES[i])}returnr}两个查询函数的实现风格和智能家居 App 的 DeviceData 一致——全部用 for 循环遍历数组。getRecipeById返回单个 Recipe 或 undefined找不到时getRecipesByCat返回新数组过滤后的结果。getRecipeById返回Recipe | undefined而不是Recipe——TypeScript 的联合类型。调用方需要处理 undefined 的情况比如if (this.recipe)判断后再使用这比直接返回 null 更安全编译器会强制你检查。二、首页的四个区块区块一Header 标题区Row(){Column(){Text(美味菜谱).fontSize(26).fontWeight(FontWeight.Bold).fontColor(T1)Text(8道精选 · 家常好味道).fontSize(13).fontColor(T2).margin({top:2})}.alignItems(HorizontalAlign.Start).layoutWeight(1)Stack(){Column(){}.width(42).height(42).borderRadius(21).linearGradient({angle:135,colors:[[A,0],[#FF9F43,1]]})Text().fontSize(18)}}.width(100%).padding({left:18,right:18,top:14}).margin({bottom:14})Header 结构和前面三个 App 的首页完全一致——左侧标题 右侧渐变头像。区别是渐变色从主色#FF6B6B渐变到橙色#FF9F43而不是主色到浅紫色。这个橙色渐变呼应了菜谱的温暖调性——红色和橙色都是暖色系让人联想到食物和烹饪。8道精选 · 家常好味道是硬编码的——没有从RECIPES.length动态计算。如果以后增加菜谱需要手动更新这个数字。区块二搜索栏Row(){SymbolGlyph($r(sys.symbol.magnifyingglass)).fontSize(16).fontColor([T3]).margin({left:12})TextInput({placeholder:搜索菜谱...,text:this.searchText}).layoutWeight(1).height(40).backgroundColor(transparent).fontSize(14).onChange((v:string){this.searchTextv})}.width(100%).height(40).backgroundColor(#F0EEF4).borderRadius(20).padding({left:16,right:16}).margin({left:16,right:16,bottom:16})搜索栏用 Row 水平排列放大镜图标和输入框。逐行分析SymbolGlyph($r(sys.symbol.magnifyingglass))——放大镜图标用系统 SymbolGlyph 而不是 emoji。SymbolGlyph 的视觉风格更统一、更规范适合做功能性图标搜索、返回、箭头等。emoji 适合做装饰性图标食物、房间等。TextInput({ placeholder: 搜索菜谱..., text: this.searchText })——输入框placeholder 是灰色提示文字text 绑定State searchText。用户输入时触发.onChange更新this.searchText。backgroundColor(transparent)——输入框背景透明。输入框的背景色由外层 Row 的#F0EEF4提供输入框本身不需要额外背景。如果给 TextInput 加了背景色会和 Row 的背景叠加看起来有两层颜色。搜索功能的当前状态searchText会实时更新输入什么显示什么但没有实际的过滤逻辑——下方的菜谱列表始终显示全部 8 道菜不会根据搜索文字筛选。这是一个 UI 占位后续需要实现过滤// 后续需要实现的过滤逻辑getFilteredRecipes():Recipe[]{if(this.searchText)returnRECIPESconstresult:Recipe[][]for(leti0;iRECIPES.length;i){if(RECIPES[i].name.includes(this.searchText)||RECIPES[i].desc.includes(this.searchText)){result.push(RECIPES[i])}}returnresult}区块三分类导航Text(分类).fontSize(17).fontWeight(FontWeight.Bold).fontColor(T1).width(100%).padding({left:16}).margin({bottom:8})Row({space:8}){ForEach(CATS,(cat:Category){Column(){Text(cat.icon).fontSize(28).margin({bottom:4})Text(cat.name).fontSize(11).fontColor(T1)}.layoutWeight(1).padding({top:12,bottom:12}).backgroundColor(cat.color12).borderRadius(14).onClick((){router.pushUrl({url:pages/CategoryPage,params:{cat:cat.name}asRecordstring,Object})})})}.width(100%).padding({left:16,right:16}).margin({bottom:18})分类区域用 Row 横向排列 6 个分类图标。逐个分析关键点Row({ space: 8 })——6 个分类之间间距 8vp。总宽度 6 个分类 × 各自宽度 5 个间距 × 8vp。每个分类用.layoutWeight(1)均分剩余空间所以不需要手动计算宽度。cat.color 12——分类背景色用主题色 18% 透明度。每个分类有自己的颜色家常菜#FF6B6B、汤粥#FF9F43 等加透明度后变成浅色背景。6 个分类的背景色各不相同形成彩色标签的视觉效果。路由跳转——点击分类跳转到 CategoryPage传递cat参数分类名。CategoryPage 用getRecipesByCat(cat)过滤出该分类下的菜谱。参数是字符串不是 id因为分类数据比较简单直接传名字比传 id 更直观。分类和菜谱的关联方式——Category 的name和 Recipe 的category字段用中文字符串匹配“家常菜”汤粥等。这种字符串外键在原型阶段最直观但真实 App 应该用数字 id 关联避免中文编码问题。区块四菜谱列表Text(全部菜谱).fontSize(17).fontWeight(FontWeight.Bold).fontColor(T1).width(100%).padding({left:16}).margin({bottom:8})Column({space:10}){ForEach(RECIPES,(r:Recipe){Row(){Text(r.icon).fontSize(36).width(64).height(64).borderRadius(16).backgroundColor(#F5F5FA).textAlign(TextAlign.Center)Column(){Text(r.name).fontSize(15).fontWeight(FontWeight.Bold).fontColor(T1)Text(r.desc).fontSize(11).fontColor(T3).maxLines(1).margin({top:2})Row(){Text(⏱ r.time).fontSize(10).fontColor(T2)Text( · r.difficulty).fontSize(10).fontColor(T2)Text( · r.servings).fontSize(10).fontColor(T2)}.margin({top:4})}.alignItems(HorizontalAlign.Start).margin({left:12}).layoutWeight(1)SymbolGlyph($r(sys.symbol.chevron_right)).fontSize(14).fontColor([#DDD])}.width(100%).padding(14).backgroundColor(CW).borderRadius(16).shadow({radius:4,color:rgba(0,0,0,0.03),offsetY:1}).onClick((){router.pushUrl({url:pages/RecipeDetail,params:{id:r.id}asRecordstring,Object})})})}.width(100%).padding({left:16,right:16})菜谱列表用Column({ space: 10 })垂直排列每个菜谱是一个横向卡片。逐行拆解卡片结构左侧 emoji 图标——Text(r.icon).fontSize(36).width(64).height(64)。64×64 的固定区域emoji 居中显示。背景色#F5F5FA是极浅的灰色让 emoji 在白色卡片上有一个底座。borderRadius(16)让背景变成圆角矩形。中间信息区——三行文字第一行菜名15px 粗体深色第二行描述11px 灰色maxLines(1)限制最多一行超出部分省略第三行时间 难度 人数10px 灰色用 “·” 分隔maxLines(1)——文本截断。菜谱描述可能很长比如红烧肉的肥而不腻入口即化的经典红烧肉米饭杀手限制一行后超出部分显示省略号。这保证所有卡片的高度一致不会因为描述长短不同导致卡片高低不齐。右侧箭头——SymbolGlyph($r(sys.symbol.chevron_right))灰色 14px。和前面 App 的右箭头一致表示可点击查看详情。卡片阴影——.shadow({ radius: 4, color: rgba(0,0,0,0.03), offsetY: 1 })。4vp 模糊半径、3% 黑色透明度、1vp 向下偏移。这是项目里最轻的阴影——首页的设备状态卡片用的是 radius: 16、A‘25’ 的重阴影。菜谱卡片用轻阴影是因为卡片数量多8 个重阴影会让页面看起来太厚重。路由跳转——点击卡片跳转到 RecipeDetail传递id参数菜谱 id。和分类页传名字不同详情页传数字 id——因为 Recipe 有 12 个字段传 id 比传所有字段更高效详情页通过getRecipeById(id)查询完整数据。三、State 的当前用途首页只有一个 StateStatesearchText:string这个 State 绑定了搜索框的输入内容——用户输入时.onChange更新它搜索框显示它的值。但目前没有用它做任何过滤操作——菜谱列表始终用RECIPES全量数据没有根据searchText筛选。和前面几个 App 对比首页的 State 数量是最少的——只有一个搜索文本。这说明首页的数据流很简单所有数据从 RecipeData 直接读取不需要在页面里维护额外的状态副本。搜索功能如果后续实现需要新增一个State filteredRecipes: Recipe[] []在searchText变化时重新计算过滤结果。四、首页和 CategoryPage 的代码复用对比首页的菜谱卡片和 CategoryPage 的菜谱卡片首页Row(){Text(r.icon).fontSize(36).width(64).height(64).borderRadius(16).backgroundColor(#F5F5FA).textAlign(TextAlign.Center)Column(){Text(r.name).fontSize(15).fontWeight(FontWeight.Bold).fontColor(T1)Text(r.desc).fontSize(11).fontColor(T3).maxLines(1).margin({top:2})Row(){Text(⏱ r.time).fontSize(10).fontColor(T2)Text( · r.difficulty).fontSize(10).fontColor(T2)Text( · r.servings).fontSize(10).fontColor(T2)}.margin({top:4})}.alignItems(HorizontalAlign.Start).margin({left:12}).layoutWeight(1)SymbolGlyph($r(sys.symbol.chevron_right)).fontSize(14).fontColor([#DDD])}CategoryPageRow(){Text(r.icon).fontSize(36).width(64).height(64).borderRadius(16).backgroundColor(#F5F5FA).textAlign(TextAlign.Center)Column(){Text(r.name).fontSize(15).fontWeight(FontWeight.Bold).fontColor(T1)Text(r.desc).fontSize(11).fontColor(T3).maxLines(1).margin({top:2})Text(⏱ r.time · r.difficulty).fontSize(10).fontColor(T2).margin({top:4})}.alignItems(HorizontalAlign.Start).margin({left:12}).layoutWeight(1)SymbolGlyph($r(sys.symbol.chevron_right)).fontSize(14).fontColor([#DDD])}两段代码几乎完全一致——唯一的区别是第三行信息首页用了三个独立的Text “·” 分隔符CategoryPage 用了一个Text拼接字符串。最终视觉效果一样但实现方式不同。这种重复是抽取 Builder 的典型场景。如果以后更多页面比如搜索结果页也需要同样的菜谱卡片可以抽取BuilderRecipeCard(r:Recipe){Row(){Text(r.icon).fontSize(36).width(64).height(64).borderRadius(16).backgroundColor(#F5F5FA).textAlign(TextAlign.Center)Column(){Text(r.name).fontSize(15).fontWeight(FontWeight.Bold).fontColor(T1)Text(r.desc).fontSize(11).fontColor(T3).maxLines(1).margin({top:2})Text(⏱ r.time · r.difficulty · r.servings).fontSize(10).fontColor(T2).margin({top:4})}.alignItems(HorizontalAlign.Start).margin({left:12}).layoutWeight(1)SymbolGlyph($r(sys.symbol.chevron_right)).fontSize(14).fontColor([#DDD])}}当前没有抽取——因为只有两个页面用到维护成本可接受。五、项目文件结构entry/src/main/ets/ pages/ Index.ets 首页搜索 分类 菜谱列表 CategoryPage.ets 分类页按分类筛选菜谱 RecipeDetail.ets 详情页食材 步骤 计时器 services/ RecipeData.ets 数据定义 查询函数3 个页面 1 个服务层——三个 App 里结构最简单的。页面数量少意味着每个页面的职责更清晰Index 负责展示和导航CategoryPage 负责筛选RecipeDetail 负责详情和交互收藏、计时器、份量调整。数据层的 RecipeData 包含了完整的信息——8 道菜谱的食材、步骤、小贴士都是真实的 mock 数据不是测试数据1测试数据2这种占位符。这让 App 的预览效果更接近真实产品。
延伸阅读

更多相关文章

2026/9/12 16:33:51

UVa 11571 Simple Equations Extreme

题目描述 给定三个不同的整数 xxx 、 yyy 、 zzz &#xff0c;满足以下三个方程&#xff1a; xyzA x y z A xyzA xyzB xyz B xyzB x2y2z2C x^2 y^2 z^2 C x2y2z2C 输入 NNN &#xff08; N<250N < 250N<250 &#xff09;个测试用例&#xff0c;每个测试用例给出…

2026/9/15 3:11:29

火焰图像语义分割数据集:二分类、像素级标注与工业落地实践

简介&#xff1a;本资源是一套专为计算机视觉初学者与算法工程师设计的火焰图像语义分割数据集&#xff0c;聚焦工业安全、火灾监测等实际场景中的二分类分割任务。数据集严格遵循标准分割格式&#xff1a;原始图像&#xff08;256256 JPG&#xff09;与对应0/1二值掩膜&#x…

2026/9/15 3:11:29

Keil添加文件闪退原因排查与解决全攻略

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/15 3:11:29

C++台球游戏源码解析:物理模拟、碰撞检测与实战调试

简介&#xff1a;这是一份基于C开发的经典台球游戏完整工程&#xff0c;适合正在学习游戏编程、C面向对象设计或需要毕业设计参考的开发者使用。源码通过类与对象封装球台、球杆、台球等核心元素&#xff0c;并实现碰撞检测、物理模拟、事件处理、游戏循环等关键机制&#xff0…

2026/9/15 3:11:29

基于Hadoop+Spark的北京二手房大数据分析平台构建

1. 项目背景与核心价值北京二手房市场作为国内最具代表性的房地产市场之一&#xff0c;其数据具有典型的高维度、非线性和时空相关性特征。这个项目通过构建基于HadoopSpark的大数据处理分析平台&#xff0c;实现了对二手房市场的多维度特征挖掘与可视化呈现&#xff0c;为市场…

2026/9/15 3:06:29

Skills协议:可验证、可复用的能力建模与评分体系

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/14 2:17:50

拯救者Y7000黑屏故障排查与维修实战指南

1. 项目概述&#xff1a;一台黑屏的拯救者Y7000&#xff0c;到底卡在哪一步&#xff1f; 联想拯救者Y7000系列笔记本&#xff0c;从2018年第一代搭载i5-8300H开始&#xff0c;到后来的i7-9750H、i7-10750H、i5-11400H&#xff0c;再到2023年款的R7-7840HS&#xff0c;它始终是学…

2026/9/15 0:01:16

AI英语单词APP开发:自适应学习算法与移动端优化实践

1. 项目概述 作为一名在移动应用开发领域摸爬滚打多年的老手&#xff0c;我最近完成了一个AI英语单词APP的开发项目。这个项目将传统单词记忆方法与现代AI技术相结合&#xff0c;打造了一款能够智能适应不同用户学习习惯的英语学习工具。 市面上大多数单词APP都存在一个通病&a…

2026/9/15 0:01:16

Flutter与OpenHarmony结合开发手语学习APP实战

1. 项目背景与核心价值作为一名同时接触过Flutter和OpenHarmony的开发者&#xff0c;最近我完成了一个基于Flutter for OpenHarmony的手语学习APP实战项目。这个项目最大的特点在于实现了跨平台框架与国产操作系统深度结合的创新实践——用Flutter开发的应用能完美运行在OpenHa…

2026/9/15 0:01:16

六个月成为机器人工程师:从ROS2到SLAM的实战路径

1. 六个月的紧迫感从哪来&#xff1a;先搞清楚你要成为哪种机器人工程师说实话&#xff0c;六个月的期限并不是一个宽松的时间线。市面上任何一本正经的机器人学教材都超过五百页&#xff0c;ROS2的官方文档可以翻到你怀疑人生&#xff0c;再加上ABB、KUKA这些工业机器人厂家动…

2026/9/14 11:59:31

USB Type-C PCB布局分区设计:电源、高速信号与PD协议全攻略

做硬件这行&#xff0c;Type-C接口算是典型的“看着简单&#xff0c;做起来全坑”的东西。光引脚就24个&#xff0c;高低速信号、电源、控制线全部塞在一个小小的连接器里&#xff0c;如果PCB布局不做规划&#xff0c;打样回来基本就是“插上没反应”、“高速掉线”、“静电一打…

2026/9/14 13:53:59

系统编程学习原型如何补齐稳定性边界

系统编程学习原型如何补齐稳定性边界预算有限时&#xff0c;我先优化明显多余的复制&#xff0c;而不是猜测性地换容器。用借用传递只读数据通常就能减少分配&#xff1a; fn parse(line: &str) -> Result<Item, Error> { /* ... */ }用基准确认热点确实在分配&am…

2026/9/14 11:22:57

雨花区哪家财务公司代理记账比较好?

在雨花区&#xff0c;企业处理财税事务常常面临诸多挑战&#xff0c;选择一家靠谱的财务公司至关重要。湖南巨勤财务管理咨询有限公司就是本地正规实体财税服务机构&#xff0c;深耕本地工商财税行业多年&#xff0c;熟悉当地工商局、税务局最新政策与申报流程。主营公司注册、…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
咨询二维码