Vue指令大全

1. v-text

v-text主要用來更新textContent，可以等同于JS的text屬性。

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

這兩者等價：

<span>{{msg}}</span>

2. v-html

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

<div v-html="rawHtml"></div>

這個div的内容将會替換成屬性值rawHtml，直接作為HTML進行渲染。

3. v-pre

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

<div id="app">

    <span v-pre>{{message}}</span>  //這條語句不進行編譯

    <span>{{message}}</span>

</div>

最終僅顯示第二個span的内容

4. 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>

5. 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即使産生改變，也不會重新渲染。

6. v-if

v-if可以實作條件渲染，Vue會根據表達式的值的真假條件來渲染元素。

<a v-if="ok">yes</a>

如果屬性值ok為true，則顯示。否則，不會渲染這個元素。

7. v-else

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

<a v-if="ok">yes</a>

<a v-else>No</a>

8. 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>

9. v-show

<h1 v-show="ok">hello world</h1>

也是用于根據條件展示元素。和v-if不同的是，如果v-if的值是false，則這個元素被銷毀，不在dom中。但是v-show的元素會始終被渲染并儲存在dom中，它隻是簡單的切換css的dispaly屬性。

注意：v-if有更高的切換開銷

v-show有更高的初始渲染開銷。

是以，如果要非常頻繁的切換，則使用v-show較好；如果在運作時條件不太可能改變，則v-if較好

10. v-for

用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 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>

注意：當v-for和v-if同處于一個節點時，v-for的優先級比v-if更高。這意味着v-if将運作在每個v-for循環中

11. v-bind

v-bind用來動态的綁定一個或者多個特性。沒有參數時，可以綁定到一個包含鍵值對的對象。常用于動态綁定class和style。以及href等。

簡寫為一個冒号【 ：】

<1>對象文法：

//進行類切換的例子

<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>

<2>數組文法

<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>

<3>直接綁定資料對象

<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>

12. v-model

這個指令用于在表單上建立雙向資料綁定。

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修飾符

<1> .lazy

預設情況下，v-model同步輸入框的值和資料。可以通過這個修飾符，轉變為在change事件再同步。

<input v-model.lazy="msg">

<2> .number

自動将使用者的輸入值轉化為數值類型

<input v-model.number="msg">

<3> .trim

自動過濾使用者輸入的首尾空格

<input v-model.trim="msg">

13. 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 是目前元素自身時觸發處理函數

.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 隻會阻止對元素自身的點選。