Vue3 style CSS 變量注入的實(shí)現(xiàn)

更新時(shí)間：2021年07月22日 09:04:37 作者：guangzan

本文主要介紹了Vue3 style CSS 變量注入的實(shí)現(xiàn)，文中通過示例代碼介紹的非常詳細(xì)，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

摘要

在單文件組件樣式中支持使用組件狀態(tài)驅(qū)動(dòng)的 CSS 變量（ CSS 自定義屬性）。

基礎(chǔ)示例

<template>
  <div class="text">hello</div>
</template>

<script>
  export default {
    data() {
      return {
        color: 'red',
        font: {
          size: '2em',
        },
      }
    },
  }
</script>

<style>
  .text {
    color: v-bind (color);

    /* expressions (wrap in quotes) */
    font-size: v-bind ('font.size');
  }
</style>

動(dòng)機(jī)

Vue SFC 樣式提供了直接的 CSS 搭配和封裝，但它是純粹的靜態(tài)的 —— 這意味著到目前為止，我們沒有能力在運(yùn)行時(shí)根據(jù)組件的狀態(tài)動(dòng)態(tài)更新樣式。

現(xiàn)在，隨著大多數(shù)現(xiàn)代瀏覽器支持原生 CSS 變量，我們可以利用它來輕松連接組件的狀態(tài)和樣式。

設(shè)計(jì)細(xì)節(jié)

SFC 中的標(biāo)簽現(xiàn)在支持一個(gè)自定義 CSS 函數(shù) v-bind：

<!-- in Vue SFC -->
<style>
  .text {
    color: v-bind (color);
  }
</style>

正如預(yù)期的那樣，這將把聲明的值綁定到組件狀態(tài)的屬性上，reactively.color color

該函數(shù)內(nèi)部可以支持任意的 JavaScript 表達(dá)式，但由于 JavaScript 表達(dá)式可能包含在 CSS 標(biāo)識(shí)符中無效的字符，因此在大多數(shù)情況下需要用引號(hào)來包裹它們：v-bind

.text {
  font-size: v-bind ('theme.font.size');
}

當(dāng)檢測(cè)到這種 CSS 變量時(shí)，SFC 編譯器將執(zhí)行以下操作：

重寫到一個(gè)帶有哈希變量名稱的本機(jī)。上面的內(nèi)容將被改寫為：v-bind () var ()

.text {
  color: var (--6b53742-color);
  font-size: var (--6b53742-theme_font_size);
}

請(qǐng)注意，hash 將應(yīng)用于所有情況，無論標(biāo)簽是否有范圍。這意味著注入的 CSS 變量不會(huì)意外地泄漏到子組件中。

相應(yīng)的變量將作為內(nèi)聯(lián)樣式被注入到組件的根元素中。對(duì)于上面的例子，最終渲染的 DOM 將看起來像這樣：

<div style="--6b53742-color:red;--6b53742-theme_font_size:2em;" class="text">
  hello
</div>

注入是響應(yīng)式的 ——所以如果組件的屬性發(fā)生變化，注入的 CSS 變量將被相應(yīng)地更新。這種更新是獨(dú)立于組件的模板更新的，所以對(duì)一個(gè)純 CSS 的響應(yīng)式屬性的改變不會(huì)觸發(fā)模板的重新渲染。

編譯細(xì)節(jié)

為了注入 CSS 變量，編譯器需要生成并注入如下代碼到組件的 setup ()

import { useCssVars } from 'vue'

export default {
  setup() {
    //...
    useCssVars(_ctx => ({
      color: _ctx.color,
      theme_font_size: _ctx.theme.font.size,
    }))
  },
}

... 這里，運(yùn)行時(shí)幫助器設(shè)置了一個(gè)將變量響應(yīng)性地應(yīng)用到 DOM.useCssVars watchEffect 上。

該編譯策略要求腳本編譯時(shí)首先對(duì)標(biāo)簽內(nèi)容進(jìn)行簡(jiǎn)單的重碼解析，以確定要暴露的變量列表。然而，這個(gè)解析階段不會(huì)像基于 AST 的完整解析 <style> 那樣耗費(fèi)開銷。

