【重点突破】—— UniApp微信小程序开发教程学习Three

2023-03-15,,

一、实战

HBuilderX:在微信小程序中运行页面,需要设置->安全 开启微信小程序服务端口,HBuilder工具->设置->配置程序路径

    网络请求、模板语法、打开页面、页面传参
    列表  api:  https://unidemo.dcloud.net.cn/api/news

    - 返回数据格式
    - id 新闻id 如: 72980
    - title 标题
    - created_at 创建时间
    - author_avatar 图标

    详情  地址:

    https://unidemo.dcloud.net.cn/api/news/36kr/ + id  ( id 为新闻id,上个页面传过来的)  

    使用 rich-text 【富文本组件来展示新闻内容】

    <rich-text class="richText" :nodes="strings" ></rich-text>

    pages:新建页面 -> 就会多一个文件夹 里面包含一个 同名.vue文件

网络请求 api

onLoad: function() {
快捷写法 -> ureq
}

请求列表数据:

onLoad:function(){
uni.request({
url: 'https://unidemo.dcloud.net.cn/api/news',
method: 'GET',
data: {},
success: res => {
console.log(res)
},
fail: () => {},
complete: () => {}
});
}

页面跳转(打开页面) - 两种方式

//  ①   <navigator url=""></navigator>

//  ②   @tap="openinfo"       //监听单击事件

//       快捷写法 : me -> 选择 Vue methods方法代码块

//       unav -> 选择 uni.navigateTo({ 代码块 })

methods: {
openinfo() {
uni.navigateTo({
url: '../info/info'
});
}
},

页面传参  ——  :data-变量名称="" 进行附加信息的传递,保存在监听事件的 e.currentTarget.dataset.变量名称

//  index.vue 列表页

:data-newsid="item.post_id"

methods: {
openinfo(e) {
var newsid = e.currentTarget.dataset.newsid;
//console.log(newsid)
uni.navigateTo({
url: '../info/info?newsid='+newsid
});
}
}, // info.vue 详情页 // onLoad生命周期:页面加载成功,获取传递的参数,保存在onLoad方法的 e.变量名称 中 onLoad: function(e){
console.log(e) //{newsid: "5219628" }
}  

数据加载中 

uni.showLoading({
title: "加载中...."
})  

加载完成后

uni.hideLoading()  

补充知识点: pages.json -- pages 页面路由数组

"pages": [
// pages数组中第一项表示应用启动页,参考:
// https://uniapp.dcloud.io/collocation/pages
{
"path": "pages/index/index",
"style": {
"navigationBarTitleText": "uni-app"
}
} ,
//在使用HBuilderX新建info页面文件夹时,自动创建
{
"path" : "pages/info/info",
"style" : {}
}
],

开发小技巧:condition 设置模式配置--便于调试时,固定打开某一页面

"condition": {       //模式配置,仅开发期间生效
"current": 0, //当前激活的模式(list 的索引项)
"list": [{
"name": "test", //模式名称
"path": "pages/info/info", //启动页面,必选
"query": "newsid=5158607" //启动参数,在页面的onLoad函数里可得到
}]
}

ctrl + r 微信开发者工具-运行到页面

二、白话uni-app —— html、vue、小程序的区别

网络模型:c/s ,前后端分离,通过ajax获取json数据
文件类型:.vue文件
文件内代码架构:template、script、style是并列的一级节点
外部文件引用方式:es6写法,import引入外部的js模块或css
组件/标签变化:以前是html标签,现在是小程序组件

    div 改成 view
    span、font 改成 text
    a 改成 navigator
    img 改成 image
    input 还在,但type属性改成了confirmtype
    form、button、checkbox、radio、label、textarea、canvas、video 这些还在。
    select 改成 picker
    iframe 改成 web-view
    ul、li没有了,都用view替代
    audio 不再推荐使用,改成api方式
https://uniapp.dcloud.io/api/media/background-audio-manager?id=getbackgroundaudiomanager

