站长资讯网
最全最丰富的资讯网站

vue有什么常用api

vue的api有:1、nextTick;2、mixin;3、“$forceUpdate”;4、set和delete;5、filter;6、directive;7、“$root”;8、“$el”;9、“$data”;10、“$props”等。

vue有什么常用api

本教程操作环境:windows7系统、vue2.9.6版,DELL G3电脑。

nextTick


功能: 添加在下次Dom更新循环结束之后的延迟回调,修改数据之后,可以获取更新后的Dom。
用法:

Vue.nextTick( [callback, context] ) vm.$nextTick( [callback] ) // 用法2 // 作为一个 Promise 使用 (2.1.0 起新增) Vue.nextTick()   .then(function () {     // DOM 更新了   })

说明:

  • callback:延迟回调函数
  • context:可选的object

ps:2.1.0 起新增:如果没有提供回调且在支持 Promise 的环境中,则返回一个 Promise。请注意 Vue 不自带 Promise 的 polyfill,所以如果你的目标浏览器不原生支持 Promise (IE:你们都看我干嘛),你得自己提供 polyfill。

扩展: 关于nextTick的执行机制和使用场景,我们还必须掌握类似的requestAnimationFrame() 和 process.nextTick(), 前者是浏览器自带的监听(在下次重绘之前执行),后者是node环境下,在下一个事件轮询的时间点上执行。

mixin


功能: 注册一个混入,影响注册之后所有创建的每个 Vue 实例。插件作者可以使用混入,向组件注入自定义的行为。
用法:

// 为自定义的选项 'myOption' 注入一个处理器。 Vue.mixin({   created: function () {     var myOption = this.$options.myOption     if (myOption) {       console.log(myOption)     }   } })  new Vue({   myOption: 'hello!' }) // => "hello!"

说明:

  • object:一个vm的属性或方法

ps:请谨慎使用全局混入,因为它会影响每个单独创建的 Vue 实例 (包括第三方组件)。大多数情况下,只应当应用于自定义选项,就像上面示例一样。推荐将其作为插件发布,以避免重复应用混入。

$forceUpdate


功能: 迫使 Vue 实例重新渲染。
用法:

vm.$forceUpdate()

说明: 注意它仅仅影响实例本身和插入插槽内容的子组件,而不是所有子组件。

set、delete


功能: 对响应式数据的属性进行设置、删除,同时触发视图更新。
用法:

// 用法1 Vue.set( target, key, value ) Vue.delete( target, key ) // 用法2 vm.$set( target, key, value ) vm.$delete( target, key )

说明:

  • target:目标对象
  • key:要添加的属性名
  • value:要添加的属性值

ps:主要使用场景,可以避开 Vue 不能检测到 property 被删除的限制

filter


功能: 用于一些常见的文本格式化和一些规范数据mapping。
用法:

<!-- 在双花括号中 --> {{ message | capitalize }}  <!-- 在 `v-bind` 中 --> <div v-bind:id="rawId | formatId"></div>
// 注册 filters: {   capitalize: function (value) {     if (!value) return ''     value = value.toString()     return value.charAt(0).toUpperCase() + value.slice(1)   } }
// 全局注册 Vue.filter('capitalize', function (value) {   if (!value) return ''   value = value.toString()   return value.charAt(0).toUpperCase() + value.slice(1) })  new Vue({   // ... })

说明:

  • 过滤器函数总接收表达式的值 (之前的操作链的结果) 作为第一个参数。
  • 过滤器应该被添加在 JavaScript 表达式的尾部,由“管道”符号指示。

ps:过滤器可以接受多个参数,如{{ message | filterA('arg1', arg2) }},这里,filterA 被定义为接收三个参数的过滤器函数。其中 message 的值作为第一个参数,普通字符串 'arg1' 作为第二个参数,表达式 arg2 的值作为第三个参数。

directive


功能: 用于注册自定义指令。
用法:

<!-- 当页面加载时,该元素将获得焦点 -->  <input v-focus>
// 注册一个全局自定义指令 `v-focus` Vue.directive('focus', {   // 当被绑定的元素插入到 DOM 中时……   inserted: function (el) {     // 聚焦元素     el.focus()   } })
// 注册局部指令,组件中也接受一个 directives 的选项 directives: {   focus: {     // 指令的定义     inserted: function (el) {       el.focus()     }   } }

说明:

  • inserted 只是注册指令的其中一个插值函数,完整的注册属性还可以包括:
    • bind:只调用一次,指令第一次绑定到元素时调用,在这里可以进行一次性的初始化设置。
    • inserted:被绑定元素插入父节点时调用(仅保证父节点存在,但不一定已被插入文档中)。
    • update:所在组件的 VNode 更新时调用,但是可能发生在其子 VNode 更新之前。指令的值可能发生了改变,也可能没有,但是可以通过比较更新前后的值来忽略不必要的模板更新。
    • componentUpdated:指令所在组件的 VNode 及其子 VNode 全部更新后调用。
    • unbind:只调用一次,指令与元素解绑时调用。
Vue.directive('my-directive', {   bind: function () {},   inserted: function () {},   update: function () {},   componentUpdated: function () {},   unbind: function () {} })

v-model 语法糖

v-model 常用于表单元素上进行数据的双向绑定,比如 <input>。除了原生的元素,它还能在自定义组件中使用。

v-model 是一个语法糖,可以拆解为 props: value 和 events: input。就是说组件必须提供一个名为 value 的 prop,以及名为 input 的自定义事件,满足这两个条件,使用者就能在自定义组件上使用 v-model。比如下面的示例,实现了一个数字选择器:

<template>   <div>     <button @click="increase(-1)">减 1</button>     <span >{{ currentValue }}</span>     <button @click="increase(1)">加 1</button>   </div> </template> <script>   export default {     name: 'InputNumber',     props: {       value: {         type: Number       }     },     data () {       return {         currentValue: this.value       }     },     watch: {       value (val) {         this.currentValue = val;       }     },     methods: {       increase (val) {         this.currentValue += val;         this.$emit('input', this.currentValue);       }     }   } </script>

props 一般不能在组件内修改,它是通过父级修改的,因此实现 v-model 一般都会有一个 currentValue 的内部 data,初始时从 value 获取一次值,当 value 修改时,也通过 watch 监听到及时更新;组件不会修改 value 的值,而是修改 currentValue,同时将修改的值通过自定义事件 input 派发给父组件,父组件接收到后,由父组件修改 value。所以,上面的数字选择器组件可以有下面两种使用方式:

<template>   <InputNumber v-model="value" /> </template> <script>   import InputNumber from '../components/input-number/input-number.vue';    export default {     components: { InputNumber },     data () {       return {         value: 1       }     }   } </script>

或:

<template>   <InputNumber :value="value" @input="handleChange" /> </template> <script>   import InputNumber from '../components/input-number/input-number.vue';    export default {     components: { InputNumber },     data () {       return {         value: 1       }     },     methods: {       handleChange (val) {         this.value = val;       }     }   } </script>

如果你不想用 value 和 input 这两个名字,从 Vue.js 2.2.0 版本开始,提供了一个 model 的选项,可以指定它们的名字,所以数字选择器组件也可以这样写:

<template>   <div>     <button @click="increase(-1)">减 1</button>     <span >{{ currentValue }}</span>     <button @click="increase(1)">加 1</button>   </div> </template> <script>   export default {     name: 'InputNumber',     props: {       number: {         type: Number       }     },     model: {       prop: 'number',       event: 'change'     },     data () {       return {         currentValue: this.number       }     },     watch: {       value (val) {         this.currentValue = val;       }     },     methods: {       increase (val) {         this.currentValue += val;         this.$emit('number', this.currentValue);       }     }   } </script>

在 model 选项里,就可以指定 prop 和 event 的名字了,而不一定非要用 value 和 input,因为这两个名字在一些原生表单元素里,有其它用处。

.sync 修饰符

如果你使用过 Vue.js 1.x,一定对 .sync 不陌生。在 1.x 里,可以使用 .sync 双向绑定数据,也就是父组件或子组件都能修改这个数据,是双向响应的。在 Vue.js 2.x 里废弃了这种用法,目的是尽可能将父子组件解耦,避免子组件无意中修改了父组件的状态。

不过在 Vue.js 2.3.0 版本,又增加了 .sync 修饰符,但它的用法与 1.x 的不完全相同。2.x 的 .sync 不是真正的双向绑定,而是一个语法糖,修改数据还是在父组件完成的,并非在子组件。

仍然是数字选择器的示例,这次不用 v-model,而是用 .sync,可以这样改写:

<template>   <div>     <button @click="increase(-1)">减 1</button>     <span >{{ value }}</span>     <button @click="increase(1)">加 1</button>   </div> </template> <script>   export default {     name: 'InputNumber',     props: {       value: {         type: Number       }     },     methods: {       increase (val) {         this.$emit('update:value', this.value + val);       }     }   } </script>

用例:

<template>   <InputNumber :value.sync="value" /> </template> <script>   import InputNumber from '../components/input-number/input-number.vue';    export default {     components: { InputNumber },     data () {       return {         value: 1       }     }   } </script>

看起来要比 v-model 的实现简单多,实现的效果是一样的。v-model 在一个组件中只能有一个,但 .sync 可以设置很多个。.sync 虽好,但也有限制,比如:

  • 不能和表达式一起使用(如 v-bind:title.sync="doc.title + '!'" 是无效的);

  • 不能用在字面量对象上(如 v-bind.sync="{ title: doc.title }" 是无法正常工作的)。

其它简单的常用属性和方法

// console.log(vm.$root);  vm.$root    //实例对象  vm.$el  //根元素(真实的DOM元素) // console.log(vm.$el);  vm.$el.innerHTML    //得到根元素(真实的DOM元素)中的内容 // console.log(vm.$el.innerHTML);  vm.$data    //实例下的data对象 // console.log(vm.$data);  vm.$options     //实例下的挂载项 // console.log(vm.$options);  vm.$props   //组件之间通信的数据 // console.log(vm.$props);  vm.$parent      //在组件中,指父元素 // console.log(vm.$parent);  vm.$children    //在组件中,指子代元素 // console.log(vm.$children);  vm.$attrs   //用来获取父组件传递过来的所有属性 // console.log(vm.$attrs);  vm.$listeners   //用来获取父组件传递过来的所有方法 // console.log(vm.$listeners);  vm.$slots   //组件中的插槽 // console.log(vm.$slots);  vm.$scopedSlots     //用来访问作用域插槽 // console.log(vm.$scopedSlots);  vm.$refs    //用来定位DOM元素(使用ref进行追踪) // console.log(vm.$refs);  vm.$watch   //用于监听数据(在vue文件中使用后会自动销毁) // console.log(vm.$watch);  vm.$emit    //用于派发事件(常用于数据通信) // console.log(vm.$emit);  vm.$on  //用于监听事件的派发 // console.log(vm.$on);  vm.$once    //只监听事件一次(之后不监听) // console.log(vm.$once);  //生命周期 beforeCreate() { } created() { } beforeMount() { } mounted() { } beforeUpdate() { } updated() { } beforeDestroy() { } destroyed() { }

(学习视频分享:vuejs教程、web前端)

赞(0)
分享到: 更多 (0)