在生產(chǎn)中，變量名可以被進(jìn)一步 hash，以減少 CSS 的占用。

.text {
  color: var (--x3b2fs2);
  font-size: var (--29fh29g);
}

相應(yīng)的生成的 JavaScript 代碼將相應(yīng)地使用相同的哈希值。

采用策略

這是一個(gè)完全向后兼容的新功能。然而，我們應(yīng)該明確指出，它依賴于本地的 CSS 變量，所以用戶需要了解瀏覽器的支持范圍。

實(shí)踐

在 script 中聲明兩個(gè)響應(yīng)式的屬性，分別是 wallpaperBlur 和 wallpaperMask。wallpaperBlur 表示壁紙的模糊程度， wallpaperMask 表示遮罩的透明度。通過 v-bind 將它們應(yīng)用到 style，這意味著當(dāng)我們?cè)?script 中改變這兩個(gè)值時(shí)，樣式會(huì)響應(yīng)更改。

// script
const wallpaperBlur = ref('0px')
const wallpaperMask = ref('rgba(0, 0, 0, 0)')

// style
.wallpaper {
  filter: blur(v-bind(wallpaperBlur));
  bottom: calc(v-bind(wallpaperBlur) * -2);
  left: calc(v-bind(wallpaperBlur) * -2);
  right: calc(v-bind(wallpaperBlur) * -2);
  top: calc(v-bind(wallpaperBlur) * -2);
  .wallpaper-image {
    transition: background-image 0.6s, background-color 0.4s;
  }
  .wallpaper-mask {
    background-color: v-bind(wallpaperMask);
  }
}

提示

綁定恰當(dāng)?shù)膶傩?br />

在上面的例子中，你可能想到到更改遮罩的透明度僅需要聲明一個(gè) 0-1 的數(shù)字，之后在 style 中這樣寫：

.wallpaper-mask {
  background-color: rgba(0, 0, 0, v-bind(wallpaperMask));
}

上文已經(jīng)提到在編譯階段會(huì)將 style 中的 v-bind 改寫為 CSS 變量的形式，上面的代碼會(huì)被改寫為這樣：

.wallpaper-mask {
  background-color: rgba(0, 0, 0, var (--[hash]-wallpaper_mask));
}

rgba(0, 0, 0, var (--[hash]-wallpaper_mask)) 在 CSS 中是無法被解析的。所以這就是為什么將 wallpaperMask 的初始值聲明為 rgba(0, 0, 0, 0) 的原因。這是需要十分注意的一點(diǎn)，CSS 中還有許多類似的情況。

注意 style 的更新

在設(shè)計(jì)細(xì)節(jié)中提到相應(yīng)的變量將作為內(nèi)聯(lián)樣式被注入到組件的根元素中。最終渲染的 DOM 將看起來像這樣：

<div style="--6b53742-color:red;--6b53742-theme_font_size:2em;"></div>

當(dāng)你在 <script> 中改變 <style> 中綁定的屬性時(shí)，內(nèi)斂樣式中的 CSS 變量將會(huì)響應(yīng)更改。但是，并不能單獨(dú)更新內(nèi)斂樣式其中的一個(gè) CSS 變量，這意味著更新一個(gè)組件中的任意一個(gè)“動(dòng)態(tài)樣式”，都將引起根組件中的內(nèi)斂樣式全部更新。當(dāng) style 屬性的值包含大量 CSS 變量時(shí)，你需要考慮重新組織組件。因?yàn)榫幾g生成的 CSS 變量都將作為內(nèi)聯(lián)樣式被注入到組件的根元素中，我們無法控制這種行為，將一個(gè)引起更新的 CSS 變量和其他 CSS 變量解耦。

試想這種情況， style 中編譯生成的 CSS 變量中包含一個(gè)其值為龐大的 base64 的 CSS 變量。當(dāng)更新該組件中其他 CSS 變量時(shí)，整個(gè) style 都將更新，這將帶來額外的硬件開銷。我們需要將這個(gè)生成 base64 CSS 變量的組件單獨(dú)抽離，以使該 CSS 變量注入到該組件的根元素，不受其他 CSS 變量更新影響。