Vue躬行記(4)——組件


  組件是可復用的Vue實例,擁有屬於自己的數據、模板、腳本和樣式,可避免繁重的重復性開發。由於組件都是獨立的,因此其內部代碼不會影響其它組件,但可以包含其它組件,並且相互之間還能通信。

一、注冊

  在使用組件之前,需要先將其注冊,Vue提供了兩種注冊方式:全局注冊和局部注冊。

1)全局注冊

  通過Vue.component()方法可注冊全局的組件,它能接收兩個參數,第一個是組件名稱,第二個既可以是擴展過的構造器(即Vue.extend()的返回值),也可以是選項對象(會自動調用Vue.extend()),如下所示。

Vue.component("btn-custom", Vue.extend({ }));    //擴展過的構造器
Vue.component("btn-custom", { });                //選項對象

  組件的選項對象也會包含data、methods、計算屬性和生命周期鈎子等成員,但不包含掛載目標el選項,並且data選項也不再是一個對象而是一個函數,因為只有這樣才能讓每個實例維護各自的數據對象,互不影響。注意,只有在組件注冊之后才能將其應用於其它Vue根實例的模板中,如下所示。

<div id="container">
  <btn-custom></btn-custom>
</div>
<script>
  Vue.component("btn-custom", {
    data: function() {
      return {
        txt: "提交"
      };
    },
    template: '<button>{{txt}}</button>'
  });
  var vm = new Vue({ 
    el: "#container"
  });
</script>

  渲染出的DOM結構如下所示。

<div id="container">
  <button>提交</button>
</div>

  組件的命名方式除了上面的連字符分隔式之外,還有另一種大駝峰式(例如BtnCustom)。當把組件引用至字符串模板中時,兩種命名方式都是有效的;而當把組件直接應用到DOM模板中時(如下所示),就不能用大駝峰命名,因為標簽會被自動轉換成小寫(即<btncustom>),於是就找不到這個組件的定義,進而拋出錯誤。

<div id="container">
  <BtnCustom></BtnCustom>
</div>

2)局部注冊

  Vue的局部注冊需要分兩步,首先通過創建選項對象的方式來定義組件,如下所示。

var BtnCustom = {
  data: function() {
    return {
      txt: "提交"
    };
  },
  template: "<button>{{txt}}</button>"
};

  然后在Vue根實例的components選項中注冊要使用的組件(如下所示),其中屬性名就是模板中要使用的自定義元素名,屬性值就是組件。

var vm = new Vue({
  el: "#container",
  components: {
    "btn-custom": BtnCustom
  }
});

  注意,當構建一個組件時,其模板中必須包含一個根元素,之前的示例都只有一個元素。如果有多個元素,那么就得像下面這樣用一個元素(<div>)包裹其它元素(<span>和<button>)。

var BtnCustom = {
  template: `<div>
      <span>按鈕</span>
      <button>提交</button>
    </div>`
};

二、數據傳遞

  組件的props選項能接收從外部(可以是父組件)傳遞進來的數據,其值是一個由HTML特性組成的數組或對象,如下所示。

<btn-custom in-html="提交"></btn-custom>
<script>
  Vue.component("btn-custom", {
    props: ["inHtml"],
    template: '<button>{{inHtml}}</button>'
  });
</script>

  由於HTML特性的名稱大小寫不敏感,因此瀏覽器會將所有大寫字母自動轉換成小寫。這意味着如果在組件內為props選項添加駝峰式的特性(例如inHtml),那么在DOM模板中需要聲明成等價的連字符分隔式的特性(例如in-html),否則在組件內將讀取不到該特性。有一點要注意,在字符串模板中使用特性,兩種命名方式都是有效的。

1)動態傳值

  特性值的類型除了上文的字符串之外,還可以通過v-bind指令動態的將任意類型傳遞給組件的props選項,例如傳入一個數字,如下所示。

<btn-custom :digit="1"></btn-custom>
<script>
  Vue.component("btn-custom", {
    props: ["digit"],
    created: function() {
      typeof this.digit;         //"number"
    }
  });
</script>

  在created鈎子中調用typeof運算符計算this.digit,得到的值為“number”,說明數字傳遞成功。

  如果要傳遞對象的所有屬性,那么不必一個一個聲明,只需要不定義v-bind的參數即可,如下所示,兩個btn-custom組件是等價的。

<div id="container">
  <btn-custom v-bind="obj"></btn-custom>
  <!-- 相當於 -->
  <btn-custom :id="obj.id" :name="obj.name"></btn-custom>
