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
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...