【UNI-APP】新闻资讯APP总结

• 官方网站：https://uniapp.dcloud.io/
• UMI-APP出现问题总结：
  uni-app出现的一些踩坑注意点
  video标签中使用src黑屏问题
• 特色：
  条件编译
  App端的Nvue开发
  HTML5+
• 知识点
  

环境开发

• 安装并运行HbuiderX
• 使用vue-cli的方式运行项目

vue create -p dcloudio/uni-preset-vue test-uniapp

• 采用 Sass 预处理编辑器实现 css 编写

模板语法

问题：为什么data不建议用对象格式？

• 因为变量会一直保留，更新页面时，值不会进行初始化

注意：

• template模块下只能存在一个元素

工作内容

1 首页功能开发

1.1 初始化数据库

1.2. 配置tabbar

1.3. 自定义导航栏

注意事项：

• 在uni-app中存在easyCom，若组件的命名方式是：components/组件名/组件名.vue，就不需要引用和注册，直接使用即可
• 此时是局部引入
• 一般导航栏高度在44 45 左右
• 颜色频繁使用，将其放入uni.scss中，即设置某个变量代替：$mk-base-color:#f07373
  问题：
• 设置好后，导航栏随着滚动条消失了

1.4. 添加小程序的状态栏（导航栏适配小程序）

注意事项：

• 状态栏高度要根据手机型号调整
• 搜索框高度也不能固定
• 将小程序状态栏字体调成白色

