Vue 指令總結

YXi發表於2019-07-25

{{ }} :插值表示式 寫的時候最好加兩個空格: {{ msg }}

v-text

直接把資料渲染出來,有Html標籤也不會解析

<h1 v-text="msg"></h1>

msg:"Hello"
複製程式碼

v-html

雙大括號的方式會將資料解釋為純文字,而非HTML。為了輸出真正的HTML,可以用v-html指令。它等同於JS的innerHtml屬性。

<div v-html="name"></div>
複製程式碼

這個div的內容將會替換成屬性值name,直接作為HTML進行渲染

能不使用就不使用,因為有可能會造成XSS攻擊

v-if

可以實現條件渲染,Vue會根據表示式的值的真假條件來渲染元素
<a v-if="2>1">yes</a>
0,-0,""會自動轉化成false 1會轉成true 也可以放表示式
如果為 true 則顯示,否則不顯示

v-else

搭配v-if使用的,它必須緊跟在v-if或者v-else-if後面,否則不起作用

<p v-if="score>=60">及格</p>
<p v-else>不及格</p>
複製程式碼

v-else-if

v-else-if充當v-if的else-if塊,可以鏈式的使用多次。可以更加方便的實現switch語句

<div v-if="type==='A'">
    A
</div>
<div v-if="type==='B'">
    B
</div>
<div v-if="type==='C'">
    C
</div>
<div v-else>
    Not A,B,C
</div>
複製程式碼

v-show

也是用於根據條件展示元素。和v-if不同的是,如果v-if的值是false,則這個元素被銷燬,不在dom中。但是v-show的元素會始終被渲染並儲存在dom中,它只是簡單的切換css的dispaly屬性。如:display:none;(不顯示) display:block;(顯示)
不支援 template 標籤

<a v-show="true">yes</a>

注:v-if有更高的切換開銷,v-show有更高的初始渲染開銷。因此,如果要非常頻繁的切換,則使用v-show較好;如果在執行時條件不太可能改變,則v-if較好

v-pre

主要用來跳過這個元素和它的子元素編譯過程。可以用來顯示原始的Mustache標籤。跳過大量沒有指令的節點加快編譯

<div id="app">
    <span v-pre>{{message}}</span>  //這條語句不進行編譯
    <span>{{message}}</span>
</div>	
複製程式碼

所以僅僅顯示第二個span裡的內容

v-el

可以使用v-el指令,去給這個元素註冊一個索引,方便通過所屬例項的$el訪問這個元素。

<span v-el:msg>hello</span>
<span v-el:other-msg>world</span>
this.$els.msg.textContent //-> "hello"
this.$els.otherMsg.textContent// -> "world"
this.$els.msg//-><span>hello</span>
複製程式碼

注:HTML不區分大小寫,所以v-el:someEl將轉換為全小寫。可以用v-el:some-el然後設定this.$el.someEl。

v-cloak

用來保持在元素上直到關聯例項結束時進行編譯

<div id="app" v-cloak>
    <div>
        {{message}}
    </div>
</div>
<script type="text/javascript">
    new Vue({
      el:'#app',
      data:{
        message:'hello world'
      }
    })
</script>
複製程式碼

在頁面載入時會閃爍,先顯示

<div>
    {{message}}
</div>
複製程式碼

然後才會編譯為:

<div>
    hello world!
</div>
複製程式碼

v-once

v-once關聯的例項,只會渲染一次。之後的重新渲染,例項極其所有的子節點將被視為靜態內容跳過,這可以用於優化更新效能。

<span v-once>This will never change:{{msg}}</span>  //單個元素
<div v-once>//有子元素
    <h1>comment</h1>
    <p>{{msg}}</p>
</div>
<my-component v-once:comment="msg"></my-component>  //元件
<ul>
    <li v-for="i in list">{{i}}</li>
</ul>
複製程式碼

上面的例子中,msg,list即使產生改變,也不會重新渲染。

v-for

根據遍歷陣列來進行渲染
有下面兩種遍歷形式

<div v-for="(item,index) in items"></div>   //使用in,index是一個可選引數,表示當前項的索引
<div v-for="item of items"></div>   //使用of
複製程式碼

下面是一個例子,並且在v-for中,擁有對父作用域屬性的完全訪問許可權

<ul id="app">
    <li v-for="(item,index) in items">
        {{parent}}-{{item.text}}
    </li>
</ul>
<script type="text/javascript">
    var example = new Vue({
      el:'#app',
      data:{
        parent:'父作用域'
        items:[
          {text:'文字1'},
          {text:'文字2'}
        ]
      }
    })
</script>
複製程式碼

會被渲染為:

<ul id="app">
    <li>父作用域-文字1</li>
    <li>父作用域-文字2</li>
</ul>
複製程式碼

支援 template 標籤

vue 2.5 以上要求 必須在迴圈時 使用key屬性,key需要是唯一的,key的作用就是用來區分元素,但是 template 標籤上不能使用 key 屬性

為什麼使用key?
有利於DOM的diff演算法,但是儘量不要使用index來作為key,因為有可能會出現bug,而且更新DOM的時候有可能會出現效能問題。
key 的作用主要是為了高效的更新虛擬DOM。

注:當v-for和v-if同處於一個節點時,v-for的優先順序比v-if更高。這意味著v-if將執行在每個v-for迴圈中

單標籤上不能使用v-for,這時候需要在這個單標籤外面再加上一個標籤,迴圈加上的這個標籤才可以,一般都是加 template 這個標籤

v-bind

