Published on

使用 CSS variables 和Tailwind css实现主题换肤

背景

在 2B 的项目中,常常有客户(甲方爸爸)需求,定制与他们企业相同的主题的网站;随着苹果暗黑模式的推出,换肤的需求在网站开发中越来越多,也越来越重要,最近在网上看到 Tailwind Labs 的实现的换肤视频,决定实践一把。

实现博客列表

我们先使用 Tailwind css 实现一个博客列表

  • 效果

image.png

  • html 代码
<div class="min-h-screen bg-white">
  <ul class="space-y-10 p-10">
    <li>
      <a class="text-gray-600">
        <article
          class="group relative flex transform items-center transition-transform hover:-translate-x-2"
        >
          <div
            class="flex flex-grow flex-col space-y-4 rounded bg-gray-50 py-8 px-8 text-base shadow-md"
          >
            <div class="flex flex-row justify-between">
              <h3 class="text-xl font-bold text-gray-900">useEffect 完整指南</h3>
              <span>2020-06-08</span>
            </div>
            <p className="leading-8">
              你用Hooks写了一些组件,甚或写了一个小型应用。你可能很满意,使用它的API很舒服并且在这个过程中获得了一些小技巧。
            </p>
          </div>
        </article>
      </a>
    </li>
    <li>
      <a class="text-gray-600">
        <article
          class="group relative flex transform items-center transition-transform hover:-translate-x-2"
        >
          <div
            class="flex flex-grow flex-col space-y-4 rounded bg-gray-50 py-8 px-8 text-base shadow-md"
          >
            <div class="flex flex-row justify-between">
              <h3 class="text-xl font-bold text-gray-900">
                使用 CSS variables 和Tailwind csss实现主题换肤
              </h3>
              <span>2020-06-08</span>
            </div>
            <p className="leading-8">根据Tailwind Labs的[换肤视频],手动实践。</p>
          </div>
        </article>
      </a>
    </li>
  </ul>
</div>

CSS variables

使用 CSS variables 是实现换肤最方便的方案,按传统的方案就得加入一些 css class 就可以实现,如:

:root {
  --page-bg: #fff;
  --card-bg: #f9fafb; /* gray-50 */
  --title-color: #111827; /* gray-900 */
  --desc-color: #4b5563; /* gray-600 */
}

.theme-dark {
  --page-bg: #111827; /* gray-900 */
  --card-bg: #1f2937; /* gray-800 */
  --title-color: #f3f4f6; /* gray-100 */
  --desc-color: #e5e7eb; /* gray-200 */
}
.page__bg {
  background-color: var(--page-bg);
}
.post__card {
  background-color: var(--card-bg);
}
.post__title {
  color: var(--title-color);
}
.post__desc {
  color: var(--desc-color);
}

image.png

这样就可以实现深色皮肤了,如果想增加一套皮肤,只需增加一套颜色变量就可以了。

兼容性

CSS variables 只支持现代浏览器,但是许多客户还在使用 IE11,为了兼容 IE11 可以使用 postcss 插件postcss-custom-properties

例如下面 css:

:root {
  --color: red;
}
h1 {
  color: var(--color);
}

经过 postcss 的处理,得到下面的 css,不支持的 css 属性, 浏览器会自动忽略。

h1 {
  color: red;
  color: var(--color);
}

但是这个插件只对第一次编译的时候有用,动态换肤的时候就失效了, 我们可以使用 js polyfill 来修复这个问题,在 HTML 中引入下面代码就可以解决。

<script>
  window.MSInputMethodContext &&
    document.documentMode &&
    document.write(
      '<script src="https://cdn.jsdelivr.net/gh/nuxodin/[email protected]/ie11CustomProperties.min.js"><\/script>'
    )
</script>

😅 但是这样写完全体现不出 Tailwind css 的优势,Tailwind 的思想是 Utility-First,写页面的时候不需要取繁琐的 class 名称了。

Tailwind 配置

tailwind css 可以让用户在tailwind.config.js中配置一些自定义颜色,这样 css 中就增加了与之对应颜色的 class。