"pages": [ //pages数组中第一项表示应用启动页，参考：https://uniapp.dcloud.io/collocation/pages
		{
			"path": "pages/tabbar/index/index",
			"style": {
				//导航栏的样式 custom取消默认的导航栏
				"navigationStyle":"custom",
				//字体颜色为白色
				"navigationBarTextStyle":"white",
				"navigationBarTitleText": "uni-app"
			}
		}

1.5. 使用字体图标

• 插件市场地址

1.6. 选项卡展示

scroll-view可滚动视图区域，用于区域滚动
滚动视图

1.7. 选项卡数据初始化

• 新建云函数，并上线部署
• 通过云函数获取数据
• props传递数据

//获取数据库的引用
const db = uniCloud.database()

1.8. 封装数据请求

• 将函数返回的错误同意管理，只是关注成功的回调
• 使用requireApi实现文件批量导出

// 批量导出文件
const requireApi = require.context(
	//api 目录的相对路径
	'.',
	//是否查询子目录
	false,
	//查询文件的一个后缀
	/.js$/
)

let module = {}
requireApi.keys().forEach((key,index)=>{
	// 去掉index.js
	if(key === './index.js') return 
	Object.assign(module,requireApi(key))
})
export default module

1.9. 选项卡切换

• 选项卡点中高亮

1.10.基础卡片视图实现\更多卡片视图实现

• 解决滚动时导航栏同时上移的问题
  

1.11. 实现内容的切换

• 使用swiper-item实现页面左右上下滚动，注意高度撑开
• change事件监听swiper，关注返回内容中detail属性
• 利用emit完成组件中的传值
• swiper中属性current可选择当前跳转的哪个页面

1.12. 内容卡片数据初始化

• 将数据动态渲染到卡片中
• 调用云数据库中的内容，建立云函数，记得上传部署

const db = uniCloud.database()
exports.main = async (event, context) => {
	//event为客户端上传的参数
	// 获取数据
	const list = await db.collection('article')
	.field({
		//过滤掉content内容 true:表示只返回该字段 FALSE：不返回
		content:false
	})
	.get()
	
	//返回数据给客户端
	return {
		code:200,
		msg:'数据请求成功',
		data:list.data
		}
};

• api文件中引入
• methods创建方法this.$api.get_list().then(res=>{}),周期created调用
  

1.13. 切换选项卡懒加载数据【优化】

• 对swiper进行更改时会触发change事件
• 云函数中筛选文章分类数据，采用聚合的方法，更精细化的处理数据（求和、分组、筛选）

exports.main = async (event, context) => {
	//event为客户端上传的参数
	const list = await db.collection('article')
	//获取数据库集合的聚合操作实例
	.aggregate() 
	//根据条件过滤文档，并且把符合条件的文档传递给下一个流水线阶段。 
	.match({ //匹配类别为前端开发的文章
		classify:'前端开发'
	})
	//把指定的字段传递给下一个流水线，指定的字段可以是某个已经存在的字段，也可以是计算出来的新字段。 
	.project({
		//类似field 不需要接收content false 或0
		content:false
	})
	//标志聚合操作定义完成，发起实际聚合操作 
	.end()

• 切换不同类别的导航栏时，数据会有闪动
  

1.13. 上拉加载更多【优化】

• 首页的第一个展示应该是推荐，而非分类文章
  
• 【优化】每次切换分类，之前分类已经加载的数据不需要再向服务器请求
  进行一个数据存在性的判断

//当数据不存在或者长度是0的情况下， 才去请求数据
if(!this.listCatchData[current] || this.listCatchData[current].length === 0){
	this.getList(current)
}

• 标签中没有数据时，显示数据正在加载中

1. 进入插件市场
2. 使用loadmore插件

//loading:正在加载
//noMore:没有更多数据
//状态需要进行判断
<uni-load-more iconType="snow" status="loading"></uni-load-more>

• 如何判断没有更多数据的显示?
  1.确定每页显示的数据量pageSize
  2.通过云函数中的聚合限制

	//指定一个正整数，跳过对应数量的文档，输出剩下的文档
	.skip(pageSize * (page - 1))
	//指定查询结果集数量上限 
	.limit(pageSize)

• 实现上拉加载
  scroll-view中的触发事件@scrolltolower=“”：滑动到底部/右边会触发

1.14 收藏按钮实现【优化】【问题】

- 心形图标设置

//heart-filled：爱心填充
<uni-icons size="20" color="#f07373" type="heart"></uni-icons>

• 【优化】多篇文章若多次触发收藏按钮点击回调会造成整个页面的渲染，影响性能
• 单独交互最好抽离出来形成一个单独的组件
• 【问题】点击范围出现问题，若卡片同时存在点击事件点击收藏按钮会同时触发两个事件
• 在我的页面中反映出收藏的内容，操作云函数数据库在user数据表中属性article_like_ids

const db = uniCloud.database();
const dbCmd = db.command;
exports.main = async (event, context) => {
  //event为客户端上传的参数
  const {
    user_id,
    article_id
  } = event;
  const userinfo = await db.collection('user').doc(user_id).get();
  const article_likes_ids = userinfo.data[0].article_likes_ids;
  
  let dbCmdFun = null;
  if (article_likes_ids.includes(article_id)) {
  		//删除
    dbCmdFun = dbCmd.pull(article_id);
  } else {
  		//添加
    dbCmdFun = dbCmd.addToSet(article_id);
  }
  await db.collection('user').doc(user_id).update({
    article_likes_ids: dbCmdFun
  })
  //返回数据给客户端
  return {
    code: 200,
    msg: '数据请求成功',
    data: userinfo.data[0]
  }
};

写完api文件引入

• 【问题】刷新之后页面之后，收藏的状态消失
  云函数获取列表文章信息中通过聚合添加一个字段

//设置聚合的操作符
const $ = db.command.aggregate
//追加字段
.addField({
	//$.in() 当前某个数组是否包含某个字段
	is_like:$.in(['$_id',article_likes_ids])
})

• 通过uni.showLoading、uni.hideLoading、uni.showToast实现收藏提示语

2 搜索页功能模块

2.1 搜索页导航栏修改

• 将默认组件样式消失，在pages页面下的相关组件中写"navigationStyle": "custom"

2.2 使用Vuex管理历史记录

• 引入、注册、使用
• 【问题】每输入一个数字都要发送一次请求，需要限制请求系数
• 利用正则通过文章名筛选搜索的内容

.match({
      title: new RegExp(value)
    })

• 点击相关文章，需要把历史记录保存在vuex中

2.3 搜索历史数据持久化【问题】

• 搜索页面中的返回首页使用uni.switchTab
• 【问题】由于vuex非持久化储存，所以刷新页面会导致历史记录丢失

3 标签页功能模块

• 点击首页的设置出现
  

3.1 标签管理页布局样式

• 点击编辑，相关标签会出现X号
  uni-icons type="clear"

3.2 标签页数据处理

• 利用聚合判断是我的标签还是标签推荐
• 点击编辑实现相关操作
• 保存标签页数据
  

3.3 使用自定义事件同步数据

• 标签设置完成后，需要将设置的标签传递给首页
• 使用emit触发，on监听回调
• 自定义事件，只能在打开的是页面触发

4 详情页功能模块

4.1 详情页页面展示

• 用户头像圆角设置50%，压缩的话用flex-shrink设置为0
• 评论工具栏高度：54px
• 编辑小图标：type="compose"
• 评论小图标：type="chat"
• 收藏小图标：:type="formData.is_like?'heart-filled':'heart'"
• 点赞小图标：:type="formData.is_thumbs_up?'hand-thumbsup-filled':'hand-thumbsup'"
• 定位：position:fixed

4.2 内容预加载【优化】

• 点进文章详情中部分相关信息已经在首页列表中获取到，可以实现预加载
• 通过url进行参数的传递，通过JSON.stringify将对象转换为字符串形式（因为URL必须传递字符串）
• 传参注意长度，url传递的长度有限制，使用什么参数就传什么参数

// 为了点击文章详情进行的预加载
      const params = {
        _id: item._id,
        title: item.title,
        author: item.author,
        create_time: item.create_time,
        thumbs_up_count: item.thumbs_up_count,
        browse_count: item.browse_count
      }
// 点击文章跳转到文章详情页面 
      uni.navigateTo({
        url: '/pages/detail/detail?params='+JSON.stringify(params)
      })

• 如何获取到参数？在文章详情页面home-detail的生命周期onLoad()
• 使用JSON.parse()将其转换成对象形式
• 将之前页面的内容传递到之后的页面，解决数据读取中的白屏现象，实现快速渲染

	onLoad(query) {
      this.formData = JSON.parse(query.params);
      this.getDetail();
      this.getComment();
    }

4.3 详情页面数据初始化

• 新建云函数，手动在文章数据库中增加三个字段
• $.in([a,b]):判断b中是否包含a字段

// 手动添加三个字段
  let list = await db.collection('article').aggregate().addFields({
    // 是否关注作者
    is_author_like: $.in(['$author.id', userinfo.author_likes_ids]),
    // 是否收藏文章
    is_like: $.in(['$_id', userinfo.article_likes_ids]),
    // 是否点赞
    is_thumbs_up: $.in(['$_id', userinfo.thumbs_up_article_ids])
  })

• match进行筛选 现在查找的是所有的文章列表 只需要返回传入对应文章的信息

  .match({
    _id: article_id
  })

• 利用project拒绝返回评论字段

.project({
    comments: 0
  })

4.4 富文本渲染【插件】

• 数据库传过来的文章内容是html格式，如何处理？
  
• 利用gaoyia-parse插件中的uParse实现富文本渲染
• 使用方法 content：富文本内容 noData：无数据时显示的内容

<uparse :content="formData.content" :noData="noData"></uparse>
noData: '
详情加载中...
'

• 样式还是很丑，去App.vue中加载插件中的样式

/*每个页面公共css */
  @import url("/components/gaoyia-parse/parse.css");

• 也可以使用官方提供的解析富文本，缺点是代码构建会复杂

4.5 发布窗口展示【插件】

• 点击评论输入弹出输入框
• 使用uni-popup插件实现评论弹出框，该插件依赖uni-transition组件

		//ref:弹出框 type:底部弹出 maskClick:点击蒙版是否取消弹窗
	  <uni-popup ref="popup" type="bottom" :maskClick="false">

• 样式设置左右对齐：display: flex;justify-content: space-between;
• 右对齐：justify-content:flex-end

4.6 评论内容实现【知识】

• 设置云函数评论的接收参数

// 查询条件声明符
const dbCmd = db.command
  const {
    user_id, // 用户id
    article_id, // 文章id
    content, // 评论内容
    comment_id = '', // 评论id
    reply_id = "", // 子回复ID
    is_reply = false // 是否子回复
  } = event

• 获取文章下的所有评论

let commentObj = {
		comment_id: getID(5), //评论ID
		comment_content: content, // 评论内容
		create_time: new Date().getTime(), // 创建时间
		is_reply: is_reply, // 区分主回复，还是子回复 
		author: {
			author_id: user._id, // 作者id
			author_name: user.author_name, // 作者名称
			avatar: user.avatar, // 作者头像
			professional: user.professional // 专业 前端工程师还是后端
		},
		reply: [],
	}

获取时间戳的原因在于：云函数中处理的时间与实际时间有差距

• 随机生成评论ID

function getID(length) {
	return Number(Math.random().toString().substr(3, length) + Date.now()).toString(36)
}

方法 num.toString(base) 返回在给定 base 进制数字系统中 num 的字符串表示形式

• 更新文章评论

await db.collection('article').doc(article_id).update({
		comments: commentObj
	})

• 设置好评论布局，调用接口
• 设置得到评论函数，利用聚合中的.unwind()筛选数据，请求评论内容

const list = await db.collection('article').aggregate().match({
      _id: article_id
    })
    .unwind('$comments')
    .project({
      _id: 0,
      comments: 1
    })
    .replaceRoot({
      newRoot: '$comments'
    })
    .skip(pageSize*(page-1))
    .limit(pageSize)
    .end()

• 实现回复内容模块
• 由于回复模块相似 ，可以使用递归引用，注意name值的书写
• 会出现无线调用的问题，需要条件限制

 <view class="comments-reply" v-for="item in comments.reply" :key="item.comment_id">
        <comments-box :comments="item" :replys="true" @reply="reply"></comments-box>
      </view>

• 通过设置一个属性区分回复的地方

	replys: {
      type: Boolean,
      default: false
    }

4.7 关注作者按钮

• 云函数中利用dbCmd.pull()和dbCmd.addToSet()实现取消关注和添加关注

  let dbCmdFun = null;
  if(author_likes_ids.includes(author_id)) {
	  // 取消关注
    dbCmdFun = dbCmd.pull(author_id)
  } else {
	  // 添加关注
    dbCmdFun = dbCmd.addToSet(author_id)
  }
  
  await db.collection('user').doc(user_id).update({
    author_likes_ids: dbCmdFun
  })

4.7 文章的收藏和点赞

• 点赞不能取消
• 云函数执行失败如何查看错误？
  打开web控制台=》找对应云函数=》点开日志
  -首页收藏需要更新uni.emit()

4.8 评论列表【正则】

• 点击评论按钮显示评论列表
• 限制文章详情中显示的评论数量
• 页面上拉加载，用生命周期onReachBottom()

onReachBottom() {
			//下拉没数据 不进行数据请求
			if (this.loading === 'noMore') return;
			this.page++;
			this.getComment();
		},
// 对象复制
		let oldList = JSON.parse(JSON.stringify(this.commentList));
		oldList.push(...data);
		this.commentList = oldList;

• 创建的时间戳转换为正常的时间显示
• 创建utils文件里面存放一些工具类
• 利用正则匹配时间戳并格式化
• 计算属性filters使用

export const  parceTime = (time) => {
  const format = '{year}-{month}-{day} {hour}:{minute}:{second}'
  let date = null;
  if (typeof date === 'string') {
    time = parseInt(date)
  }
  date = new Date(time)
  const formatObj = {
    year: date.getFullYear(),
    month: date.getMonth() + 1,
    day: date.getDate(),
    hour: date.getHours(),
    minute: date.getMinutes(),
    second: date.getSeconds()
  }
  let strTime = format.replace(/{(year|month|day|hour|minute|second)+}/g, (res, key) => {
    let val = formatObj[key];
    if (res.length > 0 && val < 10) {
      val = '0' + val;
    }
    return val;
  })
  return strTime;
}
//引入
import {parceTime } from '@/utils/index.js'
//使用
filters: {
    dateFormat(time) {
      return parceTime(time);
    }
  },

5 关注页功能模块

5.1 关注导航栏实现

- Sass实现中间竖线，通过伪元素

.tab-item:nth-child(1) {
          border-right: 1px solid $theme-color;
        }

5.2 收藏文章内容实现

• 用swiper实现文章和作者的左右滑动效果，高度要设置100%，不然滚动不了
• 设置云函数get_follow，同样通过聚合筛选，获取收藏的文章列表数据
• 取消收藏相应页面消失
• 添加加载消息提示
• 收藏数据状态变更反应到首页，使用自定义事件
• 【问题】每次点击首页中的文章收藏，list组件都会触发监听事件，影响使用效果，需要在该组件中国添加一个类别判断属性，只有来自follw组件才触发

5.3 关注作者页面实现

• 同样使用自定义事件进行状态的更新

6 个人信息页功能模块

6.1 个人中心页面实现

• 背景虚化filter

.header-background {
			position: absolute;
			top: 0;
			right: 0;
			bottom: 0;
			left: 0;
			opacity: 0.3;
			filter: blur(8px);

			image {
				width: 100%;
				height: 100%;
			}
		}

• 头像图标contact

<uni-icons class="icons" type="contact" size="16" color="#666"></uni-icons>

• 问号图标help

<uni-icons class="icons" type="help" size="16" color="#666"></uni-icons>

6.2 个人中心数据处理

• 通过vuex保存用户的相关信息，并本地存储

6.3我的文章的实现

• 新建页面

6.4问题反馈页面实现

• 点击加号选择图片使用uni.chooseImage(),this的指向不是vue的实例，里面的回调要使用箭头函数
• 选完图片隐藏
• 图片上传 uniCloud.uploadFile()
  1. 打开web控制台
  2. 打开云存储（图片上传的位置）
  3. 图片循环上传（API 只支持单张图片上传）

async submit(){
	let imagesPath = []
	uni.showLoading()
	for(let i = 0;i < this.imgLists.length;i++){
		const filePath = this.imgLists[i]
		filePath = await this.upoadFiles(filePath)
		imagesPath.push(filePath)
	}
	uni.hideLoading()
}
async upoadFiles(filePath){
	consr result = await uniCloud.uploadFile({
		filePath:filePath
	})
	return result.fileID
}

4. 点击云存储可以看到上传好的反馈图片

• 新建数据库保存反馈意见
• 反馈提交成功后，跳转到个人中心（加个定时器）

平台兼容

微信小程序优化与兼容

问题1：loadmore加载到文章列表的上面

- 原因：由于list-card渲染完全的时间比loadmore慢

• 解决：套一个空的元素

<view class=""> 
	  <!-- 为了兼容小程序 包一个外壳 -->
	  	<list-card :item="item" v-for="item in list" :key="item._id"></list-card>
	  </view>

问题2：翻页的时候显示没有数据

- 原因：load.loading为undefined，由于第一次初始渲染的时候load未定义

• 解决：

:status="load.loading || 'loading'" 

问题3：微信开发小程序清除所有缓存后重编译报错

• 报错信息：请求云函数错误：docId必须为字符串或数字
• 原因：ID信息不同步
• 解决：通过watch监听vuex中userinfo状态的变化，状态变更在请求接口

遇到的问题

1. 设置好导航栏后，会随着滚动条的移动而消失

• 需要给标签设置好定位
• 滚动内容需要单独封装组件，使用匿名插槽
• 将卡片单独封装成组件
• 标题文件溢出隐藏

position：fixed
left:0
top:0
z-index:99

• 设置完后数据显示仍然有些问题

<view class="navbar-fixed">
				<view class="navbar-search-icon">
					
				</view>
				<view class="navbar-search-text">
					uni-app
				</view>
				<view style="height: 45px;"></view>
</view>

2. 小程序的状态栏高度要根据手机型号调整

在created（）生命周期中使用：

created() {
			// /获取手机系统信息
			const info= uni.getSystemInfoSync()
			console.log(info)
			// 设置状态栏的高度
			this.statusBarHeight = info.statusBarHeight
		}

3. 搜索框高度也不能固定

通过API接口获取小程序胶囊的位置，然后计算高度
同时将宽度也调整好

			// 获取胶囊的位置
			const MenuButtonInfo = uni.getMenuButtonBoundingClientRect()
			// (胶囊底部高度- 状态栏的高度) +. (胶囊顶部高度-.状态栏内的高度)
			// =导航栏的高度
			this.navBarHeight = (MenuButtonInfo.bottom - info.statusBarHeight) + (MenuButtonInfo.top - info
				.statusBarHeight)
			this.windowWidth = MenuButtonInfo.left;

注意:接口getMenuButtonBoundingClientRect在H5、app、mp-alipay不支持
==解决：==利用ifndef

#ifndef H5 || APP-PLUS || MP-ALIPAY
			// 获取胶囊的位置 h5不支持
			const MenuButtonInfo = uni.getMenuButtonBoundingClientRect()
			// (胶囊底部高度- 状态栏的高度) +. (胶囊顶部高度-.状态栏内的高度)
			// =导航栏的高度
			this.navBarHeight = (MenuButtonInfo.bottom - info.statusBarHeight) + (MenuButtonInfo.top - info
				.statusBarHeight)
			this.windowWidth = MenuButtonInfo.left;
#endif

4.tab页面设置内容滚动时，导航栏同时上移消失

5.切换不同类别的导航栏时，相应变更的数据会有闪动（懒加载）

• 在显示文章列表的组件中，切换时每次会给list赋一个新值，但赋值之前仍然为旧值，所以在通过云函数赋新值的过程中，仍然可以看到旧值
• 解决：设置一个缓存变量
• 利用this.$set(this.listCatchData, current, data)监听数组变化

6.点击范围出现问题，若卡片同时存在点击事件点击收藏按钮会同时触发两个事件

• 收藏按钮需要阻止冒泡
• 在收藏按钮点击事中加修饰符

@click.stop="likeTap"

7. 搜索框中的内容每输入一个字符都要发送一次请求，需要限制请求次数

• 不管用户输入多么频繁，每一秒才发送一次请求

				if (!this.mark) {
					this.mark = true;
					this.timer = setTimeout(() => {
						this.mark = false
						this.getSearch(value)
					}, 1000)
				}

8.由于vuex非持久化储存，所以刷新页面会导致历史记录丢失

• 利用本地缓存
• vuex数据初始化先查看本地缓存是否存在相关数据

//state
historyList: uni.getStorageSync('_history') || [] 
//action 将数据保存在本地
uni.setStorageSync('_history', list)
//清除本地缓存
uni.removeStorageSync('_history')

慕课新闻APP项目知识总结：

1.数据库使用

• 使用了慕课的接口
• 使用阿里云作为云服务数据库，点击database初始化db_init.json
  

2.事件冒泡

3.数据库添加删除内容

数据库操作符

4.字符串方法

• 在生成随机评论ID时使用str.substr()方法
  JavaScript 中有三种获取字符串的方法：substring、substr 和 slice
str.slice(start [, end])：返回字符串从 start 到（但不包括）end 的部分。
  str.substring(start [, end])：返回字符串在 start 和 end 之间 的部分，允许 start 大于 end
  str.substr(start [, length])：返回字符串从 start 开始的给定 length 的部分

5. 深入学习

项目发行打包

H5

• manifest.json文件 -> uni-app应用标识 -> H5配置 -> 选择路由模式（线上history）-> 其他配置默认 -> 点击发行 -> 成功查看（dist文件）

微信小程序

域名报错，将报错的域名添加到服务器配置中（详情的项目配置唱查看）