主頁 > 企業開發 > 組件設計要求

組件設計要求

2022-05-11 08:05:44 企業開發

前言

在我們日常代碼開發程序中,組件的使用是必不可少的,我們也會去封裝組件,但是大家寫組件的風格各式各樣,沒有一個統一的準則,而且也沒有遵循軟體開發的原則:高內聚、低耦合;因為我是給行業提供代碼的,行業給交付提供代碼,我們要盡量去減少大家的接入成本,降低接入成本的最好方案就是我們在設計組件的時候撰寫好檔案,保證職責單一,不要耦合業務,就在很多程度上降低了成本了,在我們平時開發程序中,也遇到過一些組件,一個組件的實作有上千行代碼,那種組件我是直接不想看的,所以我們在開發組件的時候如果你的代碼超過了300行,那你就需要好好思考一下,是否有需要優化的了,設計是否合理,是否有重復的代碼可以封裝等等,

大家在看這個檔案時可以先詳細閱讀一下這個檔案

組件職責單一

比如商品串列篩選條件組件,提供篩選功能,輸出一個選擇的form提供給外部組件請求串列資料,

一個很簡單的功能,為了保證組件的功能的單一,不允許其他模塊往這個組件中新增篩選條件,如果在不修改組件的情況下可以直接使用這個組件

<template>
  <!--過濾器-->
  <el-form
    style="padding-right: 20px"
    inline
    
    :model="filter"
    ref="filter"
    label-position="right"
    label-
  >
    <!-- 關鍵字搜索 -->
    <el-form-item label="商品標題:" prop="itemMainTitle">
      <el-input
        
        placeholder="請輸入"
        size="mini"
        v-model.trim="filter.itemMainTitle"
        @input="checkFilterParam('itemMainTitle', 80)"
      />
    </el-form-item>

    <!-- barcode條形碼搜索 -->
    <el-form-item v-if="showBarcode" label="條形碼:" prop="barcode">
      <el-input
        
        placeholder="條形碼搜索"
        prefix-icon="el-icon-search"
        size="mini"
        v-model.trim="filter.barcode"
        @input="checkFilterParam('barcode', 20)"
      />
    </el-form-item>

    <el-form-item label="商品分類:" prop="categoryId">
      <goods-category-cascader
        
        :active-goods-type="goodsType"
        :with-all="true"
        size="mini"
        v-model="filter.categoryId"
        :reset-selecte="resetSelecte"
        @changeRestStatus="changeRestStatus"
      />
    </el-form-item>

    <el-form-item label="售賣型別:" prop="saleType">
      <el-select  v-model="filter.saleType" size="mini" placeholder="售賣型別">
        <el-option label="全部型別" :value="https://www.cnblogs.com/fshmjl/p/null"></el-option>
        <el-option label="普通售賣" :value="https://www.cnblogs.com/fshmjl/p/SaleChannel.Normal"></el-option>
        <el-option label="活動售賣" :value="https://www.cnblogs.com/fshmjl/p/SaleChannel.Activity"></el-option>
      </el-select>
    </el-form-item>

    <!-- 上下架狀態 -->
    <el-form-item v-if="showStatus" prop="itemActiveStatus" label="狀態:">
      <el-select  v-model="filter.itemActiveStatus" size="mini">
        <el-option label="全部狀態" :value="https://www.cnblogs.com/fshmjl/p/null"></el-option>
        <el-option label="啟用" :value="https://www.cnblogs.com/fshmjl/p/GoodsStatus.PullShelves"></el-option>
        <el-option label="禁用" :value="https://www.cnblogs.com/fshmjl/p/GoodsStatus.RemoveShelves"></el-option>
      </el-select>
    </el-form-item>

    <el-form-item label="是否支持退款:" prop="notAllowRefund">
      <el-select  v-model="filter.notAllowRefund" size="mini" placeholder="是否支持退款">
        <el-option label="全部狀態" :value="https://www.cnblogs.com/fshmjl/p/null"></el-option>
        <el-option label="支持" :value="https://www.cnblogs.com/fshmjl/p/AllowRefund.Yes"></el-option>
        <el-option label="不支持" :value="https://www.cnblogs.com/fshmjl/p/AllowRefund.No"></el-option>
      </el-select>
    </el-form-item>

    <el-form-item v-if="showPerformance" label="履約主體:" prop="performanceBuId">
      <slot></slot>
    </el-form-item>

    <el-button type="primary" @click="onFilter">搜索</el-button>
    <el-button v-if="!showLabel" plain @click="handleReset" style="margin-top: 2px">重置</el-button>
  </el-form>
</template>

體積要小

為了不讓組件去耦合業務,要盡可能的保證組件的純粹性,如上面講到的篩選條件組件,只需要保證輸出的篩選欄位正確性,而篩選的條件的值可以由外部組件提供(如商品分類的資料),

為什么資料要外部傳入?

這是因為一般情況下存在的篩選條件,串列也肯定會有,而有時候后端在回傳資料時只回傳了id,就需要我們去通過id決議出對應的name,這就需要使用到對應的資料,這個時候就可以共享資料,

這樣也可以進一步降低耦合與體積

遵循使用習慣

很多組件都有他們的慣用方法,比如表單組件會使用 v-model 來進行系結表單值、模態框我們會使用visible 或 show() 方法來控制顯示,

遵循這些慣用方法, 可以減少開發者的心智負擔,維持介面的統一性,另外也更容易地被組合/集成(比如在 Ant-design 中 Form.Item 就依賴于這個協議),

舉個例子,頭像選擇器:

export default {
  name: 'AvatarSelect',
  props: ['avatar'],
	methods: {
    handleSelect() {
			// ...
			this.$emit('avatar-change', value)
		}
  }
}

<avatar-select :avatar="form.avatar" @avatar-change="form.avatar = $event" />

謹防樣式污染

  • 每個組件應該有一個命名空間,且這個命名空間最好避免和其他組件沖突,

    <template>
    	<div >
        ...
      </div>
    </template>
    
    <style lang="scss">
      .my-component {
    		// 下級組件樣式
    	}
    <style>
    
  • 總是開啟 Scoped CSS. 這是一種最簡便的防止污染的方式

    <style scoped>
    .example {
      color: red;
    }
    </style>
    
    <template>
      <div >hi</div>
    </template>
    
  • CSS 類嵌套不要超過兩級,否則從可讀性和可維護性上都會大打折扣

    .foo {
      .bar {
    		.baz {
    		  // 幾百幾千行代碼
    			}
    		// 幾百幾千行代碼
    	}
    }
    
  • 推薦使用 BEM 來作為CSS 類名,讓CSS 的語意和組件結構關聯起來,

    .my-component {
      &__head {/*...*/}
      &__footer {/*...*/}
    }
    
  • 通過 class 或 style 來定制組件的樣式,不要使用直接給標簽加樣式

    // ?
    <el-input />
    <style>
      .el-input {
    		// 樣式覆寫
    	}
    </style>
    
    // ?
    <el-input  />
    <style>
    	.my-input {
    		// 樣式覆寫
    	}
    </style>
    

組件擴展

由于我們是基礎產品,那提供的組件也要盡量豐富,豐富并不是說要在組件中加各種判斷,而是在職責單一、體積、耦合間權衡利弊,也可以創建同型別組件,在同一個檔案index.jsexport

單向資料流

  • 只通過 props 向下級傳遞狀態,不要通過 ref 這類方式,程序式地去影響下級組件的狀態,

  • 下級組件只通過 event 向上級通信,

  • 下級組件不準修改 props 源資料,

  • 遵循 v-model, update:* 協議,

  • v-model 遵循資料不可變原則,即你不能直接修改 value,而是應該創建一個新的 value,

    // 假設 value 是一個串列
    handleRemove(item) {
      const idx = this.value.indexOf(item)
      if (idx !== -1) {
        const newValue = https://www.cnblogs.com/fshmjl/p/[...this.value]
    		newValue.splice(idx, 1)
        this.$emit('input', newValue)
    	}
    }
    
  • 使用 computed 來衍生資料,保持源資料的純潔,

  • 分離業務狀態和視圖狀態,比如串列項的激活狀態就是視圖狀態,而后端回傳的資料就是業務狀態,

    // 推薦
    <item :checked="item.id in checked" @click="checked.add(item.id)" />
    
    // 不推薦: 直接在源資料上添加了一個欄位,污染了原有的資料,
    <item :checked="item.checked" @click="item.checked = true" />
    

進階篇

用 JSX 賦能 Vue

Vue 本身是完全支持 JSX 渲染的,但是大部分情況我們還是習慣或者推薦使用模板,

如果你習慣了 React 的 renderProps ,覺得 Vue 的 slot 不夠用,那么可以上 JSX,

使用依賴注入

為了更好點交流和學習,請大家在參閱博客后,留下你的疑問和寶貴意見,謝謝!!!!

轉載請註明出處,本文鏈接:https://www.uj5u.com/qiye/472298.html

標籤:JavaScript

上一篇:JavaScript知識總結 終結篇--面向物件,垃圾回收與記憶體泄漏

下一篇:跨域問題及其解決方法(JSONP&CORS)

標籤雲
其他(157675) Python(38076) JavaScript(25376) Java(17977) C(15215) 區塊鏈(8255) C#(7972) AI(7469) 爪哇(7425) MySQL(7132) html(6777) 基礎類(6313) sql(6102) 熊猫(6058) PHP(5869) 数组(5741) R(5409) Linux(5327) 反应(5209) 腳本語言(PerlPython)(5129) 非技術區(4971) Android(4554) 数据框(4311) css(4259) 节点.js(4032) C語言(3288) json(3245) 列表(3129) 扑(3119) C++語言(3117) 安卓(2998) 打字稿(2995) VBA(2789) Java相關(2746) 疑難問題(2699) 细绳(2522) 單片機工控(2479) iOS(2429) ASP.NET(2402) MongoDB(2323) 麻木的(2285) 正则表达式(2254) 字典(2211) 循环(2198) 迅速(2185) 擅长(2169) 镖(2155) 功能(1967) .NET技术(1958) Web開發(1951) python-3.x(1918) HtmlCss(1915) 弹簧靴(1913) C++(1909) xml(1889) PostgreSQL(1872) .NETCore(1853) 谷歌表格(1846) Unity3D(1843) for循环(1842)

熱門瀏覽
  • IEEE1588PTP在數字化變電站時鐘同步方面的應用

    IEEE1588ptp在數字化變電站時鐘同步方面的應用 京準電子科技官微——ahjzsz 一、電力系統時間同步基本概況 隨著對IEC 61850標準研究的不斷深入,國內外學者提出基于IEC61850通信標準體系建設數字化變電站的發展思路。數字化變電站與常規變電站的顯著區別在于程序層傳統的電流/電壓互 ......

    uj5u.com 2020-09-10 03:51:52 more
  • HTTP request smuggling CL.TE

    CL.TE 簡介 前端通過Content-Length處理請求,通過反向代理或者負載均衡將請求轉發到后端,后端Transfer-Encoding優先級較高,以TE處理請求造成安全問題。 檢測 發送如下資料包 POST / HTTP/1.1 Host: ac391f7e1e9af821806e890 ......

    uj5u.com 2020-09-10 03:52:11 more
  • 網路滲透資料大全單——漏洞庫篇

    網路滲透資料大全單——漏洞庫篇漏洞庫 NVD ——美國國家漏洞庫 →http://nvd.nist.gov/。 CERT ——美國國家應急回應中心 →https://www.us-cert.gov/ OSVDB ——開源漏洞庫 →http://osvdb.org Bugtraq ——賽門鐵克 →ht ......

    uj5u.com 2020-09-10 03:52:15 more
  • 京準講述NTP時鐘服務器應用及原理

    京準講述NTP時鐘服務器應用及原理京準講述NTP時鐘服務器應用及原理 安徽京準電子科技官微——ahjzsz 北斗授時原理 授時是指接識訓通過某種方式獲得本地時間與北斗標準時間的鐘差,然后調整本地時鐘使時差控制在一定的精度范圍內。 衛星導航系統通常由三部分組成:導航授時衛星、地面檢測校正維護系統和用戶 ......

    uj5u.com 2020-09-10 03:52:25 more
  • 利用北斗衛星系統設計NTP網路時間服務器

    利用北斗衛星系統設計NTP網路時間服務器 利用北斗衛星系統設計NTP網路時間服務器 安徽京準電子科技官微——ahjzsz 概述 NTP網路時間服務器是一款支持NTP和SNTP網路時間同步協議,高精度、大容量、高品質的高科技時鐘產品。 NTP網路時間服務器設備采用冗余架構設計,高精度時鐘直接來源于北斗 ......

    uj5u.com 2020-09-10 03:52:35 more
  • 詳細解讀電力系統各種對時方式

    詳細解讀電力系統各種對時方式 詳細解讀電力系統各種對時方式 安徽京準電子科技官微——ahjzsz,更多資料請添加VX 衛星同步時鐘是我京準公司開發研制的應用衛星授時時技術的標準時間顯示和發送的裝置,該裝置以M國全球定位系統(GLOBAL POSITIONING SYSTEM,縮寫為GPS)或者我國北 ......

    uj5u.com 2020-09-10 03:52:45 more
  • 如何保證外包團隊接入企業內網安全

    不管企業規模的大小,只要企業想省錢,那么企業的某些服務就一定會采用外包的形式,然而看似美好又經濟的策略,其實也有不好的一面。下面我通過安全的角度來聊聊使用外包團的安全隱患問題。 先看看什么服務會使用外包的,最常見的就是話務/客服這種需要大量重復性、無技術性的服務,或者是一些銷售外包、特殊的職能外包等 ......

    uj5u.com 2020-09-10 03:52:57 more
  • PHP漏洞之【整型數字型SQL注入】

    0x01 什么是SQL注入 SQL是一種注入攻擊,通過前端帶入后端資料庫進行惡意的SQL陳述句查詢。 0x02 SQL整型注入原理 SQL注入一般發生在動態網站URL地址里,當然也會發生在其它地發,如登錄框等等也會存在注入,只要是和資料庫打交道的地方都有可能存在。 如這里http://192.168. ......

    uj5u.com 2020-09-10 03:55:40 more
  • [GXYCTF2019]禁止套娃

    git泄露獲取原始碼 使用GET傳參,引數為exp 經過三層過濾執行 第一層過濾偽協議,第二層過濾帶引數的函式,第三層過濾一些函式 preg_replace('/[a-z,_]+\((?R)?\)/', NULL, $_GET['exp'] (?R)參考當前正則運算式,相當于匹配函式里的引數 因此傳遞 ......

    uj5u.com 2020-09-10 03:56:07 more
  • 等保2.0實施流程

    流程 結論 ......

    uj5u.com 2020-09-10 03:56:16 more
最新发布
  • 使用Django Rest framework搭建Blog

    在前面的Blog例子中我們使用的是GraphQL, 雖然GraphQL的使用處于上升趨勢,但是Rest API還是使用的更廣泛一些. 所以還是決定回到傳統的rest api framework上來, Django rest framework的官網上給了一個很好用的QuickStart, 我參考Qu ......

    uj5u.com 2023-04-20 08:17:54 more
  • 記錄-new Date() 我忍你很久了!

    這里給大家分享我在網上總結出來的一些知識,希望對大家有所幫助 大家平時在開發的時候有沒被new Date()折磨過?就是它的諸多怪異的設定讓你每每用的時候,都可能不小心踩坑。造成程式意外出錯,卻一下子找不到問題出處,那叫一個煩透了…… 下面,我就列舉它的“四宗罪”及應用思考 可惡的四宗罪 1. Sa ......

    uj5u.com 2023-04-20 08:17:47 more
  • 使用Vue.js實作文字跑馬燈效果

    實作文字跑馬燈效果,首先用到 substring()截取 和 setInterval計時器 clearInterval()清除計時器 效果如下: 實作代碼如下: <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta ......

    uj5u.com 2023-04-20 08:12:31 more
  • JavaScript 運算子

    JavaScript 運算子/運算子 在 JavaScript 中,有一些運算子可以使代碼更簡潔、易讀和高效。以下是一些常見的運算子: 1、可選鏈運算子(optional chaining operator) ?.是可選鏈運算子(optional chaining operator)。?. 可選鏈操 ......

    uj5u.com 2023-04-20 08:02:25 more
  • CSS—相對單位rem

    一、概述 rem是一個相對長度單位,它的單位長度取決于根標簽html的字體尺寸。rem即root em的意思,中文翻譯為根em。瀏覽器的文本尺寸一般默認為16px,即默認情況下: 1rem = 16px rem布局原理:根據CSS媒體查詢功能,更改根標簽的字體尺寸,實作rem單位隨螢屏尺寸的變化,如 ......

    uj5u.com 2023-04-20 08:02:21 more
  • 我的第一個NPM包:panghu-planebattle-esm(胖虎飛機大戰)使用說明

    好家伙,我的包終于開發完啦 歡迎使用胖虎的飛機大戰包!! 為你的主頁添加色彩 這是一個有趣的網頁小游戲包,使用canvas和js開發 使用ES6模塊化開發 效果圖如下: (覺得圖片太sb的可以自己改) 代碼已開源!! Git: https://gitee.com/tang-and-han-dynas ......

    uj5u.com 2023-04-20 08:01:50 more
  • 如何在 vue3 中使用 jsx/tsx?

    我們都知道,通常情況下我們使用 vue 大多都是用的 SFC(Signle File Component)單檔案組件模式,即一個組件就是一個檔案,但其實 Vue 也是支持使用 JSX 來撰寫組件的。這里不討論 SFC 和 JSX 的好壞,這個仁者見仁智者見智。本篇文章旨在帶領大家快速了解和使用 Vu ......

    uj5u.com 2023-04-20 08:01:37 more
  • 【Vue2.x原始碼系列06】計算屬性computed原理

    本章目標:計算屬性是如何實作的?計算屬性快取原理以及洋蔥模型的應用?在初始化Vue實體時,我們會給每個計算屬性都創建一個對應watcher,我們稱之為計算屬性watcher ......

    uj5u.com 2023-04-20 08:01:31 more
  • http1.1與http2.0

    一、http是什么 通俗來講,http就是計算機通過網路進行通信的規則,是一個基于請求與回應,無狀態的,應用層協議。常用于TCP/IP協議傳輸資料。目前任何終端之間任何一種通信方式都必須按Http協議進行,否則無法連接。tcp(三次握手,四次揮手)。 請求與回應:客戶端請求、服務端回應資料。 無狀態 ......

    uj5u.com 2023-04-20 08:01:10 more
  • http1.1與http2.0

    一、http是什么 通俗來講,http就是計算機通過網路進行通信的規則,是一個基于請求與回應,無狀態的,應用層協議。常用于TCP/IP協議傳輸資料。目前任何終端之間任何一種通信方式都必須按Http協議進行,否則無法連接。tcp(三次握手,四次揮手)。 請求與回應:客戶端請求、服務端回應資料。 無狀態 ......

    uj5u.com 2023-04-20 08:00:32 more