位置:电子教程 > Uni-app入门到精通教程 (如果看不到内容请使用360浏览器) 推荐学习资源
前言
第1章 uni-app入门
2.1.1 应用生命周期
2.2 路由
2.3 运行环境判断
2.4 页面样式与布局
2.5 template 和 block
2.7 NPM支持
2.8 TypeScript 支持
2.9 小程序组件支持
2.10 WXS
3.1 配置概要
3.2 配置项列表 pages.json
3.3 manifest.json 配置项列表
3.4 package.json
3.5 vue-config.js
3.6 uni.scss
3.7 App.vue 3.7.1 应用生命周期
3.8 main.js
4.1 JSON 简介
4.2 JSON 语法
4.3 JSON 对象
4.4 JSON 数组
4.5 JSON.parse()
4.6 JSON.stringify()转字符串
4.7 eval函数
5.1uni-app常用语法
5.2 uni-app接口的使用
5.3 uni-app中表单的使用
5.4 uni-app中参数的使用
第6章 uni-app常用组件
当前阅读教程:Uni-app入门到精通教程 > 1.6 使用Vue.js注意事项
阅读(22555525)      收藏       赞(5685)      分享
上一篇: 1.5.3 css引入静态资源 下一篇: 2.1.1 应用生命周期

1.6 使用Vue.js注意事项

uni-app 在发布到H5时支持所有vue的语法;发布到App和小程序时,由于平台限制,无法实现全部vue语法,但uni-app仍是是对vue语法支持度最高的跨端框架。本文将详细讲解差异。

相比Web平台, Vue.js uni-app 中使用差异主要集中在两个方面:

n  新增:uni-app除了支持Vue实例的生命周期,还支持应用启动、页面显示等生命周期

n  受限:相比web平台,在小程序和App端部分功能受限,具体见下。

生命周期

uni-app 完整支持 Vue 实例的生命周期,同时还新增 应用生命周期 页面生命周期。

模板语法

uni-app 完整支持 Vue 模板语法。

注意:如果使用老版的非自定义组件模式,即manifest"usingComponents":false,部分模版语法不支持,但此模式已不再推荐使用,详见https://ask.dcloud.net.cn/article/35699

老版非自定义组件模式不支持情况(新版自定义组件模式已不存在此情况):

n  不支持部分复杂的 JavaScript 渲染表达式

n  不支持过滤器

data 属性

data 必须声明为返回一个初始数据对象的函数;否则页面关闭时,数据不会自动销毁,再次打开该页面时,会显示上次数据。

//正确用法,使用函数返回对象

data() {

    return {

        title: 'Hello'

    }

}

 

//错误写法,会导致再次打开页面时,显示上次数据

data: {

    title: 'Hello'

}   

全局变量

