网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
相关概念
- Flex组件:以弹性方式布局子组件的容器组件。
- Search组件:搜索框组件,适用于浏览器的搜索内容输入框等应用场景。
- Text组件:显示一段文本的组件。
- Image组件:图片组件,支持本地图片和网络图片的渲染展示。
- Scroll组件:可滑动的容器组件,当子组件的布局尺寸超过父组件的视口时,内容可以滑动。
- 条件渲染:条件渲染可根据应用的不同状态,使用if、else和else if渲染对应状态下的UI内容。
- 循环渲染:基于数组类型数据执行循环渲染。
环境搭建
软件要求
- DevEco Studio版本:DevEco Studio 3.1 Release。
- OpenHarmony SDK版本:API version 9。
硬件要求
- 开发板类型:润和RK3568开发板。
- OpenHarmony系统:3.2 Release。
环境搭建
完成本篇Codelab我们首先要完成开发环境的搭建,本示例以RK3568开发板为例,参照以下步骤进行:
- 获取OpenHarmony系统版本:标准系统解决方案(二进制)。以3.2 Release版本为例:
2. 搭建烧录环境。
1. [完成DevEco Device Tool的安装]( )
2. [完成RK3568开发板的烧录]( )
-
搭建开发环境。
代码结构解读
本篇Codelab只对核心代码进行讲解,对于完整代码,我们会在gitee中提供。
├──entry/src/main/ets // 代码区
│ ├──common
│ │ └──constants
│ │ └──StyleConstants.ets // 样式常量类
│ ├──entryability
│ │ └──EntryAbility.ts // 程序入口类
│ ├──pages
│ │ └──HomePage.ets // 主界面
│ ├──view
│ │ ├──ClearSearch.ets // 清除历史记录自定义组件
│ │ ├──FlexLayout.ets // 弹性布局自定义组件
│ │ └──SearchInput.ets // 搜索输入框自定义组件
│ └──viewmodel
│ └──SearchViewModel.ets // 历史搜索数据类
└──entry/src/main/resources // 资源文件目录
编写搜索框布局
在这个章节中,我们需要完成搜索框布局的编写,并实现文本输入和点击事件。效果如图所示:
在ets目录下,点击鼠标右键 > New > Directory,新建名为view的自定义子组件目录。然后在view目录下,点击鼠标右键 > New > ArkTS File,新建名为SearchInput的ArkTS文件。最后在SearchInput.ets文件中,逐步完成如下操作:
- 使用@Component新增一个自定义组件,组件名为SearchInput。
- 在build()中使用Flex作为容器组件,实现子组件水平排列。
- 使用Search组件作为搜索框布局,Text组件作为搜索文本按钮布局。
// SearchInput.ets
@Component
export default struct SearchInput {
build() {
Flex({ alignItems: ItemAlign.Center }) {
// 搜索框布局
Search()
...
// 搜索文本按钮布局
Text($r('app.string.search'))
...
}
...
}
}
接下来我们实现Search组件的样式及输入功能,并将输入的数据添加到数组searchArr中:
- 使用@State定义变量searchInput,存储搜索框输入的文本内容。
- 在Search组件参数中,将变量searchInput赋值给参数value,参数placeholder填写提示内容,参数icon表示搜索图标路径。
- 设置高度height、宽度width、背景颜色backgroundColor、提示内容颜色placeholderColor等属性。
- 设置onChange事件,将用户输入的内容绑定到变量searchInput中。
- 使用@Link定义一个数组变量searchArr,点击搜索文本按钮时,将用户输入的内容即searchInput的值,通过数组的unshift()方法,在数组searchArr的头部添加数据。
// SearchInput.ets
@Component
export default struct SearchInput {
@State searchInput: string = '';
@Link searchArr: Array<string>;
build() {
Flex({ alignItems: ItemAlign.Center }) {
// 搜索框布局
Search({
value: this.searchInput,
placeholder: StyleConstants.SEARCH_PLACEHOLDER,
icon: StyleConstants.SEARCH_ICON
})
.placeholderColor($r('app.color.placeholder_color'))
.placeholderFont({ size: $r('app.float.font_size') })
.textFont({ size: $r('app.float.font_size') })
.height(StyleConstants.SEARCH_HEIGHT)
.width(StyleConstants.SEARCH_WIDTH)
.backgroundColor(Color.White)
...
.onChange((value: string) => {
this.searchInput = value;
})
// 搜索文本按钮布局
Text($r('app.string.search'))
...
.onClick(() => {
if (this.searchInput !== '' && this.searchInput.trim().length > 0) {
// 使用unshift在数组头部添加数据
this.searchArr.unshift(this.searchInput.trim());
}
this.searchInput = '';
})
}
...
}
}
然后我们在HomePage.ets首页中,引入SearchInput搜索输入框自定义组件。
- 使用@State定义数组变量searchArr,存放最近搜索文本内容。
- 在构造参数中,使用$符号引用@State修饰的变量searchArr,将父组件的变量searchArr与子组件searchArr变量关联起来。
// HomePage.ets
import SearchInput from '../view/SearchInput';
@Entry
@Component
struct HomePage {
@State searchArr: Array<string> = SearchViewModel.getSearchArrData();
build() {
Column() {
// 搜索输入框自定义组件
SearchInput({ searchArr: $searchArr })
}
...
}
}
编写清除记录布局
在这个章节中,我们需要完成清除记录布局的编写,并实现条件渲染。效果如图所示:
在view目录下,点击鼠标右键 > New > ArkTS File,新建名为ClearSearch的ArkTS文件。然后在ClearSearch.ets文件中,逐步完成如下操作:
- 使用@Component新增一个自定义组件,组件名为ClearSearch。
- 在build()中使用Flex作为容器组件,实现子组件水平排列。
- 使用if/else实现条件渲染:当有搜索内容时,显示最近搜索的文本和清除搜索内容图标;否则就显示没有搜索内容和相关图片。
- 使用@Link定义数组变量searchArr,当点击清除搜索内容图标时,所有最近搜索内容清空。
// ClearSearch.ets
@Component
export default struct ClearSearch {
// 搜索内容数组
@Link searchArr: Array<string>;
build() {
Flex({ alignItems: ItemAlign.Center }) {
if (this.searchArr.length > 0) {
Text($r('app.string.recent_searches'))
...
Image($r('app.media.ic_delete'))
...
.onClick(() => {
this.searchArr.splice(0, this.searchArr.length);
this.searchArr.length = 0;
})
} else {
Column() {
Image($r('app.media.ic_no_search'))
...
Text($r('app.string.no_search_content'))
...
}
...
}
}
}
}
然后我们在HomePage.ets首页中,引入ClearSearch搜索输入框自定义组件。
// HomePage.ets
import SearchInput from '../view/SearchInput';
import ClearSearch from '../view/ClearSearch';
@Entry
@Component
struct HomePage {
@State searchArr: Array<string> = SearchViewModel.getSearchArrData();
build() {
Column() {
// 搜索输入框自定义组件
SearchInput({ searchArr: $searchArr })
// 清除搜索记录自定义组件
ClearSearch({ searchArr: $searchArr })
}
...
}
}
编写弹性布局
在这个章节中,我们需要完成弹性布局的功能样式,并实现循环渲染。效果如图所示:
在view目录下,点击鼠标右键 > New > ArkTS File,新建名为FlexLayout的ArkTS文件。然后在FlexLayout.ets文件中,逐步完成如下操作:
- 使用@Component新增一个自定义组件,组件名为FlexLayout。
- 在build()中使用Flex作为容器,设置参数wrap为FlexWrap.Wrap时为弹性布局,实现自动换行。
- 使用if实现条件渲染,当有搜索内容时,显示最近搜索的所有内容。
- 使用@Link定义数组变量searchArr,表示子组件要显示的所有最近搜索文本内容。
- 使用ForEach遍历变量searchArr,实现循环渲染。
// FlexLayout.ets
@Component
export default struct FlexLayout {
@Link searchArr: Array<string>;
**深知大多数程序员,想要提升技能,往往是自己摸索成长,但自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!**
![](https://img-blog.csdnimg.cn/direct/743b668910224b259a5ffe804fa6d0db.png)
![img](https://img-blog.csdnimg.cn/img_convert/12efeb924bf1b029bcc18cea7e7feac6.png)
![img](https://img-blog.csdnimg.cn/img_convert/e8a02c08cfd68ad41442da99f32f1e6d.png)
**既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,涵盖了95%以上鸿蒙开发知识点,真正体系化!**
**由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频,并且后续会持续更新**
**[需要这份系统化的资料的朋友,可以戳这里获取](https://bbs.csdn.net/topics/618636735)**
24b259a5ffe804fa6d0db.png)
[外链图片转存中...(img-D8w10Nl1-1715616550363)]
[外链图片转存中...(img-Kmxa3NQK-1715616550363)]
**既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,涵盖了95%以上鸿蒙开发知识点,真正体系化!**
**由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频,并且后续会持续更新**
**[需要这份系统化的资料的朋友,可以戳这里获取](https://bbs.csdn.net/topics/618636735)**