const colors = require('tailwindcss/colors')

module.exports = {
  mode: 'jit',
  theme: {
    extend: {
      colors: {
        amber: colors.amber,
        lime: colors.lime,
        rose: colors.rose,
        orange: colors.orange,
      },
    },
    backgroundColor: {
      //utilities like `bg-base` and `bg-primary`
      base: 'var(--color-base)',
      'off-base': 'var(--color-off-base)',
      primary: 'var(--color-primary)',
      secondary: 'var(--color-secondary)',
      muted: 'var(--color-text-muted)',
    },
    textColor: {
      //like `text-base` and `text-primary`
      base: 'var(--color-text-base)',
      muted: 'var(--color-text-muted)',
      'muted-hover': 'var(--color-text-muted-hover)',
      primary: 'var(--color-primary)',
      secondary: 'var(--color-secondary)',
    },
  },
  variants: {},
  plugins: [],
}

在这里为了方便使用和记忆,我用来几个简单的变量名称来定义,背景和字体颜色,当然还有扩展其他样式如borderColor

然后在 css 中定义变量 theme 方法可以获取 tailwind 内置的颜色,想要使用颜色比配置在 colors 中。跟多颜色可以访问customizing-colors,当然

@tailwind base;
@tailwind components;
@tailwind utilities;

@layer base {
  .theme-light {
    --color-base: theme('colors.white');
    --color-text-base: theme('colors.black');
    --color-off-base: theme('colors.gray.50');
    --color-text-muted: theme('colors.gray.600');
    --color-text-muted-hover: theme('colors.gray.500');
    --color-primary: theme('colors.blue.600');
    --color-secondary: theme('colors.blue.300');
  }

  .theme-dark {
    --color-base: theme('colors.gray.900');
    --color-text-base: theme('colors.gray.100');
    --color-off-base: theme('colors.gray.800');
    --color-text-muted: theme('colors.gray.300');
    --color-text-muted-hover: theme('colors.gray.200');
    --color-primary: theme('colors.blue.500');
    --color-secondary: theme('colors.blue.200');
  }
}

tailwind 中有个样式是text-opacity-10 设置了字体颜色,还可以设置透明度,查看源码发现样式是通过 rgba 实现的.

.text-gray-900 {
  --tw-text-opacity: 1;
  color: rgba(17, 24, 39, var(--tw-text-opacity));
}

如想要支持这个透明度的样式,我们还需要将颜色转成 Rgb,tailwind.config.js 配置

function withOpacity(variableName) {
    return ({ opacityValue }) => {
        if (opacityValue) {
            return `rgba(var(${variableName}), ${opacityValue})`;
        }
        return `rgb(var(${variableName}))`;
    };
}

module.exports = {

   ...,

   theme: {
        // we want to extend the current colors instead of replacing them
        extend: {
         //like `bg-base` and `bg-primary`
            backgroundColor: {
                primary: withOpacity('--color-primary'),
                secondary: withOpacity('--color-secondary'),
                muted: withOpacity('--color-text-muted'),
            },
        //like `text-base` and `text-primary`
            textColor: {
                primary: withOpacity('--color-primary'),
                secondary: withOpacity('--color-secondary'),
            },
      }
}

css 中颜色定义

.theme-dark {
  --color-base: 17, 24, 39; /* gray-900 */
  --color-text-base: 243, 244, 246; /* gray-100 */
  --color-off-base: 31, 41, 55; /* gray-800 */
  --color-text-muted: 229, 231, 235; /* gray-200 */
  --color-muted-offset: 209, 213, 219; /* gray-300 */
  --color-primary: 147, 197, 253; /* blue-300 */
  --color-secondary: 96, 165, 250; /* blue-400 */
}

最终效果

image.png

顺便提一下https://play.tailwindcss.com/ 必须点击 share 才会保存。😂 我在练习的时候也没保存,吃过一堑。

参考

runjs-cool
关注微信公众号,获取最新原创文章(首发)View on GitHub