实现全局变量的方式需要遵循 Vue 单文件模式的开发规范。详细参考:uni-app全局变量的几种实现方式(https://ask.dcloud.net.cn/article/35021

Class 与 Style 绑定

为节约性能,我们将 Class Style 的表达式通过 compiler 硬编码到 uni-app 中,支持语法和转换效果如下:

class 支持的语法:

<view :class="{ active: isActive }">111</view>

<view v-bind:class="{ active: isActive, 'text-danger': hasError }">222</view>

<view :class="[activeClass, errorClass]">333</view>

<view v-bind:class="[isActive ? activeClass : '', errorClass]">444</view>

<view v-bind:class="[{ active: isActive }, errorClass]">555</view>

style 支持的语法:

<view v-bind:style="{ color: activeColor, fontSize: fontSize + 'px' }">666</view>

<view v-bind:style="[{ color: activeColor, fontSize: fontSize + 'px' }]">777</view>

H5端不支持 Vue官方文档小白教程网Class Style 绑定 中的 classObject styleObject 语法。

不支持示例

小白教程网www.2d5.net

<template>

    <view :class="[activeClass]" :style="[baseStyles,overridingStyles]"></view>

</template>

 

<script>

    export default {

        data() {

            return {

                activeClass: {

                    'active': true,

                    'text-danger': false

                },

                baseStyles: {

                    color: 'green',

                    fontSize: '30px'

                },

                overridingStyles: {

                    'font-weight': 'bold'

                }

            }

        }

    }

</script>

注意:以:style=""这样的方式设置px像素值,其值为实际像素,不会被编译器转换。

此外还可以用 computed 方法生成 class 或者 style 字符串,插入到页面中,举例说明:

<template>

    <!-- 支持 -->

    <view :class="computedClassStr"></view>

    <view :class="{active: isActive}"></view>

 

    <!-- 不支持 -->

    <view :class="computedClassObject"></view>

</template>

<script>

    export default {

        data () {

            return {

                isActive: true

            }

        },

        computed: {

            computedClassStr () {

                return this.isActive ? 'active' : ''

            },

            computedClassObject () {

                return { active: this.isActive }

            }

        }

    }

</script>

用在组件上

H5端暂不支持在自定义组件上使用 Class Style 绑定

计算属性

完整支持 Vue官方文档小白教程网:计算属性。

条件渲染

完整支持 Vue官方文档小白教程网:条件渲染

列表渲染

完整vue列表渲染 Vue官方文档小白教程网:列表渲染

key

如果列表中项目的位置会动态改变或者有新的项目添加到列表中,并且希望列表中的项目保持自己的特征和状态(如 <input> 中的输入内容,<switch> 的选中状态),需要使用 :key 来指定列表中项目的唯一的标识符。

:key 的值以两种形式提供

n  使用 v-for 循环 array item 的某个 property,该 property 的值需要是列表中唯一的字符串或数字,且不能动态改变。

n  使用 v-for 循环中 item 本身,这时需要 item 本身是一个唯一的字符串或者数字

当数据改变触发渲染层重新渲染的时候,会校正带有 key 的组件,框架会确保他们被重新排序,而不是重新创建,以确保使组件保持自身的状态,并且提高列表渲染时的效率。

如不提供 :key,会报一个 warning 如果明确知道该列表是静态,或者不必关注其顺序,可以选择忽略。

示例

小白教程网www.2d5.net

<template>

    <view>

        <!-- array item 的某个 property -->

        <view v-for="(item,index) in objectArray" :key="item.id">

            {{index +':'+ item.name}}

        </view>

        <!-- item 本身是一个唯一的字符串或者数字时,可以使用 item 本身 -->

        <view v-for="(item,index) in stringArray" :key="item">

            {{index +':'+ item}}

        </view>

    </view>

</template>

<script>

export default {

  data () {

    return {

      objectArray:[{

          id:0,

          name:'li ming'

      },{

          id:1,

          name:'wang peng'

      }],

      stringArray:['a','b','c']

    }

  }

}

</script>

注意事项

n  H5平台 使用 v-for 循环整数时和其他平台存在差异,如 v-for="(item, index) in 10" 中,在H5平台 item 1 开始,其他平台 item 0 开始,可使用第二个参数 index 来保持一致。

n  在非H5平台 循环对象时不支持第三个参数,如 v-for="(value, name, index) in object" 中,index 参数是不支持的。

事件处理器

几乎全支持 Vue官方文档小白教程网:事件处理器

// 事件映射表,左侧为 WEB 事件,右侧为 ``uni-app`` 对应事件

{

    click: 'tap',

    touchstart: 'touchstart',

    touchmove: 'touchmove',

    touchcancel: 'touchcancel',

    touchend: 'touchend',

    tap: 'tap',

    longtap: 'longtap',

    input: 'input',

    change: 'change',

    submit: 'submit',

    blur: 'blur',

    focus: 'focus',

    reset: 'reset',

    confirm: 'confirm',

    columnchange: 'columnchange',

    linechange: 'linechange',

    error: 'error',

    scrolltoupper: 'scrolltoupper',

    scrolltolower: 'scrolltolower',

    scroll: 'scroll'

}

注意:

n  为兼容各端,事件需使用 v-on @ 的方式绑定,请勿使用小程序端的bind catch 进行事件绑定。

n  事件修饰符

l  .stop:各平台均支持, 使用时会阻止事件冒泡,在非 H5 端同时也会阻止事件的默认行为

l  .prevent 仅在 H5 平台支持

l  .self:仅在 H5 平台支持

l  .once:仅在 H5 平台支持

l  .capture:仅在 H5 平台支持

l  .passive:仅在 H5 平台支持

n  若需要禁止蒙版下的页面滚动,可使用 @touchmove.stop.prevent="moveHandle"moveHandle 可以用来处理 touchmove 的事件,也可以是一个空函数。

<view @touchmove.stop.prevent="moveHandle"></view>

n  按键修饰符:uni-app运行在手机端,没有键盘事件,所以不支持按键修饰符。

表单控件绑定

支持 Vue官方文档小白教程网:表单控件绑定。

建议开发过程中直接使用 uni-app:表单组件。用法示例

小白教程网www.2d5.net

H5 select 标签用 picker 组件进行代替

<template>

  <view>

    <picker @change="bindPickerChange" :value="index" :range="array">

      <view>

        当前选择:{{array[index]}}

      </view>

    </picker>

  </view>

</template>

 

<script>

export default {

  data () {

    return {

      index: 0,

      array: ['A', 'B', 'C']

    }

  },

  methods: {

    bindPickerChange (e) {

      console.log(e)

    }

  }

}

 

</script>

表单元素 radio radio-group 组件进行代替

<template>

  <view>

    <radio-group @change="radioChange">

      <label v-for="(item, index) in items" :key="item.name">

        <radio :value="item.name" :checked="item.checked"/> {{item.value}}

      </label>

    </radio-group>

  </view>

</template>

 

<script>

export default {

  data () {

    return {

      items: [

        {name: 'USA', value: '美国'},

        {name: 'CHN', value: '中国', checked: 'true'},

        {name: 'BRA', value: '巴西'},

        {name: 'JPN', value: '日本'},

        {name: 'ENG', value: '英国'},

        {name: 'TUR', value: '法国'}

      ]

    }

  },

  methods: {

    radioChange (e) {

      console.log('radio发生change事件,携带value值为:', e.target.value)

    }

  }

}

 

</script>

v-html指令

由于非H5端,不支持dom和普通html元素,所以自然非H5端也不支持v-html

跨端的富文本处理方案详见:https://ask.dcloud.net.cn/article/35772

组件

Vue 组件

组件是 vue 技术中非常重要的部分,组件使得与ui相关的轮子可以方便的制造和共享,进而使得vue使用者的开发效率大幅提升。

uni-app搭建了组件的插件市场,可大幅提升开发者的效率。https://ext.dcloud.net.cn/

在项目的/component目录下存放组件,在要显示组件的页面中则分为3步:导入、注册和使用。

可以这个评分组件的使用为例,了解vue组件的使用方式。

<template>

    <view>

        <uni-rate value="2"></uni-rate> <!-- 第三步,使用组件。并传值点亮2颗星 -->

    </view>

</template>

<script>

import uniRate from "@/components/uni-rate/uni-rate.vue" //第一步,导入组件

export default {

    components: {

        uniRate //第二步,注册组件

    }

}

</script>

uni-app只支持vue单文件组件(.vue 组件)。其他的诸如:动态组件,自定义 render,和<script type="text/x-template"> 字符串模版等,在非H5端不支持。

详细的非H5端不支持列表:

n  Slotscoped 暂时还没做支持)

