vue有什麼常用api

2022-03-07 16:00:43

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

本教學操作環境: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() {
}

(學習視訊分享:、)

以上就是vue有什麼常用api的詳細內容,更多請關注TW511.COM其它相關文章!