DCloud_heavensoft
DCloud_heavensoft
  • 发布:2019-03-05 23:13
  • 更新:2022-07-15 17:42
  • 阅读:316082

白话uni-app 【也是html、vue、小程序的区别】

分类:uni-app

白话uni-app

本文适合对象:

  1. 已经通过uni-app官网对产品概念有基本了解。
  2. 熟悉h5,但对小程序、vue不了解

传统的h5只有1端,即浏览器。而uni-app可跨多端,虽仍属前端,与传统h5有不同。
如果你对h5比较了解,可通过本文快速了解uni-app。

网络模型的变化

以前网页大多是b/s,服务端代码混合在页面里;

现在是c/s,前后端分离,通过js api(类似ajax的uni.request)获取json数据,把数据绑定在界面上渲染。

文件类型变化

以前是.html文件,开发也是html,运行也是html。
现在是.vue文件,开发是vue,经过编译后,运行时已经变成了js文件。
现代前端开发,很少直接使用HTML,基本都是开发、编译、运行。所以uni-app有编译器、运行时的概念。

文件内代码架构的变化

以前一个html大节点,里面有script和style节点;

现在template是一级节点,用于写tag组件,script和style是并列的一级节点,也就是有3个一级节点。

以前

<!DOCTYPE html>  
<html>  
    <head>  
        <meta charset="utf-8" />  
        <title></title>  
        <script type="text/javascript">  

        </script>  
        <style type="text/css">  

        </style>  
    </head>  
    <body>  

    </body>  
</html>

现在。这个叫vue单文件组件规范sfc

<template>  
    <view>  
    注意必须有一个view,且只能有一个根view。所有内容写在这个view下面。  
    </view>  
</template>  

<script>  
    export default {  

    }  
</script>  

<style>  

</style>

外部文件引用方式变化

以前通过script src、link href引入外部的js和css;

现在是es6的写法,import引入外部的js模块(注意不是文件)或css

以前

<script src="js/jquery-1.10.2.js" type="text/javascript"></script>  
<link href="css/bootstrap.css" rel="stylesheet" type="text/css"/>

现在

js要require进来,变成了对象。

在hello uni-app的common目录有一个工具类util.js,可以在hello uni-app中搜索这个例子查看。

<script>  
var util = require('../../../common/util.js');  //require这个js模块  
var formatedPlayTime = util.formatTime(playTime); //调用js模块的方法  
</script>

而在这个util.js里,要把之前的function封装为对象的方法

function formatTime(time) {  
    return time;//这里没写逻辑  
}  

module.exports = {  
    formatTime: formatTime  
}

当然还有一些高级的用法

var dateUtils = require('../../../common/util.js').dateUtils; //直接使用js模块的属性。在hello uni-app有示例  
import * as echarts from '/components/echarts/echarts.simple.min.js'; //将js导入并重命名为echarts,然后使用echarts.来继续执行方法。在hello uni-app有示例

css外部文件导入

<style>  
    @import "./common/uni.css";  

    .uni-hello-text{  
        color:#7A7E83;  
    }  
</style>

全局样式,在根目录下的app.vue里写入,每个页面都会加载app.vue里的样式。

另外,vue支持组件导入,可以更方便的封装一个包括界面、js、样式的库。

如下是导入一个角标的组件库,在页面上显示一个abc并且右上角有个数字角标1,详见

<template>  
    <view>  
        <uni-badge text="abc" :inverted="true"></uni-badge><!--3.使用组件-->  
    </view>  
</template>  
<script>  
    import uniBadge from "../../../components/uni-badge.vue";//1.导入组件(这步属于传统vue规范,但在uni-app的easycom下可以省略这步)  
    export default {  
        data() {  
            return {  

            }  
        },  
        components: {  
            uniBadge //2.注册组件(这步属于传统vue规范,但在uni-app的easycom下可以省略这步)  
        }  
    }  
</script>

如需要全局导入vue组件,即每个页面都可以直接使用而不用引用和注册的话,在项目根目录下的main.js里处理。如下是hello uni-app里的例子。

//main.js  
import pageHead from './components/page-head.vue' //导入  
Vue.component('page-head', pageHead) //注册。注册后在每个vue的page页面里可以直接使用<page-head></page-head>组件。

上述的组件使用方式属于传统vue的概念。uni-app 2.7以后推出了更简单的组件使用技术easycom,无需引用和注册组件,直接在template区域使用组件即可。

组件/标签的变化

以前是html标签,比如<div>,现在是小程序组件,比如<view>
那么标签组件有什么区别,不都是用尖括号包围起来一段英文吗?
其实标签是老的概念,标签属于浏览器内置的东西。但组件,是可以自由扩展的。
类似你可以把一段js封装成函数或模块,你也可以把一个ui控件封装成一个组件。