n  动态组件

n  异步组件

n  inline-template

n  X-Templates

n  keep-alive

n  transition (可使用 animation CSS 动画替代)

n  老的非自定义组件编译模式不支持在组件引用时,在组件上定义 click 等原生事件、v-show(可用 v-if 代替)和 class style 等样式属性(例:<card> </card> 样式是不会生效的)。建议更新为自定义组件模式

n  老的非自定义组件编译模式组件里使用 slot 嵌套的其他组件时不支持 v-for。建议更新为自定义组件模式

uni-app内置基础组件

uni-app 内置了小程序的所有组件,比如: picker,map 等,需要注意的是原生组件上的事件绑定,需要以 vue 的事件绑定语法来绑定,如 bindchange="eventName" 事件,需要写成 @change="eventName"

示例

小白教程网www.2d5.net

<picker mode="date" :value="date" start="2015-09-01" end="2017-09-01" @change="bindDateChange">

    <view>

      当前选择: {{date}}

    </view>

</picker>

全局组件

uni-app 支持配置全局组件,需在 main.js 里进行全局注册,注册后就可在所有页面里使用该组件。

注意

l  Vue.component 的第一个参数必须是静态的字符串。

l  nvue页面暂不支持全局组件

示例

小白教程网www.2d5.net

main.js 里进行全局导入和注册

import Vue from 'vue'

import pageHead from './components/page-head.vue'