用來動態的繫結一個或者多個特性,主要用於屬性繫結。沒有引數時,可以繫結到一個包含鍵值對的物件。常用於動態繫結class和style。以及href等

單向繫結:資料變化,檢視更新, 常用於在 data 中宣告一個值,然後用來繫結到標籤中

簡寫為一個冒號【 :】

  • 物件語法
//進行類切換的例子
<div id="app">
    <!--當data裡面定義的isActive等於true時,is-active這個類才會被新增起作用-->
    <!--當data裡面定義的hasError等於true時,text-danger這個類才會被新增起作用-->
    <div :class="{'is-active':isActive, 'text-danger':hasError}"></div>
</div>
<script>
    var app = new Vue({
        el: '#app',
        data: {
            isActive: true,  
            hasError: false
        }
    })
</script>
複製程式碼

渲染結果:

<!--因為hasError: false,所以text-danger不被渲染-->
<div class = "is-active"></div>
複製程式碼
  • 陣列語法:
<div id="app">
    <!--陣列語法:errorClass在data對應的類一定會新增-->
    <!--is-active是物件語法,根據activeClass對應的取值決定是否新增-->
    <p :class="[{'is-active':activeClass},errorClass]">12345</p>
</div>
<script>
    var app = new Vue({
        el: '#app',
        data: {
            activeClass: false,
            errorClass: 'text-danger'
        }
    })
</script>
複製程式碼

渲染結果:

<!--因為activeClass: false,所以is-active不被渲染-->
<p class = "text-danger"></p>
複製程式碼
  • 直接繫結資料物件:
<div id="app">
    <!--在vue例項的data中定義了classObject物件,這個物件裡面是所有類名及其真值-->
    <!--當裡面的類的值是true時會被渲染-->
    <div :class="classObject">12345</div>
</div>
<script>
    var app = new Vue({
        el: '#app',
        data: {
            classObject:{
                'is-active': false,
                'text-danger':true
            }           
        }
    })
</script>
複製程式碼

渲染結果:

<!--因為'is-active': false,所以is-active不被渲染-->
<div class = "text-danger"></div>
複製程式碼

v-model

用於在表單上建立雙向資料繫結

雙向繫結:資料變化,檢視更新,檢視變化,資料更新, 常作用於表單元素(在對錶單進行繫結時,value不能省)

v-model會忽略所有表單元素的value、checked、selected特性的初始值。因為它選擇Vue例項資料做為具體的值

<div id="app">
    <input v-model="somebody">
    <p>hello {{somebody}}</p>
</div>
<script>
    var app = new Vue({
        el: '#app',
        data: {
            somebody:'小明'
        }
    })
</script>
複製程式碼

這個例子中直接在瀏覽器input中輸入別的名字,下面的p的內容會直接跟著變。這就是雙向資料繫結

v-model僅僅是語法糖,v-model = :value + @input (input事件:當輸入框中的資料改變時觸發)

v-model 修飾符

1.lazy
預設情況下,v-model同步輸入框的值和資料。可以通過這個修飾符,轉變為在change事件再同步
<input v-model.lazy="msg">

2.number
自動將使用者的輸入值轉化為數值型別
<input v-model.number="msg">

3.trim
自動過濾使用者輸入的首尾空格
<input v-model.trim="msg">

v-on

v-on主要用來監聽dom事件,以便執行一些程式碼塊。表示式可以是一個方法名
簡寫為:【 @ 】

<div id="app">
    <button @click="consoleLog"></button>
</div>
<script>
    var app = new Vue({
        el: '#app',
        methods:{
            consoleLog:function (event) {
                console.log(1)
            }
        }
    })
</script>
複製程式碼

事件修飾符

  • .stop 阻止事件繼續傳播
  • .prevent 事件不再過載頁面
  • .capture 使用事件捕獲模式,即元素自身觸發的事件先在此處處理,然後才交由內部元素進行處理
  • .self 只當在 event.target 是當前元素自身時觸發處理函式 (例如把self放到了父元素上面,點選子元素,父元素的事件不被觸發)
  • .once 事件將只會觸發一次
  • .passive 告訴瀏覽器你不想阻止事件的預設行為
<!-- 阻止單擊事件繼續傳播 -->
<a v-on:click.stop="doThis"></a>

<!-- 提交事件不再過載頁面 -->
<form v-on:submit.prevent="onSubmit"></form>

<!-- 修飾符可以串聯 -->
<a v-on:click.stop.prevent="doThat"></a>

<!-- 只有修飾符 -->
<form v-on:submit.prevent></form>

<!-- 新增事件監聽器時使用事件捕獲模式 -->
<!-- 即元素自身觸發的事件先在此處處理,然後才交由內部元素進行處理 -->
<div v-on:click.capture="doThis">...</div>

<!-- 只當在 event.target 是當前元素自身時觸發處理函式 -->
<!-- 即事件不是從內部元素觸發的 -->
<div v-on:click.self="doThat">...</div>

<!-- 點選事件將只會觸發一次 -->
<a v-on:click.once="doThis"></a>

<!-- 滾動事件的預設行為 (即滾動行為) 將會立即觸發 -->
<!-- 而不會等待 `onScroll` 完成  -->
<!-- 這其中包含 `event.preventDefault()` 的情況 -->
<div v-on:scroll.passive="onScroll">...</div>
複製程式碼

注:使用修飾符時,順序很重要;相應的程式碼會以同樣的順序產生。因此,用v-on:click.prevent.self會阻止所有的點選,而 v-on:click.self.prevent只會阻止對元素自身的點選。而且修飾符也可以一次使用多個(也就是上面所說的串聯)


^_<