ElementUI 源碼簡析——Basic篇

来源:https://www.cnblogs.com/karthuslorin/archive/2019/07/16/11195386.html
-Advertisement-
Play Games

Layout 佈局 row 佈局組件中的父組件,用於控制子組件。很簡單的一個佈局標簽,主要通過 justify 和 align 控制子元素的對齊方式,使用 render 函數通過傳入的 tag 屬性控制生成的標簽。 在這裡推薦學習下 render 函數和 JSX 的寫法,因為之後比較複雜的組件都是通 ...


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

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

aside

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

main

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

最簡單的組件之一,通過傳入的 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;
        },
        //...
    },
    // ...
};

和一般文字鏈接區別不大的一個組件,主要區別在於兩點:

  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 定義標簽屬性、通過組合插槽方便組件使用、通過多種因素設定屬性以及各種預設設計等等。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • iOS13中presentViewController的問題 更新了Xcode11.0 beta之後,在iOS13中運行代碼發現 和之前彈出的樣式不一樣。 會出現這種情況是主要是因為我們之前對 裡面的一個屬性,即 (該屬性是控制器在模態視圖時將要使用的樣式)沒有設置需要的類型。在iOS13中 的預設 ...
  • JavaScript簡介 JavaScript歷史 在上世紀1995年,著名的互聯網公司網景公司希望能在靜態HTML頁面上添加一些動態效果,於是叫Brendan Eich這哥們在兩周之內設計出了JavaScript語言。 ECMAScript 為了讓JavaScript成為全球標準,幾個公司聯合EC ...
  • JQGrid是一個在jquery基礎上做的一個表格控制項,以ajax的方式和伺服器端通信。 JQGrid Demo 是一個線上的演示項目。在這裡,可以知道jqgrid可以做什麼事情。 下麵是轉自其他人blog的一個學習資料,與其說是學習資料,說成查詢幫助文檔更加合適。 jqGrid學習之 安裝 jqG ...
  • 什麼是Node? Node.js 是一個基於Chrome V8 引擎的JavaScript運行環境 Node.js使用了一個事件驅動、非阻塞式I/O的模型,使其輕量又高效 事件驅動: 任務執行,發佈者,訂閱者,事件驅動 ( on emit ) 非阻塞: 執行某一個任務的同時也可以執行其他任務 I/O ...
  • 【本文為原創,轉載請註明出處】 技術【HTML+CSS】 佈局【Div】 步驟1 劃分div佈局 步驟2 填充內容 超鏈接+圖片+文本 步驟3 知識點整理 1.清除瀏覽器樣式 https://www.cnblogs.com/Caixingmin/p/11196614.html 2.多個div併排不換 ...
  • 清除瀏覽器預設樣式的原因 一、 某些標簽的預設樣式不符合我們的設計要求。比如說a標簽,預設它是有一條下劃線,並且字體顏色也讓人覺得很難看,所以我們需要清除它預設的樣式,同時根據要求給它重新添加自定義樣式。如圖是a標簽的預設樣式。 二、各瀏覽器預設的樣式各不同,所以會影響到我們的開發,因為在每次開發之 ...
  • 先做個自我介紹,我13年考上一所很爛專科民辦的學校,學的是生物專業,具體的學校名稱我就不說出來獻醜了。13年我就輟學了,我在那樣的學校,一年學費要1萬多,但是根本沒有人學習,我實在看不到希望,我就退學了。退學後我也迷茫,大專都沒有畢業,我真的不知道我能幹什麼,我在糾結著我能做什麼。所以輟學後我一段時 ...
  • 本文主要講述我在做項目中使用裝飾器(decorator)來動態載入koa-router的路由的一個基礎架構。 目前JavaScript 對decorator 是不支持,但是可以用babel 來編譯 既然是koa2結合decorator 使用,首先是要起一個koa2 項目。 環境要求: node >7 ...
一周排行
    -Advertisement-
    Play Games
  • 示例項目結構 在 Visual Studio 中創建一個 WinForms 應用程式後,項目結構如下所示: MyWinFormsApp/ │ ├───Properties/ │ └───Settings.settings │ ├───bin/ │ ├───Debug/ │ └───Release/ ...
  • [STAThread] 特性用於需要與 COM 組件交互的應用程式,尤其是依賴單線程模型(如 Windows Forms 應用程式)的組件。在 STA 模式下,線程擁有自己的消息迴圈,這對於處理用戶界面和某些 COM 組件是必要的。 [STAThread] static void Main(stri ...
  • 在WinForm中使用全局異常捕獲處理 在WinForm應用程式中,全局異常捕獲是確保程式穩定性的關鍵。通過在Program類的Main方法中設置全局異常處理,可以有效地捕獲並處理未預見的異常,從而避免程式崩潰。 註冊全局異常事件 [STAThread] static void Main() { / ...
  • 前言 給大家推薦一款開源的 Winform 控制項庫,可以幫助我們開發更加美觀、漂亮的 WinForm 界面。 項目介紹 SunnyUI.NET 是一個基於 .NET Framework 4.0+、.NET 6、.NET 7 和 .NET 8 的 WinForm 開源控制項庫,同時也提供了工具類庫、擴展 ...
  • 說明 該文章是屬於OverallAuth2.0系列文章,每周更新一篇該系列文章(從0到1完成系統開發)。 該系統文章,我會儘量說的非常詳細,做到不管新手、老手都能看懂。 說明:OverallAuth2.0 是一個簡單、易懂、功能強大的許可權+可視化流程管理系統。 有興趣的朋友,請關註我吧(*^▽^*) ...
  • 一、下載安裝 1.下載git 必須先下載並安裝git,再TortoiseGit下載安裝 git安裝參考教程:https://blog.csdn.net/mukes/article/details/115693833 2.TortoiseGit下載與安裝 TortoiseGit,Git客戶端,32/6 ...
  • 前言 在項目開發過程中,理解數據結構和演算法如同掌握蓋房子的秘訣。演算法不僅能幫助我們編寫高效、優質的代碼,還能解決項目中遇到的各種難題。 給大家推薦一個支持C#的開源免費、新手友好的數據結構與演算法入門教程:Hello演算法。 項目介紹 《Hello Algo》是一本開源免費、新手友好的數據結構與演算法入門 ...
  • 1.生成單個Proto.bat內容 @rem Copyright 2016, Google Inc. @rem All rights reserved. @rem @rem Redistribution and use in source and binary forms, with or with ...
  • 一:背景 1. 講故事 前段時間有位朋友找到我,說他的窗體程式在客戶這邊出現了卡死,讓我幫忙看下怎麼回事?dump也生成了,既然有dump了那就上 windbg 分析吧。 二:WinDbg 分析 1. 為什麼會卡死 窗體程式的卡死,入口門檻很低,後續往下分析就不一定了,不管怎麼說先用 !clrsta ...
  • 前言 人工智慧時代,人臉識別技術已成為安全驗證、身份識別和用戶交互的關鍵工具。 給大家推薦一款.NET 開源提供了強大的人臉識別 API,工具不僅易於集成,還具備高效處理能力。 本文將介紹一款如何利用這些API,為我們的項目添加智能識別的亮點。 項目介紹 GitHub 上擁有 1.2k 星標的 C# ...