更新记录
0.1.6(2023-01-28) 下载此版本
- 更新 云函数定时任务避免整点执行
0.1.5(2021-08-25) 下载此版本
- 兼容vue3.0
- 修复 iOS在搜索页面,失焦后无法聚焦
0.1.4(2021-03-01) 下载此版本
- 调整为uni_modules目录规范
平台兼容性
阿里云 | 腾讯云 | 支付宝云 |
---|---|---|
√ | √ | √ |
Vue2 | Vue3 |
---|---|
√ | × |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
HBuilderX 3.1.0 app-vue app-nvue | × | × | × | × | × | × |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 |
---|---|---|---|
× | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
× | × | × | × | × | × | × | × | × |
云函数类插件通用教程
使用云函数类插件的前提是:使用HBuilderX 2.9+
什么是 uniCloud
uniCloud 是 DCloud 联合阿里云、腾讯云,为开发者提供的基于 serverless 模式和 js 编程的云开发平台,更多请参考uniCloud 文档。
云端一体搜索模板解决了什么问题?
uniCloud 云端一体搜索模板,自带下拉候选、历史搜索、热搜。无需再开发服务器代码
云端一体搜索模板有以下功能点:
- 热词设置,可自定义,回车默认搜索热词
- 搜索历史,本地历史,去重排序删除
- 搜索记录,自动向云端储存搜索记录,可用于归纳搜索发现
- 搜索发现,向用户展现热搜
- 搜索联想,基于 uni-list 实现搜索联想列表,兼容 nvue,高性能
- APP 端语音输入,解放双手
- 兼容 nvue
前后一体,兼容 nvue,只需导入插件,初始化数据库即可拥有上述功能。
您也可以自己修改逻辑自定义数据库字段,和随意定制 UI 样式。
体验步骤
-
下载或导入示例项目,绑定一个 uniCloud 服务空间。需 HBuilderX 3.0 以上版本。
-
在项目的 uniCloud/database 目录下找到 db_init.json,对其点右键执行初始化数据库。这样会给服务空间创建 3 个表:opendb-search-log、opendb-search-hot、opendb-mall-goods。如果之前存在相同表,建议删除后重新执行数据库初始化。
-
运行示例项目到任意平台,H5、App、小程序均可。
-
运行后首页是商品列表,上面有搜索框。点击搜索框进入搜索页面,输入待搜索的商品名称会在下方拉出候选,确认搜索后会返回商品列表页面,列表内容即为搜索结果。
-
在项目的 uniCloud/cloudfunctions 目录下找到云函数 uni-analyse-searchhot,点右键上传到服务空间,该云函数会定时运行,统计和计算近期热搜关键字,并体现在搜索界面的热搜候选词中。
项目代码说明
uniCloud 数据表
数据表基于 openDB 规范,它约定了一个标准用户表的表名和字段定义,并且基于 nosql 的特性,可以由开发者自行扩展字段。
本项目用到了 3 个表:
- opendb-search-log:搜索日志表。每次搜索,都会将搜索词记录在该表中。详见
- opendb-search-hot:热搜表。通过其他云函数定期分析搜索日志表,提取近期热搜词,存入热搜表。详见
- opendb-mall-goods:用于本示例演示的商品列表。实际项目中,可自行提供为需要搜索的表。详见
这些表在 uniCloud Web 控制台中新建表的界面,均可以选择。
云函数
uni-analyse-searchhot
- 这是一个定时运行的跑批云函数。用于从搜索日志表中归纳热搜。默认归纳最近
7天
搜索记录,截取其中10
条,可在云函数中进行修改 - 在
package.json
中有其触发器配置,默认每2小时
运行一次,可在配置中修改。部署在云端后,也可以在 web 控制台修改。定时触发器使用cron 表达式 注意
该云函数本地运行不生效,需要上传部署至云端
- 这是一个定时运行的跑批云函数。用于从搜索日志表中归纳热搜。默认归纳最近
前端页面
首页是商品列表页面,点击顶部的搜索框,进入搜索页面。
前端页面基于 unicloud-db 组件操作数据库。
商品列表页面是基于 云端一体商品列表模板 改进而来。
页面示例搜索的是“opendb-mall-goods”表,可以在页面中的clientDB组件中修改collection属性,指向新的数据表进行搜索。