</div>
<script>
  Vue.component("btn-custom", {
    props: ["id"],
    template: '<button>{{id}}</button>'
  });
  var vm = new Vue({
    el: "#container",
    data: {
      obj: { id: 1, name: "strick" }
    }
  });
</script>

  注意,在props選項中聲明的是id或name,而不是obj。

2)數據流

  在Vue中,組件之間的數據是自頂向下單向流動的(即單向數據流),父組件通過props將數據傳遞給子組件。一旦父組件的數據有所更新,那么子組件也會自動更新,如果在子組件中修改接收的props(例如下面的digit特性),那么Vue會拋出錯誤警告,避免改變父組件的狀態。

Vue.component("btn-custom", {
  props: ["digit"],
  created: function() {
    this.digit = 2;
  }
});

  很多需要改變props的情況,其實都能以另一種更合理的方式解決,例如將其保存到組件的data屬性中或定義成一個計算屬性等。

3)校驗特性

  組件的props能以對象的形式指定值類型,其鍵是接收的特性名稱,值是類型構造函數。這樣既有助於閱讀,也可以避免傳遞無效的值。在下面的示例中,指定了digit必須是數字,而number既可以是數字也可以是字符串。

Vue.component("btn-custom", {
  props: {
    digit: Number,
    number: [Number, String]
  }
});

  除了Number和String之外,內置的構造函數還有Boolean、Array、Object、Date、Function和Symbol。不僅如此,還可以自定義構造函數,通過instanceof運算符來檢查。在下面的示例中,驗證man特性是否是通過new Person()創建的。

Vue.component("btn-custom", {
  props: {
    man: People
  }
});
function People(name) {
  this.name = name;
}

  除了基礎的類型檢查之外,組件還允許自定義驗證函數、添加必填標記和附帶默認值,如下所示。

Vue.component("btn-custom", {
  props: {
    digit: {        
      type: Number,
      required: true    //必填
    },
    number: {        
      type: Number,
      default: 100      //數字默認值
    },
    people: {        
      type: Object,
      default: function() {           //對象默認值
        return { name: "strick" };
      }
    },
    name: {            
      validator: function(value) {    //驗證函數
        return value.length > 5;
      }
    }
  }
});

  在使用這些校驗規則時,有兩點需要注意:

  (1)當默認值是對象或數組時,需要從函數中獲取。

  (2)由於props會在組件實例創建之前進行驗證,因此在default()和validator()函數中不能使用組件的屬性,例如data、computed、methods等。

4)未在props中的特性

  組件可以聲明任意多個特性,而那些沒有在props中定義的特性不但會被保存到實例屬性$attrs中,還會被添加到根元素上。注意,class和style兩個特性未包含在$attrs屬性中,並且它們會與原特性進行合並,而不是替換。以下面的btn-custom組件為例,根元素<button>會接收type和class兩個特性。

<btn-custom type="submit" class="size"></btn-custom>
<script>
  Vue.component("btn-custom", {
    props: ["digit"],
    created: function() {
      console.log(this.$attrs);         //{type: "submit"}
    },
    template: '<button type="button" class="warning">{{digit}}</button>'
  });
</script>

  渲染出的<button>元素如下所示,其中type的值被替換成了“submit”,而class的值變成了“warning size”。

<button type="submit" class="warning size"></button>

  如果不想讓根元素繼承特性,那么可以將組件的inheritAttrs選項設為false,但要注意,inheritAttrs不會影響class和style的傳遞。還是以btn-custom組件為例,props和template兩個選項與之前相同。

<btn-custom type="submit" class="size"></btn-custom>
<script>
  Vue.component("btn-custom", {
    inheritAttrs: false
  });
</script>

  渲染出的<button>元素如下所示,其中type的值未被替換,而class的值仍然是“warning size”。

<button type="button" class="warning size"></button>

三、混入

  混入(mixin)是一種代碼復用技術,一個混入對象可包含任意組件選項,並能將其與普通組件混合在一起。

1)選項合並策略

  當組件和混入對象包含同名選項時,這些選項將會通過2種策略進行合並。

  (1)當數據對象或值為對象的選項(例如methods、components等)發生沖突時,同名的屬性將以組件的為准。如下代碼所示,雖然混入對象Mixin的數據對象也包含name屬性,但是依然會被btn-custom組件中的name屬性所覆蓋,並且它的getName()也會被替換。

var Mixin = {
  data: function() {
    return { name: "strick" };
  },
  methods: {
    getName: function() {
      console.log("mixin");
    }
  }
};
Vue.component("btn-custom", {
  mixins: [Mixin],
  data: function() {
    return { name: "freedom" };
  },
  methods: {
    getName: function() {
      console.log("component");
    }
  }
});

  (2)當生命周期鈎子發生沖突時,同名的鈎子將合並成一個數組,混入對象的鈎子在前,組件的鈎子在后,如下所示,先輸出“mixin”,再輸出“component”。

var Mixin = {
  created: function() {
    console.log("mixin");
  }
};
Vue.component("btn-custom", {
  mixins: [Mixin],
  created: function() {
    console.log("component");
  }
});

2)全局混入

  通過Vue.mixin()方法可注冊全局的混入對象,如下所示。

Vue.mixin({
  created: function () {
    console.log("global");
  }
});

  全局混入會影響所有的Vue實例,包括自定義的組件或第三方組件,因此要謹慎使用。大部分情況下它只適合自定義的選項,在官方的代碼風格指南中,為混入中的這些選項制訂了專門的命名規范,即以“$_”和自定義的命名空間為前綴(例如$_namespace_),從而避免與其它實例中的選項相沖突,下面是一個簡單的示例。

Vue.mixin({
  $_namespace_getAge: function () {
    return 28;
  }
});

3)自定義選項合並策略

  除了預定義的合並策略之外,Vue還允許自定義合並策略,只需在Vue.config.optionMergeStrategies中添加一個包含合並邏輯的函數即可。

  下面是一個示例,首先在混入對象和組件中都聲明了一個自定義的age選項;然后在Vue.config.optionMergeStrategies中添加一個同名的age()函數,並且需要在組件之前聲明合並函數;最后在created鈎子中調用實例屬性$options,讀取到的age值為28,符合age()函數中的合並規則。

var Mixin = {
  age: 28
};
Vue.config.optionMergeStrategies.age = function(toVal, fromVal) {
  return fromVal > toVal ? toVal : fromVal;
};
Vue.component("btn-custom", {
  mixins: [Mixin],
  created: function() {
    this.$options.age;        //28
  },
  age: 30
});

四、動態組件

  Vue內置的<component>元素可渲染一個元組件為動態組件,通過它的is特性來決定使用哪個組件。下面用一個例子來演示<component>元素的用法,首先全局注冊兩個組件tab1和tab2;然后將它們合並成數組賦給vm實例的tabs屬性,而另一個current屬性記錄了當前要渲染的組件,默認值為tab1;最后將該屬性值傳遞給is特性,並在DOM模板中創建兩個按鈕,每個按鈕都注冊了點擊事件,可更改要渲染的組件。

<div id="container">
  <button v-for="tab in tabs" @click="current = tab">{{ tab }}</button>
  <component :is="current"></component>
</div>
<script>
  Vue.component("tab1", {
    template: '<input type="text"/>'
  });
  Vue.component("tab2", {
    template: '<input type="text"/>'
  });
  var vm = new Vue({
    el: "#container",
    data: {
      current: "tab1",
      tabs: ["tab1", "tab2"]
    }
  });
</script>

1)<keep-alive>

  雖然可以動態切換組件,但是組件的狀態無法保持,例如在tab1組件的文本框中輸入字符,來回切換后,這些字符就消失了。如果要緩存組件的狀態,那么可以用Vue提供的另一個內置的<keep-alive>元素,如下所示,用它來包裹<component>元素,就不會銷毀失活的組件,從而提升渲染性能。

<keep-alive>
  <component :is="current"></component>
</keep-alive>

  注意,<keep-alive>元素自身不會渲染成一個DOM元素,並且其可與任意元素配合,但子元素只能渲染一個。由此可知,<keep-alive>元素內可包含條件指令(如下所示),但不能包含v-for指令。

<keep-alive>
  <tab1 v-if="current == 'tab1'"></tab1>
  <tab2 v-else></tab2>
<keep-alive>

  有兩個與<keep-alive>元素相關的生命周期鈎子:activated和deactivated。以之前的tab1組件為例,為其添加這兩個鈎子(如下代碼所示),它被包裹在<keep-alive>元素中。當激活tab1組件時,會觸發activated鈎子;而當停用tab1組件時,會觸發deactivated鈎子。

Vue.component("tab1", {
  template: '<input type="text"/>',
  activated: function() {
    console.log("activated");
  },
  deactivated: function() {
    console.log("deactivated");
  }
});

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM