ElementUI 源碼簡析——Basic 篇

Layout 佈局

row

佈局組件中的父組件，用於控制子組件。很簡單的一個佈局標籤，主要經過 justify 和 align 控制子元素的對齊方式，使用 render 函數經過傳入的 tag 屬性控制生成的標籤。

在這裏推薦學習下 render 函數和 JSX 的寫法，由於以後比較複雜的組件都是經過 render函數 + JSX 的方式來寫的。

// 核心代碼
render(h) {
    return h(this.tag, {
        class: [
            'el-row',
            this.justify !== 'start' ? `is-justify-${this.justify}` : '',
            this.align !== 'top' ? `is-align-${this.align}` : '',
            { 'el-row--flex': this.type === 'flex' }
        ],
        style: this.style
    }, this.$slots.default);
}
複製代碼

col

佈局組件中的子組件，經過傳入的props控制佔據的列數、偏移、大小等，經過 forEach 對每一個屬性進行處理，生成包含對應樣式的 classList。

最後將 classList 傳入 createElement 函數（h）中的第二個參數（標籤選項）中，如此，就生成了所須要的佈局。

// 核心代碼
render (h) {
    // 省略，經過props計算classList
    return h(this.tag, {
      class: ['el-col', classList],
      style
    }, this.$slots.default);
}
複製代碼

Container 佈局容器

container

父容器組件，根據傳入的direction字段，決定樣式是水平仍是垂直。當沒有傳入direction字段時，根據插槽中子組件是否含有 header 或 footer組件，若是含有則爲垂直，不然爲水平。

// 核心代碼
computed: {
    isVertical() {
        if (this.direction === 'vertical') {
            return true;
        } else if (this.direction === 'horizontal') {
            return false;
        }
        return this.$slots && this.$slots.default
            ? this.$slots.default.some(vnode => {
            const tag = vnode.componentOptions && vnode.componentOptions.tag;
            return tag === 'el-header' || tag === 'el-footer';
        })
        : false;
    }
}
複製代碼

header

最簡單的組件之一，經過傳入的 height 參數定義 style 高度。

aside

最簡單的組件之一，經過傳入的 width 參數控制 style 寬度。

main

真正意義上的最簡單容器組件，包含插槽的純容器。

footer

最簡單的組件之一，經過傳入的 height 參數定義 style 高度。

佈局容器總結

何爲容器？在個人理解中，容器就是一個限制大小的盒子。佈局容器經過屬性定義 header、aside、footer 的高寬的行內樣式，接下來只須要定義 main 爲 flex: 1 便可實現自適應佈局。

Icon 圖標

感受比較沒有意義的一個組件，經過傳入的 name 來組成相似於 el-icon-name 格式的類，而後將這個類定義在 i 標籤內。不過大多數人都不會用這個組件，爲何？由於連官網推薦寫法都是直接在 i 標籤內添加對應圖標的類。

Button 按鈕

Button 組件是 Basic 裏面惟一一個稍微複雜一點的組件。它與其餘 Basic 組件的最大區別在於，經過 provide/inject 獲取了祖先組件，而後參照祖先組件的尺寸參數，將 Button 組件的尺寸參數設爲一致。

Button 組件的尺寸由三個因素決定：

1. 直接設置組件的 size 屬性，該因素具備最高優先級，類比於樣式中的行內樣式。
2. 當 Button 運用在 Form 組件中，能夠經過配置 Form 組件的 size 屬性來決定，當沒有直接設置 Button 組件的 size 屬性時，由該因素決定 Button 組件的尺寸，類比於樣式中的樣式繼承。
3. 當前兩種因素都不存在時，由 this.$ELEMENT 對象中的 size 屬性決定。What？ this.$ELEMENT 什麼鬼？它是接收初始化 ElementUI 時傳入的尺寸參數的對象，包含兩個屬性：size 以及 zIndex，方便全局定義各類組件的尺寸。類比於樣式中的 body 樣式繼承。

// 核心代碼
export default {
    name: 'ElButton',
    // 經過 inject 獲取 elForm 以及 elFormItem 這兩個組件
    inject: {
        elForm: {
            default: ''
        },
        elFormItem: {
            default: ''
        }
    },
    // ...
    computed: {
        _elFormItemSize() {
            return (this.elFormItem || {}).elFormItemSize;
        },
        buttonSize() {
            // 三種因素決定按鈕的尺寸
            return this.size || this._elFormItemSize || (this.$ELEMENT || {}).size;
        },
        //...
    },
    // ...
};
複製代碼

Link 文字連接

和通常文字連接區別不大的一個組件，主要區別在於兩點：

1. 能夠經過 disabled 屬性設置禁用，原理是當 disabled 屬性爲 false 時，將 a 標籤的 href 屬性置爲 null，同時阻止阻止其向上拋出 click 事件。
2. 靈活運用插槽，看似該組件只有一個插槽，實則擁有兩個插槽，一個是匿名插槽，一個是名爲 icon 的具名插槽，經過合理的設置能夠快速實現各類需求。

值得一提的是，該組件還使用了一個通用組件開發的小技巧：經過 v-bind="$attrs" 進行快速屬性賦值。爲何要這樣作？由於 a 標籤能夠含有各類 html 屬性，而這些屬性咱們不可能一一經過 props 接收而後賦值到 a 標籤的屬性上。

所以，咱們能夠經過 v-bind="$attrs" 無視傳入的屬性是什麼，一股腦將其賦值到 a 標籤上。這至關於，開發者能夠直接像操做 a 標籤同樣操做 Link 組件，大大方便了組件的使用。

<template>
  <a
    :class="[
      'el-link',
      type ? `el-link--${type}` : '',
      disabled && 'is-disabled',
      underline && !disabled && 'is-underline'
    ]"
    :href="disabled ? null : href"
    v-bind="$attrs"
    @click="handleClick"
  >

    <i :class="icon" v-if="icon"></i>

    <span v-if="$slots.default" class="el-link--inner">
      <slot></slot>
    </span>

    <template v-if="$slots.icon"><slot v-if="$slots.icon" name="icon"></slot></template>
  </a>
</template>
複製代碼

總結

通讀了 Basic 系列的源碼，能夠發現，這一部分的源碼其實相對比較簡單，可是，卻又不少的小細節點值得學習，好比：經過 v-bind=$attrs 定義標籤屬性、經過組合插槽方便組件使用、經過多種因素設定屬性以及各類缺省設計等等。