Vue.component('page-head',pageHead)

index.vue 里可直接使用组件

<template>

  <view>

    <page-head></page-head>

    </view>

</template>

命名限制

uni-app 中以下这些作为保留关键字,不可作为组件名。

l  a

l  canvas

l  cell

l  content

l  countdown

l  datepicker

l  div

l  element

l  embed

l  header

l  image

l  img

l  indicator

l  input

l  link

l  list

l  loading-indicator

l  loading

l  marquee

l  meta

l  refresh

l  richtext

l  script

l  scrollable

l  scroller

l  select

l  slider-neighbor

l  slider

l  slot

l  span

l  spinner

l  style

l  svg

l  switch

l  tabbar

l  tabheader

l  template

l  text

l  textarea

l  timepicker

l  transition-group

l  transition

l  video

l  view

l  web

注意

l  除以上列表中的名称外,标准的 HTML SVG 标签名也不能作为组件名。

l  在百度小程序中使用时,不要在 data 内使用 hidden ,可能会导致渲染错误

常见问题

1. 如何获取上个页面传递的数据

onLoad 里得到,onLoad 的参数是其他页面打开当前页面所传递的数据。

2. 如何设置全局的数据和全局的方法

uni-app 内置了 vuex ,在app里的使用,可参考hello-uniapp store/index.js

//store.js

import Vue from 'vue'

import Vuex from 'vuex'

Vue.use(Vuex)

const store = new Vuex.Store({

    state: {...},

    mutations: {...},

    actions: {...}

})

 

export default store

 

//main.js

...

import store from './store'

Vue.prototype.$store = store

const app = new Vue({

    store,...

})

...

 

//test.vue 使用时:

import {mapState,mapMutations} from 'vuex'

3. 如何捕获 app onError

由于 onError 并不是完整意义的生命周期,所以只提供一个捕获错误的方法,在 app 的根组件上添加名为 onError 的回调函数即可。如下:

export default {

   // 只有 app 才会有 onLaunch 的生命周期

   onLaunch () {

       // ...

   },

 

   // 捕获 app error

   onError (err) {

       console.log(err)

   }

}

4. 组件属性设置不生效解决办法

当重复设置某些属性为相同的值时,不会同步到view层。 例如:每次将scroll-view组件的scroll-top属性值设置为0,只有第一次能顺利返回顶部。 这和props的单向数据流特性有关,组件内部scroll-top的实际值改动后,其绑定的属性并不会一同变化。

解决办法有两种(以scroll-view组件为例):

l  监听scroll事件,记录组件内部变化的值,在设置新值之前先设置为记录的当前值

<scroll-view :scroll-top="scrollTop" scroll-y="true" @scroll="scroll">

export default {

    data() {

        return {

            scrollTop: 0,

            old: {

                scrollTop: 0

            }

        }

    },

    methods: {

        scroll: function(e) {

            this.old.scrollTop = e.detail.scrollTop

        },

        goTop: function(e) {

            this.scrollTop = this.old.scrollTop

            this.$nextTick(function() {

                this.scrollTop = 0

            });

        }

    }

}

监听scroll事件,获取组件内部变化的值,实时更新其绑定值

<scroll-view :scroll-top="scrollTop" scroll-y="true" @scroll="scroll">

 

export default {

    data() {

        return {

            scrollTop: 0,

        }

    },

    methods: {

        scroll: function(e) {

            this.scrollTop = e.detail.scrollTop

        },

        goTop: function(e) {

            this.scrollTop = 0

        }

    }

}

第二种解决方式在某些组件可能造成抖动,推荐第一种解决方式。

【uniapp参考资料】

(1)uni-app跨平台开发 入门到实战 

https://ke.qq.com/course/package/26512


(2)uni-app 完整商城界面设计实战  

https://ke.qq.com/course/2381059


(3)基于vue的uniapp商城完整项目源代码 

https://ke.qq.com/course/3064977


(4)毕业设计网

http://www.pc-365.net


(5)小程序编程网

http://www.4317.org


(6)计算机编程网

http://www.05423.com


上一篇: 1.5.3 css引入静态资源 下一篇: 2.1.1 应用生命周期
计算机毕业设计作品网      毕业设计文档网      小程序教程网       毕业设计资料网  |         毕业设计定制QQ:45157718(微信同号)(备注:毕设)