之前网页大可能是b/s,服务端代码混合在页面里;css
如今是c/s,先后端分离,经过js api(相似ajax的uni.request)获取json数据,把数据绑定在界面上渲染。html
之前是.html文件,如今是.vue文件前端
之前一个html大节点,里面有script和style节点;vue
如今template是一级节点,用于写tag组件,script和style是并列的一级节点,也就是有3个一级节点。vue单文件组件规范sfchtml5
<template> <view> 注意必须有一个view,且只能有一个根view。全部内容写在这个view下面。 </view> </template> <script> export default { } </script> <style> </style>
之前经过script src、link href引入外部的js和css;android
如今是es6的写法,import引入外部的js模块(注意不是文件)或csswebpack
在hello uni-app的common目录有一个工具类util.js
,能够在hello uni-app中搜索这个例子查看。ios
<script> var util = require('../../../common/util.js'); //require这个js模块 var formatedPlayTime = util.formatTime(playTime); //调用js模块的方法 </script>
而在这个util.js
里,要把以前的function封装为对象的方法es6
function formatTime(time) { return time;//这里没写逻辑 } module.exports = { formatTime: formatTime }
固然还有一些高级的用法web
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有示例
<style> @import "./common/uni.css"; .uni-hello-text{ color:#7A7E83; } </style>
全局样式,在根目录下的app.vue里写入,每一个页面都会加载app.vue里的样式。
以下是导入一个角标的组件库,在页面上显示一个abc而且右上角有个数字角标1
<template> <view> <uni-badge text="abc" :inverted="true"></uni-badge><!--3.使用组件--> </view> </template> <script> import uniBadge from "../../../components/uni-badge.vue";//1.导入组件 export default { data() { return { } }, components: { uniBadge //2.注册组件 } } </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>组件。
具体说来:
除了改动外,新增了一批手机端经常使用的新组件
cover-view 可覆盖原生组件的视图容器
cover-view须要多强调几句,uni-app的非h5端的video、map、canvas、textarea是原生组件,层级高于其余组件。如需覆盖原生组件,好比在map上加个遮罩,则须要使用cover-view组件
除了内置组件,还有不少开源的扩展组件,把经常使用操做都进行封装,DCloud创建了插件市场收录这些扩展组件,详见插件市场
js的变化,分为运行环境变化、数据绑定模式变化、api变化3部分。
标准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的库,好比jqurey没法使用。
固然app和小程序支持web-view组件,里面能够加载标准HTML,这种页面仍然支持浏览器专用对象window、document、navigator、location。
如今前端趋势是去dom化,改用mvvm模式,更简洁的写法,大幅减小代码行数,同时差量渲染性能更好。
uni-app使用vue的数据绑定方式解决js和dom界面交互的问题。
若是你想改变某个dom元素的显示内容,好比一个view的显示文字:
之前是给view设id,而后js里经过选择器获取dom元素,进一步经过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>
若是你学太小程序的数据绑定,但不了解vue,要注意:
小程序的数据绑定参考了vue,但本身修改了一些。在uni-app中只支持标准的vue,不支持小程序的数据绑定语法
小程序里的setData在uni-app里并不存在,由于vue是自动双向数据绑定的。直接经过赋值方式修改数据,若是数据绑定到界面上,界面会自动更新渲染
js api的变化
由于uni-app的api是参考小程序的,因此和浏览器的js api有不少不一样,如
uni-app的js api还有不少,但基本就是小程序的api,把wx.xxx改成uni.xxx便可。详见
uni-app在不一样的端,支持条件编译,无限制的使用各端独有的api,详见条件编译
标准的css基本都是支持的。
选择器有2个变化:*选择器不支持;元素选择器里没有body,改成了page。微信小程序便是如此。
单位方面,px没法动态适应不一样宽度的屏幕,rem没法用于nvue/weex。若是想使用根据屏幕宽度自适应的单位,推荐使用rpx,全端支持。
uni-app推荐使用flex布局,并默认就是flex布局,这个布局思路和传统流式布局有点区别。但flex的有趣在于,无论是什么技术都支持这种排版,web、小程序/快应用、weex/rn、原生的iOS、Android开发,全都支持flex。它是通吃全部端的新一代布局方案。相关教程请自行百度学习。
uni-app的vue文件里支持全部web排版方式,无论是流式仍是flex。但nvue里,只支持flex,由于它在app端是使用原生排版引擎渲染的。
注意背景图和字体文件尽可能不要大于40k。会影响性能。若是非要大于40k,需放到服务器侧远程引用或base64后引入,不能放到本地做为独立文件引用。在小程序里,其实小于40k的文件在css里也没法引用,uni-app编译器在编译时自动作了处理,把小于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页面中作。
在vue中,之前的js事件监听
概念改成了生命周期
概念。详见uni-app生命周期
若是你熟悉小程序开发的话,对比变化以下:
为了实现多端兼容,综合考虑编译速度、运行性能等因素,uni-app
约定了以下开发规范:
wx
替换为 uni
,详见uni-app接口规范Vue.js
规范,同时补充了App及页面的生命周期一个uni-app工程,默认包含以下目录及文件:
┌─components uni-app组件目录
│ └─comp-a.vue 可复用的a组件
├─hybrid 存放本地网页的目录,
├─platforms 存放各平台专用页面的目录,
├─pages 业务页面文件存放的目录
│ ├─index
│ │ └─index.vue index页面
│ └─list
│ └─list.vue list页面
├─static 存放应用引用静态资源(如图片、视频等)的目录,注意:静态资源只能存放于此
├─wxcomponents 存放小程序组件的目录,
├─main.js Vue初始化入口文件
├─App.vue 应用配置,用来配置App全局样式以及监听
├─manifest.json 配置应用名称、appid、logo、版本等打包信息
└─pages.json 配置页面路由、导航条、选项卡等页面类信息
Tips
static
目录下的 js
文件不会被编译,若是里面有 es6
的代码,不通过转换直接运行,在手机设备上会报错。css
、less/scss
等资源一样不要放在 static
目录下,建议这些公用的资源放在 common
目录下。ext.json
sitemap.json
文件。模板内引入静态资源:
template
内引入静态资源,如image
、video
等标签的src
属性时,可使用相对路径或者绝对路径
js文件引入:
js文件或script标签内(包括renderjs等)引入js文件时,可使用相对路径和绝对路径
css引入静态资源:
css文件或style标签内引入css文件时(scss、less文件同理),只能使用相对路径
注意:自HBuilderX 2.6.6-alpha起支持绝对路径引入静态资源,旧版本不支持此方式
uni-app页面路由为框架统一管理,开发者须要在pages.json里配置每一个路由页面的路径及页面样式。相似小程序在app.json中配置页面路由同样。因此 uni-app 的路由用法与 Vue Router 不一样,如仍但愿采用 Vue Router 方式管理路由,可在插件市场搜索 Vue-Router。
uni-app 有两种页面路由跳转方式:使用navigator组件跳转、调用API跳转。
开发环境和生产环境:
uni-app 可经过 process.env.NODE_ENV 判断当前环境是开发环境仍是生产环境。通常用于链接测试服务器或生产服务器的动态切换。
if(process.env.NODE_ENV === 'development'){ console.log('开发环境') }else{ console.log('生产环境') }
平台判断有2种场景,一种是在编译期判断,一种是在运行期判断。
编译期判断 编译期判断,即条件编译,不一样平台在编译出包后已是不一样的代码。
// #ifdef H5 alert("只有h5平台才有alert方法") // #endif
如上代码只会编译到H5的发行包里,其余平台的包不会包含如上代码。
运行期判断 运行期判断是指代码已经打入包中,仍然须要在运行期判断平台,此时可以使用 uni.getSystemInfoSync().platform 判断客户端环境是 Android、iOS 仍是小程序开发工具(在百度小程序开发工具、微信小程序开发工具、支付宝小程序开发工具中使用 uni.getSystemInfoSync().platform 返回值均为 devtools)。
switch(uni.getSystemInfoSync().platform){ case 'android': console.log('运行Android上') break; case 'ios': console.log('运行iOS上') break; default: console.log('运行在开发者工具上') break; }
若有必要,也能够在条件编译里本身定义一个变量,赋不一样值。在后续运行代码中动态判断环境。
尺寸单位:uni-app 支持的通用 css 单位包括 px、rpx
vue页面支持普通H5单位,但在nvue里不支持:
nvue还不支持百分比单位。
App端,在 pages.json 里的 titleNView 或页面里写的 plus api 中涉及的单位,只支持 px。注意此时不支持 rpx
nvue中,uni-app 模式(nvue 不一样编译模式介绍)可使用 px 、rpx,表现与 vue 中一致。weex 模式目前遵循weex的单位,它的单位比较特殊:
下面对 rpx 详细说明:
微信小程序设计了 rpx 解决这个问题,uni-app 在 App 端、H5 端都支持了 rpx。
rpx 是相对于基准宽度的单位,能够根据屏幕宽度进行自适应。uni-app 规定屏幕基准宽度 750rpx。
开发者能够经过设计稿基准宽度计算页面元素 rpx 值,设计稿 1px 与框架样式 1rpx 转换公式以下:
设计稿 1px / 设计稿基准宽度 = 框架样式 1rpx / 750rpx
换言之,页面元素宽度在 uni-app 中的宽度计算公式:
750 * 元素在设计稿中的宽度 / 设计稿基准宽度
举例说明:
uni-app
里面的宽度应该设为:750 * 100 / 750
,结果为:100rpx。uni-app
里面的宽度应该设为:750 * 100 / 640
,结果为:117rpx。uni-app
里面的宽度应该设为:750 * 200 / 375
,结果为:400rpx。uni-app 已将经常使用的组件、JS API 封装到框架中,开发者按照 uni-app 规范开发便可保证多平台兼容,大部分业务都可直接知足。
但每一个平台有本身的一些特性,所以会存在一些没法跨平台的状况。
uni-app 提供了条件编译手段,在一个工程里优雅的完成了平台个性化实现。
条件编译是用特殊的注释做为标记,在编译时根据这些特殊的注释,将注释里面的代码编译到不一样平台。
写法:以 #ifdef 或 #ifndef 加 %PLATFORM% 开头,以 #endif 结尾。
条件编译写法 | 说明 |
---|---|
#ifdef APP-PLUS 需条件编译的代码 #endif |
仅出如今 App 平台下的代码 |
#ifndef H5 需条件编译的代码 #endif |
除了 H5 平台,其它平台均存在的代码 |
#ifdef H5 || MP-WEIXIN 需条件编译的代码 #endif |
在 H5 平台或微信小程序平台存在的代码(这里只有||,不可能出现&&,由于没有交集) |
%PLATFORM% 可取值以下:
值 | 平台 | 参考文档 |
---|---|---|
APP-PLUS | App | HTML5+ 规范 |
APP-PLUS-NVUE | App nvue | Weex 规范 |
H5 | H5 | |
MP-WEIXIN | 微信小程序 | 微信小程序 |
MP-ALIPAY | 支付宝小程序 | 支付宝小程序 |
MP-BAIDU | 百度小程序 | 百度小程序 |
MP-TOUTIAO | 字节跳动小程序 | 字节跳动小程序 |
MP-QQ | QQ小程序 | (目前仅cli版支持) |
MP | 微信小程序/支付宝小程序/百度小程序/字节跳动小程序/QQ小程序 |
注意: 条件编译是利用注释实现的,在不一样语法里注释写法不同,js使用 // 注释
、css 使用 /* 注释 */
、vue/nvue 模板里使用 <!-- 注释 -->
示例,以下代码仅在 App 下出现:
示例,以下代码不会在 H5 平台上出现:
示例,以下代码会在 App 和 H5 平台上出现:
示例,以下广告组件仅会在微信小程序中出现:
样式的条件编译,不管是 css 仍是 sass/scss/less/stylus 等预编译语言中,必须使用 /*注释*/
的写法。
下面的页面,只有运行至 App 时才会编译进去
不一样平台下的特有功能,以及小程序平台的分包,均可以经过 pages.json 的条件编译来更好地实现。这样,就不会在其它平台产生多余的资源,进而减少包体积。
json的条件编译,如不一样平台的key名称相同,cli项目下开发者本身安装的校验器会报错,需自行关闭这些校验器对json相同key的校验规则。若是使用HBuilderX的校验器,无需在乎此问题,HBuilderX的语法校验器为此优化过。
在不一样平台,引用的静态资源可能也存在差别,经过 static 的的条件编译能够解决此问题,static 目录下新建不一样平台的专有目录(目录名称同 %PLATFORM% 值域,但字母均为小写),专有目录下的静态资源只有在特定平台才会编译进去。
如如下目录结构,a.png 只有在微信小程序平台才会编译进去,b.png 在全部平台都会被编译。
┌─static
│ ├─mp-weixin
│ │ └─a.png
│ └─b.png
├─main.js
├─App.vue
├─manifest.json
└─pages.json
若是想把各平台的页面文件更完全的分开,也能够在uni-app项目根目录建立platforms
目录,而后在下面进一步建立APP-PLUS、MP-WEIXIN等子目录,存放不一样平台的文件。
在 HBuilderX 中,ctrl+alt+/ 便可生成正确注释(js:// 注释
、css:/* 注释 */
、vue/nvue模板: <!-- 注释 -->
)。
pages.json 文件用来对 uni-app 进行全局配置,决定页面文件的路径、窗口样式、原生的导航栏、底部的原生tabbar 等。
启动模式配置,仅开发期间生效,用于模拟直达页面的场景,如:小程序转发后,用户点击所打开的页面。
属性说明:
属性 | 类型 | 是否必填 | 描述 |
---|---|---|---|
current | Number | 是 | 当前激活的模式,list节点的索引值 |
list | Array | 是 | 启动模式列表 |
list说明:
属性 | 类型 | 是否必填 | 描述 |
---|---|---|---|
name | String | 是 | 启动模式名称 |
path | String | 是 | 启动页面路径 |
query | String | 否 | 启动参数,可在页面的 onLoad 函数里得到 |
注意: 在 App 里真机运行可直接打开配置的页面,微信开发者工具里须要手动改变编译模式,以下图:
代码示例:
"condition": { //模式配置,仅开发期间生效 "current": 0, //当前激活的模式(list 的索引项) "list": [ { "name": "index", //模式名称 "path" : "pages/index/index", "query": "interval=4000&autoplay=false" //启动参数,在页面的onLoad函数里面获得。 }, { "name": "about", //模式名称 "path" : "pages/about/about", "query": "" //启动参数,在页面的onLoad函数里面获得。 } ] }
manifest.json
文件是应用的配置文件,用于指定应用的名称、图标、权限等。
经过在package.json文件中增长uni-app扩展节点,可实现自定义条件编译平台(如钉钉小程序、微信服务号等平台)。
vue.config.js 是一个可选的配置文件,若是项目的根目录中存在这个文件,那么它会被自动加载,通常用于配置 webpack 等编译选项,具体规范参考:vue.config.js
uni.scss
文件的用途是为了方便总体控制应用的风格。好比按钮颜色、边框风格,uni.scss
文件里预置了一批scss变量预置。
uni.scss是一个特殊文件,在代码中无需 import 这个文件便可在scss代码中使用这里的样式变量。uni-app的编译器在webpack配置中特殊处理了这个uni.scss,使得每一个scss文件都被注入这个uni.scss,达到全局可用的效果。若是开发者想要less、stylus的全局使用,须要在vue.config.js中自行配置webpack策略。
App.vue
是uni-app的主组件,全部页面都是在App.vue
下进行切换的,是页面入口文件。但App.vue
自己不是页面,这里不能编写视图元素。
这个文件的做用包括:调用应用生命周期函数、配置全局样式、配置全局的存储globalData
main.js是uni-app的入口文件,主要做用是初始化vue实例、定义全局组件、使用须要的插件如vuex。
为提高开发效率,HBuilderX将 uni-app 经常使用代码封装成了以 u 开头的代码块,如在 template 标签内输入 ulist 回车,会自动生成以下代码:
<view class="uni-list"> <view class="uni-list-cell"> <view class="uni-list-cell-navigate uni-navigate-right" v-for="(item,index) in list" :key="index"> {{item.value}} </view> </view> </view>
代码块分为Tag代码块、JS代码块,如在 script
标签内输入 uShowToast
回车,会自动生成以下代码:
uni.showToast({ title: '', mask: false duration: 1500 });
uni-app已支持代码块见下方列表。
Tag代码块:
几乎各类组件无论是内置组件仍是uni ui的组件,均已封装为代码块,在HBuilderX的vue代码template区域中敲u,代码助手会提示全部可见列表。也可在HBuilderX菜单工具-代码块设置-vue代码块的左侧列表查阅全部。
除组件外,其余经常使用代码块包括:
JS代码块:
uni api代码块:
vue js代码块:
其余经常使用js代码块:
预置代码块不知足需求的话,能够自定义代码块,教程参考https://ask.dcloud.net.cn/article/35924
首先务必确认uni-app和原生代码,谁是主谁是从的问题。
若是应用是uni-app开发为主,只是想离线打包,那么不该该使用uni小程序sdk,请在HBuilderX的发行菜单里点击离线打包。 另注意离线打包没法享受插件市场的付费原生插件,若有相关需求需本身进行原生插件开发,参考插件市场右上角的原生插件开发教程。
uni-app编译后的wxml代码没有可维护性,不便于整合到原生小程序里。若是想复用原生小程序的代码: