---
tags: 學習
---

# 前端UI設計規範引入

使用背景:
UI設計規範通常包含字體、字級、主配色與客製組件的樣式(style)。

在專案中，也經常會引入已經完善的樣式庫來妥善管理全站的樣式，像是tailwindCSS。同時，也會在使用前端框架的情況下，導入其他UI庫，像是vue3的Element plus，且這些UI組件通常也有自己需要倚賴的樣式庫。

而這些需要倚賴的樣式庫，如果在專案有要求設計規範時，可以很方便產出符合UI設計規範的專案樣式庫。

以下是預設使用sass的專案中，配置tailwindCSS和Element plus來增加或覆寫預設的樣式。

## 對tailwindCSS增加定義

依照官方文檔建立tailwind.config.js中，加入需要客製定義的元素，tailwind就能在編譯後建立出相依這些元素的樣式。

module.exports = {
    mode: 'jit', //只編譯有使用到的樣式
    content: ['./index.html', './src/**/*.{vue,js,ts,jsx,tsx}'],
    theme: {
        //...(略)
        colors:{
            //...(略) 
            pressing: '#DBE9D8', //定義顏色與對應的色碼
            pressing2: '#E0F2DE',
            mainGreen: '#3bb071',
            mainGreenDarker: '#b8d8c9',
            secondColor: '#b8d8c9',
        }
    }
}

在class中，就能使用如text-mainGreen的樣式改變字體顏色，也能使用from-pressing to-pressing2來讓背景的漸層樣式去對應到上段新定義的顏色。

<template>
    <div class="... bg-gradient-to-r from-pressing to-pressing2 text-mainGreen">
        <Login />
        <Footer />
    </div>
</template>

## 對Element plus覆寫定義

這部分可以分為兩個情況做處理

### 在UI庫產生樣式庫前，先修改定義的元素
比如要修改顏色中定義為primary的色碼。依照官方文檔去覆寫定義，在專案使用sass的情況下，可以獨立建立一支scss檔案。

//elementPlusInit.scss
@forward 'element-plus/theme-chalk/src/common/var.scss' with (
    $colors: (
        'primary': (
            'base': #3bb071
        )
    )
);

而必須確保在專案在掛載Element plus樣式庫前，先執行這段scss檔的內容，在我目前使用Vite的情況下，是在vite.config.js中，設定如下。在理解上，是把這支scss檔指令/資料加到vite打包css的預處理流程中，而改變element-plus產生的樣式庫的結果。

export default ({ mode }) => defineConfig({
    //...(略) 
    css: {
        preprocessorOptions: {
            scss: {
                additionalData: `@use "@/assets/styles/elementPlusInit.scss" as *;`
            }
        }
    }
})

:::warning
在vite ^2.3.7上打包後
這支預載scss定義的樣式會被重複在每一個分割的組件css中
所以目前先採取只先把定義修改的指令在這支檔案，否則會有大量的重複樣式產生在開發和打包結果中。
:::

### 在UI庫產生樣式庫後，覆寫已經定義好的樣式
這部分的實作，就是打開dev tool找到畫面上element-plus給組件配的樣式名稱，再做一次覆寫。而這邊的覆寫，還嘗試加入深/淺模式變化上，強制(!important)讓組件的樣式換上自定義的顏色(但可能還有更漂亮的作法?)。

.el-table {
    background: var(--bg) !important;
    color: var(--font-color) !important;
    --el-table-bg-color: var(--bg) !important;
    --el-table-tr-bg-color: var(--bg) !important;
    --el-table-row-hover-bg-color: var(--bgHover) !important;
}

.el-table__expanded-cell[class*='cell'] {
    padding: 10px 20px;
}

.el-table td,
.el-table th {
    padding: 4px;
    font-weight: 400;
}

.el-breadcrumb__inner a {
    color: var(--font-color) !important;
}