其实老的HTML标签也可以在uni-app里使用,uni-app编译器会在编译时把老标签转为新标签,比如把div编译成view。但不推荐这种用法,调试H5端时容易混乱,基于元素的选择器也会出问题
新增手机端常用的新组件:

    scroll-view 可区域滚动视图容器
    swiper 可滑动区域视图容器
    icon 图标
    rich-text 富文本(不可执行js,但可渲染各种文字格式和图片)
    progress 进度条
    slider 滑块指示器
    switch 开关选择器
    camera 相机
    live-player 直播
    map 地图

cover-view 可覆盖原生组件的视图容器。
uni-app的非h5端的video、map、canvas、textarea是原生组件,层级高于其他组件。
如需覆盖原生组件,比如在map上加个遮罩,则需要使用cover-view组件
js变化:

    运行环境从浏览器变成v8引擎。浏览器专用的window、document、navigator、location对象,包括cookie等存储,只有在浏览器中才有,app和小程序都不支持。但app和小程序支持web-view组件,里面可以加载标准HTML,这种页面仍然支持浏览器专用对象window、document、navigator、location。
    数据绑定模式变化从DOM操作变成Vue的MVVM模式
    注意: ① 小程序的数据绑定参考了vue,但自己修改了一些。在uni-app中只支持标准的vue,不支持小程序的数据绑定语法。②小程序里的setData在uni-app里并不存在,因为vue是自动双向数据绑定的。直接通过赋值方式修改数据,如果数据绑定到界面上,界面会自动更新渲染

Api变化

    alert、confirm 改成 uni.showmodel
    ajax 改成 uni.request
    cookie、session 没有了,local.storage 改成 uni.storage

uni-app的js api还有很多,但基本就是小程序的api,把wx.xxx改为uni.xxx即可
CSS变化:

    不支持*选择器、元素选择器里body改为page
    默认单位 upx、默认布局 flex布局
    注意背景图和字体文件尽量不要大于40k。会影响性能。

如果非要大于40k,需放到服务器侧远程引用或base64后引入,不能放到本地作为独立文件引用。
在小程序里,其实小于40k的文件在css里也无法引用,uni-app编译器在编译时自动做了处理,把小于40k的文件编译为base64方式。
工程结构和页面管理:

    每个可显示的页面,都必须在 pages.json 中注册。pages.json类似与小程序的app.json,是配置文件。
    与Vue相比:没有Vue的路由,路由都在pages.json中管理。

与小程序相比: 原来app.json被一拆为二。

    页面管理,被挪入了uni-app的pages.json;非页面管理,挪入了manifest.json。
    原来的app.js和app.wxss被合并到了app.vue中

uni-app的首页,是在pages.json里配的,page节点下第一个页面就是首页。一般在/pages/xx的目录下。
页面提供了原生的导航栏和底部tabbar,但必须在pages.json中配置。

三、基于Promise封装uni-app的request方法,实现类似axios形式的请求

拦截器只能自己封装,uni-app仅提供网络请求的方法和中断连接的方法;
uni-app内置了flyio:https://wendux.github.io/dist/#/doc/flyio/readme

var Fly=require("flyio/dist/npm/wx");
var fly=new Fly; var server = "https://uniapp.dcloud.io/update";
var req = {"appid":"123","version":"123"}; fly.request(server, req, {
method:"get",
timeout:5000 //超时设置为5s
}) .then( d=>{
console.log("request result:",d)
}) .catch(
(e) => console.log("error", e)
);

方法一uniapp 数据网络请求封装以及通用使用【教程】:https://blog.csdn.net/Neil_1993/article/details/90483790
方法二【使用unifly代替uni-request】:unifly支持uni-request所有功能,而且更具有模块化思想。(uni-request不再维护,但历史版本仍然可以使用)

    uni-request 教程:https://www.liangzl.com/get-article-detail-39769.html
    uniFly 教程: https://www.jianshu.com/p/2729ac395cf5

基于fly.js:是一个类似于axios的工具,可以设置拦截等需求
Fly官网:https://wendux.github.io/dist/#/doc/flyio/readme
对比axios:https://wendux.github.io/dist/#/doc/flyio/compare


注:以上内容来自UniApp官网推荐教程

重点突破】—— UniApp微信小程序开发教程学习Three的相关教程结束。

《【重点突破】—— UniApp微信小程序开发教程学习Three.doc》

下载本文的Word格式文档,以方便收藏与打印。