- Published on
使用 CSS variables 和Tailwind css实现主题换肤
背景
在 2B 的项目中,常常有客户(甲方爸爸)需求,定制与他们企业相同的主题的网站;随着苹果暗黑模式的推出,换肤的需求在网站开发中越来越多,也越来越重要,最近在网上看到 Tailwind Labs 的实现的换肤视频,决定实践一把。
实现博客列表
我们先使用 Tailwind css 实现一个博客列表
- 效果
- 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);
}
这样就可以实现深色皮肤了,如果想增加一套皮肤,只需增加一套颜色变量就可以了。
兼容性
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 */
}
最终效果
顺便提一下https://play.tailwindcss.com/ 必须点击 share 才会保存。😂 我在练习的时候也没保存,吃过一堑。