uni-app参考小程序规范,提供了一批内置组件。

下为html标签和uni-app内置组件的映射表:

除了改动外,新增了一批手机端常用的新组件

除了内置组件,还有很多开源的扩展组件,把常用操作都进行封装,DCloud建立了插件市场收录这些扩展组件,详见插件市场

js的变化

js的变化,分为运行环境变化、数据绑定模式变化、api变化3部分。

  • 运行环境从浏览器变成v8引擎

标准js语法和api都支持,比如if、for、settimeout、indexOf等。

但浏览器专用的window、document、navigator、location对象,包括cookie等存储,只有在浏览器中才有,app和小程序都不支持。

可能有些人以为js等于浏览器里的js。其实js是ECMAScript组织管理的,浏览器中的js是w3c组织基于js规范补充了window、document、navigator、location等专用对象。

在uni-app的各个端中,除了h5端,其他端的js都运行在一个独立的v8引擎下,不是在浏览器中,所以浏览器的对象无法使用。如果你做过小程序开发,对此应当很了解。

这意味着依赖document的很多HTML的库,比如jquery无法使用。

当然app和小程序支持web-view组件,里面可以加载标准HTML,这种页面仍然支持浏览器专用对象window、document、navigator、location。

  • 以前的dom操作,改成vue的MVVM模式

现在前端趋势是去dom化,改用mvvm模式,更简洁的写法,大幅减少代码行数,同时差量渲染性能更好。

uni-app使用vue的数据绑定方式解决js和dom界面交互的问题。

如果你想改变某个dom元素的显示内容,比如一个view的显示文字:

以前是给view设id,然后js里通过选择器获取dom元素,进一步通过js进行赋值操作,修改dom元素的属性或值。

如下演示了一段代码,页面中有个显示的文字区和一个按钮,点击按钮后会修改文字区的值

<html>  
    <head>  
        <script type="text/javascript">  
            document.addEventListener("DOMContentLoaded",function () {  
                document.getElementById("spana").innerText="456"  
            })  
            function changetextvalue () {  
                document.getElementById("spana").innerText="789"  
            }  
        </script>  
    </head>  
    <body>  
        <span id="spana">123</span>  
        <button type="button" onclick="changetextvalue()">修改为789</button>  
    </body>  
</html>  

现在的做法,是vue的绑定模式,给这个dom元素绑定一个js变量,在script中修改js变量的值,dom会自动变化,页面会自动更新渲染

<template>  
    <view>  
        <text>{{textvalue}}</text><!-- 这里演示了组件值的绑定 -->  
        <button :type="buttontype" @click="changetextvalue()">修改为789</button><!-- 这里演示了属性和事件的绑定 -->  
    </view>  
</template>  

<script>  
    export default {  
        data() {  
            return {  
                textvalue:"123",  
                buttontype:"primary"  
            };  
        },  
        onLoad() {  
            this.textvalue="456"//这里修改textvalue的值,其实123都来不及显示就变成了456  
        },  
        methods: {  
            changetextvalue() {  
                this.textvalue="789"//这里修改textvalue的值,页面自动刷新为789  
            }  
        }  
    }  
</script>

注意上述代码中的 export default {} 里的 data(): {return { }}
在vue的设计中,这里存放着页面中需要绑定的数据,写在data里,才能被界面正确的绑定和渲染。
注意:uni-app的vue页面是vue的单文件组件规范,按照vue的定义只接受 function,必须用 return 包起来。

如果你学过小程序的数据绑定,但不了解vue,要注意:

  • 小程序的数据绑定参考了vue,但自己修改了一些。在uni-app中只支持标准的vue,不支持小程序的数据绑定语法
  • 小程序里的setData在uni-app里并不存在,因为vue是自动双向数据绑定的。直接通过赋值方式修改数据,如果数据绑定到界面上,界面会自动更新渲染

从上述示例,还可看出事件的写法变化。

  • 以前,元素的事件是用onxxx="",里面写一段js或引用function的name,比如上述代码中的onclick="changetextvalue()"
  • 现在,需要在js的export default {} 里的 methods: {} 里写一个方法,然后在组件中使用@click="changetextvalue()"

在js中,与data和methods平级的,如上述示例代码中的onload(),称为生命周期。在普通vue页面里的生命周期叫页面生命周期。在项目根目录的app.vue文件中的生命周期叫应用生命周期。
除了onload,还有onready等很多生命周期,具体见uni-app的生命周期

在高级用法里,vue支持给组件设ref(引用标记),这类似于之前html中给一个dom元素设id,然后在js中也可以用this.$refs.xxx来获取。如下:

<template>  
  <view>  
    <view ref="testview">11111</view>  
    <button @click="getTest">获取test节点</button>  
  </view>  
</template>  

<script>  
export default {  
  methods: {  
    getTest() {  
      console.log(this.$refs.testview)  
    }  
  }  
};  
</script>
  • js api的变化

因为uni-app的api是参考小程序的,所以和浏览器的js api有很多不同,如

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

uni-app的js api还有很多,但基本就是小程序的api,把wx.xxx改为uni.xxx即可。详见

uni-app在不同的端,支持条件编译,无限制的使用各端独有的api,详见条件编译

css的变化

标准的css基本都是支持的。

选择器有2个变化:*选择器不支持;元素选择器里没有body,改为了page。微信小程序即是如此。

page{  

}

单位方面,px无法动态适应不同宽度的屏幕,rem无法用于nvue/weex。如果想使用根据屏幕宽度自适应的单位,推荐使用rpx,全端支持。 尺寸单位文档

uni-app推荐使用flex布局,这个布局思路和传统流式布局有点区别。但flex的特色在于,不管是什么技术都支持这种排版,web、小程序/快应用、weex/rn、原生的iOS、Android开发,全都支持flex。它是通吃所有端的新一代布局方案。相关教程请自行百度学习。

uni-app的vue文件里支持所有web排版方式,不管是流式还是flex。但nvue里,只支持flex,因为它在app端是使用原生排版引擎渲染的。

注意css里背景图和字体文件,尽量不要大于40k,因为会影响性能。在小程序端,如果要大于40k,需放到服务器侧远程引用或base64后引入,不能放到本地作为独立文件引用。

工程结构和页面管理

uni-app的工程结构有单独的要求,详见

每个可显示的页面,都必须在 pages.json 中注册。如果你开发过小程序,那么pages.json类似app.json。如果你熟悉vue,这里没有vue的路由,都是在pages.json里管理。

原来工程的首页一般是index.html或default.html,是在web server里配的。而uni-app的首页,是在pages.json里配的,page节点下第一个页面就是首页。一般在/pages/xx的目录下。

app和小程序中,为了提升体验,页面提供了原生的导航栏和底部tabbar,注意这些配置是在pages.json中做,而不是在vue页面里创建,但点击事件的监听在显示的vue页面中做。

如果你熟悉小程序开发的话,对比变化如下:

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

结语

最后,本文并非uni-app的完整教程,了解掌握uni-app,还需要认真过一遍uni-app的文档。

掌握好vue,也仍需要进一步去vue官网学习。或通过uni-app专业视频培训课程,连同vue带uni-app一起学会。

根据腾讯课堂和职友集的数据,会vue的人,比不会vue的普通前端薪资高27%哦。

如果你熟悉小程序,但不熟悉vue的话,这里还有一篇文章总结的很好:vue和微信小程序的区别、比较

223 关注 分享
1***@qq.com 全村人的老司机 DCloud_HB_WDL Trust SimpleJalon 雪之梦技术驿站 wenju DCloud_UNI_HT l***@dingtalk.com 1***@qq.com 5***@qq.com 5***@qq.com b***@126.com junyu 1***@qq.com 6***@qq.com 闫明 y***@163.com 3***@qq.com 中旭信息 e***@163.com 8***@qq.com iPan skysowe s***@163.com 浪里寻花 刘归航 c***@qq.com y***@163.com 9***@qq.com c***@126.com sonicsunsky 1***@qq.com 这不是我没有 whgz 2***@qq.com 没得好名字 蒋雨洋 半路老王 3***@qq.com 2***@qq.com x***@foxmail.com 9***@qq.com 1***@163.com 雪域雄鹰 webber007 3***@qq.com T***@163.com c***@126.com 3***@qq.com

要回复文章请先登录注册

L***@163.com

L***@163.com

请问大佬,想阅读源码,请问有大概的指导吗?
2022-07-15 17:42
DCloud_heavensoft

DCloud_heavensoft (作者)

回复 2***@qq.com :
感谢反馈
2022-06-09 22:44
2***@qq.com

2***@qq.com

jqurey是不是jquery噢?
2022-06-06 09:53
剑逍遥

剑逍遥

用通俗的语言讲透了难点,作者很66666
2022-03-27 18:03
Arunner

Arunner

白话的真好,赞
2022-03-24 11:09
1***@qq.com

1***@qq.com

有没有想一起合作开发的伙伴,,有点联系我 QQ 1923657499@qq.com
2022-03-19 10:55
3***@qq.com

3***@qq.com

你好QQ小程序有了代码以后怎么搞
2022-03-17 19:48
9***@qq.com

9***@qq.com

点个赞
2022-01-08 12:45
Bullbat_710

Bullbat_710

写的非常好 点个赞
2021-11-25 16:58
5***@qq.com

5***@qq.com

作者太强了,写的超级友好!大赞!
2021-08-17 09:58