白話uni-app 【也是html、vue、小程序的區(qū)別】
白話uni-app
本文適合對(duì)象:
已經(jīng)通過(guò)uni-app官網(wǎng)對(duì)產(chǎn)品概念有基本了解。
熟悉h5,但對(duì)小程序、vue不了解
傳統(tǒng)的h5只有1端,即瀏覽器。而uni-app可跨多端,雖仍屬前端,與傳統(tǒng)h5有不同。
如果你對(duì)h5比較了解,可通過(guò)本文快速了解uni-app。
網(wǎng)絡(luò)模型的變化
以前網(wǎng)頁(yè)大多是b/s,服務(wù)端代碼混合在頁(yè)面里;
現(xiàn)在是c/s,前后端分離,通過(guò)js api(類似ajax的uni.request)獲取json數(shù)據(jù),把數(shù)據(jù)綁定在界面上渲染。
文件類型變化
以前是.html文件,開(kāi)發(fā)也是html,運(yùn)行也是html。
現(xiàn)在是.vue文件,開(kāi)發(fā)是vue,經(jīng)過(guò)編譯后,運(yùn)行時(shí)已經(jīng)變成了js文件。
現(xiàn)代前端開(kāi)發(fā),很少直接使用HTML,基本都是開(kāi)發(fā)、編譯、運(yùn)行。所以u(píng)ni-app有編譯器、運(yùn)行時(shí)的概念。
文件內(nèi)代碼架構(gòu)的變化
以前一個(gè)html大節(jié)點(diǎn),里面有script和style節(jié)點(diǎn);
現(xiàn)在template是一級(jí)節(jié)點(diǎn),用于寫(xiě)tag組件,script和style是并列的一級(jí)節(jié)點(diǎn),也就是有3個(gè)一級(jí)節(jié)點(diǎn)。
以前
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title></title>
<script type="text/javascript">
</script>
<style type="text/css">
</style>
</head>
<body>
</body>
</html>
現(xiàn)在。這個(gè)叫vue單文件組件規(guī)范sfc
<template>
<view>
注意必須有一個(gè)view,且只能有一個(gè)根view。所有內(nèi)容寫(xiě)在這個(gè)view下面。
</view>
</template>
<script>
export default {
}
</script>
<style>
</style>
外部文件引用方式變化
以前通過(guò)script src、link href引入外部的js和css;
現(xiàn)在是es6的寫(xiě)法,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"/>
現(xiàn)在
js要require進(jìn)來(lái),變成了對(duì)象。
在hello uni-app的common目錄有一個(gè)工具類util.js,可以在hello uni-app中搜索這個(gè)例子查看。
<script>
var util = require('../../../common/util.js'); //require這個(gè)js模塊
var formatedPlayTime = util.formatTime(playTime); //調(diào)用js模塊的方法
</script>
而在這個(gè)util.js里,要把之前的function封裝為對(duì)象的方法
function formatTime(time) {
return time;//這里沒(méi)寫(xiě)邏輯
}
module.exports = {
formatTime: formatTime
}
當(dāng)然還有一些高級(jí)的用法
var dateUtils = require('../../../common/util.js').dateUtils; //直接使用js模塊的屬性。在hello uni-app有示例
import * as echarts from '/components/echarts/echarts.simple.min.js'; //將js導(dǎo)入并重命名為echarts,然后使用echarts.來(lái)繼續(xù)執(zhí)行方法。在hello uni-app有示例
css外部文件導(dǎo)入
<style>
@import "./common/uni.css";
.uni-hello-text{
color:#7A7E83;
}
</style>
全局樣式,在根目錄下的app.vue里寫(xiě)入,每個(gè)頁(yè)面都會(huì)加載app.vue里的樣式。
另外,vue支持組件導(dǎo)入,可以更方便的封裝一個(gè)包括界面、js、樣式的庫(kù)。
如下是導(dǎo)入一個(gè)角標(biāo)的組件庫(kù),在頁(yè)面上顯示一個(gè)abc并且右上角有個(gè)數(shù)字角標(biāo)1,詳見(jiàn)
<template>
<view>
<uni-badge text="abc" :inverted="true"></uni-badge><!--3.使用組件-->
</view>
</template>
<script>
import uniBadge from "../../../components/uni-badge.vue";//1.導(dǎo)入組件(這步屬于傳統(tǒng)vue規(guī)范,但在uni-app的easycom下可以省略這步)
export default {
data() {
return {
}
},
components: {
uniBadge //2.注冊(cè)組件(這步屬于傳統(tǒng)vue規(guī)范,但在uni-app的easycom下可以省略這步)
}
}
</script>
如需要全局導(dǎo)入vue組件,即每個(gè)頁(yè)面都可以直接使用而不用引用和注冊(cè)的話,在項(xiàng)目根目錄下的main.js里處理。如下是hello uni-app里的例子。
//main.js
import pageHead from './components/page-head.vue' //導(dǎo)入
Vue.component('page-head', pageHead) //注冊(cè)。注冊(cè)后在每個(gè)vue的page頁(yè)面里可以直接使用<page-head></page-head>組件。
上述的組件使用方式屬于傳統(tǒng)vue的概念。uni-app 2.7以后推出了更簡(jiǎn)單的組件使用技術(shù)easycom,無(wú)需引用和注冊(cè)組件,直接在template區(qū)域使用組件即可。
組件/標(biāo)簽的變化
以前是html標(biāo)簽,比如
那么標(biāo)簽和組件有什么區(qū)別,不都是用尖括號(hào)包圍起來(lái)一段英文嗎?
其實(shí)標(biāo)簽是老的概念,標(biāo)簽屬于瀏覽器內(nèi)置的東西。但組件,是可以自由擴(kuò)展的。
類似你可以把一段js封裝成函數(shù)或模塊,你也可以把一個(gè)ui控件封裝成一個(gè)組件。
uni-app參考小程序規(guī)范,提供了一批內(nèi)置組件。
下為html標(biāo)簽和uni-app內(nèi)置組件的映射表:
section 改成 view
span、font 改成 text
a 改成 navigator
img 改成 image
input 僅僅是輸入框。原h(huán)tml規(guī)范中input不僅是輸入框,還有- radio、checkbox、時(shí)間、日期、文件選擇功能。在uni-app和小程序規(guī)范中,input僅僅是輸入框。其他功能uni-app有單獨(dú)的組件或API:radio組件、checkbox組件、時(shí)間選擇、日期選擇、圖片選擇、視頻選擇、多媒體文件選擇(含圖片視頻)、通用文件選擇。
form、button、label、textarea、canvas、video 這些還在。
select 改成 picker
iframe 改成 web-view
ul、li沒(méi)有了,都用view替代。做列表一般使用uList組件
audio 不再推薦使用,改成api方式,背景音頻api文檔
其實(shí)老的HTML標(biāo)簽也可以在uni-app里使用,uni-app編譯器會(huì)在編譯時(shí)把老標(biāo)簽轉(zhuǎn)為新標(biāo)簽,比如把section編譯成view。但不推薦這種用法,調(diào)試H5端時(shí)容易混亂。
除了改動(dòng)外,新增了一批手機(jī)端常用的新組件
scroll-view 可區(qū)域滾動(dòng)視圖容器
swiper 可滑動(dòng)區(qū)域視圖容器
icon 圖標(biāo)
rich-text 富文本(不可執(zhí)行js,但可渲染各種文字格式和圖片)
progress 進(jìn)度條
slider 滑塊指示器
switch 開(kāi)關(guān)選擇器
camera 相機(jī)
live-player 直播
map 地圖
cover-view 可覆蓋原生組件的視圖容器 cover-view需要多強(qiáng)調(diào)幾句,uni-app的非h5端的video、map、canvas、textarea是原生組件,層級(jí)高于其他組件。如需覆蓋原生組件,則需要使用cover-view組件。詳見(jiàn)層級(jí)介紹
除了內(nèi)置組件,還有很多開(kāi)源的擴(kuò)展組件,把常用操作都進(jìn)行封裝,DCloud建立了插件市場(chǎng)收錄這些擴(kuò)展組件,詳見(jiàn)插件市場(chǎng)
js的變化
js的變化,分為運(yùn)行環(huán)境變化、數(shù)據(jù)綁定模式變化、api變化3部分。
運(yùn)行環(huán)境從瀏覽器變成v8引擎
標(biāo)準(zhǔn)js語(yǔ)法和api都支持,比如if、for、settimeout、indexOf等。
但瀏覽器專用的window、document、navigator、location對(duì)象,包括cookie等存儲(chǔ),只有在瀏覽器中才有,app和小程序都不支持。
可能有些人以為js等于瀏覽器里的js。其實(shí)js是ECMAScript組織管理的,瀏覽器中的js是w3c組織基于js規(guī)范補(bǔ)充了window、document、navigator、location等專用對(duì)象。
在uni-app的各個(gè)端中,除了h5端,其他端的js都運(yùn)行在一個(gè)獨(dú)立的v8引擎下,不是在瀏覽器中,所以瀏覽器的對(duì)象無(wú)法使用。如果你做過(guò)小程序開(kāi)發(fā),對(duì)此應(yīng)當(dāng)很了解。
這意味著依賴document的很多HTML的庫(kù),比如jqurey無(wú)法使用。
當(dāng)然app和小程序支持web-view組件,里面可以加載標(biāo)準(zhǔn)HTML,這種頁(yè)面仍然支持瀏覽器專用對(duì)象window、document、navigator、location。
以前的dom操作,改成vue的MVVM模式
現(xiàn)在前端趨勢(shì)是去dom化,改用mvvm模式,更簡(jiǎn)潔的寫(xiě)法,大幅減少代碼行數(shù),同時(shí)差量渲染性能更好。
uni-app使用vue的數(shù)據(jù)綁定方式解決js和dom界面交互的問(wèn)題。
如果你想改變某個(gè)dom元素的顯示內(nèi)容,比如一個(gè)view的顯示文字:
以前是給view設(shè)id,然后js里通過(guò)選擇器獲取dom元素,進(jìn)一步通過(guò)js進(jìn)行賦值操作,修改dom元素的屬性或值。
如下演示了一段代碼,頁(yè)面中有個(gè)顯示的文字區(qū)和一個(gè)按鈕,點(diǎn)擊按鈕后會(huì)修改文字區(qū)的值
<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>
現(xiàn)在的做法,是vue的綁定模式,給這個(gè)dom元素綁定一個(gè)js變量,在script中修改js變量的值,dom會(huì)自動(dòng)變化,頁(yè)面會(huì)自動(dòng)更新渲染
<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的值,其實(shí)123都來(lái)不及顯示就變成了456
},
methods: {
changetextvalue() {
this.textvalue="789"//這里修改textvalue的值,頁(yè)面自動(dòng)刷新為789
}
}
}
</script>
注意上述代碼中的 export default {} 里的 data(): {return { }}。
在vue的設(shè)計(jì)中,這里存放著頁(yè)面中需要綁定的數(shù)據(jù),寫(xiě)在data里,才能被界面正確的綁定和渲染。
注意:uni-app的vue頁(yè)面是vue的單文件組件規(guī)范,按照vue的定義只接受 function,必須用 return 包起來(lái)。
如果你學(xué)過(guò)小程序的數(shù)據(jù)綁定,但不了解vue,要注意:
小程序的數(shù)據(jù)綁定參考了vue,但自己修改了一些。在uni-app中只支持標(biāo)準(zhǔn)的vue,不支持小程序的數(shù)據(jù)綁定語(yǔ)法
小程序里的setData在uni-app里并不存在,因?yàn)関ue是自動(dòng)雙向數(shù)據(jù)綁定的。直接通過(guò)賦值方式修改數(shù)據(jù),如果數(shù)據(jù)綁定到界面上,界面會(huì)自動(dòng)更新渲染
從上述示例,還可看出事件的寫(xiě)法變化。
以前,元素的事件是用onxxx="",里面寫(xiě)一段js或引用function的name,比如上述代碼中的onclick="changetextvalue()"
現(xiàn)在,需要在js的export default {} 里的 methods: {} 里寫(xiě)一個(gè)方法,然后在組件中使用@click="changetextvalue()"
在js中,與data和methods平級(jí)的,如上述示例代碼中的onload(),稱為生命周期。在普通vue頁(yè)面里的生命周期叫頁(yè)面生命周期。在項(xiàng)目根目錄的app.vue文件中的生命周期叫應(yīng)用生命周期。
除了onload,還有onready等很多生命周期,具體見(jiàn)uni-app的生命周期
在高級(jí)用法里,vue支持給組件設(shè)ref(引用標(biāo)記),這類似于之前html中給一個(gè)dom元素設(shè)id,然后在js中也可以用this.$refs.xxx來(lái)獲取。如下:
<template>
<view>
<view ref="testview">11111</view>
<button @click="getTest">獲取test節(jié)點(diǎn)</button>
</view>
</template>
<script>
export default {
methods: {
getTest() {
console.log(this.$refs.testview)
}
}
};
</script>
js api的變化
因?yàn)閡ni-app的api是參考小程序的,所以和瀏覽器的js api有很多不同,如
alert,confirm 改成 uni.showmodel
ajax 改成 uni.request
cookie、session 沒(méi)有了,local.storage 改成 uni.storage
uni-app的js api還有很多,但基本就是小程序的api,把wx.xxx改為uni.xxx即可。詳見(jiàn)
uni-app在不同的端,支持條件編譯,無(wú)限制的使用各端獨(dú)有的api,詳見(jiàn)條件編譯
css的變化
標(biāo)準(zhǔn)的css基本都是支持的。
選擇器有2個(gè)變化:*選擇器不支持;元素選擇器里沒(méi)有body,改為了page。微信小程序即是如此。
page{
}
單位方面,px無(wú)法動(dòng)態(tài)適應(yīng)不同寬度的屏幕,rem無(wú)法用于nvue/weex。如果想使用根據(jù)屏幕寬度自適應(yīng)的單位,推薦使用rpx,全端支持。尺寸單位文檔
uni-app推薦使用flex布局,這個(gè)布局思路和傳統(tǒng)流式布局有點(diǎn)區(qū)別。但flex的特色在于,不管是什么技術(shù)都支持這種排版,web、小程序/快應(yīng)用、weex/rn、原生的iOS、Android開(kāi)發(fā),全都支持flex。它是通吃所有端的新一代布局方案。相關(guān)教程請(qǐng)自行百度學(xué)習(xí)。
uni-app的vue文件里支持所有web排版方式,不管是流式還是flex。但nvue里,只支持flex,因?yàn)樗赼pp端是使用原生排版引擎渲染的。
注意css里背景圖和字體文件,盡量不要大于40k,因?yàn)闀?huì)影響性能。在小程序端,如果要大于40k,需放到服務(wù)器側(cè)遠(yuǎn)程引用或base64后引入,不能放到本地作為獨(dú)立文件引用。
工程結(jié)構(gòu)和頁(yè)面管理
uni-app的工程結(jié)構(gòu)有單獨(dú)的要求,詳見(jiàn)
每個(gè)可顯示的頁(yè)面,都必須在 pages.json 中注冊(cè)。如果你開(kāi)發(fā)過(guò)小程序,那么pages.json類似app.json。如果你熟悉vue,這里沒(méi)有vue的路由,都是在pages.json里管理。
原來(lái)工程的首頁(yè)一般是index.html或default.html,是在web server里配的。而uni-app的首頁(yè),是在pages.json里配的,page節(jié)點(diǎn)下第一個(gè)頁(yè)面就是首頁(yè)。一般在/pages/xx的目錄下。
app和小程序中,為了提升體驗(yàn),頁(yè)面提供了原生的導(dǎo)航欄和底部tabbar,注意這些配置是在pages.json中做,而不是在vue頁(yè)面里創(chuàng)建,但點(diǎn)擊事件的監(jiān)聽(tīng)在顯示的vue頁(yè)面中做。
如果你熟悉小程序開(kāi)發(fā)的話,對(duì)比變化如下:
原來(lái)app.json被一拆為二。頁(yè)面管理,被挪入了uni-app的pages.json;非頁(yè)面管理,挪入了manifest.json
原來(lái)的app.js和app.wxss被合并到了app.vue中
結(jié)語(yǔ)
最后,本文并非uni-app的完整教程,了解掌握uni-app,還需要認(rèn)真過(guò)一遍uni-app的文檔。
